Adr Skill
ADR Skill helps teams document architecture decisions as executable specifications for coding agents. It guides you through a four-phase workflow—scanning existing decisions, capturing intent through structured questions, drafting the record with implementation details, and validating against an agent-readiness checklist. Built for codebases where decisions must be explicit, measurable, and actionable.
ADR Skill creates Architecture Decision Records optimized for agentic coding workflows with implementation plans and validation.
AI-generated summary based on this skill's SKILL.md
Install
joelhooks/joelclaw/adr-skill · repository language: TypeScript
git clone https://github.com/joelhooks/joelclaw
cp -r joelclaw ~/.claude/skills/adr-skillgenerated, unverified - the skill's exact subdirectory could not be determined; check the repository on GitHub
npx skillfed install joelhooks/joelclaw/adr-skillFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I write an ADR with the ADR Skill?
ADR Skill guides you through a four-phase workflow to document architecture decisions as executable specifications. Start by scanning existing decisions, then capture intent through structured questions, draft the record with implementation details, and validate against an agent-readiness checklist. This process ensures your architecture decision records are explicit, measurable, and actionable for coding agents and team members.
What is ADR format and what are best practices?
ADR Skill teaches ADR (Architecture Decision Record) format as a structured approach to documenting technical design choices. Best practices include capturing decision context, stating the chosen option clearly, explaining the rationale, and listing consequences. ADR Skill emphasizes making decisions explicit and measurable so they become executable specifications that teams and coding agents can act on consistently.
How does ADR Skill help establish team consensus?
ADR Skill standardizes how teams capture and communicate design decisions through its structured four-phase workflow. By guiding teams through scanning existing decisions, asking clarifying questions, drafting records with implementation details, and validating readiness, ADR Skill creates a shared framework that helps establish consensus on architectural directions and maintains decision history for future reference.
Can ADR Skill create templates for architecture decisions?
Yes, ADR Skill provides templates and structure for creating architecture decision records. It helps you document system design decisions in a standardized format that captures intent, rationale, and consequences. ADR Skill's template-driven approach ensures consistent documentation across your codebase and makes decision records actionable for both human teams and coding agents.
How does ADR Skill track decision status and history?
ADR Skill maintains decision history and rationale through structured record-keeping in your architecture decision log. By documenting each technical choice with context, options considered, and consequences, ADR Skill creates a traceable decision record management system. This approach helps teams understand why decisions were made and supports future architectural planning and agent-driven implementation.