spec
The source of truth. Everything here is data, schemas or specification prose. Code implements it, never the other way round. Depends on nothing.
| Folder | Holds | Filled by |
|---|---|---|
glossary.yaml | The ubiquitous language | WP0 draft, approved with WP1 |
language/ | Language definition data, grammar, specification prose | WP1 |
schemas/ | JSON Schemas: app manifest, theme, kit, module manifest, CLI output, build report | WP1 onward |
diagnostics/ | Every error and warning: code, message, explanation, fix (catalogue.yaml) | WP1, WP4 |
styling/ | The default theme's tokens and the utility vocabulary | Walking skeleton, WP7 |
conformance/ | Fixtures: input file and expected output per target | WP1 onward |
ir/ | Screen IR and style table schemas: the central contracts | WP1 |
kit/ | One spec per kit part: pieces, variants, states, tokens | WP7 |
effects/ | One TypeScript interface per platform effect | WP11 |
Changing anything user-facing here needs a decision record and Mik's approval.