Brief coordinator runbook
Authoritative source, reproduced unchanged. Exact Markdown ยท Agent copy with resolved links. These instructions govern research runs, not checkpoint interviews. They keep the run's own words: a room is a community, a mark an artwork, the analyst the aggregator, the case lead the community coder and the global model the population model.
- Inspect
python3 _tools/brief_queue.py list --limit 10. Work only on queued ranks in that order. - Keep at most six active writers. When one writer completes, handle that single rank immediately, then refill its slot. Do not wait for a batch.
- Writers are always fresh agents:
gpt-5.6-sol, high reasoning,fork_context:false. ReadBRIEF-WRITER-PROMPT.mdafresh and state the exactrooms/<subreddit>/briefdirectory in the launch message. - For writers:
prepare, spawn,start. At completion runfinish --rank N --message ..., inspect returned JSON, then close the accepted worker. - A
finishprocess exit of zero can still returnstatus: retry. Retry only that rank with a fresh Sol writer. For an interrupted worker userecover --rank N --error ..., close it, then start a fresh writer. - For a
work: harnessrank with zero pre-week items, runprepareandfinishwithout a writer, then refill the resulting slot. - Never use a resumed production writer. Never process event coding or excluded prior-run rooms. Do not use the legacy sync script while this moved yard is canonical.
- At completion, confirm 395 verified, no running or queued ranks, run
the brief validation and reader tests with
PYTHONPATH=_tools python3 -m unittest _tools/test_brief_validation.py _tools/test_brief_reader.py, then pause the scheduler.