Workflows

2026-06-20

ADR Authoring Workflow

1. Draft architecture rationale in a working note.
2. Promote stable cross-repo decisions into docs/adr/canonical/.
3. Reference canonical ADRs from repo-local overrides in owning repositories.
4. Keep architecture pages descriptive and move normative decisions into ADRs.

Documentation Editing Workflow

1. Update entry pages in docs/ when navigation or repo intent changes.
2. Keep English documentation in the root docs/ tree.
3. Run mkdocs build after each structural change to validate navigation, hooks, and generated registry output.

MCP Contract Workflow

1. Update docs/agent/manifest.yaml when authority order or resource roots change.
2. Update docs/context/ files when repo capabilities, workflows, or contracts change.
3. Re-run python D:\github\workspace-mcp\scripts\mcp_provision.py dirac-framework to refresh registry state.