# 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) |