refine-plan

Evaluate and refine implementation plans through parallel multi-agent review.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Iteratively improve a plan document by spawning specialized review sub-agents in parallel, synthesizing their feedback, performing research when needed, and repeating until the plan is ready for implementation.

Core Features & Use Cases

  • Parallel orchestration of Holistic, Software Architecture, and domain-specialist reviewers to assess an implementation plan.
  • Context loading from repository-wide conventions, decisions, and active epics to ground refinement.
  • Multi-round refinement loop (up to 12 iterations) with feedback synthesis, research triggers, and targeted plan edits.
  • Final verification and transition from a -refining plan to a -refined plan, preserving the original as source of truth.

Quick Start

Run /refine-plan <path-to-plan> to start refining the plan.

Frequently Asked Questions about refine-plan

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

FAQPage Schema
How do I iteratively refine an implementation plan with multi-agent feedback?

Iterative plan refinement spawns parallel review sub-agents to synthesize feedback and edit your plan. It loads repository context and decisions, running up to 12 refinement loops until the plan reaches production-ready status.

What is the best way to review a software architecture plan before implementation?

Reviewing a software architecture plan is best handled by parallel domain-specialist agents that assess structure and context. They synthesize feedback into targeted edits, preserving the original plan as a source of truth.

Can I use automated plan refinement for machine learning project strategies?

Automated plan refinement works across domains including machine learning, web, and systems. It applies multi-agent evaluation and research triggers to iteratively improve your ML strategy document until it meets explicit exit criteria.

Does the plan refinement loop automatically research missing information?

The plan refinement loop triggers research automatically when reviewers identify gaps. It synthesizes the findings into feedback, applying targeted edits to the plan document before the next evaluation iteration begins.

What are the limitations of automated multi-agent plan refinement?

Automated multi-agent plan refinement enforces a strict 12-iteration cap and requires explicit exit criteria to stop. It transitions the document to a refined state, preserving the original plan separately as the source of truth.

How do I load repository decisions and conventions for plan evaluation?

Loading repository decisions and conventions happens automatically during context initialization for plan evaluation. The system grounds the refinement process by reading active epics and project decisions before spawning review agents.