Capture architectural decisions as numbered ADR markdown files in docs/adr/ with context, alternatives considered, consequences, and an index README. Use when the user says 'record this decision' or 'ADR this', chooses between frameworks or databases, discusses trade-offs, or asks why the codebase is shaped this way.
Security grade of this SKILL.md: SAFE · how we grade
How to install architecture-decision-records
npx skills add affaan-m/ECC --skill architecture-decision-records -a claude-code
The skills CLI copies this one skill into Claude Code (use -a for another agent). Or read its SKILL.md on GitHub.
What the SKILL.md says
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. 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.
Other skills in affaan-m/ECC
accessibilityDesign, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels, accessibilit…
agent-architecture-auditFull-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discip…
agent-evalHead-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metr…
agent-harness-constructionDesign and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or…
agent-introspection-debuggingStructured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when…
agent-payment-x402Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwal…
agent-runtime-gateway-smoke-testVerify a local agent API, temporary gateway tunnel, and remote sandbox callback with a tool-free task, then restore the original app connec…
agent-security-hardeningSecurity hardening guidance for AI agent frameworks that process untrusted content, invoke tools, write workspace files, manage runtime ide…
agent-self-evaluationUse after completing any non-trivial task. The agent self-rates its output on 5 axes — accuracy, completeness, clarity, actionability, conc…
agent-sortBuild an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY b…
agentic-engineeringOperate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engi…
agentic-osBuild persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based me…
ai-first-engineeringEngineering operating model for teams where AI agents generate a large share of implementation output. Use when setting team process, revie…
ai-regression-testingRegression testing strategies for AI-assisted development. Sandbox-mode API testing without database dependencies, automated bug-check work…
android-clean-architectureClean Architecture patterns for Android and Kotlin Multiplatform projects — module structure, dependency rules, UseCases, Repositories, and…
angular-developerGenerates Angular code and provides architectural guidance. Trigger when creating projects, components, or services, or for best practices…
api-connector-builderBuild a new API connector or provider by matching the target repo's existing integration pattern exactly. Use when adding one more integrat…
api-designREST API design patterns including resource naming, status codes, pagination, filtering, error responses, versioning, and rate limiting for…
article-writingWrite articles, guides, blog posts, tutorials, newsletter issues, and other long-form content in a distinctive voice derived from supplied…
automation-audit-opsEvidence-first automation inventory and overlap audit workflow for ECC. Use when the user wants to know which jobs, hooks, connectors, MCP…