architecture-decision

Solid

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 20,555 stars 2999 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 97/100

Stars 20%
100
Recency 20%
90
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
1 weeks ago
Language
Shell
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

architecture-decision-records

Architecture decision record workflow. Use when the user chooses between significant technical options, asks to record a decision, asks why a design exists, or discusses architecture, dependencies, data models, deployment shape, or long-lived tradeoffs.

0 Updated today
JunMystery
AI & Automation Listed

architecture

Create or evaluate an architecture decision record (ADR). Use when choosing between technologies (e.g., Kafka vs SQS), documenting a design decision with trade-offs and consequences, reviewing a system design proposal, or designing a new component from requirements and constraints.

2 Updated 2 days ago
nota-america
AI & Automation Listed

architecture

Create or evaluate an architecture decision record (ADR). Use when choosing between technologies (e.g., Kafka vs SQS), documenting a design decision with trade-offs and consequences, reviewing a system design proposal, or designing a new component from requirements and constraints.

15 Updated 2 days ago
charlieviettq
AI & Automation Solid

architecture-decision-records

Capture architectural decisions made during Claude Code sessions as structured ADRs. Auto-detects decision moments, records context, alternatives considered, and rationale. Maintains an ADR log so future developers understand why the codebase is shaped the way it is.

201,447 Updated yesterday
affaan-m
AI & Automation Listed

architecture-decision-records

Capture architectural decisions made during Claude Code sessions as structured ADRs. Auto-detects decision moments, records context, alternatives considered, and rationale. Maintains an ADR log so future developers understand why the codebase is shaped the way it is.

0 Updated 2 days ago
goharabbas321