agentleFS
atomicinnovationatomicinnovation/accelerator/skills/planning/implement-plan/SKILL.md

implement-plan

Skill34 starsChanged 51 days agoMITView on GitHub

Execute an approved implementation plan from the configured plans

28 other projects use a version of this, 2 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use iterate-plan, fix-bug and 4 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

  • JetBrainsSkill

    fix-bug

    End-to-end bug fix workflow for the Exposed project. Accepts a GitHub issue (#NUMBER), YouTrack issue (EXPOSED-NUMBER), or YouTrack URL (https://youtrack.jetbrains.com/issue/EXPOSED-NUMBER). Fetches the issue, creates a failing reproducer test, commits on a new branch, implements the fix, validates, and opens a PR. Use this skill whenever the user wants to fix a bug from an issue tracker, mentions a EXPOSED issue number, or references a GitHub issue to fix.

    Also in 3 projects that use this

  • NVIDIASkill

    review-code

    Review a code repository for concrete issues in correctness, robustness, security, maintainability, tests, and integration. Use for repository-wide or focused code review where practical engineering judgment and strict scope control matter.

    Also in 3 projects that use this

  • SentrySkill

    create-pr

    Create pull requests following Sentry conventions. Use when opening PRs, writing PR descriptions, or preparing changes for review. Follows Sentry's code review guidelines.

    Also in 5 projects that use this

  • ElasticSkill

    create-skill

    Interactively create a new Claude Code skill and add it to the elastic-docs-skills catalog. Use when the user wants to generate a new skill, scaffold a slash command, or build automation for docs tasks.

    Also in 3 projects that use this

  • GoogleSkill

    diagnosing-bugs

    Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

    Also in 3 projects that use this

The file

Show its rules and text

We split this skill into the rules it gives an agent

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

  • 0

    Common

    Most of the 28 edited versions we read keep these.

  • 23

    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. Very specific:

    If no "Agent Names" section appears above, use these defaults: accelerator:reviewer, accelerator:codebase-locator, …

    line 17
  2. Distinctive:

    When given a plan path:

    line 31
  3. Distinctive:

    Read the plan completely and check for any existing checkmarks (- [x])

    line 33
  4. Distinctive:

    Read the original work item and all files mentioned in the plan

    line 34
  5. Distinctive:

    Read files fully: - never use limit/offset parameters, you need complete context

    line 35
  6. Distinctive:

    Create a todo list to track your progress

    line 38
  7. Distinctive:

    Start implementing if you understand what needs to be done

    line 39
  8. Distinctive:

    If no plan path provided, ask for one.

    line 41
  9. Distinctive:

    Follow the plan's intent while adapting to what you find

    line 47
  10. Distinctive:

    Verify your work makes sense in the broader codebase context

    line 49
  11. Distinctive:

    Update checkboxes in the plan as you complete sections

    line 50
  12. Distinctive:

    When things don't match the plan exactly, think about why and communicate clearly.

    line 52
  13. Distinctive:

    If you encounter a mismatch:

    line 55
  14. Distinctive:

    STOP and think deeply about why the plan can't be followed

    line 57
  15. Distinctive:

    After implementing a phase:

    line 70
  16. Very specific:

    Run the success criteria checks (usually ./go covers everything)

    line 73
  17. Distinctive:

    Update your progress in both the plan and your todos

    line 75
  18. Distinctive:

    Check off completed items in the plan file itself using Edit

    line 76
  19. Distinctive:

    Don't let verification interrupt your flow - batch it at natural stopping points.

    line 78
  20. Very specific:

    Validate the frontmatter: after writing, run corpus frontmatter validate over the plan file whose checkboxes you just updated:

    line 81
  21. Distinctive:

    If it exits non-zero, the plan violates the canonical frontmatter standard.

    line 88
  22. Distinctive:

    When something isn't working as expected:

    line 94
  23. Distinctive:

    Consider if the codebase has evolved since the plan was written

    line 97
  24. Distinctive:

    Use sub-tasks sparingly - mainly for targeted debugging or exploring unfamiliar territory.

    line 100
  25. Distinctive:

    If the plan has existing checkmarks:

    line 105
  26. Distinctive:

    Verify previous work only if something seems off

    line 109

“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

!accelerator config context --skill implement-plan --fail-safe !accelerator config agents --fail-safe

If no "Agent Names" section appears above, use these defaults: accelerator:reviewer, accelerator:codebase-locator, accelerator:codebase-analyser, accelerator:codebase-pattern-finder, accelerator:documents-locator, accelerator:documents-analyser, accelerator:web-search-researcher.

Plans directory: !accelerator config path plans --fail-safe

You are tasked with implementing an approved technical plan from the configured plans directory (shown above). These plans contain phases with specific changes and success criteria.

Getting Started

When given a plan path:

  • Read the plan completely and check for any existing checkmarks (- [x])
  • Read the original work item and all files mentioned in the plan
  • Read files fully - never use limit/offset parameters, you need complete context
  • Think deeply about how the pieces fit together
  • Create a todo list to track your progress
  • Start implementing if you understand what needs to be done

If no plan path provided, ask for one.

Implementation Philosophy

Plans are carefully designed, but reality can be messy. Your job is to:

  • Follow the plan's intent while adapting to what you find
  • Implement each phase fully before moving to the next
  • Verify your work makes sense in the broader codebase context
  • Update checkboxes in the plan as you complete sections

When things don't match the plan exactly, think about why and communicate clearly. The plan is your guide, but your judgment matters too.

If you encounter a mismatch:

  • STOP and think deeply about why the plan can't be followed
  • Present the issue clearly:
    Issue in Phase [N]:
    Expected: [what the plan says]
    Found: [actual situation]
    Why this matters: [explanation]
    
    How should I proceed?

Verification Approach

After implementing a phase:

  • Pause and let me review all the changes you have made
  • Run the success criteria checks (usually ./go covers everything)
  • Fix any issues before proceeding
  • Update your progress in both the plan and your todos
  • Check off completed items in the plan file itself using Edit

Don't let verification interrupt your flow - batch it at natural stopping points.

Validate the frontmatter: after writing, run corpus frontmatter validate over the plan file whose checkboxes you just updated:

accelerator corpus frontmatter validate --file <path>

If it exits non-zero, the plan violates the canonical frontmatter standard; report the emitted violation and fix the frontmatter before completing.

If You Get Stuck

When something isn't working as expected:

  • First, make sure you've read and understood all the relevant code
  • Consider if the codebase has evolved since the plan was written
  • Present the mismatch clearly and ask for guidance

Use sub-tasks sparingly - mainly for targeted debugging or exploring unfamiliar territory.

Resuming Work

If the plan has existing checkmarks:

  • Trust that completed work is done
  • Pick up from the first unchecked item
  • Verify previous work only if something seems off

Remember: You're implementing a solution, not just checking boxes. Keep the end goal in mind and maintain forward momentum.

!accelerator config instructions implement-plan --fail-safe

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.