This repo is both a project and an experiment substrate. Start with ARCHITECTURE.md for the design; the rest below documents the experiment machinery.
- PLAN.md — the full build plan (human/Claude Code readable).
- BOOTSTRAP.md — one-time Claude Code work: Phase 0 scaffolding, SPEC extraction, golden tests, seed tag. Do this BEFORE any harness run.
- SPEC/ — constants extracted from the Pac-Man Dossier (level tables, speed patterns, schedules). Read-only for the loop.
- FIXTURES/ — one fixture per build phase for the loop harness.
Each contains GOAL.md + fixture.yaml (whose
oraclefield is the exact cargo command to run; no shell scripts). - tests/golden/ — the oracle's teeth. Written during bootstrap,
immutable during harness runs (
tests/golden/integrity.rsenforces this).
Each fixture seeds from the tag left by the previous phase's accepted run
(seed-p1, seed-p2, ...). The harness creates a worktree from the seed
ref, runs the DeepSeek V4 loop until the fixture's oracle command exits 0
or the turn cap hits, and reports turns/tokens. Accepting a run = merging it
and tagging the next seed (the fixture's on_pass_tag).