stage 1 · system definitiondesign-mdfoundationsplanning

Generate a DESIGN.md

A committed DESIGN.md tells every agent in your repo what the visual language is — drafted from your positioning brief, formatted for AI tooling.

Variablesfill in to personalize the prompt
play · generate-design-md
You are helping me create a `DESIGN.md` file — a concise specification document that describes a design system's visual language for use with AI coding tools. **Step 1 — Read the living brief:** Read `LIVING_BRIEF.md` from the project root. Confirm the product identity, density, theme, and any key decisions already recorded. If the file does not exist, ask the user to run the `positioning-brief` play first. **Step 2 — Read the references:** Read the following from the Sistema knowledge base: - DESIGN.md format specification: `{{sistema_url}}/raw/standards/design-md/spec` - Token architecture synthesis: `{{sistema_url}}/raw/principles/tokens/architecture` - Visual language overview: `{{sistema_url}}/raw/principles/visual-language/overview` The spec file defines the exact format, YAML schema, section order, and token types. The token architecture synthesis explains the tier model and naming principles your DESIGN.md should follow. The visual language overview provides the translation framework from positioning to preliminary token directions — if `establish-visual-language` has been run, use the approved style tile as the primary source for visual direction values; otherwise use the visual language framework to derive directions from the positioning brief. **Step 3 — Generate the DESIGN.md:** My project context (supplement to the living brief): {{project_context}} Rules: - Follow the DESIGN.md format spec exactly — YAML front matter first, then markdown sections in the order defined in the spec - Token names in the YAML must follow the naming principles from the token architecture synthesis: semantic, role-based, consistent pattern across categories - The Overview section must reflect the positioning brief (from the living brief or from context above) — not generic placeholder prose - Mark any value you are deciding without explicit guidance as `[default — review]` - Do not reference any specific design system's approach or terminology - Output raw markdown only — no surrounding explanation or code fences wrapping the whole document **Step 4 — Update the living brief:** Append to the decision log in `LIVING_BRIEF.md`: ``` [2026-05-13] — Generated initial DESIGN.md — [note any key decisions made] ``` ---
3 KB refs
paste intoClaude CodeCursor

Part of a campaign

Tip

Plays work best when your agent has read DESIGN.md first. Run session-start at the beginning of each session to orient it.

How plays work

Covers DESIGN.md setup, pulling KB references into prompts, and running plays end-to-end.

Read the guide