Claude-Code-Game-Studios/docs/CLAUDE.md
Donchitos 6c041ac1be Release v0.4.0: /consistency-check, skill fixes, genre-agnostic agents
New skill: /consistency-check — cross-GDD entity registry scanner
New registries: design/registry/entities.yaml, docs/registry/architecture.yaml
Skill fixes: no-arg guards, verdict keywords, AskUserQuestion gates on all team-* skills
Agent fixes: genre-agnostic language in game-designer, systems-designer, economy-designer, live-ops-designer
Docs: skill/template counts corrected, stale references cleaned up

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

1.4 KiB

Docs Directory

When authoring or editing files in this directory, follow these standards.

Architecture Decision Records (docs/architecture/)

Use the ADR template: .claude/docs/templates/architecture-decision-record.md

Required sections: Title, Status, Context, Decision, Consequences, ADR Dependencies, Engine Compatibility, GDD Requirements Addressed

Status lifecycle: ProposedAcceptedSuperseded

  • Never skip Accepted — stories referencing a Proposed ADR are auto-blocked
  • Use /architecture-decision to create ADRs through the guided flow

TR Registry: docs/architecture/tr-registry.yaml

  • Stable requirement IDs (e.g. TR-MOV-001) that link GDD requirements to stories
  • Never renumber existing IDs — only append new ones
  • Updated by /architecture-review Phase 8

Control Manifest: docs/architecture/control-manifest.md

  • Flat programmer rules sheet: Required / Forbidden / Guardrails per layer
  • Date-stamped Manifest Version: in header
  • Stories embed this version; /story-done checks for staleness

Validation: Run /architecture-review after completing a set of ADRs.

Engine Reference (docs/engine-reference/)

Version-pinned engine API snapshots. Always check here before using any engine API — the LLM's training data predates the pinned engine version.

Current engine: see docs/engine-reference/godot/VERSION.md