the signals and their derived score are provisional and subject to change.
validate manually before sharing.
9d248a47924e2b54f4f5e3511efd760b58a5a0b0a460046eacb21 week agoCo-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>79f372efb0ae1 week agoCo-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>82aad2d4df971 week agoCo-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>c4bac82baeb41 week agoCo-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>c1c681af7dbc1 week agoCo-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>33129d3437da1 week agoCo-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>4a7966b3b3ee1 week agoCo-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>76bf8843a2031 week agoCo-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>@AGENTS.md
# AGENTS.md — how to build games with JumPHP
You are working in **JumPHP**, a framework to write **retro 2D games in PHP**. The same PHP code runs:
- on the **desktop** (native PHP 8.5 + SDL2 / OpenGL / OpenAL extensions, in Docker, in a real window with sound),
- in the **browser** (the same PHP 8.5 + extensions compiled to WebAssembly: OpenGL = WebGL, OpenAL = Web Audio;
the game is a static web page).
Everything (PHP, composer, emscripten, web server, relay server, tests) runs **in Docker** throug# externals — notes for agents
A JumPHP engine extension (read `../../AGENTS.md`, section "Engine extensions", and `../../docs/extensions.md`).
- `composer.json` `extra.jumphp`: what the engine registers (services, boot, loaders, config keys with defaults) and what jumphp.net shows
(`summary` one line, `features` a list, `screenshots` https pictures, `example`, `docs`, `engine` the JumPHP versions it works with).
- Pure PHP only (the browser build packs it): no extension of PHP, no blocking call, 32-b# {{GAME_ID}} — notes for agents
This game is built with JumPHP. **Read `../../AGENTS.md` first** (rules, commands, API).
## Checklist
```bash
bin/jumphp test {{GAME_ID}} # lint + phpstan + headless smoke test (must pass)
bin/jumphp shot {{GAME_ID}} 60 # title screen -> games/{{GAME_ID}}/var/screenshots/shot.png
JUMPHP_INPUT='[[5,"confirm"]]' bin/jumphp shot {{GAME_ID}} 240 var/screenshots/play.png
bin/jumphp build {{GAME_ID}} && bin/jumphp webshot {{GAME_ID}} 6 '[[1,"Enter# skeleton-extension-demo — notes for agents
The example game of the engine extension `extensions/skeleton-extension` (required through a path repository).
Read `../../AGENTS.md` ("Engine extensions") and `../../docs/extensions.md`. Its game tests are the extension's tests; `tests/SamplesTest.php` plays every sample of `extensions/skeleton-extension/doc/samples/` (add one sample per thing the extension does, no test to write for them).
# {{GAME_ID}} — a plugin of the JumPHP IDE
PHP that runs inside the JumPHP IDE. Read docs/ide-plugins.md of JumPHP (the API, the Ui nodes, the tests) first.
- `composer.json` `extra.jumphp-ide`: id, name, version, the plugin's class; `autoload` psr-4 (a namespace of its
own: `JumphpPlugins\...`). No package of its own at run time: only PHP and the IDE's (nikic/php-parser, symfony/yaml).
- `src/TodoPlugin.php` implements `JumPHP\Ide\Plugin\Plugin`: `activate(Api $ide)` adds actions, tool windows,
run# dmmotor — notes for agents
Built with JumPHP: **read `../../AGENTS.md` first**. This game is a port of id Software's GPL v2 engine
(linuxdoom-1.10) to PHP, playing Freedoom Phase 1 or Phase 2 (chosen on the first screen). See `README.md` for the map of `src/Dm/`.
## Rules of this project
- **Licences**: `src/`, `tools/`, `tests/` are GPL v2 (`LICENSE`); keep the id Software copyright line and the
"after <file>.c" header in every ported file. `assets/wads/` is Freedoom (BSD): keep `COPYING.txt` / `C# {{GAME_ID}}
A graphic PHP app (no HTML): `JumPHP\Gui` forms, made from `skeleton-gui/` (`bin/jumphp gui:new`). Guide: `docs/gui.md`
of JumPHP (AGENTS.md §17).
- `forms/MainForm.form.yaml`: the main window's widgets (the IDE's visual editor writes it; YAML by hand too).
- `src/Form/MainForm.php`: the code behind it; `events: {click: onAddClick}` in the form file = the method called.
Keep one `@property <Widget> $<id>` docblock line per widget id.
- `config/project.yaml`: `kind: gui`, `view: window`, `# {{GAME_ID}} — notes for agents
This is a JumPHP **CLI app**: it lives in the terminal (no window, no SDL). Commands are Symfony Console commands,
full-screen screens are symfony/tui widgets. **Read `../../docs/cli.md` first.**
## Checklist
```bash
bin/jumphp test {{GAME_ID}} # php -l + phpstan + phpunit (commands, screens on a VirtualTerminal) + smoke
JUMPHP_KEYS='[[1,"a"],[1.3,"Milk"],[1.6,"\r"]]' bin/jumphp shot {{GAME_ID}} 2.5 # the screen as text: read it
bin/jumphp run {# {{GAME_ID}} — notes for agents
This is a JumPHP **desktop app** (not an SDL game). **Read `../../AGENTS.md` §16 and `../../docs/tauri.md` first.**
## Checklist
```bash
bin/jumphp app:test {{GAME_ID}} # php -l + phpunit (AppTestCase, no window) + the app on Xvfb (must pass)
bin/jumphp app:shot {{GAME_ID}} # -> games/{{GAME_ID}}/var/screenshots/app.png: open it and look
bin/jumphp app:export {{GAME_ID}} # -> games/{{GAME_ID}}/dist/standalone/{{GAME_ID}}-linux-x86_64
```
## This app
-# skeleton-extension — notes for agents
A JumPHP engine extension (read `../../AGENTS.md`, section "Engine extensions", and `../../docs/extensions.md`).
- `composer.json` `extra.jumphp`: what the engine registers (services, boot, loaders, config keys with defaults) and what jumphp.net shows
(`summary` one line, `features` a list, `screenshots` https pictures, `example`, `docs`, `engine` the JumPHP versions it works with).
- Pure PHP only (the browser build packs it): no extension of PHP, no blocking cnone