improve-exec-plan

Reviews and revises an existing ExecPlan against verified repository code evidence.

2|Updated May 6, 2026
One-click install
npx skills add https://github.com/bpcakes/jig-skills --skill improve-exec-plan-bpcakes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improve-exec-plan
Source: https://github.com/bpcakes/jig-skills/tree/main/plugins/jig-exec-plans/skills/improve-exec-plan
Command: npx skills add https://github.com/bpcakes/jig-skills --skill improve-exec-plan-bpcakes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Execution plans often drift from reality: they reference wrong file paths, renamed symbols, nonexistent tests, or commands the repository does not support. This Skill audits an existing ExecPlan against the actual codebase and rewrites it in place so it is accurate, complete, and executable without changing its original intent. ## Core Features & Use Cases - Evidence-grounded verification: Deep-reads every file, symbol, payload, migration, and command the plan references and flags mismatches with reality. - Lifecycle and invariant tracing: Follows durable state through create, execute, retry, reconcile, reopen, and cleanup paths, checking that guard fields like revisions or checkpoint cursors survive every mutating path. - In-place plan rewrite: Fixes wrong paths and signatures, adds missing lifecycle coverage and compatibility notes, and appends a revision note while preserving completed progress and history. - Use Case: Before handing an ExecPlan to an implementer, run this Skill to confirm every referenced helper, test, and command actually exists and that retry and recovery paths preserve the same invariants as the main path. ## Quick Start Ask the agent to improve the ExecPlan at a specific path, for example: review and improve the ExecPlan in .agent/plans/add-retry-logic.md against the current repository code.

Frequently Asked Questions about improve-exec-plan

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

FAQPage Schema
How do I verify an implementation plan against my codebase?

Point the Skill at the plan file path or a recent plan in chat. It reads every referenced file and symbol, searches for alternate code paths, and rewrites the plan in place with corrections grounded in code it actually inspected.

What is an ExecPlan review workflow for AI coding agents?

An ExecPlan review checks a plan's accuracy, completeness, lifecycle coverage, invariant preservation, feasibility, and testability against repository evidence. This Skill pairs with a PLANS.md standard file when present and rewrites the plan at its original path.

Does it change the goal or scope of my plan?

No. The Skill preserves the plan's intent, completed progress, and history sections. It only fixes factual inaccuracies, adds code-proven missing coverage, and strengthens vague acceptance criteria.

Can it catch missing retry or recovery path handling?

Yes. It traces durable state through create, execute, retry, timeout, reconcile, reopen, and cleanup paths, checking that guard fields like revisions or checkpoint cursors are preserved on every mutating path, not just the main one.

What happens if the plan is already accurate?

If no substantive code-grounded improvements are found, the Skill leaves the plan unchanged and reports that result, avoiding surface-level rewording or unnecessary diffs.