Run or continue a job
Use the orchestrator after a job has reached 2_ready/, or to resume a paused job in 3_ongoing/.
Copy this to run the next job
Orchestrator
_processes/02_orchestrator/orchestrator.prompt.md
Two invocation modes — copy blocks show the workflow-internal path (bare
_processes/...); prefix with _code_workflow/ when your cwd is the host project root. See How to use → Two invocation modes.
Common invocations
Paste the orchestrator prompt path alone when there is only one ready or paused candidate. Add <slug> after the path in your message when you want a specific job.
Orchestrator prompt
_processes/02_orchestrator/orchestrator.prompt.mdWhat it does
| # | Step |
|---|---|
| 1 | Reads the job. Loads JOB.md, PROGRESS.md, note.md, and key-findings.md before mutating anything. |
| 2 | Runs pre-flight checks. Workflow version, app.md, runtime requirements in config.json, and queue state. |
| 3 | Moves to 3_ongoing/. Writes a diagnostic .lock so two orchestrators cannot work the same job. |
| 4 | Runs pending stages. Skips disabled/complete stages, then dispatches the next stage prompt from _processes/02_orchestrator/stages/ as a sub-agent and parses its STAGE_HANDOFF (D-56, pure-conductor dispatch). |
| 5 | Stops at gates. When a gate is yes, it updates PROGRESS.md, removes .lock, and tells you what to review. |
| 6 | Lands in 4_done/. When every enabled stage is complete, the git landing commits (and on PR: yes opens the PR) per ## Git (D-63), then the folder moves to done. |
Gate stops
| Gate | What to review |
|---|---|
after_creation | The generated JOB.md in 1_creation/ (default no — only fires when you opt in; D-41). |
after_clarify | 01_clarify/clarify-report.md and any mandate rewrite. Auto-passes on NO_CLARIFICATION_NEEDED. |
after_brainstorm | 02_brainstorm/ outputs, especially consolidated.md in dual mode. |
before_plan | The current mandate and brainstorm artifacts. |
before_execution | 03_plan/PLAN.md. |
before_commit | The staged-diff summary at the post-validate git landing — the job's full source diff, still uncommitted (D-63). |
before_pr | The generated PR description and the resolved PR target branch (blank ⇒ production). |
Resume after a gate — review the artifact the orchestrator named, then send the same orchestrator path again. Add the slug if multiple jobs are available.