reef

Use when doing code work that must be integration-friendly: branches, commits, tests, PR-ready receipts, owned paths, and parent-friendly handoff.

Use when implementing and exposing a product/application service or UI that should run outside Reef root. Choose child/resource VM placement, stand up the app, and report how to reach it.

Use when handling parent commands such as steer, abort, pause, or resume, or when deciding how urgently to react to inbox messages from above.

Use when agents need to coordinate through reef store, peer signals, barriers, rendezvous, or child/peer communication without breaking authority boundaries.

Create a new service module for reef. Use when adding a new capability to the server — a new store, API routes, LLM tools, behaviors, or dashboard widget.

Use when a task has multiple independent subsystems, needs recursive delegation, or requires a parent to split implementation and then integrate the results.

Use when inspecting the live fleet, differentiating active vs historical lineage, tracing ancestry, checking subtree state, or doing post-mortem investigation.

Use when working with GitHub repos, branch setup, auth tokens, PR flow, or repo preparation inside Reef.

Use when debugging Reef or fleet behavior through logs, including keyword/date filtering, per-agent inspection, post-mortem analysis, and handoff investigation.

Use when signaling done/blocked/failed, reporting artifacts upward, or deciding whether to create a checkpoint before risky or meaningful state transitions.

Use when spawning, configuring, auditing, or retiring resource VMs that host infrastructure such as databases, services, test environments, or webhook-facing systems.

Use when root reef must supervise the fleet, maintain continuity across turns, detect drift or stalls, and decide when to steer, recover, schedule follow-up, or clean up.

Use when reef needs deferred attention, follow-up checks, deadlines, or condition-based orchestration via scheduled checks instead of reminder-style timers.

Set up a reef server with example services. Use when bootstrapping a new reef instance or adding fleet coordination services to an existing one.