ADR Architecture Decision Records

•
15
•

Creates and manages Architecture Decision Records (ADRs) to document system design choices and provide executable implementation plans for AI agents.

The ADR Skill enables developers and AI agents to formally document technical decisions through a structured, four-phase workflow including scanning, intent capture, drafting, and review. It uses Socratic questioning to extract deep technical intent and converts it into agent-ready specifications that include explicit constraints, non-goals, and detailed implementation plans. By bridging the gap between high-level architectural decisions and concrete code changes, this skill ensures that future contributors—both human and AI—understand the reasoning behind a codebase and have a clear roadmap for implementation and verification.

주요 기능

01Bidirectional linking between decision records and existing source code
02Agent-readiness validation against a standardized architectural checklist
03Automated generation of implementation plans with specific file-level mapping
04Support for multiple ADR templates including Simple and MADR formats
05Socratic capture workflow to extract deep technical intent from users
0615 GitHub stars

사용 사례

01Onboarding AI agents to complex architectural patterns before coding begins
02Superseding legacy architecture decisions with structured version history
03Proposing and documenting new dependencies or infrastructure changes