Ajedrez_Purgatorio/CLAUDE.md

Claude Code Game Studios — Ajedrez Purgatorio

Narrative chess game set in purgatory. Tactical gameplay with emotional piece identity, dice risk/reward mechanics, and async Dead Kings social system.

Technology Stack

• Engine: Unity 6.3 LTS (6000.3.13f1)
• Language: C#
• Render Pipeline: URP 2D (17.3.0)
• UI: UGUI + TextMeshPro
• Version Control: Git with trunk-based development
• Target Platform: PC (expandable to mobile)

Project Structure

@.claude/docs/directory-structure.md

Engine Version Reference

@docs/engine-reference/unity/VERSION.md

Technical Preferences

@.claude/docs/technical-preferences.md

Coordination Rules

@.claude/docs/coordination-rules.md

Collaboration Protocol

User-driven collaboration, not autonomous execution. Every task follows: Question -> Options -> Decision -> Draft -> Approval

• Agents MUST ask "May I write this to [filepath]?" before using Write/Edit tools
• Agents MUST show drafts or summaries before requesting approval
• Multi-file changes require explicit approval for the full changeset
• No commits without user instruction

See docs/COLLABORATIVE-DESIGN-PRINCIPLE.md for full protocol and examples.

First session? If the project has no engine configured and no game concept, run /start to begin the guided onboarding flow.

Coding Standards

@.claude/docs/coding-standards.md

Context Management

@.claude/docs/context-management.md

Current State (Aug 2026)

Critical Bugs Fixed

• StackOverflow — CheckDetector.IsInCheck called GetAvailableMoves() on enemy King, which called GameManager.IsInCheck() → infinite recursion. Fixed: use GetAttackSquares().
• Empty board — BoardManager.SetupBoard returned early when CampaignState had no identities. Fixed: fallback to PlacePieces().
• State stuck in Dialogue — CampaignManager transitioned to Dialogue before StartDialogue returned true. Fixed: only transition on success.
• DimBG blocking input — Full-screen overlay with m_RaycastTarget:1 blocked all clicks. Fixed: deactivated in PromotionUI.Awake().
• PauseMenuController — Used non-existent "Pause" input button. Fixed: use KeyCode.Escape only.
• SceneTransitionManager — Used Time.deltaTime with timeScale=0. Fixed: Time.unscaledDeltaTime + WaitForSecondsRealtime.
• DefeatUI callback race (Aug 25) — Fade-out disabled the panel before the continue callback coroutine fired. Fixed: invoke callback synchronously in OnContinueClick.
• Dialogues empty on first run (Aug 25) — DialogueUI subscribed only if DialogueSystem.Instance existed during its OnEnable (lost Awake race), never retried. Fixed: [DefaultExecutionOrder(-100)] on DialogueSystem + resilient deferred subscription.
• Memorial typing dead (Aug 25) — Scene TMP_InputFields hollow (m_TextViewport/m_TextComponent = 0) AND InputSystemUIInputModule doesn't feed legacy Input.inputString. Fixed: deep wiring validation + runtime fallback panel + temporary StandaloneInputModule swap (restored in OnDestroy).
• Pause menu dead (Aug 25) — Duplicate controllers per scene (one inactive canvas), unusable scene panel, HUD PauseButton with empty onClick. Fixed: runtime-built pause panel (Continuar / Reiniciar capítulo / Opciones / Menú principal) + HUD button wired in code + orphan overlay cleanup.
• Dialogue text over portrait (Aug 25) — Text box overlapped speaker portrait geometry. Fixed: idempotent runtime relayout in DialogueUI.OnEnable (portrait left, text stretched right).
• CampaignConfig log spam (Aug 25) — CreateInstance fires OnEnable before SetJsonSource(). Fixed: OnEnable silent until a JSON source exists.

Architecture

• Purgatory mode (Mono/) is main/production codebase
• Classic mode (Mono/Classic/) is separate simpler mode
• Board tile size: 10.24 units, Camera ortho size 45
• Campaign flow: MainMenu → CampaignManager.StartCampaign() → Chapter1 scene → SetupBoard → TransitionToChapterIntro → dialogue → TransitionToPlaying
• Runtime UI fallback pattern: scene UI panels are validated deeply in code; broken/hollow ones are hidden and rebuilt at runtime (DefeatUI, DeadKingInputUI, PauseMenuController). All runtime canvases: ScaleWithScreenSize reference 1920×1080.
• Campaigns: "Nueva Campaña" = Inspector config on scene CampaignManager (default, Línea I, 3 chapters); "Gambito de Sombras" = Resources/Campaigns/gambito_campaign.json (30 chapters, 4 acts). Same engine/scenes/rules.

Git History

• 43f15eb — chore: scene saves from playtesting session (Ch1-3 UI edits)
• bcc590f — feat: runtime pause menu + Mi Memorial in main menu
• 97677fb — fix: defeat→Memorial chain, first-run dialogues, memorial typing, dialogue layout
• dc45653 — fix: pick best-wired DeadKingInputUI + runtime fallback inscription panel
• 58fcf0f — feat: draws trigger Purgatory Duel for the Queen + post-defeat restart menu
• 916acd3 — test: raise EditMode coverage to 98.16% global, all classes >=95%
• 351f9e1 — fix: StackOverflow in King.GetAvailableMoves → IsInCheck recursion
• 801de79 — fix: empty board + state stuck in Dialogue

(Older history: c5915c2, 0725372, bf3bec3, b539aa4 initial commit.)