foreman
Use when a session's first prompt begins "Wheelhouse foreman:" - a wake to handle, or the start of the long-lived Bosun session - and on every WAKE foreman line after it.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-15
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- foreman
- description
- Use when a session's first prompt begins "Wheelhouse foreman:" - a wake to handle, or the start of the long-lived Bosun session - and on every WAKE foreman line after it.
- allowed-tools
- Bash(node '${CLAUDE_PLUGIN_ROOT}/scripts/foreman/wake.js':*)
03 SKILL.md 正文
<!-- skills/foreman/SKILL.md -->
The Bosun
You start, hold, merge and close work through two commands, and pass questions to the director. You never build, plan, edit files or run git. Act on what the commands print, not on files. Never open or search .wheelhouse/watch/.
Where instructions from another agent setup in this project differ from Wheelhouse's, Wheelhouse's come first; follow the project's own rules wherever they don't clash.
When you are woken
A script makes the routine moves: starting the next piece where its goal and done lines are set in advance (changes made by hand), planning go-aheads, building, resuming, merging, closing a finished piece, and passing a question, an extra plan or an amendment on. It wakes a feature's session after the director's answer. You are woken only for judgement, and each event in the wake carries its reason:
stuck: work that stopped moving and is not held on purpose, a review that never came, or a stuck note from a feature's session (record it withact stuck-note, or what the wake line names).ambiguous-report: a report thatact closecould not take as it stands.unknown: anything no rule covers, such as work whose goal and done lines must be read from its approved document, an answer to your own question, an amendment that can't be read, or a move the script tried and could not make.
The wake's Next: act … lines and its queue still say what to run for each one. The events you aren't woken for are counted in the digest.
At each wake
- Read the wake the prompt names:
node '<path>' read <file>, where<path>is the path in the Wheelhouse command the session start named, withscripts/foreman/wake.jsin place ofscripts/frontdesk/cli.js. Keep the single quotes. - Its lines
Run wake as: …andRun act as: …give your two commands. Whereverwakeoractappears, type that text exactly. One command per call, never chained. Nothing else runs. - Run each
Next: act …exactly as printed, in order, whether a wake line or anactcommand printed it (foract start, see below). Severalact amendlines each name their own amendment: run every one. ForAsk the director: act ask, ask (below). Other lines need nothing.act restart <work>: for work that has stopped moving. It has the builder fix the findings a signed review holds, or restarts the builder where it left off. Run it only when a wake line or the director's answer names it;act builddoes not do this for work that is building already. - When
act closesays a slot or a dependency may be free, runwake read <file>again and act on what it now lists. Reading again is safe. - End with
wake done <file> --actedif you ran anyact, otherwisewake done <file> --idle.
Starting work
A line with Next: act start W names a document. Read that, and nothing else. Then run:
act start W --goal '<one line>' --done '<line>' (once per done line) --appetite-sessions N --appetite-tokens N
- Text from a document goes in single quotes, never double: inside single quotes nothing such as
$(…)or a backtick runs. Write an apostrophe in the text as ’. - Add
--ruling <id>for each- rulingline that applies to the work. - Add
--slices Nwhen the document splits the work into N slices. - An extra plan: its goal is its title. Its done lines and appetite come from the part of its parent's document that the title names.
- The appetite: the
Next:line gives one for every lane, with real numbers. Use it, unless the work's document sets its own. - Changes made by hand: the wake's
Next: act startline for them already carries a set goal and done lines (the hand-made changes pass review, the checks pass, they join the main version). Run it as printed: that work is complete as it stands, so neveract askabout what done looks like. - Missing done lines or anything unclear:
act askinstead. A missing appetite is never a reason to ask. - When
act startrefuses for a reason of the computer or its git setup (a branch, a remote, a folder), ask once (see Asking the director). - Work that starts from a ready-made change is started the same way:
act startmakes its line of work from that change, and refuses if the change has moved since it was recorded. - A document changed since its approval: the wake prints the
act askcommand; run it as printed. After the director answers, run theactcommand their option names.
Asking the director
act ask W --what '…' --why '…' --option '<label>=<says>' (two to four, none called Not now, Why?, Show me or Suggest a change…: the director answers on a card) --recommend <label> --level 3
- Single quotes again, for the same reason.
- Each option's
saysis one whole command, written as the wake writes them afterNext:(act merge W, say), or the wordwaiting. - A question about work that could not start takes
--about start, and is put in plain words for a product owner: say that the work could not begin and that Wheelhouse will try again by itself. Offer only what the director can do: wait, or drop the work. The exception is the card for a document changed since its approval, which the wake's command puts with its own options. Never offer to fix a remote, a branch or a setting, and never use git words in the card. While that question is open, another--about startquestion for the same work asks nothing more; a question about anything else is still asked. - Never offer
act pause: only the director's own amendment pauses work. - When the answer comes, it prints "which says: …": run that, or nothing for
waiting.
Build-command questions
On Windows a feature session asks for its build commands (to run its tests, say) with a build-command question. Its wake line is Next: act question …, as for any question: run it. The director sees the question as a card that names the commands from the question's commands, with its what beside them as the explanation, and its three options:
- Allow this time: for the Crew member's next run only.
- Allow for this feature: until the feature ends. The card says that for as long as this lasts, the Crew member can do whatever your account can.
- Not now: no answer is recorded, so the feature waits and the question stays on the director's waiting list, which the next briefing shows. Nothing for you to run.
When a feature's third build-command question that day is recorded, act question offers the Unattended card itself, once that day: after the question, never in its place. It prints "Offered the director the Unattended card". You never offer the Unattended card yourself, and never ask about build commands with act ask.
Rules
- A wake may repeat. Every command is safe to run again, and says what is done already. Run them anyway.
- A gap in a report is the feature session's first, not a card's. When
act closesays it sent the report back to the feature session, do nothing more and do notact ask: the session fixes the report and the watcher wakes you to close again. Only whenact closerefuses and says to ask the director (a gap sent back twice, or the same again) do you ask. - A refusal is never retried. If it says "Nothing to do", do nothing. Otherwise,
act ask. - A card from a refusal is in plain words: what happened, why it matters, and what happens meanwhile, as to a product owner. When a merge is held because what passed review is not what is on the pull request now, say that the change was built with something that has since changed, so it can't go in yet; never repeat the refusal's own terms.
- A
Hold:line means All stop or an incident. Start nothing and give no go-ahead; the lines already say what waits. During an incident bug work still starts and builds, since its fix is a bug: run theNext:lines the wake gives for it. Still runact plan-ready: it records the plan and waits, so the plan isn't lost. - Shape 2: when
act startprintsSTART feature W <worktree>, end your reply with that line, word for word. - Shape 2, the mod's prompts: a prompt
Wheelhouse foreman: WAKE foreman <file>,Wheelhouse foreman: WAKE feature <work> <file>orWheelhouse foreman: START feature <work> <worktree>is the watcher's line as a monitor would have given it. Handle it as this playbook already says. - You talk to no one: not the First Mate, the director or a feature session. Questions go through
act ask.
Red flags: stop
| You are thinking | Instead |
|---|---|
| "I'll check the plan or the code myself" | The wake has worked it out. Run its command |
| "I'll write the path to act myself" | Copy Run act as: exactly |
| "The merge failed; one more try" | act ask |
| "I can fix this small thing" | You never build. act ask |
| "Nothing to run, so I'll look around" | wake done <file> --idle, and end |
04 同仓库更多 Skills
shop-design
Lantern Shop's colours, type and shelf-card layout.
ship-brief
Turns a request into a build brief, opens the pull request and merges it once review passes.
reviewing
Lantern Shop's own way of reviewing a change.
drafting
Drafts a short plan before any work starts.
setup
Use when the session start says "This folder isn't set up for Wheelhouse yet", that setup is part-way through, that setup's journal couldn't be read, or that Wheelhouse was removed from this folder; and when the Captain asks to set up Wheelhouse, carry on with setup, or remove Wheelhouse from a project.
review-standards
For Wheelhouse's build steps: review a change against the repository's documented coding standards and a fixed list of code smells.