Files
Claude-Code-Game-Studios/docs/architecture/tr-registry.yaml
Donchitos 0bbf25ec31 Pipeline integrity + brownfield adoption system
Pipeline integrity (4 fixes for snapshot-vs-live-reference problem):
- NEW docs/architecture/tr-registry.yaml: persistent stable TR-IDs per GDD
  requirement; /architecture-review bootstraps and appends, never renumbers
- /create-control-manifest: added Manifest Version stamp to header
- /create-epics-stories: stories embed TR-ID reference (not quoted text),
  Manifest Version from manifest, ADR status gate (Proposed → Blocked)
- /story-done: TR-ID registry lookup at review time, manifest staleness check
- /story-readiness: ADR Accepted check, TR-ID validity, manifest version check
- /review-all-gdds + /architecture-review: fixed parenthetical status values
  ("Needs Revision" only, no parentheticals that break exact-match reads)

Workflow infrastructure:
- NEW /help skill: context-aware "what's next" using workflow-catalog.yaml
- NEW .claude/docs/workflow-catalog.yaml: YAML-driven phase/step sequence
- /sprint-plan + /sprint-status: sprint-status.yaml machine-written tracking

Brownfield adoption system (migrate, not replace):
- NEW /adopt skill: format compliance audit (not existence check); classifies
  gaps BLOCKING/HIGH/MEDIUM/LOW; produces docs/adoption-plan-[date].md with
  numbered migration plan; never regenerates existing artifacts
- /design-system retrofit [path]: fills only missing GDD sections, preserves
  all existing content
- /architecture-decision retrofit [path]: adds missing ADR sections (Status,
  ADR Dependencies, Engine Compatibility) without touching existing content
- /start option D: split into D1 (early-stage) and D2 (has GDDs/ADRs → adopt)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-11 18:46:07 +11:00

57 lines
1.9 KiB
YAML

# Technical Requirement ID Registry
#
# PURPOSE: Persistent, stable IDs for every GDD technical requirement.
# Prevents TR-ID renumbering across /architecture-review runs, which would
# break story references.
#
# RULES:
# - IDs are PERMANENT. Never renumber, never delete (use status: deprecated).
# - Add new entries only at the END of each system's list.
# - When a GDD requirement is reworded (same intent): update `requirement`
# text and add a `revised` date. The ID stays the same.
# - When a requirement is removed from the GDD: set status: deprecated.
# - When a requirement is split or replaced: set status: superseded-by with
# the new TR-ID(s).
#
# WRITTEN BY: /architecture-review (appends new entries, never overwrites)
# READ BY: /create-epics-stories (embed IDs in stories)
# /story-done (look up current requirement text at review time)
# /story-readiness (validate TR-ID exists and is active)
#
# ID FORMAT: TR-[system-slug]-[NNN]
# system-slug = short slug matching the GDD system name
# NNN = three-digit zero-padded sequence per system, starting at 001
#
# STATUS VALUES: active | deprecated | superseded-by: TR-[system]-NNN
version: 1
last_updated: ""
requirements: []
# --- EXAMPLE ENTRIES (remove when first real entries are added) ---
#
# - id: TR-combat-001
# system: combat
# gdd: design/gdd/combat-system.md
# requirement: "Player takes damage from enemies based on attack power minus defence"
# created: 2026-03-10
# revised: ""
# status: active
#
# - id: TR-combat-002
# system: combat
# gdd: design/gdd/combat-system.md
# requirement: "Combo window timing is 0.4 seconds between hits"
# created: 2026-03-10
# revised: "2026-04-01"
# status: active
#
# - id: TR-combat-003
# system: combat
# gdd: design/gdd/combat-system.md
# requirement: "Old damage formula using raw stats"
# created: 2026-03-10
# revised: ""
# status: superseded-by: TR-combat-001