plan-refiner

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.