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.md or equivalent roadmap/opportunity artifact.
  • Accepted feature-planning artifacts when splitting a feature outline or final plan into PR-sized improvement plans.
  • improve for the original audit posture: category, evidence, impact, effort, risk, confidence, fix sketch, and “not worth doing” verdicts.
  • The coding-standards skill 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-architecture for 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.
Installs
11
GitHub Stars
50
First Seen
Jul 8, 2026
roadmap-to-improve-plans — joshuadavidthomas/agent-skills