Adr Skill
Adr Skill guides you through a structured four-phase workflow to author Architecture Decision Records that serve as executable specifications for coding agents. It captures decision intent through targeted questioning, scans your codebase for related patterns and existing ADRs, then drafts records with implementation plans concrete enough for agents to act on without follow-up.
Adr Skill creates Architecture Decision Records designed for agents to implement without ambiguity or follow-up questions.
AI-generated summary based on this skill's SKILL.md
Install
vercel/ai/adr-skill · repository language: TypeScript
git clone https://github.com/vercel/ai
cp -r ai ~/.claude/skills/adr-skillgenerated, unverified - the skill's exact subdirectory could not be determined; check the repository on GitHub
npx skillfed install vercel/ai/adr-skillFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I write an ADR using Adr Skill?
Adr Skill guides you through a structured four-phase workflow to author Architecture Decision Records. The skill captures decision intent through targeted questioning, scans your codebase for related patterns and existing ADRs, then drafts records with implementation plans concrete enough for agents to act on without follow-up.
What is an architecture decision record and why document it?
Adr Skill helps you create Architecture Decision Records (ADRs)—executable specifications that capture the rationale, context, and implementation details of system design choices. ADRs serve as a persistent log of technical decisions, enabling teams to understand the reasoning behind architectural choices and communicate that rationale to stakeholders across the project lifecycle.
Can Adr Skill generate ADR templates for my team?
Yes. Adr Skill generates ADR templates and establishes standardized formats for recording architectural decisions. It helps your team adopt a consistent structure for decision records, ensuring that all ADRs follow the same format and capture the necessary context for future reference and implementation.
How does Adr Skill track architectural decisions?
Adr Skill organizes and tracks technical decisions over your project lifecycle by scanning your codebase for related patterns and existing ADRs. This allows you to maintain an architecture decision log that evolves with your system, making it easy to reference past decisions and understand how architectural choices have shaped your design.
What makes Adr Skill's documentation framework different?
Adr Skill combines targeted questioning with codebase analysis to draft records with implementation plans concrete enough for coding agents to act on without follow-up. This approach bridges the gap between architectural intent and executable specifications, ensuring your ADRs are both well-reasoned and actionable.
How does Adr Skill help share architecture rationale?
Adr Skill structures your Architecture Decision Records in a standardized, documented format that makes it easy to communicate architecture rationale with stakeholders. By capturing decision context, alternatives considered, and implementation details in a consistent framework, Adr Skill ensures all team members understand the reasoning behind system design choices.