architecture-decision

Featured

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.

AI & Automation 19,911 stars 2893 forks Updated 4 days ago MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

When this skill is invoked: ## 0. Parse Arguments — Detect Retrofit Mode Resolve the review mode (once, store for all gate spawns this run): 1. If `--review [full|lean|solo]` was passed → use that 2. Else read `production/review-mode.txt` → use that value 3. Else → default to `lean` See `.claude/docs/director-gates.md` for the full check pattern. **If the argument starts with `retrofit` followed by a file path** (e.g., `/architecture-decision retrofit docs/architecture/adr-0001-event-system.md`): Enter **retrofit mode**: 1. Read the existing ADR file completely. 2. Identify which template sections are present by scanning headings: - `## Status` — **BLOCKING if missing**: `/story-readiness` cannot check ADR acceptance - `## ADR Dependencies` — HIGH if missing: dependency ordering breaks - `## Engine Compatibility` — HIGH if missing: post-cutoff risk unknown - `## GDD Requirements Addressed` — MEDIUM if missing: traceability lost 3. Present to the user: ``` ## Retrofit: [ADR title] File: [path] Sections already present (will not be touched): ✓ Status: [current value, or "MISSING — will add"] ✓ [section] Missing sections to add: ✗ Status — BLOCKING (stories cannot validate ADR acceptance without this) ✗ ADR Dependencies — HIGH ✗ Engine Compatibility — HIGH ``` 4. Ask: "Shall I add the [N] missing sections? I will not modify any existing content." 5. If yes: - For **Status**: ask the user — "What is the current status of thi...

Details

Author
Donchitos
Repository
Donchitos/Claude-Code-Game-Studios
Created
3 months ago
Last Updated
4 days ago
Language
Shell
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category