---
applyTo: "docs/**, src/gzkit/**"
---
<!-- Generated by gz agent sync — do not edit -->

# Gate 5 Runbook-Code Covenant (gzkit)

<!-- rule-version: 0.1.0 -->

> **Rule version:** `0.1.0` — initial shape conformance pass; renamed prohibited heading (OBPI-0.0.54-04).

Documentation is a first-class deliverable and must track behavior changes in the same patch set.

## Three-layer documentation model

| Layer | Location | Purpose |
|---|---|---|
| Operator runbook | `docs/user/runbook.md` | daily execution workflow |
| Governance runbook | `docs/governance/governance_runbook.md` | governance-maintainer workflow |
| Command docs | `docs/user/manpages/**` | command contracts and examples |

## Required updates when behavior changes

- Update command docs and examples.
- Update runbook flows and verification commands.
- Ensure attestation language remains explicit where required.

## Validation bundle

```bash
uv run gz lint
uv run gz validate --documents --surfaces
uv run mkdocs build --strict
```

## Do Not

- Do not leave placeholder output examples.
- Do not update code without docs when command output changes.
- Do not declare completion without explicit human attestation for heavy/foundation scope.
