// Manage Architecture Decision Records (ADRs) using adr-tools. Use this to initialize, create, list, and link ADRs to document architectural evolution.
Broadly and deeply analyze user intent (avoiding XY problems) and evaluate multiple solution approaches (default 5) with scores from 0 to 100.
Workflow for auditing security vulnerabilities using trivy, osv-scanner, and trunk.
Comprehensive workflow for creating, implementing, and validating Agent Skills. Use when asked to "create a new skill", "author a skill", "add a capability", or when standardizing project-specific workflows. Support for platform detection (Cursor, Claude Code, Gemini CLI, Codex) and template selection.
Manage changelogs using Changie. Provides tools to initialize, add change fragments, batch releases, and merge version notes.
Workflow for auditing security vulnerabilities using trivy, osv-scanner, and trunk.
Update README.md to reflect changes in project structure, skills, and agents. Use when new components are added or architecture changes.
| name | manage-adr |
| description | Manage Architecture Decision Records (ADRs) using adr-tools. Use this to initialize, create, list, and link ADRs to document architectural evolution. |
Architecture Decision Records (ADRs) are a lightweight way to document the "why" behind significant technical choices.
list).If ADRs are not yet initialized in the project, run:
adr init
This defaults to creating records in doc/adr. You can specify a different directory if needed.
To create a new ADR, use the provided script to ensure non-interactive creation:
.cursor/skills/manage-adr/scripts/create-adr.sh "Title of the ADR"
After creation, the script will output the filename. You MUST then edit the file to fill in the Context, Decision, and Consequences.
If a new decision replaces an old one, use the -s flag:
.cursor/skills/manage-adr/scripts/create-adr.sh -s <old-adr-number> "New Decision Title"
To link two existing ADRs (e.g., ADR 12 amends ADR 10):
adr link 12 Amends 10 "Amended by"
adr listread_file doc/adr/NNNN-title.mdadr generate tocadr generate graph | dot -Tpng -o adr-graph.pngreferences/adr-concepts.md for more details on the ADR philosophy.assets/template.md as a guide.