Governance and auditability

Contract artifacts

• contract.md — human intent, examples, failure modes.
• contract.json — machine ContractSpec (schemas, capabilities).
• Audit scripts — scripts/audit_contract_docs.py (and strict mode for gates).

Changes to tasks should be reviewed like API changes: schema drift affects every consumer.

Traceability

• Prefer versioned tasks (v1, v2) rather than silent behavior changes.
• Benchmarks and integration tests document expected shapes — see Benchmarks.

Operational audits

python3 scripts/audit_contract_docs.py --strict
python3 scripts/audit_docs_site.py

See also

• ContractSpec
• Release checklist
• Enterprise architecture