Claude Code Game Studios

1---
2name: architecture-decision
3description: "Creates an Architecture Decision Record (ADR) documenting a significant technical decision, its context, alternatives considered, and consequences. Every major technical choice should have an ADR."
4argument-hint: "[title]"
5user-invocable: true
6allowed-tools: Read, Glob, Grep, Write
7---
8 
9When this skill is invoked:
10 
111. **Determine the next ADR number** by scanning `docs/architecture/` for
12   existing ADRs.
13 
142. **Gather context** by reading related code and existing ADRs.
15 
163. **Guide the user through the decision** by asking clarifying questions if
17   the title alone is not sufficient.
18 
194. **Generate the ADR** following this format:
20 
21```markdown
22# ADR-[NNNN]: [Title]
23 
24## Status
25[Proposed | Accepted | Deprecated | Superseded by ADR-XXXX]
26 
27## Date
28[Date of decision]
29 
30## Context
31 
32### Problem Statement
33[What problem are we solving? Why does this decision need to be made now?]
34 
35### Constraints
36- [Technical constraints]
37- [Timeline constraints]
38- [Resource constraints]
39- [Compatibility requirements]
40 
41### Requirements
42- [Must support X]
43- [Must perform within Y budget]
44- [Must integrate with Z]
45 
46## Decision
47 
48[The specific technical decision made, described in enough detail for someone
49to implement it.]
50 
51### Architecture Diagram
52[ASCII diagram or description of the system architecture this creates]
53 
54### Key Interfaces
55[API contracts or interface definitions this decision creates]
56 
57## Alternatives Considered
58 
59### Alternative 1: [Name]
60- **Description**: [How this would work]
61- **Pros**: [Advantages]
62- **Cons**: [Disadvantages]
63- **Rejection Reason**: [Why this was not chosen]
64 
65### Alternative 2: [Name]
66- **Description**: [How this would work]
67- **Pros**: [Advantages]
68- **Cons**: [Disadvantages]
69- **Rejection Reason**: [Why this was not chosen]
70 
71## Consequences
72 
73### Positive
74- [Good outcomes of this decision]
75 
76### Negative
77- [Trade-offs and costs accepted]
78 
79### Risks
80- [Things that could go wrong]
81- [Mitigation for each risk]
82 
83## Performance Implications
84- **CPU**: [Expected impact]
85- **Memory**: [Expected impact]
86- **Load Time**: [Expected impact]
87- **Network**: [Expected impact, if applicable]
88 
89## Migration Plan
90[If this changes existing code, how do we get from here to there?]
91 
92## Validation Criteria
93[How will we know this decision was correct? What metrics or tests?]
94 
95## Related Decisions
96- [Links to related ADRs]
97- [Links to related design documents]
98```
99 
1005. **Save the ADR** to `docs/architecture/adr-[NNNN]-[slug].md`.
101