Add design doc

docs/design-context-categorization/CONTENTS-TABLE.md

@@ -0,0 +1,104 @@
+# Contents Table
+
+## Source legend
+
+See [`PROVENANCE.md`](./PROVENANCE.md) for the full mechanism. Where a value can come from either scan mode or the planned seed flow, both are listed.
+
+| Source | Meaning |
+| --- | --- |
+| Derived | Scanned off existing code. Changed only by re-scanning, not by re-answering a question. |
+| Questionnaire — In-chat (init) | `PRODUCT.md` fields, asked in chat during `/impeccable init` Step 3. Not persisted or resettable. |
+| Questionnaire — In-chat (document) | `DESIGN.md` fields asked in chat during `document.md` — covers both today's qualitative round and the new seed flow's chat portion (assets, named references, anti-reference). Not persisted or resettable today; the `(planned)` rows are where that's changing. |
+| Questionnaire — Browser (document) | `DESIGN.md` fields asked through a visual card UI during `document.md` — covers both today's shipped Layout-strictness slide and the new seed flow's browser slides (Color, Typography, Motion, Layout, Elevation, Iconography). Same persistence note as above — see `PROVENANCE.md`. |
+| Computed | Generated by the agent from other values. Never directly asked. |
+
+## Categories
+
+- Audience
+- Product
+- Brand
+- Color
+- Typography
+- Iconography
+- Material
+- Interface
+
+## Audience
+
+| Value | Derived from | Source |
+| --- | --- | --- |
+| Primary/secondary user role | `PRODUCT.md` · Users | Questionnaire — In-chat (init) |
+| Confirmed primary/secondary split | `PRODUCT.md` · Users (PR #315) | Questionnaire — In-chat (init) |
+| Context, job-to-be-done | `PRODUCT.md` · Users | Questionnaire — In-chat (init) |
+| Emotional goal on landing | `PRODUCT.md` · Brand Personality | Questionnaire — In-chat (init) |
+
+## Product
+
+| Value | Derived from | Source |
+| --- | --- | --- |
+| Name | `DESIGN.md` frontmatter `name` | Derived |
+| Register (`brand`/`product`) | `PRODUCT.md` · Register | Questionnaire — In-chat (init) |
+| What it does, success definition | `PRODUCT.md` · Product Purpose | Questionnaire — In-chat (init) |
+| Use cases (implicit) | `PRODUCT.md` · Product Purpose | Derived |
+| Differentiator / strategic claim | `PRODUCT.md` · Positioning (PR #315) | Questionnaire — In-chat (init) |
+| CTAs, memorable line, belief ladder | `PRODUCT.md` · Conversion & proof (PR #315, brand only) | Questionnaire — In-chat (init) |
+| Proof assets (testimonials, press, logos) | `PRODUCT.md` · Conversion & proof (PR #315, brand only) | Questionnaire — In-chat (init) |
+
+## Brand
+
+| Value | Derived from | Source |
+| --- | --- | --- |
+| Identity name + narrative (long form) | `DESIGN.md` · Overview | Questionnaire — In-chat (document) |
+| Description (short form of the same narrative) | `DESIGN.md` frontmatter `description` | Questionnaire — In-chat (document) |
+| Three words, voice, tone, references | `PRODUCT.md` · Brand Personality | Questionnaire — In-chat (init) |
+| Anti-references | `PRODUCT.md` · Anti-references | Questionnaire — In-chat (init) |
+| Strategic principles | `PRODUCT.md` · Design Principles | Questionnaire — In-chat (init) |
+
+## Color
+
+| Value | Derived from | Source |
+| --- | --- | --- |
+| Palette (hex) | `DESIGN.md` frontmatter `colors` | Derived / Questionnaire — Browser (document) |
+| Roles (primary/neutral) | `DESIGN.md` · Colors | Questionnaire — In-chat (document) |
+| Strategy (named rules) | `DESIGN.md` · Colors → Named Rules | Questionnaire — In-chat (document) |
+| Tints (opacity variants) | `DESIGN.md` frontmatter `colors` | Derived / Questionnaire — Browser (document) |
+| Tonal ramps (OKLCH) | `design.json` · `colorMeta.tonalRamp` | Computed |
+
+## Typography
+
+| Value | Derived from | Source |
+| --- | --- | --- |
+| Font families | `DESIGN.md` frontmatter `typography` | Derived / Questionnaire — Browser (document) |
+| Typescale (base + ratio, e.g. Major Third) | Visual document seed (planned) | Questionnaire — Browser (document) |
+| Hierarchy (role/size/weight/etc.) | `DESIGN.md` · Hierarchy | Derived |
+| Readability rules | `DESIGN.md` · Named Rules | Computed |
+
+## Iconography
+
+| Value | Derived from | Source |
+| --- | --- | --- |
+| Icon library/style (Lucide/Tabler Icons/Hugeicons) | Visual document seed (planned) | Questionnaire — Browser (document) |
+
+## Material
+
+| Value | Derived from | Source |
+| --- | --- | --- |
+| Spacing / layout scale | `DESIGN.md` frontmatter `spacing` | Derived / Questionnaire — Browser (document) |
+| Layout structure / grid strictness | Visual document seed (existing) | Questionnaire — Browser (document) |
+| Breakpoints | `design.json` · `extensions.breakpoints` | Computed |
+| Radius | `DESIGN.md` frontmatter `rounded` | Derived / Questionnaire — Browser (document) |
+| Borders | `DESIGN.md` prose (Elevation/Colors) | Derived |
+| Surfaces | `DESIGN.md` · Colors → Neutral | Derived |
+| Shadows + elevation | `DESIGN.md` · Elevation; `design.json` · `shadows` | Derived / Questionnaire — Browser (document) |
+| Motion feel (qualitative) | `DESIGN.md` · Do's and Don'ts | Questionnaire — In-chat (document) / Questionnaire — Browser (document) |
+| Motion tokens (ease/duration) | `design.json` · `extensions.motion` | Computed / Questionnaire — Browser (document) |
+
+## Interface
+
+| Value | Derived from | Source |
+| --- | --- | --- |
+| Component tokens | `DESIGN.md` frontmatter `components` | Derived |
+| Component prose + states | `DESIGN.md` · Components | Derived / Questionnaire — In-chat (document) |
+| Signature/future components | `DESIGN.md` · Components | Questionnaire — In-chat (document) |
+| Concrete HTML/CSS snippets | `design.json` · `components[]` | Computed |
+| Accessibility & Inclusion | `PRODUCT.md` · Accessibility & Inclusion | Questionnaire — In-chat (init) |