plan-refiner

Convert a raw specification into a polished implementation plan through iterative review passes.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/dreambound/plan-refiner-skill --skill plan-refiner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-refiner
Source: https://github.com/dreambound/plan-refiner-skill/tree/main
Command: npx skills add https://github.com/dreambound/plan-refiner-skill --skill plan-refiner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill transforms a starting specification into a polished implementation plan by orchestrating iterative refinement passes with a fresh agent perspective, reducing drift and misalignment across iterations.

Core Features & Use Cases

  • Iterative Refinement: Generate an initial plan from a spec, then refine it through multiple review passes with new agents each time.
  • Parallel Review: Run standard, adversarial, and optional custom reviews in parallel to surface diverse feedback and accelerate convergence.
  • Context Verification & Audit Trail: Verify version compatibility via Context7 and preserve an audit trail of all plan versions and feedback to support traceability.
  • Drift Prevention & User Involvement: Re-read the original spec each pass, surface issues to the user, capture clarifications, and let the user decide when to finalize.
  • Output Organization: Save final plan as plan.md and maintain an audit directory with pass changelogs and feedback.

Quick Start

Provide an initial specification or prompt to begin refinement. The agent will slug the spec, create a namespaced workspace under ~/.claude/plans/plan-refiner, generate an initial plan, and guide you through iterative passes with user-in-the-loop finalization.

How It Works

The skill implements an iterative refinement process with a generation step, a review loop (minimum 3 passes), user prompts for clarifications, and a finalization decision. Reviewers use Context7 to verify current versions, and a changelog documents each pass.

Frequently Asked Questions about plan-refiner

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

FAQPage Schema
How do I refine a software implementation plan to prevent drift across iterations?

You can refine an implementation plan by orchestrating iterative passes with fresh agent perspectives, re-reading the original spec each time to prevent drift. This process standardizes plan refinement by generating an initial draft and running parallel standard, adversarial, and custom reviews.

What is iterative plan refinement with fresh perspectives?

Iterative plan refinement is a process that generates an initial plan from a specification and then improves it through multiple review passes. Using fresh agent perspectives for each pass surfaces diverse feedback and reduces misalignment across iterations until the user finalizes the plan.

How do I run parallel adversarial and standard reviews on a specification?

You can run parallel adversarial and standard reviews by providing an initial specification to the refinement process. The system orchestrates these parallel review passes simultaneously to accelerate feedback convergence and surface diverse issues before finalizing the plan.

Does plan refinement verify current library versions via Context7?

Yes, the plan refinement process uses Context7 to verify current library versions and ensure version compatibility during each review pass. This verification happens automatically as reviewers evaluate the generated implementation plan.

Can I maintain an audit trail of plan versions and feedback?

Yes, the refinement process preserves a full audit trail at ~/.claude/plans/plan-refiner/{spec-slug}/. This audit directory maintains all plan versions, pass changelogs, and reviewer feedback to support complete traceability of the iterative process.

When do I need to capture user clarifications during iterative planning?

You need to capture user clarifications when the review process surfaces issues or ambiguities in the current plan. The user-in-the-loop approach prompts for clarifications during each pass and lets the user decide exactly when to finalize the polished implementation plan.