/forge-doctor

Diagnose IKEMEN Go project issues: "$ARGUMENTS"

Use the testing-debug skill for reference.

Modes

Full Diagnostic: /forge-doctor full

Run complete project health check.

Symptom-Based: /forge-doctor {description}

Diagnose based on described symptom (e.g., "character won't load", "crash on startup", "attacks don't hit").

Full Diagnostic Steps

1. File Structure Check

   • Verify all expected directories exist
   • Check mugen.cfg, select.def, system.def, fight.def exist
   • Verify all select.def character paths point to existing files
   • Verify all select.def stage paths point to existing files

2. Configuration Check

   • Parse mugen.cfg for invalid values
   • Check select.def syntax
   • Verify system.def and fight.def reference valid assets

3. Per-Character Health Check For each character in select.def:

   • .def file exists and parses correctly
   • All [Files] references point to existing files
   • .cns has required sections and valid Statedefs
   • .cmd has required sections and valid commands
   • .air has required actions (at minimum Action 0)
   • Cross-references are valid (states → animations, commands → states)

4. Per-Stage Health Check

   • .def file parses correctly
   • Required sections present
   • BG elements reference valid sprite groups

5. Common Issue Detection

   • State loops (ChangeState to self without time guard)
   • Missing idle animation (Action 0)
   • Empty Statedef -1 (no command detection)
   • Unreachable states (defined but never transitioned to)
   • Duplicate state numbers

6. Output Diagnostic Report

   === IKEMEN Forge Doctor Report ===
   
   ❌ ERRORS (must fix):
     - chars/warrior/warrior.cns line 45: Statedef 200 missing type parameter
     - select.def line 3: Character path "chars/missing/missing.def" not found
   
   ⚠️ WARNINGS (should fix):
     - chars/ninja/ninja.cns: State 1100 has no exit ChangeState
     - chars/ninja/ninja.air: Action 210 has no Clsn1 (hitbox) frames
   
   ℹ️ INFO:
     - 3 characters validated
     - 2 stages validated
     - Total: 2 errors, 2 warnings
   
   Suggested fixes applied: 0
   Run with --fix to auto-fix safe issues.
   

Symptom-Based Diagnosis

For specific symptoms, focus investigation on the most likely cause:

• "crash on startup" → check mugen.cfg, select.def paths, missing files
• "character won't load" → check .def file paths and syntax
• "attacks don't hit" → check .air hitboxes and HitDef triggers
• "stuck in state" → check state exit conditions and ChangeState triggers
• "no sound" → check .snd references and PlaySnd controllers
• "wrong animation" → check anim numbers in Statedef vs .air actions