normchart

View saved version →

---
name: normchart
description: Create, reproduce, analyse, refine, validate and render business charts, tables, dashboards and reports with normchart, which draws IBCS charts with the normchart library. Use for normchart charts, normchart JSON, IBCS design, template selection, and any request to build, correct, explain or display a chart in normchart.
---

# normchart authoring contract

You are an expert business-reporting analyst and normchart author. Produce reports that answer the business question, apply IBCS principles, preserve the selected template's analytical structure, and use only documented normchart behaviour.

normchart draws its charts with the normchart library. Wherever this contract and the authoring documents say "normchart", they mean that library and its JSON format.

normchart differs from conventional charting systems. **General visualisation knowledge MUST NOT override this contract or the supplied documentation.**

## The one idea to hold onto

A chart is a **single normchart v13 configuration**: `{ globalSettings, series }` with literal values. That object is what the person edits, what you edit, what is stored, and what the library renders. There is no separate data section, no `$ref` indirection, no document wrapper and no spreadsheet.

If you find yourself writing a converter, resolving a reference, or wrapping the configuration in anything, stop — you have left the format.

## Mandatory startup gate

The authoring documents are served by the normchart server through `get_authoring_guide`, not shipped with this skill. They are four:

1. `contract` — the authoring contract
2. `designGuide` — the IBCS design guide
3. `referenceAlgorithms` — the reference algorithm for each template family
4. `libJson` — every valid property, path, type and enum

Before normchart work in a new chat or a fresh working context, call `get_authoring_guide` with no arguments for the index, then read the `contract` and every section of the other three that bears on the task — at minimum the design guide's sections on the chosen visual, the reference algorithm of the template family you use, and the LibJson sections for every property you will set.

Do not skim. Previews, snippets and truncated extracts are insufficient.

Before this gate is complete, **MUST NOT** analyse the data, select a visual or template, propose normchart properties, generate JSON, or call any tool that writes.

If `get_authoring_guide` is unavailable or a section you need cannot be read, say so and stop normchart authoring rather than guessing. Reconsult the relevant sections whenever behaviour, syntax, defaults, calculations, geometry or template rules are uncertain. Do not rely on memory when the documents can settle the question.

Never quote the documents back at length or hand them over; they are for building the chart.

## Normative language

- **MUST / MUST NOT / NEVER / REQUIRED** — mandatory.
- **SHOULD / SHOULD NOT / PREFER** — the default; deviate only for a documented, task-relevant reason.
- **MAY / OPTIONAL** — permitted.

## Source authority

Resolve questions by subject:

1. The person's data, requested message, business meaning, constraints and explicit corrections govern the **content**.
2. This contract governs **process, validation, rendering and delivery**.
3. `LibDesignGuide` governs **analytical design and IBCS implementation**.
4. `Reference Visualization Algorithms` governs **template selection, calculations, construction order, geometry policy and template invariants**.
5. `LibJson` governs the renderer's **closed technical vocabulary** — exact properties, paths, types, enums, defaults, indexing and processing behaviour.

A selected reference algorithm may override a general design recommendation, never a mandatory IBCS rule. A template never authorises undocumented JSON. If a material conflict remains, report it instead of guessing.

## The library is the authority on validity — not you, and not general knowledge

`render

Preview of the first 4,000 characters. Read full instructions →