Architecture Decision Records
affaan-m/eccEvery software project involves many choices. Some choices shape the whole system. Architecture Decision Records help you write down those choices as you make them. Instead of losing decisions in chat messages or comments, you save them as simple text files next to your code.
The skill spots decision moments during your work. When you pick a framework, a database, or a design pattern, it can capture the context, the alternatives you considered, and why you chose what you did. Future developers can then read these records to understand the reasons behind the code.
Using a lightweight format, each record includes a title, date, status, and clear sections for context, decision, alternatives, and consequences. The skill also keeps an index so you can easily browse past decisions.
Add Architecture Decision Records skill to your workflow
Global
mkdir -p ~/.claude/skills/architecture-decision-recordsProject
mkdir -p .claude/skills/architecture-decision-recordsSource Repository
More Documentation Claude Code Skills
Grill With Docsmattpocock/skills
Stress-test your plan, refine your terms, and update docs instantly
To Prdmattpocock/skills
Generate a complete PRD from your conversation and codebase understanding
Lark Doclarksuite/cli
Create read summarize edit translate and manage Lark cloud documents
Github Actions Docsxixu-me/skills
Answers your GitHub Actions questions with exact official documentation links
Readme I18nxixu-me/skills
Localize your repo READMEs automatically with structure and selector intact
Ubiquitous Languagemattpocock/skills
Build a shared glossary of terms from your conversations with clear definitions
Doc Coauthoringanthropics/skills
Co author documents step by step with context refinement and reader testing
Edit Articlemattpocock/skills
Polish your article drafts by improving clarity structure and flow