plan-refine

Cross-check implementation plans with Codex through discovery, triage, verification, and modification cycles.

4|Updated Jul 16, 2012
One-click install
npx skills add https://github.com/takashabe/dotfiles --skill plan-refine-takashabe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-refine
Source: https://github.com/takashabe/dotfiles/tree/main/.claude/skills/plan-refine
Command: npx skills add https://github.com/takashabe/dotfiles --skill plan-refine-takashabe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan refinement helps teams cross-check implementation plans and design documents with Codex, then polish them through a structured cycle of discovery, triage, verification, and modification, explicitly surfacing residual risk.

Core Features & Use Cases

  • Codex-assisted review cycle: cross-checks plans before implementation to catch gaps and inconsistencies.
  • Structured triage and verification: classify findings by severity and stage, and verify fixes before applying.
  • Residual-risk signaling: document unresolved issues to guide subsequent work and risk management.

Quick Start

Start by selecting the target plan document (PLAN.md or plan.md), run the discovery workflow against Codex as described, and review the generated findings to begin refinement.

Frequently Asked Questions about plan-refine

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

FAQPage Schema
How do I cross-check an implementation plan for gaps before coding?

Plan refinement cross-checks implementation plans with Codex through a structured discovery, triage, verification, and modification cycle to catch gaps and inconsistencies before implementation begins.

What is residual-risk signaling in design document review?

Residual-risk signaling documents unresolved issues discovered during plan refinement to guide subsequent work and risk management, ensuring remaining gaps are explicitly surfaced for downstream teams.

How do I triage findings when reviewing a design document with Codex?

You triage findings by classifying them by severity and stage during the plan refinement cycle, then verifying fixes before applying modifications to the design document.

Can I use plan refinement for iterative fix-verification on large corrections?

Yes, plan refinement supports optional iterative fix-verification cycles when large corrections are needed, allowing repeated verification and modification until the plan is polished.

Does plan refinement require explicit frontmatter in plan documents?

Yes, plan refinement enforces explicit frontmatter and plan structure alignment so the final plan remains auditable after the discovery, triage, and verification cycles are completed.

What's the best way to start refining a PLAN.md file?

Select the target plan document, run the discovery workflow against Codex as described, and review the generated findings to begin the structured refinement cycle.