Align phase-oriented repository docs without mixing their roles. Use when current phase, completed scope, active slice, tag baseline, next-step sequencing, or long-term product strategy changed and `docs/project-status.md`, `docs/roadmap.md`, `docs/project-plan.md`, and `docs/product-strategy.md` must be checked together for drift.
Use this skill when the same implementation change affects status, roadmap, planning navigation, or long-term strategy docs at once. Keep it focused on role separation: current repository reality belongs in project-status, active release-line milestone and slice sequencing belong in roadmap, planning navigation belongs in project-plan, and long-term product strategy belongs in product-strategy.
project-planproject-statusroadmap into release history or a full endpoint catalogproject-plan remains a short planning entry point and does not duplicate project-status, roadmap, or product-strategyroadmap duplicates release history or detailed public contract textWhen the previous roadmap next-step has already been consumed by code, tests, and reference docs, use the phase sync to advance the active slice explicitly rather than leaving the roadmap one step behind.
Apply this rule when:
roadmap next-step is now part of the current baselineproject-status and roadmap wording rather than long-term strategyIn that case, sync the files this way:
Do not leave an already-completed hardening step described as the current next slice just because the active phase has not changed.
After the foundation baseline, do not assume future planning must follow fixed Week N -> Slice A/B/C calendar buckets. Use this model instead:
product-strategy: owns long-term strategic tracks and why they matterroadmap: owns the active release-line milestone, active slice, candidate next slices, and stop conditionproject-status: owns current implementation reality, current tag baseline, verification evidence, and known gapsproject-plan: stays a short planning entry pageWhen a future planning task asks what to do next:
project-status, roadmap, project-plan, and product-strategy changed and why.