Drafts and maintains structured technical design documents to analyze problems and evaluate architectural solutions before implementation.
This skill streamlines the architectural planning process by helping developers create comprehensive design documents that bridge the gap between human intent and code execution. It guides users through problem analysis, goal setting, and trade-off evaluation, ensuring that architectural decisions are well-reasoned and preserved as searchable records. By enforcing a standardized template and exploring multiple solution paths, it helps prevent 'single-option' bias and catches expensive architectural mistakes during the cheapest phase of the development lifecycle.
주요 기능
01Standardized Markdown templates for architectural decision records (ADRs)
02Versioning support via chronological update sections and standardized file naming
031 GitHub stars
04Guided problem analysis including root cause identification and impact assessment
05Comparative evaluation of multiple technical solutions with detailed pros and cons
06Structured tracking of goals, non-goals, and cross-cutting concerns like security and observability
사용 사례
01Evaluating multiple architectural approaches for a new system feature before writing code
02Documenting complex breaking changes and their migration paths for team review
03Creating a historical record of architectural decisions to prevent knowledge loss
