orchestrate
Turn the owner's feature or problem into an approved plan across tickets, keep its state in the workbench, and run it to an announced close.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- orchestrate
- description
- Turn the owner's feature or problem into an approved plan across tickets, keep its state in the workbench, and run it to an announced close.
- disable-model-invocation
- true
02 资源文件 2
- 参考文档agents/openai.yaml143 B
- 参考文档CREDITS.md574 B
03 SKILL.md 正文
Orchestrate
You are the orchestrating agent. Turn the owner's feature or problem into a plan they approve, with a definite goal; keep the plan's state in the workbench; and run the plan to an announced close.
Each repository's contribution guide, CONTRIBUTING.md, decides triage,
readiness, question routing and delivery for its work: its Triage, Readiness,
Comments, Findings and Pull requests sections. This skill is how to carry
those rules across a plan. The installed triage skill is how to triage one
request.
Workbench
The workbench is a git repository of plain Markdown holding the state of every plan you own. Your global agent instructions name its path. When they name none, ask the owner for it before you propose a plan.
Commit each workbench change straight to its default branch, and push it when the workbench has a remote.
index.md the active plans, each with its owning session reference, and launch caps
inbox.md the decision inbox
wishes.md one line per wish
<plan>/ one directory per plan
plan.md the plan
*.md its grill decisions and draft briefs
The workbench is a wiki:
- Date every entry.
- Cite each source, such as an issue, pull request, comment or session, by its link or reference, and leave its content where it is.
- Leave a superseded entry's text as written: mark it superseded, dated, and point to the entry that replaces it.
A session reference is the opaque identifier your harness gives a session, recorded as given.
index.md
One line per active plan: its directory, its goal in a few words, and the
reference of the session that owns it. When a plan closes, move its line under
a Closed heading, dated. A Launch caps list names a host by its hostname and
the most agent launches you may run at once on it.
inbox.md
The decision inbox the contribution guide names: one entry per decision open for the owner, across plans. Each entry holds the question, its plan, a link to its source, the date it opened, and your recommendation. Grills and triage runs add entries too. When the owner answers, move the entry to its plan's log, with the date, the answer, and where the owner gave it.
wishes.md
One line per wish: the date, the owner's quoted words or idea, a link to its source, and the repository it concerns.
A wish may link a filed finding for future planning. A wish never replaces the finding's tracker record or reporting links.
The plan
plan.md takes this shape:
# <Plan title>
**Goal:** <the outcome the plan delivers>
**Done means:** <the observable state that ends it>
**Approval:** <date>, <link to the owner's approval>. Preapproves: <what the plan names that the approval covers>
## Tickets
| Item | Repository | Issue | State |
| ---- | ---------- | ----- | ----- |
## Open issues
| Repository | At start | At close |
| ---------- | -------- | -------- |
## Log
- <timestamp> <entry>
- Tickets. Every row ends with a closed issue in its Issue column or
dropped (owner)in its State; the plan closes only then. A row stays for the life of the plan: a split adds rows, a merge points several rows at one issue, and only the owner drops one. State holds the row's latest step, such asgrill <session reference>,grilled <file>,triaged <file>,filed,ready, or a pull request link.grilled <file>andtriaged <file>are the done marks a grill and a triage run set. - Open issues. Count each repository's open issues when the plan starts and again at close. Report the counts; they set no limit.
- Log. Take every timestamp from the clock, in UTC, with
date -u +%Y-%m-%dT%H:%MZ, never by hand.
A plan update is any report to the owner about a plan, the proposal included. Each one lists the inferred-intent items the owner has not yet seen, with their citations, and shows the decision inbox. Log the items it showed.
Lifecycle
-
Propose. Present the goal, Done means and ticket table to the owner for approval, as a plan update. On approval, write the approval line, with what the approval preapproves, record the open-issue counts at start, and add the plan to
index.md. -
Intake. Route each new request as the contribution guide's Triage section says, with the
triageskill's method. Put your own ideas into the issue you file under aSuggestions (not decisions)heading. Give each triage run what thetriageskill gives a research run, the plan directory, and this task:- write its result to the plan directory, citing the brief or findings it posted by link;
- add each decision it leaves open for the owner to
inbox.md; - mark its row
triaged <file>inplan.md; - commit and push its writes, as Workbench says;
- report back, as Report-back says.
-
Grill. When the guide's inference test cannot settle an intent question, open a grill with the owner in its own session, and record the session's reference in the row's State. Give it what the
triageskill gives a grill, the plan directory, and this task:- write the owner's decisions and the draft briefs to the plan directory;
- add each decision it leaves open for the owner to
inbox.md; - mark its row
grilled <file>inplan.md; - commit and push its writes, as Workbench says;
- report back, as Report-back says.
Then decide the split, file the issues and accept the briefs, as the guide says. A draft you set aside for later work stays in the plan directory, marked parked, and takes no row. To take over an owner's grill or prototype, continue in that session.
-
New requirements. Handle a Finding under the contribution guide's Findings section even when it lies outside the goal: first link an existing open issue reporting the finding; otherwise file it as that section says. Continue the plan without waiting for the finding's resolution. A requirement that arrives mid-plan takes one route:
- Row: it serves the goal and passes the guide's inference test. Add it as a row, log it, and list it in the next plan update.
- Amendment: it changes the goal or the scope. Propose the amendment; it applies once the owner approves it, recorded as a new approval line that supersedes the old one.
- Wish: it lies outside the goal and is not a Finding. Add it to
wishes.md; it needs no issue merely because it is a wish.
-
Close. Once every row has ended, record the open-issue counts at close, move the plan under
Closedinindex.md, and announce, as the last plan update:- what shipped and what was dropped;
- the inferred-intent items and the wishes the plan added;
- every issue the plan filed that is still open, each with its reason;
- one suggested next direction, taken from the wishes and the parked items.
Running the plan
- One long-lived orchestrating agent owns every plan in the workbench. A fresh
session reads
index.md,inbox.mdand the active plans, and nothing else, before it acts. It then records its own session reference as each active plan's owner inindex.md, marking the previous reference superseded. - Give heavy reads, such as whole session transcripts, long logs and large diffs, to a subagent that returns what the step needs, or read a bounded tail.
- Run at most three agent launches you started at once, or the cap
index.mdnames for this host's hostname. Count every grill, triage run, research run and worker. - Workers deliver as the contribution guide's Pull requests section says.
When applicable installed rules assign a worker's merge to you, read its
accepted brief and PR handoff, then resume
babysit, including when resuming a plan. After an owner question is resolved, follow the applicable installed continuation rules to resume the worker or that same open PR.
Report-back
The file in the plan directory is the contract. A grill or triage run reports
by writing its result there, setting its done mark in plan.md, and
committing and pushing both. A wake-up message to your session is only a
nudge, and losing it loses nothing: act on the files.
When your harness cannot send messages between sessions, re-read the active plan directories at each turn, and the owner tells you when a grill is done.
With T3 Code
On T3 Code, these tools carry the steps:
- Open grills and other owner sessions with
t3_thread_launch, and record each one's reference in the plan ast3:<id>. - A launched session reports back with one
t3_thread_sendinautomode to the orchestrating thread. - Start triage runs, research runs and workers with
delegate_task, always with its effort option set. Delegated children wake their parent by themselves. - Watch each worker's pull request yourself with
watch_pull_request; a subagent can't watch. - While a plan has open T3 work, keep a 15-minute
schedule_taskheartbeat that runsbabysit's wait command on the worker pull requests no watch covers.
04 同仓库更多 Skills
repository-standards
Look up installed rules before any work in a disposable planning exercise, including tracker work and file changes.
triage
Move issues and external PRs through a state machine of triage roles, sort each request by where its uncertainty lies, and bring its agent brief to acceptance through research and independent review, or through a grilling session with the owner.
babysit
Babysit an opened pull request through checks and review to merge or its prescribed handoff. Use right after opening a pull request, or when asked to babysit or land one.
writing-for-agents
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
wayfinder
Plan a huge chunk of work (more than one agent session can hold) as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.
triage
Move issues and external PRs through a state machine of triage roles, sort each request by where its uncertainty lies, and bring its agent brief to acceptance through research and independent review, or through a grilling session with the owner. Also runs unattended as the factory's triage run, which writes nothing and ends with a run result.