Core Commands
The foundation of every ADD project. These commands bootstrap your project, create feature specifications, and manage work cycles.
/add:init — Initialize ADD
Bootstrap ADD for a project through a 4-section structured interview: Product, Architecture, Branding, and Process. Supports adoption mode for existing projects, auto-detects maturity level, and sets up cross-project persistence at ~/.claude/add/.
$ /add:init --reconfigure
/add:spec — Create Feature Spec
Structured interview to create a feature specification. 6–10 questions covering: description, user story, acceptance criteria, happy path, error handling, data models, API contracts, and UI. Produces a complete spec ready for planning and TDD.
$ /add:spec --from-prd-section 3
/add:cycle — Work Cycle Management
Plan, track, and complete work cycles within milestones. Three modes: --plan for interactive cycle planning (default), --status for real-time progress check, and --complete to close a cycle and update milestone hill charts. Maturity cascade controls parallelism: POC=1 agent, Alpha=1–2, Beta=2–4 with file reservations, GA=3–5 strict.
$ /add:cycle --status
$ /add:cycle --complete
Collaboration Commands
Human-agent collaboration primitives. Declare absence, get briefed on return, and capture learnings through retrospectives.
/add:away — Declare Absence
Set up an autonomous work plan for your absence. Default duration is 2 hours. Categorizes work as autonomous (clear specs, TDD, quality gates) vs. queued (ambiguous specs, architecture decisions). Enforced boundaries: no production deploy, no merge to main, no features without specs.
$ /add:away
/add:back — Return Briefing
Concise briefing on what happened during autonomous away mode. Shows completed tasks, in-progress items, decisions queued for your approval, and overall project state. Archives the away log to .add/away-logs/away-{date}.md.
/add:retro — Retrospective
Capture learnings from a session, feature, or sprint. Two modes: interactive retro (default) with human + agent perspectives that agree on actionable changes, and --agent-summary for non-interactive summaries. Promotes learnings to ~/.claude/add/library.md for cross-project reuse and optionally to knowledge/global.md.
$ /add:retro --agent-summary
Tooling Commands
Branding management, artifact auditing, and automated changelog generation.
/add:brand — View Branding
Display the current branding configuration from .add/config.json, detect brand drift in project artifacts (HTML, SVG, CSS), and report image generation status.
/add:brand-update — Update Branding
Update project colors, fonts, tone, and logo. Audits all artifacts for drift against the new configuration and optionally fixes or regenerates them to match.
$ /add:brand-update #b00149
/add:changelog — Generate Changelog
Generate or refresh CHANGELOG.md from conventional commit history. Maps commit types to sections: feat → Added, fix → Fixed, docs → Documentation, and so on. Use --from-scratch to regenerate the entire changelog from the first commit.
$ /add:changelog --from-scratch