home/roleplay/apply-roadmap-review

Apply Roadmap Review

GPTClaudeGemini··312 copies·updated 2026-07-14
apply-roadmap-review.prompt
# Roadmap Review — Apply Accepted Refresh

You are Codex.

Goal:
Apply an accepted roadmap review packet to repository planning docs, then stop before any slice execution work starts.

## Preconditions
- Review packet exists at `changes/<yyyy-mm-dd>-roadmap-review-<slug>/`
- `ROADMAP_REVIEW.md` exists
- the human has accepted the review packet for application
- the verdict in `ROADMAP_REVIEW.md` is `REFRESH_NOW`
- `ROADMAP_PATCH.md` exists
- `DOC_IMPACT.md` exists

If any precondition fails, stop and report exactly what is missing.

## Read order
1) `ROADMAP.md`
2) `SPEC.md`
3) `ARCHITECTURE.md`
4) `README.md`
5) `docs/runbook.md`
6) `changes/<...>/ROADMAP_REVIEW.md`
7) `changes/<...>/ROADMAP_PATCH.md`
8) `changes/<...>/DOC_IMPACT.md`

## What to update

### A) ROADMAP is mandatory
Apply `ROADMAP_PATCH.md` into `ROADMAP.md`:
- preserve the roadmap format and style already used in the repo
- apply milestone, status, sequencing, and dependency changes exactly
- keep the roadmap milestone-level, not task-level
- do not create a new active slice pointer unless explicitly instructed

### B) Supporting docs are conditional but strict
Use `DOC_IMPACT.md`:
- if SPEC impact is `required`, update only the named sections in `SPEC.md`
- if ARCHITECTURE impact is `required`, update only the named sections in `ARCHITECTURE.md`
- if README/runbook impact is `required`, update only the named sections and keep changes factual
- if ADR impact is `required`, create `docs/adr/<yyyy-mm-dd>-<slug>.md` with:
  - Context
  - Decision
  - Alternatives
  - Consequences
- if any impact is `optional` or `none`, do not edit that document in this step

### C) No execution work in this step
Do not create or update:
- `changes/<slice>/PLAN.md`
- `changes/<slice>/TASK_QUEUE.md`
- `changes/<slice>/NOW.md`
- implementation code
- PR or release artifacts

This step is planning truth sync only.

## Validation checklist
- [ ] `ROADMAP.md` updated and internally consistent
- [ ] Supporting doc changes match `DOC_IMPACT.md`
- [ ] Required ADR created if flagged
- [ ] No implementation or slice execution files created

## Output (chat)
Return:
1) files changed
2) what changed in roadmap sequencing or status (short bullets)
3) whether SPEC / ARCHITECTURE / README / runbook / ADR changed (and why)
4) exact next prompt to run:
- usually `prompts/3-dev/00-driver-plan.md`
- if strategy questions remain unresolved, return to `prompts/7-roadmap-review/01-roadmap-review.md`

when to use it

Community prompt sourced from the open-source GitHub repo kylehuirevvision/repo-rails (MIT). A "Apply Roadmap Review" style prompt — adapt the placeholders and specifics to your task. Imported as-is and not independently retested here, so check the output before relying on it.

tags

roleplaycommunitygeneral

source

kylehuirevvision/repo-rails · MIT