Documentation

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

PillarLifetimeHolds
specs/DurableCurrent experience contracts by area and concern.
assets/DurableReusable asset records with sources, licenses, and usage rules.
intake/TransientTracker-backed briefs at <KEY>.md.
research/TransientStudies, interviews, audits, and evidence.
concepts/TransientDesign alternatives, sketches, and prototype hypotheses.
plans/TransientScoped 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

  1. research/<slug>/ records an accessibility audit.
  2. cumaru-concept compares two concepts that cite that evidence.
  3. 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.

Back to the comparison