plan-fixer

Repairs stale, ambiguous, and unresolved file references in implementation plans.

9|Updated Jun 10, 2026
One-click install
npx skills add https://github.com/eventbalancer/agent-quorum --skill plan-fixer-eventbalancer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-fixer
Source: https://github.com/eventbalancer/agent-quorum/tree/main/skills/plan-fixer
Command: npx skills add https://github.com/eventbalancer/agent-quorum --skill plan-fixer-eventbalancer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Implementation plans produced by multi-agent critique loops often contain broken file:line references — line numbers that drifted, ambiguous basenames matching multiple files, or paths that no longer exist. Manually auditing every reference in a large plan is slow and error-prone. ## Core Features & Use Cases - Pointed reference repair: Fixes three validator finding kinds — stale_lines (line beyond file length), ambiguous (basename matching multiple workspace files), and unresolved (nonexistent paths) — without rewriting the plan. - Two operating modes: Propose mode suggests fixes from plan plus findings; Apply mode incorporates reviewer concerns (blocker/major/minor/nit) and emits the final plan. - Structure preservation: Keeps YAML frontmatter, per-phase Work Plan structure, convergence coverage IDs, and System Coverage rows verbatim so downstream orchestrators can slice the plan into phase packages. - Use Case: After a bounded plan-critique loop finishes with needs-review status and a findings.json listing 12 stale line references, run this Skill to read each referenced file, correct the line numbers, and output the repaired final plan. ## Quick Start Apply the plan-fixer to the canonical plan using the validator findings to repair all broken file references and output the corrected markdown plan.

Frequently Asked Questions about plan-fixer

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

FAQPage Schema
How do I fix stale file:line references in an implementation plan?

Run the fixer in propose mode with the plan and findings.json. It reads each referenced file, locates the intended content, and updates the line number or rewrites the reference to the current location without altering surrounding plan content.

What finding types does the plan reference validator produce?

The validator emits three finding kinds: stale_lines (referenced line exceeds actual file length), ambiguous (a bare basename matching multiple workspace files), and unresolved (a path that does not exist anywhere in the workspace).

How does the fixer handle references to files that do not exist yet?

Unresolved paths that the plan intentionally creates — listed in a Created files section, Create list, or roadmap — are left untouched as valid forward references. Otherwise the fixer searches for similar names and removes dead references when nothing matches.

What is the difference between propose mode and apply mode?

Propose mode takes the plan plus findings and outputs a suggested revision. Apply mode additionally receives the proposal and a reviewer JSON with concerns; blocker and major concerns must be addressed before emitting the final plan that overwrites plan.final.md.

Does the fixer rewrite or restructure the plan content?

No. It applies only pointed reference fixes, preserving the YAML frontmatter, Work Plan phase structure, invariant and occurrence IDs, and System Coverage rows verbatim. Speculative rewrites, renumbering phases, and change-log comments are explicitly forbidden.