maiconfz--plan-refiner--interactive-plan-refiner

Reviews and refines existing markdown plans against repository context through clarifying questions.

3|1|Updated May 2, 2026
One-click install
npx skills add https://github.com/agents-repo/registry --skill maiconfz-plan-refiner-interactive-plan-refiner-agents-repo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maiconfz--plan-refiner--interactive-plan-refiner
Source: https://github.com/agents-repo/registry/tree/main/.cursor/skills/maiconfz/plan-refiner/maiconfz--plan-refiner--interactive-plan-refiner
Command: npx skills add https://github.com/agents-repo/registry --skill maiconfz-plan-refiner-interactive-plan-refiner-agents-repo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Draft implementation plans often contain gaps, inconsistencies, and unverified assumptions that only surface during coding. This Skill performs an ask-first quality pass on an existing plan, checking it against the stated goal and the actual host repository before any code is written. ## Core Features & Use Cases - Critique-then-revise workflow: Compares a draft plan against the goal and a bounded rediscovery of the host repository, fixing only what needs no invention. - Blocking question handling: Surfaces questions that change approach, files, scope, or acceptance before filling material gaps, and never invents answers silently. - Plan file write-back: Updates the original plan file in place when a source path is known, without creating new files or touching product code. - Use Case: You have a markdown plan for adding a feature to your repo. Invoke this Skill with the plan and goal; it verifies cited files, checks test coverage against real repo commands, and returns a refined plan plus a list of open questions. ## Quick Start Ask the agent to review and refine your existing draft plan against the current repository, listing any blocking questions before making assumptions.

Frequently Asked Questions about maiconfz--plan-refiner--interactive-plan-refiner

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

FAQPage Schema
How do I refine an existing implementation plan before coding?▼

Provide the draft plan as markdown text or a workspace file path along with an optional goal. The agent critiques the plan against the repository, revises only what needs no invention, and returns a refined plan with any blocking questions.

How to validate a plan against actual repository files?▼

The agent runs a bounded rediscovery of the host repository using filesystem access, reading READMEs, specs, and cited files. It checks feasibility against the current tree and points test coverage at real repo commands.

Can this agent write the first draft of a plan?▼

No, it only refines existing plans. If the draft plan is empty or unusable, it asks for markdown or a valid plan file path rather than inventing a first plan.

Does the plan refiner modify code or create commits?▼

No, it must not implement product code, commit, push, or open pull requests. The only file it may modify is the source plan file when write-back applies.

What happens when the plan has unresolved ambiguities?▼

Blocking questions that change approach, files, scope, or acceptance are listed first in the open-questions output. The agent never fills material gaps with silent assumptions, and the assumption log stays empty.