Complete guide to the AgentsORG .design format (design.v1).
| Doc | Description |
|---|---|
| ../README.md | Project intro + quick start |
| overview.md | System map with diagrams |
| ecosystem.md | Figma, DTCG, Tailwind, shadcn, agents |
| design-md-mapping.md | Google DESIGN.md / getdesign.md ↔ .design |
| ../SPEC.md | Normative specification |
| ../PHILOSOPHY.md | Why living visual contracts |
| Doc | Description |
|---|---|
| ../templates/starter.design | Annotated kitchen-sink template — copy as .design and adapt |
| self-contained.md | Drag-drop / in-file agent.instructions |
| drop-in.md | Install .design in a product repo |
| shadcn.md | Integrate shadcn/ui |
| getdesign.md | Convert getdesign.md analyses |
| motion-media.md | tokens.sound, video targets, and the HyperFrames frame.md export |
| human-authoring.md | Write a strong contract |
| agent-consumption.md | Agent READ/FOLLOW/UPDATE/VERIFY |
| lifecycle.md | bootstrap → refine → lock → evolve |
| Doc | Description |
|---|---|
| comparison.md | vs DESIGN.md, DTCG, AGENTS.md, products |
| skills-sh.md | Agent Skill packaging |
| research.md | Background decisions |
The largest mermaid diagrams live in:
- overview.md — architecture, discovery, precedence, agent loop, lifecycle, token→CSS
- shadcn.md — artifact roles, agent workflow
- getdesign.md — conversion pipeline, sequence
- agent-consumption.md — follow trees
- lifecycle.md — status + locked paths
- ../templates/starter.design — annotated blank slate exercising every major section
- ../examples/ — Vercel, Stripe, Notion, Apple, Linear, Supabase (from getdesign.md)