Architecture Decision Records

This automatically captures architectural decisions during Claude Code sessions and writes them as structured ADRs in a docs/adr directory. It watches for decision moments like "let's go with X instead of Y" and prompts you to record the context, alternatives considered, and trade-offs. The format is Michael Nygard's lightweight ADR template, adapted for AI pair programming. It maintains an index so you can look up why a choice was made months later. The real value is making implicit decisions explicit before they disappear into Slack history. It asks for confirmation before creating files, which is the right move since it's modifying your repo structure.

Install to Claude Code

npx -y skills add affaan-m/ecc --skill architecture-decision-records --agent claude-code