Skip to contentRoadmapStar

Roadmap for an engineering team: what to show and what to hide

An engineering view is the one that hides almost nothing. Show owner, status, dependencies and real start and end dates. Hide the Now, Next and Later stage, which exists to answer when for people who cannot see the dates. Keep the item at problem level and link out to the tracker.

What to show this audience, and what to leave out
FieldShowWhy

Name

Yes, at problem level

An item named after its ticket stops being reviewable, because nobody outside the squad can tell what it is for

Dependencies

Yes

The only field that changes what somebody does on Monday; a hidden arrow becomes a fortnight of waiting discovered at standup

Dates

Exact start and end

A quarter hides the overlap between two items, and the overlap is what decides whether one person can do both

Owner

Yes, gaps included

The empty cell is the signal you want in planning, and filling it with a placeholder removes it

Status

Yes

The one audience that can act on blocked, so hiding it moves the same conversation to standup and slows it down

Notes

Yes

Carries the constraint that explains why the estimate looks wrong, which is the thing that otherwise gets relitigated every planning session

Link

Yes

The roadmap should stop where the tracker starts, and the link is where that boundary lives

Milestone

Yes

An external date is the one thing the team cannot renegotiate, so it belongs on the same canvas as the work it constrains

Stage

No

A translation layer for readers who cannot see the dates. On a view that shows them, it is a second and slower answer to the same question

Jul 2026
1234567
891011121314
15161718192021
22232425262728
2930311234
567891011
Priya
Search returns results that are hours old
Exact-match queries rank below fuzzy ones
Sam
Reindexing blocks writes for minutes at a time
Release freeze
Wei
The item endpoint is slow for large roadmaps
No owner
We are two majors behind on Postgres
The delivery view of this starter, exactly as the image export draws it. Every field is described in the table above.
Open this templateFree · No account · Runs in your browser

Every other version of this roadmap is an exercise in taking fields off. This one isn’t. The squad is the audience the file was built for, and the starting position is that everything stays on until there’s a reason to remove it. There’s exactly one field worth removing, and it isn’t the one people expect.

Turn off Now, Next and Later

Stage exists to answer when for readers who aren’t shown the dates. That’s a real job on a leadership or customer view, where a quarter is too precise and silence is too vague. On a view with actual start and end dates on it, stage is a second answer to a question the first answer already handled, and a slower one, because somebody has to keep it in step with the dates by hand. Two fields answering one question is where a roadmap starts disagreeing with itself.

Turn it off in the engineering view and leave it in the file. The leadership view reads it from the same items.

Quarters hide the thing you’re planning

Exact start and end dates, not quarters. A quarter tells you two items happen between January and March. It doesn’t tell you they overlap for three weeks in February, and the overlap is the entire question: whether one person can take both, whether the contractor’s window is long enough, whether the January hire matters.

This is the point where a roadmap starts to resemble a schedule, and the line is worth being deliberate about. Roadmap vs project plan sets out the difference in revision rules — a roadmap is expected to change, a plan changes through a process. An engineering view sits closer to the plan end without becoming one, and what keeps it there’s item size.

Where does the roadmap stop and the tracker start?

The link field is the boundary. An item on the roadmap names a problem and points at the ticket or the spec where the work is decomposed. When the item has shrunk to something a pair could finish in a sprint, it belongs in the tracker and comes off the roadmap.

Get this wrong and you have two systems holding the same status, one of which is always stale. Keeping a roadmap up to date is the general form of that problem. The engineering-specific form is that developers update the tracker because their own work depends on it, and update the roadmap because you asked them to, and you can tell which is which by looking at the dates.

If the squad already thinks in columns, a kanban roadmap template is the closer fit than a timeline: it keeps blocked and shipped as places an item sits rather than fields somebody maintains, which is one fewer thing to keep in step with the tracker. Keep status on the roadmap at item level only, and let the ticket carry the detail. One place per fact.

Leave the owner cell empty when it’s empty

The gap is the useful part. An item with nobody against it in the quarter you’re planning is either unowned work or work you haven’t staffed, and both need saying out loud in the session. Filling the column in advance with whoever will probably end up doing it removes the signal and commits them without the conversation.

Dependencies stay on for a matching reason. Turning the arrows off tidies the picture and moves the discovery to standup two weeks later, at a higher price.

What the squad view owes everyone else

One set of items, several saved views. Hiding a field is a property of the view, not of the data: the value stays in the file, the leadership view still reads it, and anyone you send the file to gets all of it. That’s what makes what to include in a product roadmap a question you answer once rather than eight times.

It also means this view can be the maximal one without costing anybody else anything. Every other audience is a subtraction from what the squad already keeps, so the work of serving them is done the moment this view is complete.

Open this templateFree · No account · Runs in your browser

Common mistakes

  • Duplicating the issue tracker. If an item carries a status somebody updates in two places, one of the two is already wrong.

  • Hiding dependencies because the view looks cluttered. The clutter is the schedule, and a hidden arrow is a fortnight nobody saw coming.

  • Keeping quarters on the engineering view. A quarter hides the overlap between two items, and the overlap is the thing being planned.

  • Filling in every owner before the work starts. The gap in the column is the signal, and a placeholder name removes it.

  • Letting items grow into tasks. Once an item is small enough to finish in a sprint, it belongs in the tracker and off the roadmap.

Questions

Should the engineering roadmap live in the issue tracker instead?

No, because a tracker can’t show the quarter after next without becoming a backlog. Keep the roadmap at problem level and link each item to the ticket where the work is decomposed.

Why hide Now, Next and Later from the squad?

It answers when for readers who aren’t shown the dates. The squad can see the dates, so the field is a second answer that somebody then has to keep in step by hand.

How far out should exact dates go?

About two quarters. Past that the end date is a placeholder, and a placeholder drawn at the same weight as a real date is worse than a quarter would have been.

What happens to an item once work starts?

It stays, and the ticket carries the detail. When an item shrinks to something a pair finishes in a sprint, it has become a task and comes off the roadmap.

Last updated