mirror of https://github.com/Earth-Genesis-Games/Ajedrez_Purgatorio.git synced 2026-09-11 09:47:35 +00:00

Files

T

jimmyabvandClaude Sonnet 4.6 ab31bba21e Adopt Claude Code Game Studios template, configure Unity engine, document Combat Mode

- Install CCGS agent/skill/hook framework (.claude/, docs templates, GitHub issue/PR templates)
- Configure CLAUDE.md and technical-preferences.md for Unity 6000.3.3f1 (C#, URP, collider-based mouse picking)
- Point engine reference import at docs/engine-reference/unity/ and remove unused Godot/Unreal reference docs
- Add Version Awareness section to unity-specialist agent
- Set production/review-mode.txt to lean
- Add design/gdd/combat-mode.md: reverse-documented GDD for the vs-AI Combat mode, confirming it as the foundation for the guion.md narrative campaign (separate from Classic mode)
- Add docs/architecture/ADR-0001: documents the existing board-state/singleton/per-mode architecture and the decision to keep Classic and Combat modes permanently separate
- Add docs/architecture/control-manifest.md: programmer rules sheet sourced from ADR-0001 and Unity 6 engine reference docs
- Continue in-progress Mono/Classic and Mono/Combat refactor (ScoreManager, scene/prefab updates)

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

2026-06-20 10:08:10 -03:00

4.5 KiB

Raw Permalink 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, 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, 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.5 KiB Raw Permalink Blame History