YOUR AI. A REAL TASK.
Contributing just got easier.
Choose a small improvement. Give your AI the context. Submit something we can review together.
Public code synchronized September 19, 2026. Assets and private research are separate dependencies. Check current contributions before starting. Status and contributions ↗
How the project works today.
Since September 23, 2026, the game runs the original cartridge's own code, translated to C++. Each behaviour is checked against the original game, frame by frame, in the games recorded by David and by volunteer players.
- Each task becomes a card: a complete request for one AI session, with the files, the commands and how to check the result.
- A queue orders the cards. A coordinator writes the cards and checks every delivery; another AI session runs one card at a time.
- David records games, plays and makes the decisions only he can make.
- Progress is the X1 checklist: 222 items split into 668 steps. A verified step counts in full. A step with a closed list of parts counts only the parts already checked, until it is verified.
The public code on GitHub is the previous engine and does not include the translated cartridge code. So the open tasks now use the kit material and the site videos.
Any available task: the draw prepares a concrete request and shows the required material. Use your own AI; this site needs no API key.
Build your first request.
Extract the ZIP into its own folder and open that folder in Codex. Paste the prompt below.
Choose the task you want to work on.
4 tasks are available. Completed by contributors: 2. Closed by the change of method: 2.
Check existing work before starting.
Choose a task or use the random picker to prepare your prompt.
Read the response before submitting. The kit organizes the work; AI can still make mistakes.
SMALL STARTS, USEFUL CONTRIBUTIONS
What you can work on.
Available: 3 with the kit material, 1 with video and 0 with code. Completed: 2. Closed by the change of method: 2.
Included public materialMake the Axe Max entry clearer
Find up to three hard-to-understand sentences. Propose clearer wording while preserving verified facts and open work.
Acceptance
For each suggestion: current wording, replacement and reason. Cite the entry field. A verified step must not become a completed enemy.
Text review. It does not verify new behavior, collisions or original-game fidelity.
Required inputs
context/enemies.pt-BR.jsoncontext/enemies.en.json
Included public materialReview the Chill Penguin bat translation
Compare the PT and EN cp_bat entry. Check clarity, terminology, units and completion limits.
Acceptance
Submit a table with PT text, current EN, proposed EN and rationale. Preserve values and units; distinguish OIDs from provisional names.
A better translation does not prove art, attacks or contact. If wording is already correct, report that with examples.
Required inputs
context/enemies.pt-BR.jsoncontext/enemies.en.json
Included public materialCheck catalogue consistency
Compare Axe Max, CP bat and Rotor drone in the included material. Check that summaries, six facets and next tasks agree.
Acceptance
List each entry, field and verifiable observation. Separate real contradictions from unclear terms. A report finding no defects is valid.
The catalogue is partial. Do not infer spawn counts, identity or collision from a thumbnail.
Required inputs
context/enemies.pt-BR.jsoncontext/enemies.en.json
Requires viewing the videoDescribe a visible problem in the clips
Watch one gallery clip. Describe the first unusual behavior, when it appears and what you expected to see.
Acceptance
Provide clip name, URL, time in seconds, observation and expectation. Separate observation from hypothesis; record any inability to view the clip.
Requires viewing the public video or a supplied file. Text and a poster cannot establish that the animation was examined.
Required inputs
context/media.jsonhttps://megaman.davidluky.com/galeria/
Closed — the project changed its methodMap the public snowball logic
Read the SnowballRoll implementation. Separate code rules, loaded data and inputs missing to reproduce a case. Propose one small next step.
Acceptance
Report the commit, functions, conditions and dependencies. Propose a patch only for a reproducible case using public inputs. A well-supported dependency map is a valid contribution.
Uses the public repository. Game definitions and captures are not included. Do not invent parameters or treat core contracts as proof of this enemy’s fidelity.
Required inputs
src/entities/enemy.cppsrc/entities/enemy.hdocs/reference-data.md
Closed on September 26, 2026: since September 23 the game runs the cartridge's own code, translated to C++, and the old enemy code in the public repository is no longer the reference. Do not run this task.
Closed — the project changed its methodMap the public Rotor drone update
Trace how the drone selects its direction and updates movement. Identify where state passes to physics and which inputs an independent test would require.
Acceptance
Submit paths, functions and update order, separating code observations from hypotheses. Do not claim gameplay tests or original-game comparisons without their required inputs.
Uses the public repository. Game definitions and captures are not included. Do not invent parameters or treat core contracts as proof of this enemy’s fidelity.
Required inputs
src/entities/enemy.cppsrc/entities/enemy.hdocs/reference-data.md
Closed on September 26, 2026: since September 23 the game runs the cartridge's own code, translated to C++, and the old enemy code in the public repository is no longer the reference. Do not run this task.
Completed — contribution mergedTest JSON read results
Read json_io and existing coverage. If a direct contract is absent, add a temporary-file test for open failure, malformed JSON, schema rejection and a valid read.
Acceptance
Register one small contract in the public CMake configuration. Show the expected ReadError codes and CTest results. Preserve existing tests and do not load assets.
Do not duplicate a test. Use a unique temporary directory and clean up only files owned by that test.
Required inputs
src/data/json_io.hsrc/data/json_io.cppcmake/PublicTests.cmakeCONTRIBUTING.md
MattBetancourt's contribution was reviewed and merged in PR #2 on September 21. This task is complete; choose another available task.
View existing contribution ↗Completed — contribution mergedTest screen coordinate transforms
Inspect screen_transform and existing coverage. Propose a direct contract for invalid dimensions, letterboxing and points outside the internal viewport.
Acceptance
Test deterministic mathematics only, without opening a window. Register the CMake target and describe cases and CTest results.
Read existing contracts before adding another. Do not change scaling, camera or gameplay coordinates to accommodate the test.
Required inputs
src/app/screen_transform.hcmake/PublicTests.cmakeCONTRIBUTING.md
MattBetancourt's contribution was reviewed and merged in PR #1 on September 21. This task is complete; choose another available task.
View existing contribution ↗Selecting a task does not reserve it. Check the issues and contribute from your fork. Original code is public under MIT; ROMs and assets are not included.
FROM RESPONSE TO CONTRIBUTION
Finished? Share the result.
- Review with your AI. Ask for sources, reproduction steps and what was not checked.
- Prepare the report. Use the included template. The checker validates format, not truth.
- Submit for review. Text and research by email or issue; code through a pull request to the public repository. Review your contribution before submitting.