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.
| Field | Show | Why |
|---|---|---|
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 |
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.
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.
Related
- What to include in a product roadmapOne test for every item, plus the three things that belong on no roadmap outside the squad.
- Roadmap vs project planDifferent units, different revision rules, and how to tell which one is being asked for.
- Roadmap for executivesFour fields to show, two to hide, and why each call goes the way it does.
Last updated