
architecture-decision-records
Capture architectural decisions as numbered ADR markdown files in docs/adr/
by affaan-mFree
Description
architecture-decision-records is an agent skill from ECC, Affaan Mustafa's open-source agentic engineering toolkit, listed on skills.sh. It captures architecture decisions as numbered ADR Markdown files in docs/adr/ as they happen in a coding session, and reads them back when someone asks why. A skill is a SKILL.md file of instructions (sometimes with scripts and reference notes) that an AI agent loads only when a task calls for it, so the agent knows the steps to follow and what to avoid. It is free and open source.…
Highlights
- Numbered ADR files
- Captured during sessions
- Answers 'why did we choose X?'
Ratings & Reviews
No ratings yet
Be the first to rate architecture-decision-records.
People also visit

android-clean-architecture
Clean Architecture patterns for Android and Kotlin Multiplatform projects
architecture-decision-records FAQ
What does the architecture-decision-records skill do?
It captures architecture decisions as numbered ADR Markdown files in docs/adr/ as they happen in a coding session, and reads them back when someone asks why.
How do I install the architecture-decision-records skill?
Run: npx skills add https://github.com/affaan-m/ecc --skill architecture-decision-records
Is it free?
Yes. It is free and open source.
What is an agent skill?
A SKILL.md file of instructions, sometimes with scripts and reference notes, that an AI agent such as Claude Code loads when a task needs it, so it handles that task the same careful way every time.
Has it been checked for security?
skills.sh lists three audits: Gen Agent Trust Hub Pass, Socket Pass and Snyk Pass. A Warn is worth reading before you install.
What are the best architecture-decision-records alternatives?
Popular alternatives to architecture-decision-records include android-clean-architecture, codebase-design and domain-modeling. See all architecture-decision-records alternatives

