--- name: tuturuuu-agent-coordination description: "Coordinate Tuturuuu multi-agent programs, exact-head evidence, shared-worktree ownership, and handoffs." --- # Tuturuuu Agent Coordination Protect existing work with `git status --short`, path ownership, and a separate worktree when needed. Inspect top-level active `tmp/agent-coordination/` notes before overlapping work; missing/noncanonical statuses remain active. Never take ownership merely because a note is old. Archives are historical context, not locks. Notes and commit windows are per-checkout. Separate worktrees coordinate through branches and the remote. Open PR work belongs in `.worktrees/` with immediate `bun install`. `bun setup` runs builds; use CI build checks instead. Read the relevant section of `references/coordination-protocol.md` for overlap, handoffs, delegated lanes, generated-output isolation, or cleanup. Create a note for shared/dirty, overlapping, long-running, or tooling-rule changes. Include Agent, Intent, Owned paths, Observed dirty paths, Status, Needs, Verification, Risks, and Commit window. Use statuses `working`, `blocked`, `handoff`, or `done`; never stage notes. For multi-lane work spanning PR/CI/delivery wakes, use `references/program-orchestration.md`: own the program board and acceptance, relay complete briefs, drain completed handoffs, and reconcile exact-head proof. Use its [autonomy contract](references/program-orchestration.md#autonomy-and-asynchronous-waits) for useful child work during asynchronous waits, inherited briefs and bounded workflow audits. Standing user delegation instructions apply within task authority and actual runtime/resource limits. Its operating model sets roles, the shared subagent allocation, lead budget grants and receipts; check declared allocations with `node scripts/ci/check-agent-budget.js`. Apply `references/security-default.md` to every lane: change-triggered checks, independent review for auth/RLS/CI/token/storage changes, and finding fields. A child on a linked host follows `references/linked-host-child-route.md`. Do not pass `isolation`. For assigned ongoing idea/bug/feature intake, read `references/request-backlog.md`: capture each outcome before dispatch, recover durable requests on every wake, and keep implemented work distinct from verified delivery. On fleet machines, `ttr git guard` refuses new remote branches and pull requests on the platform repos; read `references/git-guard.md` before working around a refusal. ## On DONE When the item is done, blocked for good, or handed to another owner, send Atlas one handover, then settle yourself. Never complete silently. The handover states what shipped, with the commit SHA and the live proof, what is left, the open risks, and the links. Settle with t3_thread_organize action settle. It applies at the end of the turn. A live lane with standing duties does not settle. That includes Atlas, Iris, Quinn, Selene, Rex, Pax, Cora, Forge, Mira, and any lane that still holds a watch, a waiter, a webhook, an open question, or an open program. A parent consumes a delegated child's result, reports it upward, and settles the child. Do not settle a child while its parent is still live. Every new brief includes this sentence: when the work is done, blocked for good, or handed off, send Atlas one handover and then settle, unless you are a live lane with standing duties. Before staging or committing, inspect existing staged paths and claim the window: ```bash bun git-commit-window claim --owner "" --scope "" ``` Use `wait` if occupied; release with `bun git-commit-window release --token ` after completion or abort. Claims last 5–10 minutes. The lock grants no file ownership. Stage only owned paths. Existing staged work belongs to its owner; do not change it. For requested integration, retain work until the scoped commit is on main, exact-SHA main CI passes, `bun git-sync` completes, and production verification passes. Clean up only the completed clean worktree and its task branch. Finish the note with verification and risks; archive your own `done` note under `archive//` when no handoff needs visibility. Preserve blocked, unmerged, and other-owned work.