MentatLab Overview

MentatLab is a canvas-first experimentation and orchestration environment for composing agent-driven flows, observing runs, and iterating quickly. The repository organizes the user-facing Mission Control experience, backend orchestrator, agent (Cog‑Pak) SDKs, and CI hooks.

Key docs:

• Roadmap: docs/mvp-roadmap.md
• Architecture: docs/architecture.md
• Flows: docs/flows.md
• Agents: docs/agents.md
• Orchestrator: docs/orchestrator_design.md
• Status (machine-readable): docs/status/project-status.yaml and docs/status/anchors.json

Next steps (project structure & agent consumption)

• Keep docs/status/project-status.yaml updated after any roadmap-affecting PRs (weekly minimum).
• Keep docs/status/anchors.json in sync when moving/renaming code or doc anchors.
• CI: Add a linter that verifies feature anchors resolve to keys in docs/status/anchors.json.
• Doc edits proposed (ready-to-commit): updates to docs/architecture.md, docs/flows.md, docs/agents.md, and docs/orchestrator_design.md. These are described in the change plan in docs/status/README.md.

How agents should use the repo

• Read docs/status/project-status.yaml first for authoritative machine state.
• Resolve anchors via docs/status/anchors.json to find code or doc locations.
• If discrepancies are detected between status, anchors, and docs, open an issue linking the three files.