roadmap-to-improve-plans
Installation
SKILL.md
Roadmap to Improve Plans
Turn selected strategic-roadmap opportunities or accepted feature slices into grouped batches of numbered improvement plans. This is the wide planning stage: preserve the audit judgment, feature decisions, and architecture diagnosis behind each selected item, then turn it into enough detail for future executors to work safely.
Treat plan writing as meta-work: the output should improve future execution loops by carrying forward impact, risk, confidence, design claims, regression checks, approval boundaries, and STOP conditions.
This owns this pipeline's NNN plan-bank contract directly.
Source Frame
Before writing plans, load what applies:
- The selected
.agents/ROADMAP.mdor equivalent roadmap/opportunity artifact. - Accepted feature-planning artifacts when splitting a feature outline or final plan into PR-sized improvement plans.
improvefor the original audit posture: category, evidence, impact, effort, risk, confidence, fix sketch, and “not worth doing” verdicts.- The
coding-standardsskill as the canonical source for standards concerns. Load only the reference files matching the selected work; do not copy the standards into this skill or the plan. improve-codebase-architecturefor architecture/deepening candidates: current friction, shallow-module diagnosis, deletion test, locality/leverage, and recommendation strength.- DLS-style exemplar plans when present in the target repo, especially effort indexes, numbered plans, memos, rejected/deferred notes, and reconciliation logs.
- Project docs and commands:
AGENTS.md,README.md,CONTEXT.md, architecture docs, ADRs, package/test config, CI config, and current VCS state.