Roadmap Planning skill for Codex

Problems and metrics on the roadmap, not feature dates. Codex groups requests into customer problems, links each to a strategic goal and metric, and places them in Now, Next and Later horizons with confidence that falls off honestly over time. It checks squad capacity and cross-team dependencies, writes an explicit not-doing list, cuts audience-specific views from a single source, and never shares externally without your approval.

  • Product Management
  • $roadmap-planning
  • 138 lines
  • 2 files
  • ~1,500 tokens
  • MIT
  • Updated

Install

curl -fsSL codexskills.dev/install.sh \  | sh -s -- roadmap-planning

Installs to ~/.agents/skills/roadmap-planning/ for every project on this machine.

104-line POSIX script. No sudo, no telemetry. Read install.sh

Use it in Codex

Start a prompt with $roadmap-planning, or pick it from /skills. You can also just describe the task: Codex reads the description below and loads the playbook when your request matches.

What Codex reads before loading it

Builds outcome-based product roadmaps in Now / Next / Later form - each item framed as a customer or business problem with a target metric, confidence level and evidence rather than a feature with a date - plus a stakeholder-specific view, a dependency check and a quarterly review routine. Converts feature-list or Gantt roadmaps into outcome themes. Use when asked to create or rework a product roadmap, plan the next quarter or half, explain roadmap changes to stakeholders, or turn a list of feature requests into a strategy-linked plan.

Use it when

  • You are planning the next quarter or half for a product team
  • The current roadmap is a dated feature list that keeps slipping
  • Stakeholders need a roadmap view without promises the team cannot keep
  • Requests from sales, support and leadership need to be reconciled

Use something else when

How to check the result

Every Now and Next item has a goal link, metric, owner and confidence, Now items do not exceed two per squad, and the not-doing list is populated.

The mistake it prevents

Putting dates on Later items, which turns low-confidence ideas into commitments sales will repeat to customers.

~/.agents/skills/roadmap-planning/SKILL.md

--- name: roadmap-planning description: Builds outcome-based product roadmaps in Now / Next / Later form - each item framed as a customer or business problem with a target metric,… license: MIT ---

A roadmap is a statement of intent about which problems the team will solve, in what order, and why. It is done well when every item traces to a strategic goal and a metric, confidence drops visibly the further out it goes, and a stakeholder can tell what will not happen this quarter.

Format: Now / Next / Later with outcomes

HorizonTypical spanContentConfidence
NowCurrent 4-8 weeksCommitted problems with chosen solutions in flightHigh; scope known
NextFollowing 1-3 monthsValidated problems, solution still being shapedMedium
Later3-12 monthsProblems worth solving, little or no solution workLow; may change or drop

Use dates only for genuine external commitments (contract, regulation, event). Mark them as such. A date on a Later item is a promise the team cannot keep.

Each roadmap item is an outcome card, not a feature:

### Reduce first-week drop-off for self-serve teams
Goal link: FY27 goal 2 - grow self-serve revenue
Metric: % of new workspaces with 3+ active members by day 7 (now 22%, target 35%)
Evidence: churn interviews (9 of 14 cited "couldn't get team on board"), funnel data
Candidate solutions: invite flow redesign, Slack invite, starter templates
Confidence: medium | Horizon: Next | Owner: Growth squad
Not doing: enterprise SSO onboarding (separate item, Later)

Workflow

- [ ] 1. Collect inputs: strategy/goals, OKRs, metrics, research, requests, commitments
- [ ] 2. Read the existing roadmap and what shipped last period vs what was planned
- [ ] 3. Group requests and ideas into problems (themes), not features
- [ ] 4. Link each problem to a goal and a metric; drop or park orphans
- [ ] 5. Prioritize problems (see $prioritization-frameworks for scoring)
- [ ] 6. Check capacity and dependencies; place into Now / Next / Later
- [ ] 7. Write the "Not doing" list
- [ ] 8. Produce audience views; review with the user before sharing

Step 3: from requests to problems

Ask “what would the customer be able to do, or stop suffering, if we built this?” for each request. Requests with the same answer belong to one problem. Example: “CSV import”, “Trello importer” and “copy from spreadsheet” all collapse into “New teams cannot bring existing work in, so they start empty”.

Step 6: capacity and dependency check

  • Count teams (or squads), not people. Rule of thumb: a squad holds 1-2 Now items. More than that per squad means Now is a wish list.
  • Reserve 20-30% of capacity for bugs, tech debt and unplanned work. Write the reserve on the roadmap so it is not silently consumed.
  • For every Now item, list cross-team dependencies with a named contact and whether the other team has it in their own Now. A dependency on another team’s Later is a risk.

Converting a feature roadmap

Given a Gantt chart or feature list:

  1. Ask what problem each feature solves; record the answer next to it.
  2. Merge features that solve the same problem into one outcome card.
  3. Features whose problem nobody can state go to an “Unclear rationale” list for the owner to justify or drop. Do not silently delete them.
  4. Replace dates with horizons except true external commitments.
  5. Show the old and new side by side so stakeholders see nothing was lost.

Audience views

Same roadmap, different cuts. Never maintain separate roadmaps that can drift.

AudienceShowHide
Leadership / boardThemes, goal links, metrics, major risksSolution details, squad assignments
EngineeringNow items with scope, dependencies, reserved capacitySales commitments detail
Sales / CSProblems being solved, what is Now vs later, what is not plannedInternal metrics, confidence scores, any date not committed
Customers (public)Now and Next themes in customer languageLater, internal metrics, anything uncommitted

Sharing a roadmap externally (customer email, public page, sales deck) is an outward communication: show the exact text to the user and get approval before sending or publishing anything.

Review routine

Run monthly for Now, quarterly for the whole roadmap:

  • What moved from Now to shipped? Did the metric move?
  • What new evidence changed confidence on Next or Later items?
  • What was added, and what was removed or pushed to make room?
  • Record changes in a changelog section at the bottom with a one-line reason each.

Output template

# <Product> roadmap - <period>
Strategy: <1-2 sentences> | Last reviewed: <date> | Owner: <name>

## Now (committed)
<outcome cards>
## Next (shaping)
<outcome cards>
## Later (exploring)
<one-line problem statements with goal links>
## Not doing this period
- <item> - <reason>
## Capacity
<squads, reserve %, known constraints>
## Changes since last version
- <date>: moved X from Next to Now because <evidence>

Gotchas

  • A roadmap with 15 Now items is a backlog. Push back with the capacity math.
  • Outcome language can hide vagueness: “improve onboarding” is still a feature-free slogan unless it names the metric and target.
  • Sales requests for dates on Later items: give the horizon and the confidence, not a date, and offer to revisit when the item reaches Next.
  • Do not invent metric baselines. Write “baseline unknown - instrument first”.
  • Keep tech-platform work on the roadmap as outcomes too (“cut deploy time to under 15 min so squads ship daily”); hidden platform work steals capacity invisibly.

Verification

Check that every Now and Next item has a goal link, metric, owner and confidence; every goal in the strategy has at least one item (or an explicit reason it does not); the number of Now items does not exceed squads x 2; and the Not doing list is non-empty. Read the sales view as if you were a customer: no sentence should read as a promised date that the team has not committed to.

What the zip contains

SKILL.md plus the interface file below. Nothing runs on install.

agents/openai.yamlgenerated from this page

Gives the Codex app a display name, a one-line description and a starter prompt for this skill.

interface:
  display_name: "Roadmap Planning"
  short_description: "Problems and metrics on the roadmap, not feature dates"
  default_prompt: "$roadmap-planning Turn this list of 40 feature requests into an outcome-based roadmap for next half"

About this skill

Written and maintained by the Codex Skills editors to the same editorial standard as every skill here: a selective description, a real workflow, known pitfalls and a way to verify the work. First published , last updated . MIT licensed. Something wrong or out of date? Tell us.

esc
Just launched

Codex Skills Pro is live

79 premium skills for Codex, each with scripts, references and an evidence report that proves the result.

Bought one by one$882.21
All 79 skills$49
94% off

That's $0.62 a skill, paid once.

Get all 79 for $49Or pick single skills from $4.99 →

Secure checkout by Creem