Domains / design-as-code
Design as Code domain
Design as a versioned product contract: research and concepts are transient; specs and asset records are durable.
Use it when: A design team keeps foundations, components, journeys, and accessibility rules as written contracts.
cumaru install agent <agent> --domain design-as-code Pillars
| Pillar | Lifetime | Holds |
|---|---|---|
specs/ | Durable | Current experience contracts by area and concern. |
assets/ | Durable | Reusable asset records with sources, licenses, and usage rules. |
intake/ | Transient | Tracker-backed briefs at <KEY>.md. |
research/ | Transient | Studies, interviews, audits, and evidence. |
concepts/ | Transient | Design alternatives, sketches, and prototype hypotheses. |
plans/ | Transient | Scoped delivery tasks, handoffs, and delta drafts. |
Roles
- Design Lead: owns scope, concept selection, planning, review reconciliation, and absorption.
- Designer: executes bounded plan tasks and returns artifacts, evidence, and proposed deltas.
- Reviewer: evaluates delivery independently and reports findings; does not edit durable content.
Lifecycle
- intake/ + research/ -> concepts/ -> plans/ -> specs/, with reusable records in assets/.
- Research informs concepts; a scoped maintenance change may start directly in plans/.
- Cleanup removes the plan and its consumed concepts, research, and intake only after validation, an exact removal set, and a Git recovery point.
Skills
Domain-specific skills, in addition to the universal ones: cumaru-intake,cumaru-concept,cumaru-plan,cumaru-specs,cumaru-absorb.
Bootstrap
No domain bootstrap document. cumaru bootstrap prints the universal rules.
Domain rules
- A skill never switches the active role. Use a separate agent or an explicit cumaru-role switch.
- Tracker-backed work uses cumaru-intake only after the ticket exists.
- Binary assets stay outside .cumaru/; figma and prototype links support the written contract.
Example: Select a concept and ship it
- research/<slug>/ records an accessibility audit.
- cumaru-concept compares two concepts that cite that evidence.
- Lead plans the selected concept; Reviewer audits delivery; cumaru-absorb updates specs/ and assets/.
Source: domain.md, config.yaml, roles, skills, docs/design-as-code.md at revision 37ad79f. The example is a summary
of the shipped recipes, not CLI output.