auto

/auto — Research Cycle Scheduler

/auto is the thin scheduler that drives research forward. It owns no scientific judgment of its own. Each cycle, it dispatches the agent team in a fixed sequence; every substantive decision (what to investigate, what to record, what to verify) is delegated.

The team and who owns what:

/auto itself owns only: the cycle loop, the resume beacon, pre-direction challenge dispatch, parallel worker dispatch, auto-attaching Provisional Review to each worker submission, running the optional one-repair loop, dispatching curator with the right inputs, dispatching Durable Surface Review when curator requests it, detecting parent-ascent presentation boundaries, maintaining an in-memory guide-target set from scheduler-known node paths, dispatching guide-writer at Session End, collecting the session-owned stage manifest, and closing the session through .scripts/close-session.mjs. It does not create nodes itself; if research planner creates a minimal child before returning focus.md, the scheduler simply parses the new cursor/worker target and curator closes the structure later in the cycle. When research planner writes ### Pre-Worker Tree Directives, /auto runs curator before workers as an inserted readiness transaction, then continues the ordinary cycle unless curator reports that the planned worker dispatch was invalidated.

Constraints

• Write all prose in japanese. Applies to research/focus.md, _reviews/, .logs/, agenda.md, curator's tree writes, all worker submissions. Technical terms, proper nouns, LaTeX mathematics, file/folder slugs, frontmatter keys, and the structural ## headings documented in .codex/research-tree.md and here may stay in English. The rule is about body prose, not structural tokens.
• request_user_input and all other user-input solicitations are prohibited. Users are often away during /auto; asking blocks the session.
• Do not initiate user-facing progress messages during a valid active session. The only scheduler-initiated user-facing message during an active session is the final draft emitted at Session End. Startup precondition failures may emit their specified stop message. If the user initiates communication mid-session, respond briefly and continue. Corrections from the user take precedence over scheduled dispatches.
• exec_command("sleep ...") is prohibited; polling via exec_command("ls ...") file-existence checks is prohibited. For waiting on agent completion use only Pattern A or Pattern B as defined in phases/dispatch.md.
• Full paper text is acquired only from arXiv so source provenance stays reproducible and full-text licensing/source drift does not enter the research tree. Metadata, bibliographic records, abstracts, and non-full-text discovery may use other sources when the relevant agent prompt allows it.
• Paper writing is NOT /auto's responsibility. Writing is handled by the /write skill. /auto drives research only.

Turn-Yielding Discipline

/auto is an autonomous loop: the user is not present between cycles, and a closing-tone message mid-session stalls the session waiting for input that never arrives. Any mid-session message that summarizes progress and waits for user confirmation is a stall, regardless of the exact wording.

• Never end a turn mid-session with a user-facing progress draft. Between cycles, the next action is a tool call — the next direction-challenger dispatch, the next research planner dispatch, the next worker batch, or Session End. If you are tempted to draft "I have finished cycle N of M; continuing with cycle N+1?", that is the stall — replace it with the actual next dispatch.
• The only user-facing closing message is the final Session End draft, emitted when MAX_CYCLES is exhausted or the scheduler exits for an unrecoverable failure. research/focus.md status labels are research-state records, not scheduler stop signals.
• Compaction / reconnect / crash do not terminate a session. The .logs/.auto-active beacon (written at the start of every cycle) and the SessionStart hook jointly ensure the next session resumes the loop without a greeting. See phases/session-lifecycle.md § Resume for the mechanics and the fallback.
• Progress summaries that genuinely belong somewhere go into .logs/{timestamp}_auto.md (session log, written by .scripts/close-session.mjs from research planner's close-session packet) or research/focus.md § Context (research planner's next-cycle direction). Neither is a yielded turn.

Arguments

/auto {N} — cycle limit. Default: 5. Hereafter MAX_CYCLES.

Terminology

One session = MAX_CYCLES cycles unless a startup precondition fails, the user explicitly stops the session, or the scheduler reaches an unrecoverable failure. Multiple tasks can run in parallel within a cycle.

Phase Index

Detail lives in two phase files; read on demand, not all at once.

The research information model (tree structure, file roles, context scoping, convention ledger, provenance taxonomy) is canonical in .codex/research-tree.md — direction-challenger, research planner, and curator read it at every dispatch. /auto itself does not need it in working memory; /auto reads research/focus.md (the dispatch-spec file — treat it as the scheduler's interface with research planner, not as "tree content") only to extract the fields it dispatches on. /auto never reads node-level files directly. Node-level files are read by direction-challenger in its narrow local challenge scope, by research planner for direction-setting, and by curator for tree writing.

Session Start

Read phases/session-lifecycle.md § Session Start. Key outcomes:

• Beacon-based resume decision (fresh vs. resume mid-cycle)
• Initial sanity gates: research/state.md must exist (else emit the stop message specified in phases/session-lifecycle.md and stop); concepts/ exists; .gitignore covers .logs/.auto-active
• research/focus.md existence check (if missing, the first research planner dispatch initialises it after direction-challenger runs — see session-lifecycle)

/auto does not read node-level tree files at session start. The ancestor-chain read is research planner's responsib

Content truncated.