Research a problem space and draft an Architecture Decision Record (ADR).
npx skills add https://github.com/jamesc/skills --skill draft-adr
Please help me install this Agent Skill. Skill: draft-adr Source: https://github.com/jamesc/skills/tree/main/skills/draft-adr Command: npx skills add https://github.com/jamesc/skills --skill draft-adr
This Skill automates the process of researching a problem, exploring trade-offs, and drafting a comprehensive Architecture Decision Record (ADR) to document significant technical decisions.
Use the draft-adr skill to research and draft an ADR for the problem of implementing a new caching layer.
High-intent search queries and answers about installing and using this skill.
To draft an Architecture Decision Record, you research the problem space, analyze trade-offs across user personas, and document the context, options, and impact to establish a historical technical record.
You need to create an ADR when proposing a significant architectural change, such as adopting a new database technology or altering a core communication protocol, to capture the reasoning behind the decision.
The best way to document architectural trade-offs is by following established ADR conventions that capture the context, compare prior art, and evaluate the impact on various stakeholders for future reference.
You research prior art and analyze code by reviewing existing documentation, comparing solutions against multiple user personas, and evaluating technical trade-offs to inform the architecture decision-making process.
Yes, you can use a structured decision-making process to rigorously define, research, and evaluate architectural choices before drafting a comprehensive technical decision record for your software engineering project.
Automating architecture decision documentation relies on available code analysis and documentation review, so limitations arise when prior art is undocumented or when problem spaces lack clear user personas to analyze.
petrSimonidesXartEvaluate technical approaches against project constraints with documented evidence.
nguyenpv1980-wqRecord technical decisions as structured ADRs with context, alternatives, and rollback plans.
yongwoonCapture, list, and curate Architecture Decision Records as standardized Markdown files.
GeargrindadminAnalyze architectural trade-offs and document decisions with ADR templates.
