agentleFS
ViktorSoroka07ViktorSoroka07/claude-delivery-skills/skills/implement-plan/SKILL.md

implement-plan

Skill0 starsChanged 47 days agoMITView on GitHub

Use when a plan document already exists and the work should now be built — "implement this plan", "execute the plan", "go ahead with docs/plans/X.md" — or when continuing after plan-feature.

28 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use iterate-plan, validate-plan and 9 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • corticalstackSkill

    iterate-plan

    Revise an existing implementation plan in flow/plans/ based on feedback, researching when needed. Explicit-only; run only when invoked via /iterate-plan or explicitly asked.

    Also in 5 projects that use this

  • shawn-dumasSkill

    validate-plan

    Validate an orchestration plan after pre-flight certification. Runs adversarial review, deep review (verify prompt data against codebase), and PoC gate for risky approaches. Auto-invoked by orchestrate-* skills at Step 8.

    Also in 4 projects that use this

  • parcadeiSkill

    describe-pr

    Generate comprehensive PR descriptions following repository templates

    Also in 4 projects that use this

  • joshuaalpuertoSkill

    research-codebase

    Conducts structured research across a codebase to answer questions about architecture, components, and data flow. Use when investigating how code works, where functionality lives, or how systems interact. Decomposes questions, runs parallel investigations, synthesizes findings with file:line references, and produces persistent research documents.

    Also in 4 projects that use this

  • JetBrainsSkill

    create-plan

    Research the codebase and create an implementation plan with architecture notes, design document, and track decomposition. Use when starting a new feature or large change.

    Also in 8 projects that use this

  • JetBrainsSkill

    review-plan

    Manually re-run the autonomous plan review (Phase 2 — consistency + structural). The same review runs automatically as the first phase of /execute-tracks; this command is for re-runs after inline replanning or whenever the plan needs explicit re-validation. TRIGGER when: user asks to re-validate the plan after inline replanning; user requests explicit plan review outside /execute-tracks. SKIP: /execute-tracks already running State 0 in this session (autonomous Phase 2 path will fire) — do not double-run.

    Also in 5 projects that use this

  • +1 more from JetBrains

The file

We split this skill into the rules it gives an agent

4 rules. 0 are common, 1 is distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 28 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read it fully before touching anything.

    line 15
  2. Very specific:

    Does it end with a gates task?: If not, append implementation-gates' plan task verbatim (its section "The plan task that runs these gates") …

    line 18
  3. Very specific:

    Call the Skill tool with the repo's subagent-driven-development (preferred where subagents are available) or executing-plans.

    line 30
  4. Very specific:

    Call the Skill tool with implementation-gates.

    line 40

“Common” is measured: kept by at least 6 in 10 of the 28 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

Implement Plan

Picks up where plan-feature stops, and works equally well on a plan written days ago, by someone else, or by another model.

This skill delegates and patches. It does not restate. Execution belongs to the repo's own skill; this one guarantees the things that get skipped when a plan is handed straight to an executor.

Step 1 — Read the plan first

Read it fully before touching anything. Then check two things:

  • Does it still match the repo? A plan written before a merge can name files, symbols or commands that no longer exist. Raise mismatches with the user rather than improvising around them.
  • Does it end with a gates task? If not, append implementation-gates' plan task verbatim (its section "The plan task that runs these gates") now — before implementation starts, so the executor runs it as part of the plan.

The plan is what executing-plans obeys. Patching the plan is what makes the gate run; hoping a skill fires at the end is not.

Step 2 — Check the plan's premises are settled

If the plan makes claims about behavior outside the code being written — what an API returns, what a frame contains, what a column means — confirm they were settled against evidence, not argued. Call the Skill tool with implementation-gates and run its Gate 2 on those claims now.

A plan that reads well can still rest on a false premise, and implementation will faithfully amplify it. Settling a claim costs one query here and a rewrite later.

Step 3 — Implement

Call the Skill tool with the repo's subagent-driven-development (preferred where subagents are available) or executing-plans. Follow that skill's checkpoints exactly and stop where it says stop.

The work's branch already exists: plan-feature's hand-off names it, and where the plan is committed its log shows it. Where the execution skill offers a worktree, the worktree checks out that branch — git worktree add <path> <branch> — never a new one; git checks a branch out in one worktree at a time, so where the main checkout already sits on it, move that checkout to the default branch first. A branch created here leaves two branches holding the plan and strands the one the commit hook keys on.

Where execution dispatches subagents, apply delegating-to-subagents on top — above all its audit of each delegated diff before the orchestrator commits it: discipline stated in a brief does not survive delegation. Where execution will spend at scale, budgeting-agentic-work governs the phase sizing and pricing of expensive passes.

Announce which one you used, and whether it was the repo's copy or the superpowers: one — they are forks and behave differently.

Step 4 — Gates

Call the Skill tool with implementation-gates.

Report survivors honestly. A survivor is a test gap to close, not a defect to argue away, and "the tests pass" is not evidence that they would have failed.

Step 5 — Finish

Five steps, in this order:

  1. Rewrite the plan document as the spec of what shipped — call the Skill tool with writing-plan-docs and follow its shipped-spec stage (strip checkboxes, re-tense to what landed, record what was and was not verified, no review history, no volatile counts). This happens before offering merge/PR options, not after.
  2. State readiness from evidence. "Ready to push" has one evidence: the repo's gates run from the repo root on the final committed tree with a clean status, including whatever the push itself will run, with the last line quoted. A run before the last edit or from a subdirectory, a hook that ran on an earlier commit, or a push the harness refused is not it, and the operator pushing into a failure is the symptom.
  3. Call the Skill tool with the repo's finishing-a-development-branch.
  4. Update the project memory per maintaining-project-memory (it owns the write discipline — what memory holds, and the starter prompt a continuing session ends with). Refresh the review-repo-nuances entry (that exact name — it is the one review-pr and implementation-gates read) if this work changed gates, commands, or conventions, and record what a next session needs that the repo itself cannot tell it — what is parked, which decisions are provisional. In repos that do not commit plan documents, record in that same entry where this task's executed gates record lives — plan path, branch, the SHA the gates ran at — so a later review can audit the mutation table instead of re-running the sweep. Update existing memory files over creating duplicates.
  5. Tell the user that review is a separate, billable decision: /review-pr triages its axes, and a small diff may not warrant one at all.

Rules

  • Never start implementation on a plan you have not read end to end.
  • Plan edits by the user are authoritative — re-read the plan if they changed it.
  • Never skip a repo skill's own gate to save time.
  • Stop and ask at the first blocker rather than guessing.

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.