Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion plugins/pstack/skills/poteto-mode/playbooks/orchestrate.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

**You run the program, never the code. Decide which agent does each piece of work, then check what each one produces.** For a standing project handed to one coordinator chat: multi-day, many stacked PRs, dozens to hundreds of subagents, few human turns. One task driven to a predicate is Autonomous run. One ambitious run that needs a bespoke workflow is figure-it-out. Work that one agent could finish inside the session's budget is not a program.

Run it with your own tools. Spawn workers with `delegate_task`. Keep the program's state in `${XDG_STATE_HOME:-~/.local/state}/t3-pstack/orchestrate/<project-slug>/`, with the tracker in its `notes.md`. Watch each PR with `watch_pull_request` when this thread has it. It wakes this thread on failed checks, passed required checks, new comments or reviews, and conflicts. Call no scripts, run no polling loops, and never relay messages or status between agents.
Run it with your own tools. Spawn workers with `delegate_task`. Keep the program's state in `${XDG_STATE_HOME:-~/.local/state}/t3-pstack/orchestrate/<project-slug>/`, with the tracker in its `notes.md`. Watch each PR with `watch_pull_request` when this thread has it. It wakes this thread on failed checks, passed required checks, new comments or reviews, and conflicts. Call no scripts, run no polling loops, and never relay messages or status between agents. Only a child finishing and a PR watch wake this thread, so before you end a turn, start a worker for every unit that is not blocked, or write in `notes.md` why it waits and what will wake it. A turn that ends with work left and nothing running or watched stops the program. Report it to the user as a stop, never as a finished round.

#### Topology

Expand Down
6 changes: 6 additions & 0 deletions tools/substitutions.json
Original file line number Diff line number Diff line change
Expand Up @@ -634,6 +634,12 @@
"replacement": "Keep the program's state in `${XDG_STATE_HOME:-~/.local/state}/t3-pstack/orchestrate/<project-slug>/`, with the tracker in its `notes.md`. Watch each PR with `watch_pull_request` when this thread has it. It wakes this thread on failed checks, passed required checks, new comments or reviews, and conflicts.",
"rationale": "T3 has no Cursor Project tracker or store, so the program's state lives in the port's store directory on local disk, the one Autopilot-full's trail uses. T3's PR and CI event subscription is watch_pull_request, and the wakes it lists are the ones its tool description names. T3 gives a delegated child no watch_pull_request, so a sub-coordinator has none and the condition stays"
},
{
"files": "^skills/poteto-mode/playbooks/orchestrate\\.md$",
"pattern": "Call no scripts, run no polling loops, and never relay messages or status between agents.",
"replacement": "Call no scripts, run no polling loops, and never relay messages or status between agents. Only a child finishing and a PR watch wake this thread, so before you end a turn, start a worker for every unit that is not blocked, or write in `notes.md` why it waits and what will wake it. A turn that ends with work left and nothing running or watched stops the program. Report it to the user as a stop, never as a finished round.",
"rationale": "On T3 a delegate_task child's completion and watch_pull_request are the only things that wake the coordinator's thread. A coordinator that closes a round and ends its turn with unblocked units unassigned and no child or watch running stays idle until a person writes (chhoumann/t3-pstack#74: three times in one day, once for 5 h)"
},
{
"files": "^skills/poteto-mode/playbooks/orchestrate\\.md$",
"pattern": "Run workers on a new cloud VM (`environment: \"cloud\"`) unless the work needs this machine: a `control-ui` or `control-cli` runtime check (from `cursor-team-kit`), local transcripts, a simulator, or auth that exists only here.",
Expand Down