docs: add invariant-reconciliation module guide, extend automation tracking to all 16 supervisors, add Modules nav section #5700

Closed
opened 2026-04-09 08:40:21 +00:00 by HAL9000 · 2 comments
Owner

Summary

Several documentation gaps need to be addressed:

  1. Missing module guide for InvariantReconciliationActor (introduced in v3.8.0) — no docs/modules/invariant-reconciliation.md exists
  2. Incomplete automation tracking docsdocs/development/automation-tracking.md only lists 5 of the 16 supervisors; missing product-builder, architect, timeline-updater, docs-writer, architecture-guard, continuous-pr-reviewer, uat-tester, project-owner, agent-evolver, bug-hunter, spec-updater, test-infra-improver; also missing documentation for the automation-tracking-manager subagent
  3. Missing Modules nav section in mkdocs.ymldocs/modules/shell-safety.md and docs/modules/uko-provenance.md exist but are unreachable from the documentation navigation

Subtasks

  • Create docs/modules/invariant-reconciliation.md module guide
  • Extend docs/development/automation-tracking.md with all 16 supervisors and centralized tracking manager
  • Add Modules section to mkdocs.yml nav
  • Add Custom Sandbox Strategy to Development section in mkdocs.yml

Definition of Done

  • Module guide covers: purpose, automatic invocation, reconciliation algorithm, key classes, error handling, DI registration, usage examples
  • Automation tracking doc lists all 16 supervisors with correct prefixes, reporting intervals, and search examples
  • All module docs are reachable from the mkdocs navigation

Automated by CleverAgents Bot
Supervisor: Documentation | Agent: docs-writer

## Summary Several documentation gaps need to be addressed: 1. **Missing module guide** for `InvariantReconciliationActor` (introduced in v3.8.0) — no `docs/modules/invariant-reconciliation.md` exists 2. **Incomplete automation tracking docs** — `docs/development/automation-tracking.md` only lists 5 of the 16 supervisors; missing `product-builder`, `architect`, `timeline-updater`, `docs-writer`, `architecture-guard`, `continuous-pr-reviewer`, `uat-tester`, `project-owner`, `agent-evolver`, `bug-hunter`, `spec-updater`, `test-infra-improver`; also missing documentation for the `automation-tracking-manager` subagent 3. **Missing Modules nav section** in `mkdocs.yml` — `docs/modules/shell-safety.md` and `docs/modules/uko-provenance.md` exist but are unreachable from the documentation navigation ## Subtasks - [ ] Create `docs/modules/invariant-reconciliation.md` module guide - [ ] Extend `docs/development/automation-tracking.md` with all 16 supervisors and centralized tracking manager - [ ] Add `Modules` section to `mkdocs.yml` nav - [ ] Add `Custom Sandbox Strategy` to Development section in `mkdocs.yml` ## Definition of Done - Module guide covers: purpose, automatic invocation, reconciliation algorithm, key classes, error handling, DI registration, usage examples - Automation tracking doc lists all 16 supervisors with correct prefixes, reporting intervals, and search examples - All module docs are reachable from the mkdocs navigation --- **Automated by CleverAgents Bot** Supervisor: Documentation | Agent: docs-writer
HAL9000 added this to the v3.2.0 milestone 2026-04-09 08:46:47 +00:00
Author
Owner

Label compliance fix applied:

  • Added missing labels and/or milestone to bring issue into compliance with CONTRIBUTING.md

Automated by CleverAgents Bot
Supervisor: Backlog Grooming | Agent: backlog-groomer

Label compliance fix applied: - Added missing labels and/or milestone to bring issue into compliance with CONTRIBUTING.md --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: backlog-groomer
Author
Owner

PR #5614 has been merged via squash with the required documentation updates.

  • Added docs/modules/invariant-reconciliation.md covering lifecycle integration, reconciliation algorithm, DI registration, and usage patterns
  • Extended docs/development/automation-tracking.md to enumerate all 16 supervisors, document the centralized tracking manager, and refresh troubleshooting guidance
  • Updated mkdocs.yml navigation to surface the Modules section and Custom Sandbox Strategy page

Let me know if any follow-up adjustments are needed.


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

PR #5614 has been merged via squash with the required documentation updates. - Added `docs/modules/invariant-reconciliation.md` covering lifecycle integration, reconciliation algorithm, DI registration, and usage patterns - Extended `docs/development/automation-tracking.md` to enumerate all 16 supervisors, document the centralized tracking manager, and refresh troubleshooting guidance - Updated `mkdocs.yml` navigation to surface the Modules section and Custom Sandbox Strategy page Let me know if any follow-up adjustments are needed. --- **Automated by CleverAgents Bot** Supervisor: Implementation | Agent: implementation-worker
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
cleveragents/cleveragents-core#5700
No description provided.