refine-plan

Audit in-progress plans against completed phases and capture drift.

1|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/zeveck/zskills-dev --skill refine-plan-zeveck
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine-plan
Source: https://github.com/zeveck/zskills-dev/tree/main/.claude/skills/refine-plan
Command: npx skills add https://github.com/zeveck/zskills-dev --skill refine-plan-zeveck

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Refine in-progress plans by auditing remaining phases against completed work, surfacing drift, and enforcing immutability of shipped content. It adds a Drift Log and Plan Review trail to keep plans aligned with actual progress.

Core Features & Use Cases

  • Adversarial reviewer and devil's advocate cycles surface stale references, missing specifications, and scope drift between planned and completed work.
  • Phase-aware editing touches only the remaining phases, while completed content remains immutable and verifiable via checksums.
  • Generates a structured refinement workflow with Drift Log, Plan Review, and convergence checks to support robust project execution across multiple rounds.

Quick Start

Run /refine-plan against a current plan file to start an adversarial refinement round.

Frequently Asked Questions about refine-plan

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

FAQPage Schema
How do I refine an in-progress plan to fix scope drift between completed and remaining phases?

Plan refinement audits remaining work against completed phases to capture scope drift. Adversarial reviewer cycles surface stale references and missing specifications, iterating until convergence to produce a formal plan update.

What is adversarial plan review and how does it work?

Adversarial plan review dispatches devil's advocate reviewers to surface references, assumptions, and gaps in remaining work. It iterates until convergence, preserving the immutability of shipped work while generating a formal review trail for audits.

How do I prevent edits to completed phases when updating my project plan?

Phase-aware editing touches only the remaining phases of your project plan, while completed content remains immutable and verifiable via checksums. This ensures shipped work is preserved during the refinement cycle.

Can I track drift between planned and actual project execution?

Yes, tracking drift between planned and actual execution generates a structured Drift Log and Plan Review trail. These convergence checks support robust project execution across multiple refinement rounds.

What is the best way to audit remaining work against completed phases?

Auditing remaining work against completed phases dispatches adversarial reviewers to surface stale references and missing specifications. It produces a formal plan update cycle with in-place writes and a review trail for audits.

When should I not use automated plan refinement cycles?

Automated plan refinement cycles target in-progress plans needing drift correction. If your project phases are fully complete or lack a formal plan file to audit, refinement cannot capture drift or iterate to convergence.