mirror of https://github.com/Donchitos/Claude-Code-Game-Studios synced 2026-04-21 13:27:18 +00:00

Donchitos a73ff759c9 Add v0.5.0: CCGS Skill Testing Framework, skill-improve, 4 new skills, director gate path fixes

- Add CCGS Skill Testing Framework: self-contained QA layer with 72 skill specs,
  49 agent specs, catalog.yaml, quality-rubric.md, templates, README, CLAUDE.md
- Add /skill-improve: test-fix-retest loop covering static + category checks
- Add 4 missing skills: /art-bible, /asset-spec, /day-one-patch, /security-audit
- Add /skill-test category mode (Phase 2D) with quality rubric evaluation
- Extend /skill-test audit to cover agent specs alongside skill specs
- Update all skill-test and skill-improve path refs to CCGS Skill Testing Framework/
- Remove stale tests/skills/ directory (superseded by CCGS Skill Testing Framework)
- Add director gate intensity modes (full/lean/solo) to gate-check and related skills

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-04-06 17:42:32 +10:00

4.6 KiB

Raw Blame History

CCGS Skill Testing Framework — Claude Instructions

This folder is the quality assurance layer for the Claude Code Game Studios skill/agent framework. It is self-contained and separate from any game project.

Key files

File	Purpose
`catalog.yaml`	Master registry for all 72 skills and 49 agents. Contains category, spec path, and last-test tracking fields. Always read this first when running any test command.
`quality-rubric.md`	Category-specific pass/fail metrics. Read the matching `###` section for the skill's category when running `/skill-test category`.
`skills/[category]/[name].md`	Behavioral spec for a skill — 5 test cases + protocol compliance assertions.
`agents/[tier]/[name].md`	Behavioral spec for an agent — 5 test cases + protocol compliance assertions.
`templates/skill-test-spec.md`	Template for writing new skill spec files.
`templates/agent-test-spec.md`	Template for writing new agent spec files.
`results/`	Written by `/skill-test spec` when results are saved. Gitignored.

Path conventions

Skill specs: CCGS Skill Testing Framework/skills/[category]/[name].md
Agent specs: CCGS Skill Testing Framework/agents/[tier]/[name].md
Catalog: CCGS Skill Testing Framework/catalog.yaml
Rubric: CCGS Skill Testing Framework/quality-rubric.md

The spec: field in catalog.yaml is the authoritative path for each skill/agent spec. Always read it rather than guessing the path.

Skill categories

gate        → gate-check
review      → design-review, architecture-review, review-all-gdds
authoring   → design-system, quick-design, architecture-decision, art-bible,
              create-architecture, ux-design, ux-review
readiness   → story-readiness, story-done
pipeline    → create-epics, create-stories, dev-story, create-control-manifest,
              propagate-design-change, map-systems
analysis    → consistency-check, balance-check, content-audit, code-review,
              tech-debt, scope-check, estimate, perf-profile, asset-audit,
              security-audit, test-evidence-review, test-flakiness
team        → team-combat, team-narrative, team-audio, team-level, team-ui,
              team-qa, team-release, team-polish, team-live-ops
sprint      → sprint-plan, sprint-status, milestone-review, retrospective,
              changelog, patch-notes
utility     → all remaining skills

Agent tiers

directors   → creative-director, technical-director, producer, art-director
leads       → lead-programmer, narrative-director, audio-director, ux-designer,
              qa-lead, release-manager, localization-lead
specialists → gameplay-programmer, engine-programmer, ui-programmer,
              tools-programmer, network-programmer, ml-engineer, ai-programmer,
              level-designer, sound-designer, technical-artist
godot       → godot-specialist, godot-gdscript-specialist, godot-csharp-specialist,
              godot-shader-specialist, godot-gdextension-specialist
unity       → unity-specialist, unity-ui-specialist, unity-shader-specialist,
              unity-dots-specialist, unity-addressables-specialist
unreal      → unreal-specialist, ue-gas-specialist, ue-replication-specialist,
              ue-umg-specialist, ue-blueprint-specialist
operations  → devops-engineer, deployment-engineer, database-admin,
              security-engineer, performance-analyst, analytics-engineer,
              community-manager
creative    → writer, world-builder, game-designer, economy-designer,
              systems-designer, prototyper

Workflow for testing a skill

Read catalog.yaml to get the skill's spec: path and category:
Read the skill at .claude/skills/[name]/SKILL.md
Read the spec at the spec: path
Evaluate assertions case by case
Offer to write results to results/ and update catalog.yaml

Workflow for improving a skill

Use /skill-improve [name]. It handles the full loop: test → diagnose → propose fix → rewrite → retest → keep or revert.

Spec validity note

Specs in this folder describe current behavior, not ideal behavior. They were written by reading the skills, so they may encode bugs. When a skill misbehaves in practice, correct the skill first, then update the spec to match the fixed behavior. Treat spec failures as "this needs investigation," not "the skill is definitively wrong."

This folder is deletable

Nothing in .claude/ imports from here. Deleting this folder has no effect on the CCGS skills or agents themselves. /skill-test and /skill-improve will report that catalog.yaml is missing and guide the user to initialize it.

4.6 KiB Raw Blame History