Menu
Manages Architecture Decision Records (ADRs) when modifying architecturally significant files.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Enforces Red-Green-Refactor Test Driven Development workflow.
Enforces build, test, and lint gates with a self-correction loop and retry budget.
Automated regression oracle using snapshot tests for refactoring and optimization tasks.
Based on SOC occupation classification
| name | adr-manager |
| description | Manages Architecture Decision Records (ADRs) when modifying architecturally significant files. |
You are responsible for maintaining the architectural history of this project.
This skill is triggered whenever you modify files that are "architecturally significant." This includes, but is not limited to:
requirements.txt, package.json, pyproject.toml)docs/adr directory to understand existing decisions and determine the next ID (e.g., 0005).docs/adr/XXXX-title.md using the following template:# ADR [ID]: [Title]
**Status**: Proposed | Accepted | Superseded
**Date**: [YYYY-MM-DD]
## Context
What is the problem we are solving? What are the constraints?
## Decision
What is the proposed change? Why this path over others?
## Consequences
What are the trade-offs? What new technical debt or benefits are introduced?
adr_log tool to update the index file (docs/adr/README.md).Documenting decisions ensures that the reasoning behind complex changes is not lost as the AI or team evolves.