Architecture Decision Records

by affaan-m

Architecture Decision Records is an AI Engineering skill for Claude Code, published by affaan-m in ECC.

239.8K stars36.4K forkson affaan-m/ECCAdded 2026/08/13Repository updated 2026/08/12

View source on GitHub Download repo ZIP

ai-agentsanthropicclaudeclaude-codedeveloper-toolsllmmcpproductivity

Install in seconds

Install Architecture Decision Records

Copy Architecture Decision Records into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/affaan-m/ECC/tree/main/skills/architecture-decision-records ~/.claude/skills/architecture-decision-records

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/affaan-m/ECC.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/architecture-decision-records/SKILL.md in affaan-m/ECC
Installs to: ~/.claude/skills/architecture-decision-records
Collection: One of 25 skills cataloged from this repository
Category: AI Engineering — 2451 skills

What Architecture Decision Records does

Architecture Decision Records captures architectural decisions made during Claude Code sessions as structured ADRs, recording context, alternatives, and rationale. Use it when significant technical choices are made so future developers understand why the codebase is shaped the way it is.

Architecture Decision Records is cataloged under AI Engineering on DirSkills. Architecture Decision Records comes from a repository tagged ai-agents, anthropic, claude, claude-code and developer-tools.

Documentation

README

Excerpt

Architecture Decision Records

Capture architectural decisions as they happen during coding sessions. Instead of decisions living only in Slack threads, PR comments, or someone's memory, this skill produces structured ADR documents that live alongside the code.

When to Activate

User explicitly says "let's record this decision" or "ADR this"
User chooses between significant alternatives (framework, library, pattern, database, API design)
User says "we decided to..." or "the reason we're doing X instead of Y is..."
User asks "why did we choose X?" (read existing ADRs)
During planning phases when architectural trade-offs are discussed

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Architecture Decision Records

What else does affaan-m publish alongside Architecture Decision Records?
Architecture Decision Records is one of 25 skills that DirSkills catalogs from affaan-m/ECC, the repository it ships in. Its siblings there include AI Regression Testing, AI-First Engineering and API Connector Builder. Each one is a separate skill with its own page in this directory, installs the same way Architecture Decision Records does, and is maintained by affaan-m in that same repository. The rest of the collection is listed on the affaan-m/ECC page.
How does Architecture Decision Records compare to other AI Engineering skills?
Architecture Decision Records ranks #1 by stars among the 2451 AI Engineering skills in this catalog. The most-starred ones next to it are AI-First Engineering, Agentic OS and Agentic Engineering. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Architecture Decision Records against them. Open each page to compare what they document and how they install.