Platform-First Development Philosophy
The Golden Rule
Fix the platform, not the content.
At this stage of development, all agents focus on platform code (core/, scenes/, Sparkling Editor), NOT mod content (mods/).
Why This Matters
The Captain (user) creates all mod content exactly as a real modder would. This ensures:
- Real-world testing of the modding experience
- No special treatment for demo content
- Tool validation - if content is broken, the tool that made it is broken
Decision Framework
| Symptom |
Wrong Response |
Correct Response |
| Character data is malformed |
Fix the .tres file |
Fix the Sparkling Editor component that generated it |
| Battle doesn't load correctly |
Edit the battle resource |
Fix BattleManager or MapMetadataLoader |
| Item stats are wrong |
Edit the item resource |
Fix the item editor or validation |
| Cinematic breaks |
Edit the JSON file |
Fix CinematicLoader or the cinematic editor |
What Agents Should Do
- Identify the root cause in platform code
- Fix the tool or system that produces/consumes the content
- Validate the fix by having the Captain recreate the content
- Never edit mod content to work around platform bugs
What Agents Should NOT Do
- Edit files in
mods/*/data/
- Create new mod content (characters, items, battles, etc.)
- "Fix" mod resources that appear broken
- Hardcode workarounds for specific content
Exception
Direct mod content changes are acceptable ONLY when:
- The Captain explicitly requests it
- The change is for testing/debugging purposes (then reverted)
- The mod system itself is being tested
Remember
If a modder would hit the same problem the Captain hit, the platform is broken. Fix the platform.
