pm-roadmap — Roadmap update

SkillDev tools

Summarizes iteration status, assesses milestone progress, records priority changes, tracks dependencies, and produces a Now/Next/Later roadmap with delay attribution across 5 causes, a health score, and a scope-trimming framework for resource shortfalls. User-invoked only — do NOT auto-trigger. Trig

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the pm-roadmap — Roadmap update skill

What this skill tells your AI

The instructions your AI receives, as published by serejaris/personal-corp-os in skills/pm-roadmap/SKILL.md and read by ahel’s review.

Part of the Personal Corp framework — running a one-person business through AI agents. Aggregate current iteration status, evaluate milestone progress, track priority changes and dependencies, output a roadmap status overview and planning suggestions.

Inputs

FieldRequiredNotes
Iteration statusyesCurrent Sprint task list and statuses (manual or pulled from PM tool)
Roadmap horizonnoQuarter / half / year; default quarter
ChangesnoItems needing priority or timeline adjustment + reason
DependenciesnoCross-team / tech dependencies and current state

Step 1 — Get current state

If a PM tool integration is available, pull the current Sprint task list and bucket by status. Otherwise ask the user for the list in any format (table, screenshot, verbal).

Step 2 — Iteration status summary

FieldValue
Sprint name / period{Sprint X / date range}
Planned tasks{N}
Done{X} ({X/N%})
In progress{Y}
Not started{Z}
Blocked / delayed{W}
Estimated on-time delivery{%}

Delayed-task analysis:

TaskOriginal dueNew ETAReasonMilestone impact
{task}{date}{date}{cause}yes/no

Five-cause delay attribution:

CausePatternImprovement
Scope changeMid-development requirement edits, scope creepStrengthen requirement freeze; route changes through approval
Estimation gapActual effort far exceeds estimateCalibrate from history, add buffer
Tech riskApproach proves infeasible, perf wall, tech debt blockingPre-development tech-spike phase
Dependency blockWaiting on another team / third party / approval2-week-ahead dependency early-warning
Headcount changePTO, attrition, redirected20% capacity buffer in planning

If the same root cause appears 3+ times, escalate to a process-improvement item.

Step 3 — Milestone progress

MilestoneTarget dateKey deliverableProgressStatusRisks
{M1}{date}{deliverable}{X%}On-time / at-risk / delayed{risk}

Status criteria:

  • On-time: progress ≥ time elapsed; no blocking deps
  • At-risk: progress slightly behind, or unresolved dependency
  • Delayed: progress significantly behind, or critical dependency blocked

Step 4 — Priority change log

ItemChangeOld priorityNew priorityReasonImpact
{item}Up / down / new / removed{P0/P1/P2}{P0/P1/P2}{reason}{scope}

Change-reason categories:

  • User-feedback driven (from /pm-feedback)
  • Competitor driven (from /pm-competitive)
  • Data driven (from /pm-metrics)
  • Resource change (team capacity, tech approach change)
  • External (compliance, partner ask)

Step 5 — Dependency tracking

DependencyTypeOwner / consumerNeed-byStateRisk
{desc}Tech / team / external{who depends on whom}{date}Resolved / in progress / blockedHigh / medium / low

Dependency types:

  • Tech: infrastructure, APIs, services
  • Cross-team: other product lines, design, data team
  • External: third-party services, partners, approval flows

Step 6 — Forward-looking plan

Recommend the next 2-3 iterations.

Now / Next / Later view:

HorizonItemsPriorityConfidenceDependencies
Now (current iteration){in-flight work}LockedHigh{resolved}
Next (1-2 iterations out){planned work}Locked / TBDMedium-high{to follow up}
Later (3+ iterations out){directional plans}DirectionalLow-medium{to evaluate}

Capacity assessment:

  • Available capacity next iteration: {X} person-days
  • Allocation suggestion: 70% planned features + 20% tech debt + 10% buffer
  • Given current delays, prioritize next: {list}

Roadmap health score:

DimensionWeightScoringScore
On-time delivery rate30%> 80% = 5, 60-80% = 3, < 60% = 1{X}
Scope stability20%Change < 10% = 5, 10-30% = 3, > 30% = 1{X}
Dependency resolution20%> 90% = 5, 70-90% = 3, < 70% = 1{X}
OKR alignment15%All work traces to OKR = 5{X}
Team confidence15%Team confident on timely delivery = 5{X}

Composite: weighted total ≥ 4 healthy / 3-4 at-risk / < 3 needs urgent action.

Feature-cut decision framework (when capacity is short):

Cut firstReasonCondition
Nice-to-haveDoesn't affect core valueCut directly
Splittable feature's second halfMVP-firstConfirm MVP standalone usable
Polish / perfectionismFunctional > perfectNo irreversible tech debt introduced
Low-confidence requirementsUnvalidated hypothesesTag "deferred for validation"

Principle: cut scope > delay > add people (Brooks's Law: adding people to a late project makes it later).

Step 7 — Output report

# Roadmap Update

**Date:** {date}
**Horizon:** {quarter / half}
**Current iteration:** {Sprint name / dates}

## 1. Current Iteration Status
Completion rate: {X%} ({done}/{total})
Blockers: {N}

## 2. Milestone Progress
| Milestone | Target | Progress | Status |
|---|---|---|---|

## 3. Priority Changes
| Item | Change | Reason |
|---|---|---|

## 4. Dependencies & Risks
- High-risk dependencies: {desc}
- Coordination needed: {desc}

## 5. Roadmap (Now / Next / Later)
(table)

## 6. Next-Step Recommendations
1. {recommendation 1}
2. {recommendation 2}
3. {recommendation 3}

Quality bar

  1. Status info accurate — delayed tasks have specific cause + new ETA
  2. Milestone evaluation evidenced — no "almost done" / "soon"
  3. Changes traceable — every priority change records reason and decider
  4. Risks raised proactively — not waiting for blow-up to report
  5. Recommendations actionable — owner-assignable
  6. Health score tracked over time to observe improvement trend

Roadmap-communication guide

Different audiences need different granularity:

AudienceFocusFormatCadence
CEO / VPStrategy, milestones, risksNow/Next/Later high-levelMonthly
EngineeringSprint tasks, deps, tech detailDetailed task list + dep graphDaily / weekly
Sales / CSCustomer-promised features, ETAsFeature timelineMonthly
External customersUpcoming capabilitiesQuarterly themes (no dates)Quarterly

Three rules:

  1. Don't promise specific dates externally — promise "Q2", not "April 15"
  2. Don't hide delays — early bad news beats late bad news
  3. Don't treat the roadmap as a contract — plans change

Red lines

  1. No hidden delays — report delays honestly
  2. No false promises — don't be over-optimistic on future timelines
  3. No ignored dependencies — cross-team dependencies are tracked explicitly

When input is incomplete

  • No task list → ask for at least milestones + key deliverables status
  • No priority changes recorded → output current state only, tag "recommend logging changes"
  • First use, no history → help build the baseline framework

Related skills

  • /pm-prioritize — re-rank items in the roadmap
  • /pm-metrics — metric review feeds roadmap adjustments
  • /pm-brainstorm — explore innovation directions for the Later column

Signals

GitHub stars
226
Forks
27
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
pm-roadmap-serejaris
Source
github.com/serejaris/personal-corp-os