Skip to content

Heyvhuang/copybook-skills / standalone/coordinator/skills/coordinator

coordinator

Flagged

Coordinate an ongoing software delivery run when the user assigns this session the coordinator role or asks it to manage worker handoffs, gates, release approvals and progress. Use when starting, supervising or resuming that run, including a run with one active lane. Lanes run as Herdr workers (parallel-goal-fleet) on Claude or Codex, from whichever harness coordinates; T3 Code child tasks are the fallback. Do not start a coordinator run for discussion, a read-only review of the workflow, a standalone quick second opinion or an ordinary single-session edit.

FileKindSize
SKILL.mdskill md11.8 KB
references/example-run.mdmarkdown3.4 KB
references/herdr.mdmarkdown7.7 KB
references/lessons.mdmarkdown6.9 KB
references/models.mdmarkdown4.9 KB
references/pipeline.mdmarkdown6.1 KB
references/situations.mdmarkdown3.4 KB
references/t3.mdmarkdown4.9 KB
scripts/gemini.mjsexecutablescript2.3 KB
scripts/heavy.shexecutablescript829 B
scripts/status.shexecutablescript2.0 KB
scripts/watch-ready.shexecutablescript2.0 KB
templates/lane-brief.mdmarkdown1.5 KB
templates/release-packet.mdmarkdown1.4 KB
templates/run-record.mdmarkdown1.2 KB
templates/ship.mdmarkdown1.1 KB

references/situations.md

View on GitHub
# Situations

First moves, from the example run.

**Screenshot or design feedback** ("this looks cheap"). Send the user's words verbatim and the image to the lane that owns the surface; don't fix it yourself and don't give front-end edits to Codex. For a new or disliked surface the lane makes a benchmark board first and follows the best competitor closely in structure and interaction, never their assets. Every reference the user gave goes into the brief; they notice when references are ignored.

**A bug reported twice.** Stop guessing. Get evidence (logs, events, a reproduction) before a third fix, and reply with what was tried and what the evidence says.

**Error-tracker issue.** One issue, one small PR: front end to Opus, back end to Codex. Noise gets a reporting fix, not an app fix. Resolve it when the fix ships.

**High-risk release** (money, privacy, migrations, deletion). Plan and runbook reviewed by Astra before building; build in test mode; gate; Astra again on the exact heads; packet; the user's yes; ship alone. Pricing, subscriptions, refunds and tax are the user's calls; bring them with a recommendation.

**Gate failure.** Work out whose failure it is (pipeline.md) and send the owning lane the file, the assertion and your reading. Ship the PRs that passed.

**Merge conflict.** Gates and the ship lane don't resolve conflicts; the owning lane merges main and is re-gated. Lanes sharing a rule file (DESIGN.md, tokens) conflict often: merge one, then have the other merge main.

**Stalled lane.** Read the pane: usually it is text left in the input (send Enter), a dialog (Codex's hook review swallows the first prompt if `~/.codex/hooks.json` changed since it was trusted), or a monitor that stopped on a failure and sat idle. If it is idle with no READY, nudge it with the brief path. A T3 fallback lane: read its activity (`t3_thread_read`, `view: "activity"`) and steer it with `t3_thread_send`.

**Machine overload** (load 300–900 on 10 cores). Heavy checks through `scripts/heavy.sh`, one full suite per machine, close finished lanes. Waiting for the load to drop doesn't work; a lane once waited 2 h 45 m that way.

**Overnight.** The user hands over with a grant before sleeping. Write a checklist file with their words, the finish line and their usage threshold (40% of the weekly quota on the example run). If their plan keeps running on paid credits once the quota is used up, the checklist also says whether lanes may use credits and where they stop (`references/models.md`, Quota). Decide routine design and product choices yourself, judging from the pattern of their earlier messages, with a second reader when it helps, and log each with its reason. Spending, production data and live charging still wait. Morning list: their yeses first, then inputs only they can give, then decisions to confirm.

**The user adds items mid-run.** Route each item to its lane in the same tick; new items go in the next batch, never the frozen one. When asked how it's going, answer with what shipped, what's in the gate and when the next ship lands.

**A lane asks a question.** Answer from the user's decisions and the project's docs; otherwise decide and log it. Only the permission list in SKILL.md goes to the user.

**A release blocked on the user's input.** One numbered item per input: what, where, what to send back. Never ask for a secret in chat; the user writes credential files themselves.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall