# Grand Project - Special One Preparation Package

## GPO Snapshot
- Snapshot timestamp: 2026-08-21 04:40:40 Pacific/Auckland
- Project: GP-PROJ-001 - Grand Project
- Overall state: 14.8% complete
- Canonical SHA: 727da87e596f9f293f50076ff0c99904b6e678d3
- Documentation state: current through CMD-20260820-001; health Healthy

## Previous Round Closure
- Previous milestone/run: GP-M01 - CLEAN ACCEPTED BASELINE
- Git closure state: Recorded canonical SHA 727da87e596f9f293f50076ff0c99904b6e678d3
- CI/smoke state: evidence exists in the reconciled roadmap and test history, with current review items still tracked separately.

## Current Milestone
- Current/next milestone: GP-M03 - DOCUMENT GENERATOR & NOTIFICATIONS
- Ready queue count: 2
- Review queue count: 2

## Ready Work
- GP-DOC-001: Audit/reconcile existing Document Generator work. [Ready] (GP-M03)
- GP-NOTIFY-001: Audit/reconcile existing Notifications work. [Ready] (GP-M03)

## Review Items
- GP-SEO-013: Ecommerce/public-surface integration hooks. [Needs Review] (GP-M10)
- GP-SEO-017: SEO smoke acceptance. [Needs Review] (GP-M10)

## Recommended Round Objective
- Work the ready queue in milestone order.

## Workstreams
## Audit/reconcile existing Document Generator work.
- Task IDs: GP-DOC-001
- Existing Minion: MINION-07
- Objective: Audit/reconcile existing Document Generator work.
- Detailed Objective: Audit/reconcile existing Document Generator work.
- Dependencies: None
- Relevant Components: app/routers/dashboard.py, app/services/documentation.py, app/templates/base.html, app/templates/dashboard.html, app/templates/documentation_diff.html, app/templates/documentation_home.html, app/templates/documentation_viewer.html
- Acceptance Criteria: GP-DOC-001 is implemented against the canonical GPO state., GP-DOC-001 is validated through the relevant route or service test coverage., The public dashboard and generated handoff remain consistent.
- Required Tests: python -m pytest tests/test_next_round.py, python -m pytest tests/test_documentation_part_d.py, Verify documentation routes through /docs and /docs/rounds
- Collision Risk: Low
- Parallelisation Suitability: Parallel With Integration Order
- Why Now: GP-DOC-001 is Ready, GP-M01 is closed, and MINION-07 can be reused.
## Audit/reconcile existing Notifications work.
- Task IDs: GP-NOTIFY-001
- Existing Minion: MINION-09
- Objective: Audit/reconcile existing Notifications work.
- Detailed Objective: Audit/reconcile existing Notifications work.
- Dependencies: None
- Relevant Components: app/routers/dashboard.py, app/services/notifications.py, app/templates/base.html, app/templates/dashboard.html
- Acceptance Criteria: GP-NOTIFY-001 is implemented against the canonical GPO state., GP-NOTIFY-001 is validated through the relevant route or service test coverage., The public dashboard and generated handoff remain consistent.
- Required Tests: python -m pytest tests/test_next_round.py, python -m pytest tests/test_documentation_part_d.py, Verify dashboard notifications and ready queue presentation
- Collision Risk: Low
- Parallelisation Suitability: Parallel With Integration Order
- Why Now: GP-NOTIFY-001 is Ready, GP-M01 is closed, and MINION-09 can be reused.

## Parallelisation
- Classification: Parallel With Integration Order
- Reason: The workstreams reuse different minions, but they still touch shared dashboard and integration surfaces, so build them in parallel and merge in order.

## Integration Order
- Document Generator first, Notifications second, then review the SEO carry-forward items if they remain unresolved.

## Minions On Demand
- Reuse a suitable existing Minion when one exists.
- Do not create a new Minion merely because a new workstream exists.
- Create a Minion only when the work is genuinely independent, no existing Minion is suitable, and ownership boundaries are safe.
- Register any new Minion in the coordinator control plane.
- MINION-10 remains the persistent Documentation Helper.

## Documentation Helper Gate
- Current documentation helper state: Healthy
- Documentation action: verify/no-op

## Git Startup Gate
- Previous completed accepted work must be committed, pushed, and synchronized before new work starts.

## Required Validation
- Preserve canonical hostname handling.
- Validate the changed routes and generated outputs through the public dashboard.
- Keep review items out of the ready queue until evidence supports promotion.

## Git Closure Gate
- Integration -> validation -> CI -> smoke tests -> documentation -> commit -> push -> remote SHA verification -> round closure.

## Completion Criteria
- The ready work is integrated and validated.
- The documentation helper is current or explicitly no-op.
- The generated prompt can be pasted directly into ChatGPT or Special One.
- The next-round plan is saved with a stable ID and current snapshot.

## Carry-Forward / Review Items
- GP-SEO-013, GP-SEO-017

## GPO Context
- Project: GP-PROJ-001 - Grand Project
- Canonical URL: https://gpo.jamie.waltons.co.nz
- Persistent helper: MINION-10