agentleFS
Alex5350Alex5350/arsenal/.agents/skills/planner-executor-handoff/SKILL.md

planner-executor-handoff

Skill0 starsChanged 17 days agoMITView on GitHub

Write a standalone implementation plan as the strategist tier and hand it to an executor-tier session for implementation. Use when research or a request is ready to become code, when the user asks for a plan or an implementation approach, or when switching from a planning model to a coding model.

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read the research artifact and the relevant code paths yourself.

    line 19
  2. Distinctive:

    Read the plan fully before the first command.

    line 43
  3. Distinctive:

    If the executor is stuck twice on one task, it goes back to the planner with both attempts written down.

    line 55

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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

Planner to executor handoff

Goal: produce a plan the executor tier can execute without ever talking to the planner. The plan is the entire interface. Phase doc: docs/workflows/02-planning.md; tier policy: docs/models/routing.md.

The handoff contract

A handoff is complete when the executor needs nothing but the plan and the repository: no verbal context, no "as discussed", no tribal memory.

Procedure (planner)

  1. Read the research artifact and the relevant code paths yourself; do not plan from summaries alone.
  2. Write docs/plans/<slug>.md:
# <plan title>
Work item: <tracker id>
## Goal and non-goals
## Context          (links to research, incidents, prior plans)
## Tasks            (each: acceptance criteria + how it will be tested + assigned tier)
## Test plan        (what the test gate will run)
## Risks            (each with its mitigation and owner)
## Rollback         (what makes this change safe to revert)
  1. Slice tasks to finishable-in-one-session size. A task an executor cannot complete green in a session is two tasks.
  2. Assign each task a tier. Most are executor; anything re-deciding architecture is strategist.
  3. Get the plan approved (human or second strategist session) before any code exists. Approval is recorded on the work item.

Procedure (executor)

  1. Read the plan fully before the first command.
  2. Execute tasks in order, TDD where applicable, committing per docs/standards/git.md.
  3. Deviations: small ones proceed and get logged in the handoff note; scope changes stop and go back to the planner as a work-item comment.
  4. Hand back: diff, green gates, deltas from plan, what the reviewer should probe.

Rules

  • The planner does not implement; the executor does not re-plan. Crossing that line is how responsibility blurs and defects hide.
  • If the executor is stuck twice on one task, it goes back to the planner with both attempts written down. That is a planning defect until proven otherwise.

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.