[Docs] Document invariant reconciliation module and update automation tracking guide #5668

New issue

Closed

opened 2026-04-09 08:22:19 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-09 08:22:19 +00:00

Owner

Summary

The documentation suite is missing a module guide for the InvariantReconciliationActor that explains how invariants are reconciled across scopes, how reconciliation integrates with the plan lifecycle, and how operators can respond to reconciliation failures. The automation tracking guide also omits the recently added supervisors and the automation-tracking-manager subagent, and the MkDocs navigation does not surface the new module documentation that already exists in the repository.

Acceptance Criteria

Add a dedicated module guide under docs/modules/ that covers the purpose, lifecycle integration, reconciliation algorithm, key classes, error handling, DI registration, and usage examples for the Invariant Reconciliation module
Update docs/development/automation-tracking.md to list all active automation supervisors, describe the centralized tracking manager workflow, specify required labels, and document troubleshooting steps for cycle reuse
Update mkdocs.yml to include a Modules section that links to the shell safety, UKO provenance tracking, and invariant reconciliation module pages so they are reachable from the documentation navigation

Additional Context

These documentation gaps were identified during the docs-writer Cycle 1 pass while aligning documentation with the v3.8.0 feature set and the automation tracking system changes merged in early April 2026.

Automated by CleverAgents Bot
Supervisor: Implementation | Agent: implementation-worker

## Summary The documentation suite is missing a module guide for the `InvariantReconciliationActor` that explains how invariants are reconciled across scopes, how reconciliation integrates with the plan lifecycle, and how operators can respond to reconciliation failures. The automation tracking guide also omits the recently added supervisors and the `automation-tracking-manager` subagent, and the MkDocs navigation does not surface the new module documentation that already exists in the repository. ## Acceptance Criteria - Add a dedicated module guide under `docs/modules/` that covers the purpose, lifecycle integration, reconciliation algorithm, key classes, error handling, DI registration, and usage examples for the Invariant Reconciliation module - Update `docs/development/automation-tracking.md` to list all active automation supervisors, describe the centralized tracking manager workflow, specify required labels, and document troubleshooting steps for cycle reuse - Update `mkdocs.yml` to include a Modules section that links to the shell safety, UKO provenance tracking, and invariant reconciliation module pages so they are reachable from the documentation navigation ## Additional Context These documentation gaps were identified during the docs-writer Cycle 1 pass while aligning documentation with the v3.8.0 feature set and the automation tracking system changes merged in early April 2026. --- **Automated by CleverAgents Bot** Supervisor: Implementation | Agent: implementation-worker

Rows
Columns