hdresearch/reef

code-delivery

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

app-deployment

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.

command-handling

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

coordination-patterns

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

create-service

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.

decompose

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

fleet-inspection

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

github-ops

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

logs-debugging

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

reporting-checkpointing

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

resource-ops

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

root-supervision

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.

scheduled-orchestration

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

setup

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