Grand Project Documentation Metadata

This directory is the canonical metadata home for Documentation Helper round-processing records.

Current canonical project documentation still lives primarily in the repository root and related module documentation files, including:

- `ARCHITECTURE.md`

- `DEPENDENCIES.md`

- `decisions.md`

- `updates.md`

- focused module documents such as `SEO-ARCHITECTURE.md`

This directory adds the coordination metadata required to keep those canonical documents synchronized with completed Special One rounds without duplicating documentation passes.

Round identity

There was no pre-existing Special One round ledger in the repository when this workflow was installed.

Documentation Helper must treat a round identifier as the canonical source-run identifier used by the Coordinator for that completed Special One cycle. The identifier must be recorded exactly as verified from the source evidence and must not be invented after the fact.

Current verified source-run convention:

- `CMD-YYYYMMDD-NNN`

Source-run allocation must be unique. A candidate already recorded in the command queue, ledger, or archive blocks startup until a different unused identifier is registered.

Known successful documented example:

- source run `CMD-20260820-001`

- documentation update `GP-DOCUP-000001`

Known duplicate-prevention example:

- a later ordinary duplicate request for `CMD-20260820-001` returned `NO-OP`

- no second initial documentation update was created

Files

- `.documentation-round-ledger.json`

The authoritative machine-readable record of which completed rounds have or have not been documented.

- `documentation-gate-policy.json`

The authoritative machine-readable Special One documentation-gate workflow contract.

- `.updates/<documentation-update-id>.json`

Per-update structured manifests.

- `history/round-<round-id>.md`

Human-readable change records for each successfully processed round.

- `schemas/`

JSON Schemas for the ledger and manifest formats.

Approved write boundary

Documentation Helper may modify:

- canonical documentation

- documentation metadata under this directory

Documentation Helper must not casually modify implementation/runtime source code.

Canonical dashboard URL:

- `https://gpo.jamie.waltons.co.nz`