---
name: manage-roadmap
description: Create, maintain, synchronize, or report a traceable roadmap that preserves direction and history.
---

## Goal

Maintain an evidence-backed roadmap that preserves direction and history. It does not execute work or replace an issue tracker.

### Definition of Done

- Operation, authoritative location, mode, sources, and criteria are explicit.
- Maintained work preserves traceability, history, and a current recommended next outcome or decision.
- Read-only output distinguishes shipped, planned, blocked, and unverified work.
- Authorized edits have verified transitions and links.
- Current validation accepts the selected mode; no required finding remains.

## Workflow

1. Resolve operation, roadmap location, product evidence, current work, delivery evidence, applicable instructions, and validation criteria.
2. Keep outcomes, work, evidence, dependencies, decisions, and uncertainty traceable to their owner.
3. Recommend the next outcome or decision and its consequence. Make reversible sequencing choices from evidence.
4. For substantive roadmap work, use [Quality validation](references/vstack/protocols/quality-validation.md) with the mode, scope, candidate, and evidence; otherwise apply its feedback loop directly before authorized maintenance. Triage findings, improve the candidate, and renew affected verdicts until acceptance.
5. In maintenance mode, apply only the validated edit while preserving completed and dropped history and human decisions. Verify links, status transitions, history, and applicable checks.