Skill playbooks, renderer-free simulation code, and examples as integration tests

[SandroMaglione]

Skill: playbooks per kind of change

skills/ritmo/SKILL.md now routes each change to a playbook and keeps the six principles plus the self-check. There are six playbooks:

• mechanic
• content
• ui-and-render
• bug-fix
• refactor
• state-and-upgrades

Each is a short numbered list of steps that names the Ritmo API to use and ends with a Done when check. The total is 112 lines. The structure follows pstack: a router plus playbooks loaded on demand. The new lessons come from inkline-town#30:

• keep the simulation in one folder with one glob;
• project the world once into plain view data for UIs and renderers;
• bots and tests send the same intents as the UI;
• lint the import direction between folders.

ritmo/keep-simulation-headless (breaking)

• Type-only imports: the rule now reports type-only renderer imports (import type { Container } from "pixi.js"), so neither the schema nor the simulation can name a renderer type. Renderer services live in render code, and services are not registered in the schema.
• Subpath imports: the rule also catches @typeonce/ritmo-render/* and @typeonce/ritmo-pixi/*, which used to slip past it.
• Docs: the README and the rule message say the same thing. The changeset carries the fix as a diff.

examples/ → integration/

• Top-down: integration/top-down is the headless simulation, debug.ts and the test. It names no renderer or page type, and ritmo-devtools lint on it reports no lints and no uncovered modules.
• Algorithms: integration/algorithms keeps its test.
• Concepts: concepts.ts moved next to Concepts.test.ts.
• Deleted: the untested pixi, platformer and genetics examples, vite.config.ts, the example:* scripts, and matter-js.
• Linting: one glob, integration/*/**, covers all integration simulations.
• README: links Inkline Town and Spirit Call under "Games built with Ritmo".

Repo cleanup

• Deleted: RELEASING.md and ARCHITECTURE.md.
  • RELEASING.md was a completed one-time rebrand checklist. Its still-useful release and add-a-package steps are now in .changeset/README.md.
  • From ARCHITECTURE.md, the extension rule moved into AGENTS.md. The rest restated the code or AGENTS.md.
• Removed: the orphan assets/spr_player.png, vitest.shared.ts (folded into vitest.config.ts), and stale docs/** and output/** lint ignores.
• AGENTS.md: 112 to 50 lines, keeping only rules that change a decision and aren't enforced by tooling.

Verification

pnpm run check passes (77 files, 568 tests), and so does pnpm pack:check, which now also asserts the playbooks ship.

🤖 Generated with Claude Code