Resolve items marked for review
Where markers for review come from, where you see them, and how to resolve them as not relevant, postponed or handled so the phase or story can be finished. Also how to mark a story by hand.
Updated
A marker says: something this element builds on has changed, please look at it. It never changes the element and never proposes a change. Everyone on the project team sees it, and any of them can resolve it.
Where markers come from
- A committed versionElements the team marked for review in a draft’s change plan. They read, for example, "From Discovery, version 1 → 2".
- A team memberA story marked with "Mark for review…". It reads "Marked by hand".
- A later versionA resolution holds for one change. If a later version affects the element again, it is marked again.
Find the markers
- A phase tab shows an amber count; point at it for "N elements marked for review".
- In Refinement, a story row shows "N marked".
- On the story map, marked activities, steps and stories carry a "!" that opens their marker; story cards and milestones show the count.
- Above the artifact, a bar reads "N elements marked for review".
Read one marker at a time
Click the bar to open it. It shows one marker, "1 of N", with arrows to the previous and next; postponed markers come last. On the story map, the element of the marker on screen is outlined and brought into view.
Each marker names the element, where the marker comes from and why it exists. "Details" shows the full reason and any recommendation. Badges say "Not yet assessed", "Postponed" or "Changed in this draft".
Resolve it
- "Not relevant…": asks "Why is it not relevant? (optional)", then "Resolve". No new version is needed.
- "Postpone": moves it to the end. It still counts as unresolved.
- "Handled": once you have changed the element. Offered only where the artifact can be changed now, in its draft or first run; otherwise the marker says "Start a new version to handle it."
- "Retry assessment": for a marker "Not yet assessed". The assessment then confirms it with a reason or resolves it as not relevant.
After each decision the bar moves on to the next marker.
- Reason
- up to 1,000 characters
Finish once all are resolved
While a marker is open, postponed or not yet assessed, the phase or story cannot be finished. The finish step says "N elements are marked for review. Resolve them before you finish: handled, or not relevant." and offers "Show markers". See Finish a phase and Finish a story.
Mark a story by hand
When a story needs a look that no change plan caught, open it in Refinement and choose "Mark for review…" above the artifact. "Mark this story for review" asks "Why does this story need a review?"; the reason is required. Only stories can be marked by hand.
An edit does not resolve it
Changing the element is not enough. A marker on an element you changed in the draft says "Changed in this draft": choose "Handled" when the change is done.
Marked stays finished
A finished story or phase stays finished when it is marked. To handle the marker, start its next version; see Versions and drafts.
