scotbearss/poryrom
An expert Game Boy Advance ROM-hacking workbench: scaffolds a game repo, builds it in Docker, verifies it in a headless emulator by reading the game's own memory, and talks to you in plain English.
Build a GBA ROM hack and prove the change actually works — run the static checks first, build in Docker, verify in a headless emulator, put screenshots in front of the user, and refresh the backup. Use after editing anything in a game's source, when the user says "build it", "does it work", "test this", "make the ROM", or before any playtest or deploy.
Keep the harness's knowledge base current — file a new numbered record after a round of work, then update the wiki pages that record touches so the distilled knowledge does not rot. Use after finishing a build round, a measurement, an investigation, or a playtest, and whenever the user says "write this up", "record what we learned", or "update the docs".
Start a brand-new GBA ROM hack — create its own repo beside the harness, fork the pinned engine, wire up the pin file and design doc, and build a first playable ROM. Use when the user says "start a new game", "new hack", "I want to make a game about...", or asks to set up a new project with poryrom.
Orient at the start of a session working on a GBA ROM hack — check the machine can build, confirm the game's backup is current, and report where things stand in plain English. Use when opening a game repo, when the user says "where were we", "what's the state", "let's get going", or before starting any build work in a poryrom game repo.