One page per kind of file in the coder instrument (v32) and the run yard. Each page says what the file holds, who writes it and when, why it exists, and where it is. The levels below follow the coder page, from the contracts that govern every agent down to the yard that runs every room; how it was built tells why each level came to exist.
One contract holds the method. The others exist because the roles differ: a large room needs a case lead and fleet coders, the week before the canvas needs a brief writer, and the yard needs a scheduler. Each role file says only what differs from the main contract.
Everything needed to code a community sits in its own folder, so a room can be run, rebuilt or forked on its own.
run/package/.Handing an agent the material and asking for codes did not work: it spent its turns writing parsers and serialisers, and its account of its own reading could not be checked. Each tool takes one job away from the agent and leaves a record.
A room of more than 500 items does not fit one reader. It is cut into slices, read by one coder after another, and handed to a case lead who writes the account.
The yard, file by file: every part of the yard the scheduler built, what it is, who writes it, what a new yard handler reads first, and what to change to run a yard elsewhere.
The yard runs every room, smallest first, under a scheduler. The case lead is the one agent saved whole, so a room can be resumed or forked later.
Each line is the script's own first line.
codex_coder.py:
runs one fleet coder in a temporary, validation-bounded Codex
session.coder_preflight.py:
read-only checks for one fleet coder's batch before consolidation;
copied into each batch as _scheduler_preflight.py.build_room.py:
makes one room of the yard from a raw24 collection. The entry point for
coding another community.verify_room.py:
the scheduler's mechanical checks on one room.status.py:
rebuilds STATUS.tsv from every room's
STATE.json.checkpoints.py:
immutable, content-addressed checkpoints for a managed room.continue_yard_room.py:
runs the serial fleet cycle, verifies and publishes one reading.compare_forks.py:
sets a room's run and its forks side by side.archive_verified_run.py
and archive_verified_materials.py:
archive or restore a verified room's run, and its record, brief and
instrument.repair_queue.py
and brief_queue.py:
the queues for repairing blocked rooms and for writing briefs.