plan-implement

Convert implementation plans into review-gated code changes with sequential commits.

4|Updated Feb 9, 2021
One-click install
npx skills add https://github.com/breengles/poor-man-OS-setup --skill plan-implement-breengles
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-implement
Source: https://github.com/breengles/poor-man-OS-setup/tree/main/.claude/skills/plan-implement
Command: npx skills add https://github.com/breengles/poor-man-OS-setup --skill plan-implement-breengles

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

plan-implement helps you turn an existing multi-step plan into working code safely, by executing each step through an implementer/reviewer loop and only committing after approval.

Core Features & Use Cases

  • Step-by-step execution with guardrails: Orchestrates plan parsing, step sequencing, and progress tracking while keeping the main session as an orchestrator.
  • Independent implementer/reviewer loop per step (or batch): Dispatches dedicated subagents to implement and verify changes before committing.
  • Flexible plan sourcing and step selection: Supports resolving the plan from a provided file path or from conversation/context, with options to run specific steps or all pending steps.
  • Use Case: When you draft a refactor plan in chat or save it as a plan.md file, you can execute steps one at a time with review-backed commits to reduce mistakes and scope creep.

Quick Start

Use plan-implement to run the next steps from your plan file by telling the AI: "Execute plan.md step numbers 1 3 5."

Frequently Asked Questions about plan-implement

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I execute a multi-step implementation plan with code reviews?

To execute a multi-step implementation plan with code reviews, you can use an orchestration tool that parses numbered or prose plans and runs a dedicated implementer/reviewer loop for each step. It applies incremental changes and only commits after receiving an approval verdict.

Can I run specific steps from a plan file instead of executing everything at once?

Yes, you can run specific steps from a plan file by specifying the desired step numbers during execution. The system supports flexible plan sourcing from a file path or conversation context and allows you to execute selected steps or all pending tasks sequentially.

How does incremental development with an implementer and reviewer loop work?

Incremental development with an implementer and reviewer loop works by dispatching independent subagents to write and verify code changes for each task. The reviewer performs diff-verification, and if changes are rejected, the system uses bounded retry rounds before allowing the main session to proceed.

Does the git workflow automatically commit code changes after each task?

No, the git workflow does not automatically commit code changes after each task. It uses selective git staging and commits only after the reviewer subagent provides an APPROVED verdict, ensuring that unchecked or failed implementations are kept out of the repository.

What is the best way to prevent scope creep during a complex code refactor?

The best way to prevent scope creep during a complex code refactor is to enforce task-based progress tracking and sequential step execution. By isolating each implementation phase behind a review gate, the workflow strictly bounds changes to the original drafted plan.

When should I not use an automated plan execution workflow for coding?

You should not use an automated plan execution workflow if your project lacks a clearly drafted implementation plan or if your coding task requires exploratory, unstructured changes. This approach relies on normalized step extraction and sequential execution, making it unsuitable for undefined tasks.