Agent skill

plan-implement

Execute the implementation plan from PLANS.md following TDD workflow. Use after plan-todo or plan-fix has created a plan. Runs tests, implements code, and documents results.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/plan-implement

SKILL.md

Execute the current pending work in PLANS.md following strict TDD workflow.

Pre-flight Check

  1. Read PLANS.md - Understand the full context and history
  2. Read CLAUDE.md - Understand TDD workflow and project rules

Identify What to Execute

Look in PLANS.md for pending work in this priority order:

  1. Latest "Fix Plan" with no "Iteration" after it → Execute that fix plan
  2. Original Plan with no "Iteration 1" → Execute the original plan
  3. Nothing pending → Inform user "No pending work in PLANS.md"

Execution Workflow

For each task in the plan:

TDD Cycle (MANDATORY)

1. WRITE TEST
   └─ Add test cases in [file].test.ts

2. RUN TEST (expect fail)
   └─ Use test-runner agent
   └─ If test passes: warning - test may not be testing the right thing

3. IMPLEMENT
   └─ Write minimal code to make test pass

4. RUN TEST (expect pass)
   └─ Use test-runner agent
   └─ If fail: fix implementation, repeat step 4

Task Completion Checklist

After completing ALL tasks:

  1. Run bug-hunter agent - Review changes for bugs
    • If bugs found → Fix immediately before proceeding
  2. Run test-runner agent - Verify all tests pass
    • If failures → Fix immediately before proceeding
  3. Run builder agent - Verify zero warnings
    • If warnings → Fix immediately before proceeding

Handling Failures

Failure Type Action
Test won't fail (step 2) Review test - ensure it tests new behavior
Test won't pass (step 4) Debug implementation, do not skip
bug-hunter finds issues Fix bugs, re-run checklist
test-runner fails Fix tests, re-run checklist
builder has warnings Fix warnings, re-run checklist

Never mark tasks complete with failing tests or warnings.

Document Results

After execution, append a new "Iteration N" section to PLANS.md:

markdown
---

## Iteration N

**Implemented:** YYYY-MM-DD

### Completed
- Task 1: [Brief description of what was done]
- Task 2: [Brief description of what was done]

### Checklist Results
- bug-hunter: [Passed | Found N bugs, fixed]
- test-runner: [Passed | Failed, fixed]
- builder: [Passed | Had warnings, fixed]

### Notes
[Any important observations, edge cases discovered, or deviations from plan]

Rules

  • Execute ALL pending tasks - Never leave work incomplete
  • Follow TDD strictly - Test before implementation, always
  • Fix failures immediately - Do not proceed with failing tests or warnings
  • Never modify previous sections - Only append new Iteration section
  • Do not commit or create PR - Unless explicitly requested
  • Document everything - Include all checklist results in iteration
  • If nothing to execute, inform the user and stop

Didn't find tool you were looking for?

Be as detailed as possible for better results