Governance Sync

Goal

Keep governance artifacts truthful with minimal churn.

Non-negotiables

• Read-only. Do not edit files automatically.
• Recommend updates only when triggered by actual changes.
• Be explicit about what changed and why that forces a doc update.

Workflow

1. Inspect what changed

• Prefer git diff/summary when available, otherwise use the user’s change summary.

2. Determine which artifacts’ truth conditions changed
   Common candidates:

• Tree map (Tree.txt / tree.md)
• Roadmap (roadmap.md)
• Architecture docs (ARCHITECTURE.md)
• Agent rules (AGENTS.md)
• Decision log (DECISIONS.md)
• Review queue (REVIEW_QUEUE.md)
• Suggestions log (SUGGESTIONS.md)
• Domain docs (docs/*)

3. Output a delta checklist

Output (follow exactly)

Governance Sync

Trigger summary

• Change type: <bugfix | feature | refactor | restructure | docs>
• Structural change: <yes/no>
• Decision required: <yes/no>

Required updates

[ ] :

Optional updates

[ ] :

Risks if skipped

• <Risk 1>
• <Risk 2>