refine-plan

Translate finished specs into status-bearing implementation plans with history tracking.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Iteratively translate a finished or nearly-finished spec into a detailed, status-bearing implementation plan, surfacing missing spec decisions and tracking open items.

Core Features & Use Cases

  • Translate requirements into actionable, step-by-step plans with explicit statuses
  • Maintain an iteration history and open-item tracking for governance
  • Enforce DoR/DoD-style checks and surface scope risks for timely decisions

Quick Start

Provide the current spec and any user decisions; refine-plan will append a new iteration with explicit statuses and an updated history.

Frequently Asked Questions about refine-plan

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

FAQPage Schema
How do I translate requirements into an actionable implementation plan?

To translate requirements into an actionable implementation plan, you provide a finished spec and any user decisions. The system structures the spec into trackable, step-by-step actions with explicit statuses, acceptance criteria, and iteration history.

What is the best way to track unresolved spec gaps during iteration planning?

Unresolved spec gaps during iteration planning are surfaced and preserved as non-blocking markers like [MISSING SPEC ...] or [DECISION SPEC ...]. This highlights missing decisions for timely resolution without halting the overall implementation process.

How do I enforce Definition of Ready and Definition of Done checks for spec translation?

To enforce Definition of Ready and Definition of Done checks during spec translation, the system applies governance rules to decompose specs. It surfaces scope risks and tracks open items to ensure requirements meet acceptance criteria before execution.

Can I maintain iteration history and open-item tracking for requirements management?

Yes, you can maintain iteration history and open-item tracking for requirements management. The system appends new iterations with explicit action statuses, ensuring full governance and continuous tracking of open items throughout the project lifecycle.

What happens when there are missing decisions in my spec decomposition process?

When missing decisions occur in the spec decomposition process, the system surfaces them as explicit markers like [DECISION SPEC ...]. These markers are preserved as non-blocking items to prompt timely decisions while keeping the actionable plan moving forward.

Does spec translation work for teams decomposing nearly-finished specifications?

Yes, spec translation works for teams decomposing finished or nearly-finished specifications. It iteratively structures requirements into a detailed, status-bearing implementation plan, surfacing any remaining gaps and tracking open items for final governance.