Category: Development
Architecture Decision Records
Captures architectural decisions made while coding as numbered ADRs with context, alternatives, and consequences.
Works with
What it does
- Writes numbered ADR Markdown files in
docs/adr/ - Records context, alternatives, decision, consequences, and status
- Maintains an index README
- Answers "why is it built this way?" from existing ADRs
When to use it
Great for keeping decisions like framework or database choices from living only in chat threads or memory.
How to install
- Run the command below in your terminal. Pick the agents you use (Claude Code, Codex, Cursor, Gemini CLI, Copilot, and more) and it installs into the right folder.
npx skills add https://github.com/affaan-m/ECC --skill architecture-decision-records
- To install manually, download the
architecture-decision-recordsskill folder from the GitHub repository and copy it into your agent's skills folder, such as~/.claude/skills/or.cursor/skills/. - Ask your agent for a related task and the skill is used automatically.