Handbook

Production readiness checklist

Use with Release checklist and Handbook go / no-go.

Updated 2026-07-06

Docs and website

[ ] python3 scripts/audit_docs_site.py --strict passes on shipped SHA.
[ ] forge-lcdl-website: build-site.py --link-check, check-generated-site.py --strict-diagrams --verify-rendered-diagrams, verify-hosting-target.sh.
[ ] Submodule forge-lcdl pointer inside website repo matches library release SHA.

Contracts and schemas

[ ] python3 scripts/audit_contract_docs.py --strict --strict-md
[ ] python3 scripts/audit_contract_docs.py --require-contract-identity
[ ] python3 scripts/generate_task_catalog_md.py --check

Examples and tests

[ ] pytest -q tests/docs tests/reference tests/examples
[ ] pytest -q -m "not granite" (document Granite runs separately).

Security and data handling

[ ] No secrets staged; follow Data handling redaction rules for incidents.
[ ] Logging policy reviewed for prompts / payloads (Threat model).

Operations

[ ] Escalation owners named for gateway outages vs LCDL defects (Operational runbook).

Release / versioning

[ ] CHANGELOG Unreleased section updated.
[ ] Breaking contract changes captured under Migration guides.

Agent workflows

[ ] Cursor .cursor assets reference current audit commands (Agents hub).

See also