Documentation Sitemap

Status: Current navigation index. Quarantined and authority-gated material is summarized without being presented as current guidance.

Start here

Documentation atlas — placement, source-of-truth, linking, and migration rules.
User guide — end-user workflows and product behavior.
Administrator guide — installation, configuration, operations, security, and recovery.
Developer guide — architecture, testing, integrations, and contributor material.
API documentation — API contract migration status.
Reports index — review, audit, QA, security, and retained evidence.
Archive index — superseded historical pages.

Product requirements — normative requirements; currently marked draft and retaining authority-gated legacy references.
Active task rollup — orchestrator-owned work state; workers do not modify it.
MVP mission manifest — declares itself active; current workstream status and stale outbound links await orchestrator/maintainer validation.
Documentation catalog and truth audit — complete baseline inventory, evidence labels, broken-link clusters, and migration recommendations.

Quickstart — installed-CLI first-use route with local PGlite safety boundaries.
Web dashboard — current routes, views, chat persistence, settings, and admin behavior.
Discord conversations — current authorized parent-channel, thread, attachment, and control workflow.

Administrator operations — current local procedures and explicitly held outlines.
Upgrade safety and recovery — installed-CLI/local-PGlite upgrade and framework recovery.
Mos connector lease operations — held/non-operative M1 outline while policy remains deny-all.
Administrator security — current security chapter index.
SSO providers — Authentik, WorkOS, and Keycloak configuration and discovery.
Discord ingress security — service authentication, allowlists, bindings, roles, replay, and failure controls.

Architecture index — current architecture contracts, decisions, and draft RFCs.
Channel protocol — shared DTOs and current Discord compatibility boundary; future adapters are draft.
Lease-broker protocol — authenticated Unix-socket protocol and persistence boundary.
Lease-broker security — identity, ancestry, filesystem, observer, and residual boundaries.
Whole mutator-class gate — default-deny tool authorization and launch choke point.
Compaction revocation — lifecycle observers, generation fencing, and residual stale window.
Architecture decisions — implemented and accepted boundaries.
Mos runtime portability M1 — logical identity, connector lease, grants, audit, and fencing.
Architecture RFCs — draft proposals without operational authority.
Optional AI egress gateways — draft proposal; LiteLLM and Bifrost are not integrated.
Lease-broker operations and verification — safe static/test workflow; live procedures remain held.
Channel adapter authoring — current shared contract and Discord reference boundary.

API index — consolidated gateway contract remains planned.
Legacy Tess-scoped OpenAPI contract — valid OpenAPI 3.1 artifact with incomplete gateway coverage; canonical scope requires maintainer approval.

Reports index — all tracked report categories and evidence boundaries.
Archived missions — historical CLI, harness, install UX, and storage-abstraction delivery records.
Archived planning — historical briefs, board reviews, and work-package specifications.
Archived work records — historical task scratchpads without live consumers.
P8-003 performance report — historical implementation evidence, not a current SLO.
Plans index — approved intent and implementation/audit plans.
Documentation information-architecture design — approved documentation structure decision.
Documentation catalog-audit plan — evidence method and migration acceptance criteria.
Scratchpads index — working memory and verification records.
Documentation migration scratchpad — coordinator progress, verification, and resumability record.

The complete file-level backlog remains in the documentation catalog. The groups below are intentionally not linked as current pages:

Fleet configuration: quarantined pages have executable source/test consumers and require a coordinated path, authority, and test migration.
Federation: active-versus-historical workstream status and normative authority require maintainer/orchestrator confirmation.
Native Kanban/KBN-101: requirements, task state, reports, and held PostgreSQL procedures require product-owner and orchestrator decisions.
Tess: mixed user, administrator, developer, migration, qualification, and API material requires audience splitting and a decision on active versus historical status.
Gateway API: the Tess-scoped OpenAPI artifact must not be renamed into the canonical full-gateway contract until scope, authentication, errors, schemas, and transport coverage are approved.
Deployment and tier migration: PostgreSQL, federated, bare-metal, Compose, Gateway/Web activation, and migration-runner procedures remain held under the repository safety policy.
Mixed legacy guides and scratchpads: remaining records are coupled to control documents, tests/fixtures, mission evidence, or held procedures; migrate them with their owners.
Compaction-refresh probes: scripts are Mos-gated and path-coupled; do not move or execute them as documentation cleanup.

docs/_old_structure/ remains read-only migration quarantine. It is not current navigation and must not be used as command authority.