Skip to content

Commit e97afc1

Browse files
yepzdkclaude
andcommitted
feat: add information gathering questions to ADR skill
- Add reference to adr.github.io - Add section instructing to ask questions before writing ADR - Covers: decision context, stakeholders, options, rationale, consequences Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 3b9d509 commit e97afc1

1 file changed

Lines changed: 29 additions & 0 deletions

File tree

skills/itkdev-adr.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,35 @@ description: Use when creating, updating, or managing Architecture Decision Reco
77

88
You are helping create and manage Architecture Decision Records. ADRs capture important architectural decisions along with their context and consequences.
99

10+
For more information about ADRs, see [adr.github.io](https://adr.github.io/).
11+
12+
## Information Gathering
13+
14+
**Before writing an ADR, ask questions to gather the necessary information.** Use the AskUserQuestion tool to clarify:
15+
16+
1. **What decision needs to be documented?**
17+
- What is the problem or challenge being addressed?
18+
- What triggered this decision?
19+
20+
2. **Who is involved?**
21+
- Who is making the decision?
22+
- Who are the stakeholders (advisors and affected parties)?
23+
24+
3. **What options were considered?**
25+
- What alternatives were evaluated?
26+
- What are the pros and cons of each option?
27+
28+
4. **What was decided and why?**
29+
- Which option was chosen?
30+
- What is the rationale for this choice?
31+
32+
5. **What are the consequences?**
33+
- What are the benefits of this decision?
34+
- What are the trade-offs or risks?
35+
- Are there follow-up actions needed?
36+
37+
Ask these questions conversationally before drafting the ADR. This ensures all required fields can be properly filled in.
38+
1039
## When to Create an ADR
1140

1241
Create an ADR when making decisions about:

0 commit comments

Comments
 (0)