agentleFS
danielvm-gitdanielvm-git/bigpowers/skills/delegate-task/SKILL.md

delegate-task

Skill288 starsChanged 6 days agoMITView on GitHub

Delegate one complex task to a single subagent, review its work in two stages before merging back. Sequential — one agent at a time, with oversight. Use when a task is complex and requires careful review before the result is accepted. Distinct from dispatch-agents (no parallelism here; reviewer sees full diff before proceeding).

4 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

6 rules. 0 are common, 4 are distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 4 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Before spawning the agent, read specs/state.yaml if it exists.

    line 34
  2. Distinctive:

    Do not include full file contents, full conversation history, or decisions unrelated to this task.

    line 45
  3. Very specific:

    Use the Agent tool with a fresh context per spawn.

    line 49
  4. Distinctive:

    All context the agent needs (it starts cold — no shared state)

    line 54
  5. Distinctive:

    When the subagent returns, review its report before looking at the diff:

    line 60
  6. Distinctive:

    If the report raises red flags, ask the subagent for clarification or re-run with adjusted instructions.

    line 65

“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md
<!-- story: e45s30 -->

Delegate Task

HARD GATE — HARD GATE — Delegated work must have clear success criteria and verification commands. The delegate must be able to verify completion independently.

Delegate a single complex task to a subagent with a two-stage review gate before accepting the result. Use when oversight of a single task matters more than speed.

Distinct from dispatch-agents: This skill runs one subagent sequentially with a mandatory review. dispatch-agents runs multiple subagents in parallel without inter-task review gates.

Subagent depth tiers (e45s30)

Select brief depth from task risk: and skill effort: before spawning:

TierWhenBrief includes
full_maturityP0 stories, multi-file refactors, security workFull template + CONVENTIONS excerpts + threat model if present
standardDefault implementation tasksGoal, scope, out-of-bounds, constraints, verify, prior decisions
minimal_decisiveLight probes, read-only auditsGoal, verify, explicit file list (≤15 lines total)

State depth: <tier> in the Agent tool description field.

Process

1. Define the task

Before spawning the agent, read specs/state.yaml if it exists. Then write a minimal self-contained brief using this template (brief size directly controls token cost and hallucination risk — do not pad):

Goal: [one sentence — specific, measurable outcome]
In scope: [explicit file or module list]
Out of bounds: [what NOT to do]
Constraints: [relevant CONVENTIONS.md rules, existing patterns, test requirements]
Verify: [runnable command]
Prior decisions: [relevant entries from specs/state.yaml — omit section if none apply]

Do not include full file contents, full conversation history, or decisions unrelated to this task.

2. Spawn the subagent (iterative retrieval, max 3 cycles)

Use the Agent tool with a fresh context per spawn. Pass prior decisions only via specs/state.yaml.

Cycle: dispatch → evaluate output vs goal → refine brief → re-spawn if needed (max 3 cycles).

Include in each brief:

  • All context the agent needs (it starts cold — no shared state)
  • Reference to CONVENTIONS.md constraints
  • The verify command it must run before reporting done

3. Stage 1 review — output inspection

When the subagent returns, review its report before looking at the diff:

  • Did it run the verify command? Did it pass?
  • Does it explain what it changed and why?
  • Are there any concerns raised by the agent?

If the report raises red flags, ask the subagent for clarification or re-run with adjusted instructions.

4. Stage 2 review — diff inspection

Inspect the actual diff:

git diff main...HEAD

Check:

  • Changes are scoped to what was asked — nothing extra
  • No any, no @ts-ignore, no disabled lint rules
  • Tests added for new behavior
  • CONVENTIONS.md compliance (naming, structure, no gh issue creation)
  • Boy Scout Rule: touched areas are cleaner than before

5. Decision

  • Accept: merge the result into the main working branch
  • Revise: send back to the subagent with specific feedback
  • Reject: discard and re-approach differently

After accepting, append to specs/state.yaml under ## Active Decisions:

**[task short name]**: [what approach the agent chose and why — one sentence]

Report the decision and rationale to the user.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.