agentleFS
TylerAkinsTylerAkins/ai-agent-skills/skills/implement-plan/SKILL.md

implement-plan

Skill1 starsChanged 30 days agoMITView on GitHub

Execute an accepted implementation plan through scoped changes, meaningful verification, independent final review, and repairs. Use when asked to build or implement a plan, including a Plan-to-Build handoff. Preserve requirements and authorization; commit, push, and publication remain separate actions.

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 10 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

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

  • 0

    Common

    Most of the 28 edited versions we read keep these.

  • 11

    Distinctive

    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 anti-ai-writing before drafting text.

    line 12
  2. Distinctive:

    Read the accepted plan and its authoritative requirements, including accepted decisions and unresolved choices.

    line 19
  3. Distinctive:

    Read task skills linked by the plan and applicable repository-local skills or instructions.

    line 23
  4. Distinctive:

    Verify plan paths, interfaces, contractual values, dependencies, and check commands against the repository.

    line 27
  5. Distinctive:

    Before production edits to a stateful, asynchronous, or interactive task, reconcile its plan criteria with the actual state owners, …

    line 69
  6. Distinctive:

    Use test-authoring for independently justified behavioral coverage.

    line 76
  7. Distinctive:

    When committing is authorized, create local commits at coherent, verified checkpoints using git-delivery.

    line 98
  8. Distinctive:

    Before final review, inspect the complete candidate, including relevant untracked files, for omissions, accidental changes, and contract …

    line 107
  9. Distinctive:

    Verify findings against actual triggers, consumers, and source contracts before repairing.

    line 127
  10. Distinctive:

    Do not claim the required review gate is complete when only self-review occurred.

    line 138
  11. Distinctive:

    When explicitly authorized, use git-delivery for commits, pushes, or PR preparation.

    line 142

“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 a Plan

Read anti-ai-writing before drafting text. Establish implementation authorization from the user's request or host Build handoff. Do not ask again for unchanged authorized work. A planning-only request does not authorize implementation, and Build does not automatically authorize commits or remote actions.

1. Establish intent and candidate

Read the accepted plan and its authoritative requirements, including accepted decisions and unresolved choices. Use jira-tickets in intake mode when necessary issue context is missing. Inspect repository instructions, branch/base, working changes, relevant execution paths, and dependency versions. Read task skills linked by the plan and applicable repository-local skills or instructions. Preserve unrelated work and reuse suitable task context rather than restarting intake.

Verify plan paths, interfaces, contractual values, dependencies, and check commands against the repository. Treat the plan as a proposal to reconcile, not proof of correctness. Use agent-planning only for material gaps or changes needing a revised plan. Do not rewrite user-protected plans; record proposed changes separately. Pause only tasks dependent on unresolved intent or scope.

Confirm a suitable task branch before implementation in a Git repository, preserving existing ancestry and changes. Follow repository branch conventions. Work on a protected/shared integration branch only when the user specifically requests it; resolve unsafe branch or isolation conditions before dependent edits.

2. Establish each task's evidence before editing

For each task, select its before-and-after checks before production edits:

  • For new behavior or a bug repair, prefer a focused behavioral test that fails on the unchanged implementation. Confirm the failure is the intended assertion, then run the same test and applicable checks after the change. If a pre-change test cannot run safely or meaningfully, record why, establish the strongest available baseline or reproduction, and choose the post-change check before editing. Do not claim observed regression sensitivity from an unrun comparison.
  • For behavior-preserving refactoring, establish the relevant passing baseline and check it again after the change. Follow test-authoring for coverage and sensitivity choices rather than duplicating its procedure here.
  • For documentation-only work, select document checks. A reproduction-only request does not authorize production repair.

Confirm actual test selection and results; a successful command with zero selected tests is not verification. If a required check is unavailable, report the gap and pause only work that depends on it. Apply the selected checks during implementation and after repairs; this phase is not permission to defer pre-edit evidence.

3. Implement and verify tasks

Execute tasks in dependency order using writing-clean-simple-code. Load domain procedures when needed: api-design, frontend-engineering, safe-migrations, or ci-cd-workflows. Do not load all skills or add scope solely because a domain is mentioned.

Before production edits to a stateful, asynchronous, or interactive task, reconcile its plan criteria with the actual state owners, invariants, and high-risk transitions in the source. If an important failure, retry, overlap, or identity-change case is missing, add the needed criterion and verification to the existing task before implementation. Use scope and state coverage to select scenarios without expanding into unrelated combinations.

Use test-authoring for independently justified behavioral coverage. Run focused checks in verified package directories and confirm actual test selection. Run the before-and-after checks selected for the task. Investigate unexpected failures through root-cause-debug, preserving evidence and distinguishing introduced failures from unrelated ones.

Track each task's intended outcome, verification, observed result, and material decisions in the existing plan or host task artifact. Before a dependent task, compare the interface, value, or invariant it expects with what the earlier task actually produced; resolve conflicts against source requirements. Mark a task complete only when its outcome and checks match. Reconcile changes with requirements as evidence develops. Update affected documentation through technical-documentation when the behavior or setup changes. Keep temporary diagnostics out of the final diff.

For a high-risk task with interacting state transitions, run a focused read-only code-review on its completed delta after relevant checks pass and before dependent tasks proceed. Verify the fix against its trigger, then search the full candidate and affected callers for sibling instances of the same failure pattern. This targeted review does not replace final whole-candidate review; skip it for tasks whose behavior does not carry comparable risk.

When committing is authorized, create local commits at coherent, verified checkpoints using git-delivery. Each commit should capture a complete, reviewable change and pass applicable repository checks. Prefer checkpoints after completed tasks or closely related task groups rather than a fixed time or file count. Avoid accumulating unrelated completed tasks into one large commit. Preserve unrelated work and do not commit incomplete work merely to reach a checkpoint. Push only when separately authorized; local checkpoint commits do not require an immediate push or replace final whole-candidate verification and independent review.

Before final review, inspect the complete candidate, including relevant untracked files, for omissions, accidental changes, and contract mismatches. Run applicable integration/build checks and browser verification for affected UI behavior. A completed todo list or passing unrelated suite does not establish requirement coverage.

4. Independently review the complete candidate

Final independent code-review is a required step unless the user explicitly skips it. Use a fresh read-only reviewer when available and permitted by the host. Supply repository instructions, source requirements and accepted decisions, comparison base, and exact candidate including working/untracked changes. Provide raw evidence, not author reasoning, the implementation plan as proof, self-review conclusions, or suggested findings.

A task-level review does not replace whole-candidate review. If independent context is unavailable or prohibited, perform a separate evidence-based assessment when useful, disclose the limit, and leave independent review incomplete. An aborted, empty, or partial attempt remains pending; do not reinterpret it as approval. Retry a failed attempt when feasible without spawning redundant reviews of unchanged clean work.

Verify findings against actual triggers, consumers, and source contracts before repairing. Make supported repairs within existing authorization. Resolve consequential intent conflicts before dependent changes; retain unresolved or accepted deferred findings explicitly. Rerun affected checks after repairs and independently re-review the complete final candidate after material changes. A clean review covers only the candidate and scope it actually assessed.

5. Deliver actual state

Reconcile requirements, final diff, checks, and review coverage. Report implemented behavior, meaningful verification, remaining blockers, and unavailable checks/review. Do not claim the required review gate is complete when only self-review occurred. Preserve checkpoints across resumed work, validating them against current candidate state rather than repeating unchanged verified work or trusting completion labels.

When explicitly authorized, use git-delivery for commits, pushes, or PR preparation. Do not hide unmet required steps behind a delivery request; report limits if the user asks to proceed despite them. Preserve approvals and review history. Live deployment uses authorized release-readiness, not an automatic consequence of Build.

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.