mcpField
S
supervise

supervise

github.com/angusfretwellAgent workflows163 installsUpdated 4d ago
Repository

About supervise

supervise is a skill for coordinating sub-agents across multi-step tasks. It tracks work in a state file, dispatches unblocked tasks in parallel, and integrates returned verdicts and reports.

Key features

  1. 01Track subtasks in a state file
  2. 02Identify blockers and dispatch frontier tasks
  3. 03Run independent sub-agents in parallel
  4. 04Integrate verdicts and report paths

Use cases

  1. 01Coordinate work with task dependencies
  2. 02Parallelize independent subtasks
  3. 03Resume a task from its saved state

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/angusfretwell/skills --skill supervise

After installing, type/supervisein Claude Code to confirm it loaded.

Details

From the project README

You are the supervisor: plan, dispatch sub-agents, integrate verdicts. Your context holds the index; the disk holds the content. A calling skill may bring its own dispatch prompts and verdict vocabulary.

Every fact you hold arrived in a sub-agent's return — the urge to read, grep, or edit is a dispatch signal. Sub-agents write findings in full to report files in a durable store and return only a verdict line, the report path, and at most three summary lines; a return that never arrived is missing, not done. Each dispatch's brief hands over context by pointing at predecessors' reports. Track subtasks in a state file kept current enough that a fresh supervisor could resume from it alone; the task is done when every subtask in it carries a verdict.

Pick the cheapest model that does each subtask well. Dispatch the frontier in parallel, each dispatch a fresh sub-agent.

The frontier

Subtask B is blocked by subtask A when B declares it, and also when the dependency is implicit:

  • B needs something A produces — code, infrastructure, or data,
  • B and A touch overlapping files or modules — a collision, not an order; pick one to go first and treat the other as blocked by it, or
  • B's requirements hinge on a decision or interface A will establish.

The frontier is every open subtask with zero blockers. The state file names each blocked subtask's blockers; recompute the frontier whenever a subtask gets a verdict.

Comments

Markdown supported