Adr
This skill walks you through the complete ADR lifecycle—from evaluating whether a decision is ready to record, through structured creation using the MADR template, to quality checks and ongoing log management. It grounds decisions in proven frameworks like START (readiness criteria) and ECADR (completion criteria), helping teams capture architectural rationale rather than just outcomes.
Adr guides you through creating, reviewing, and managing architecture decision records using proven frameworks for capturing architectural rationale.
AI-generated summary based on this skill's SKILL.md
Install
ncklrs/startup-os-skills/adr · repository language: TypeScript
git clone https://github.com/ncklrs/startup-os-skills
cp -r startup-os-skills ~/.claude/skills/adrgenerated, unverified - the skill's exact subdirectory could not be determined; check the repository on GitHub
npx skillfed install ncklrs/startup-os-skills/adrFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What is ADR and how does Adr help document architecture decisions?
Adr guides you through the complete ADR (Architecture Decision Record) lifecycle—from evaluating whether a decision is ready to record, through structured creation using the MADR template, to quality checks and ongoing log management. It grounds decisions in proven frameworks like START (readiness criteria) and ECADR (completion criteria), helping teams capture architectural rationale rather than just outcomes.
How to document architecture decisions with Adr's templates?
Adr provides standardized ADR templates and formats that structure your documentation. The skill walks you through creating decision records that capture not just what was decided, but the reasoning behind it. By using proven frameworks and templates, Adr ensures your architecture decision records are consistent, complete, and useful for team alignment.
How do I write an ADR using this skill?
Adr guides you step-by-step through writing an ADR. It helps you evaluate readiness using START criteria, then structures your record using the MADR template format. The skill includes quality checks to ensure your decision record is complete and captures the full rationale, not just the final outcome.
Can Adr help track and manage architecture decision logs?
Yes. Adr helps you manage and organize architecture decision logs over time. It tracks architectural decisions and their rationale, making it easy to reference past decisions, understand the evolution of your architecture, and ensure team alignment on why specific choices were made.
What makes Adr's architecture decision record format effective?
Adr uses the MADR template and frameworks like START and ECADR to ensure ADRs capture complete context. Rather than just recording outcomes, Adr helps teams document the reasoning, alternatives considered, and decision criteria—creating a living record that supports both current alignment and future reference.