What does the roadmap generator produce?

A themes-by-periods grid: one row per theme (Reliability, Developer experience, Cost), one column per period (quarters, months, releases), and a chip per item spanning from its start period to its end, coloured by status — done, current, next, risk. A now marker rules the current period so the reader sees at a glance what is behind, in flight and ahead.

How is this different from a Gantt chart or a timeline?

A Gantt is dated tasks with dependencies — use it when the question is scheduling. A timeline is dated events. A roadmap is coarser and thematic: what ships in which period, grouped by why. Chiltepin has all three as typed blocks (gantt, timeline, roadmap), and the skill picks by the reader's question rather than by the word in the request.

Can an AI agent write the roadmap?

Yes. After npx skills add jdiejim/chiltepin -g the agent knows the block, runs chiltepin block roadmap for the contract, and writes it from "lay out the 2026 platform roadmap by theme and quarter". It can read the issue tracker export or the planning doc you point it at, and the result arrives as a diff — validated before you see it.

Is there a roadmap template?

Yes — roadmap is one of the document templates that ship with the tool: a finished roadmap document with the themes grid, the milestones as a timeline and the risks, that you edit rather than fill in. Open it at chiltepin.dev/studio?template=roadmap, or scaffold it locally with chiltepin new roadmap.

Does the roadmap work as slides?

Any Chiltepin document is also a deck: chiltepin slides turns each heading into a slide, and the roadmap block re-lays itself out for the stage at presentation size. A status change is one word in a pull request, and both the page and the deck follow.

Planning tool

A roadmap generator that lives in the repo

A roadmap answers what ships when, by theme, and where are we now? Most live in a slide deck two quarters behind. Chiltepin keeps the roadmap as a typed block in Markdown next to the plans it summarises: your agent writes it, chiltepin check verifies it, and the page and the deck render from the same file.

The block and its render

This is the roadmap starter template: periods, themes, a now marker and one item per chip with from, an optional to, and a status.

```roadmap
title: Platform roadmap 2026
periods: [Q1, Q2, Q3, Q4]
now: Q3
themes: [Reliability, Developer experience, Cost]
items:
  - { label: Multi-region Postgres, theme: Reliability, from: Q1, to: Q2, status: done }
  - { label: Chaos game days, theme: Reliability, from: Q3, status: current }
  - { label: Preview envs per PR, theme: Developer experience, from: Q2, to: Q3, status: current }
  - { label: Golden-path templates, theme: Developer experience, from: Q4, status: next }
  - { label: Spot instances for batch, theme: Cost, from: Q2, status: done }
  - { label: Egress cut 30%, theme: Cost, from: Q3, to: Q4, status: risk }
```

SECTION 01 · Roadmap

Platform roadmap 2026

ROADMAP

Legenddonecurrent — in progressnext / plannedrisknow

Three themes across four quarters; the now rule marks Q3. Status is drawn in form as well as colour, and an item is one line, so a change is a one-line diff.

How to generate one

Install the skill. Run npx skills add jdiejim/chiltepin -g once. It installs the Chiltepin authoring skill into Claude Code, Cursor, Codex, Copilot and 70+ other agents.
Ask for the roadmap. "Write the 2026 platform roadmap in docs/roadmap.md: Reliability, Developer experience and Cost by quarter; we are in Q3." The agent runs chiltepin block roadmap for the contract and writes the block.
Check it. npx chiltepin check reports an item whose theme or period does not exist, or an unknown status, with a stable code and the fix. The agent repairs it before handing off.
Render it. npx chiltepin html docs/roadmap.md -p renders the page; npx chiltepin slides docs/roadmap.md -p makes the deck for the planning review. The renderer lays out the grid — never the model.

Roadmap, chevrons, gantt or mind map?

The skill picks by the reader's question. Quarters × themes is a roadmap; phases with the current one lit is a chevrons strip; dated tasks with dependencies is a gantt; unordered ideas around a topic is a mind map; work in flight is a kanban. All of them are in the planning reference and the catalog.

Part of the planning doc

A roadmap sits at the top of a planning document, followed by the OKRs, the risks and the user story map. Chiltepin renders the whole document — a growing set of typed blocks, one grammar — to a static site, slides or PDF. Start from the roadmap template, or paste a block into the playground.

Frequently asked questions

What does the roadmap generator produce?: A themes-by-periods grid: one row per theme (Reliability, Developer experience, Cost), one column per period (quarters, months, releases), and a chip per item spanning from its start period to its end, coloured by status — done, current, next, risk. A now marker rules the current period so the reader sees at a glance what is behind, in flight and ahead.
How is this different from a Gantt chart or a timeline?: A Gantt is dated tasks with dependencies — use it when the question is scheduling. A timeline is dated events. A roadmap is coarser and thematic: what ships in which period, grouped by why. Chiltepin has all three as typed blocks (gantt, timeline, roadmap), and the skill picks by the reader's question rather than by the word in the request.
Can an AI agent write the roadmap?: Yes. After npx skills add jdiejim/chiltepin -g the agent knows the block, runs chiltepin block roadmap for the contract, and writes it from "lay out the 2026 platform roadmap by theme and quarter". It can read the issue tracker export or the planning doc you point it at, and the result arrives as a diff — validated before you see it.
Is there a roadmap template?: Yes — roadmap is one of the document templates that ship with the tool: a finished roadmap document with the themes grid, the milestones as a timeline and the risks, that you edit rather than fill in. Open it at chiltepin.dev/studio?template=roadmap, or scaffold it locally with chiltepin new roadmap.
Does the roadmap work as slides?: Any Chiltepin document is also a deck: chiltepin slides turns each heading into a slide, and the roadmap block re-lays itself out for the stage at presentation size. A status change is one word in a pull request, and both the page and the deck follow.

Open the roadmap template Set up your agentnpx skills add jdiejim/chiltepin -g