Suggest documenting architectural decisions at key decision points.
npx skills add https://github.com/rjschie/dotfiles --skill adr-suggest
Please help me install this Agent Skill. Skill: adr-suggest Source: https://github.com/rjschie/dotfiles/tree/main/files/claude/skills/adr-suggest Command: npx skills add https://github.com/rjschie/dotfiles --skill adr-suggest
This Skill helps users capture architectural decisions (ADRs) by suggesting documentation at key decision-making moments, ensuring important decisions are not overlooked.
/adr <slug> to document decisions, enhancing decision-making practices.Use the adr-suggest skill during a planning session to capture architectural decisions.
High-intent search queries and answers about installing and using this skill.
You should document an architectural decision when it involves significant trade-offs, specific context, or low reversibility. Identifying these key decision points ensures important architectural choices are captured and not overlooked during planning sessions.
To capture architectural decisions during a planning session, run the `/adr <slug>` command when prompted by a suggestion. This user input triggers the documentation process, allowing you to record the trade-offs and context of the decision.
An architectural decision record (ADR) documents important technical choices, their context, and consequences. It is needed to ensure significant decisions are not overlooked, providing a clear history of why specific approaches were standardized over alternatives.
No, documenting decisions requires user input. The mechanism suggests documenting architectural decisions at key moments, but you must explicitly run the `/adr <slug>` command to capture the context, trade-offs, and details.
The best way to track these architectural decisions is to evaluate their reversibility and trade-offs during discussions, prompting the user to document them via an ADR. This ensures both reversible and irreversible choices are captured systematically.
javierhbrExtract architectural decisions with problem-solution pairs and trade-offs from conversational text.
tomzxRecord architectural decisions as ADR files with context and consequences.
sumilee-pcuDecompose game design epics into implementable development stories from GDDs and ADRs.
hgflimaCreate and manage architectural decision records using markdown templates.