Purpose
Navigate and apply the documentation governance system to ensure edits respect authority chains and SSOT principles.
Scope
Covers the governed_by DAG, authority model, conflict resolution, and validation procedures. Does not cover runtime-specific mechanics (see system-context-mechanics) or task state (see system-objective-state).
Minimal Path
- •Before editing any doc, check its
governed_byfrontmatter to identify constraints. - •Run
just docs-indexto visualize the governance DAG if relationships are unclear. - •If a conflict exists between docs, apply
docs/system/procedure/resolving-conflicts.md. - •If creating a new doc, ensure it declares
governed_byper the appropriate model doc. - •Run
just docs-validateto verify all linkages are correct.
Validation
- •
just docs-validatepasses with no errors. - •Every doc has a valid
governed_bychain to a root authority. - •No circular references exist in the DAG.
Failure Modes
- •Editing a doc without checking what governs it (authority violation).
- •Creating orphan docs with no
governed_bydeclaration. - •Duplicating content instead of linking (SSOT violation).
References
- •
docs/system/governance.md: Master governance definition - •
docs/system/authority-model.md: Authority layer definitions - •
docs/system/procedure/resolving-conflicts.md: Conflict resolution procedure - •
docs/system/procedure/validating-doc-contracts.md: Validation procedure