Files
roboco/docs/panel/index.md
T
Renn F 2fb63fed1f docs: add the user-facing MkDocs documentation site
Build a complete user-facing documentation site (MkDocs Material) under docs/, served at roboco.dev/docs via a new gh-pages deploy workflow.

- Sections: Get Started, The Company, the Tour, Operating the Panel, Choosing & Running Models, Cost & Observability, Optional Subsystems, Configure & Deploy, API Reference, Troubleshooting & Security (55 pages).
- mkdocs.yml (Material theme; excludes the agent-facing rag/ corpus, internal scratch, and orphaned stub trees) and .github/workflows/docs.yml (mkdocs gh-deploy to gh-pages).
- Retire the stale root usage.md and deployment.md to redirect stubs into the site.
- Fix the docs tooling: add the pymarkdownlnt dependency + .pymarkdown.json, run serve-docs/lint-docs/fix-docs under the docs extra, add a build-docs strict gate.
- Fix the roboco console-script entry point (cli, not the un-awaited async main).
- README: correct the project-structure tree (optimal.py, alembic) and link the docs site.
2026-06-22 15:53:00 +02:00

23 lines
1.7 KiB
Markdown

# Operating the Panel
The control panel is your one window into the company — every task, agent, message, journal, and pull request is live in front of you, served at `http://localhost:3000`. This section is a reference: one short page per area, describing what you do there and what it shows.
<div class="grid cards" markdown>
- **[Command Center](command-center.md)** — the home dashboard: cell health, your approval queues, live metrics, and the notifications inbox.
- **[Tasks & Kanban](tasks-and-kanban.md)** — the task table, the task detail page (with CEO god-mode), and the dev board.
- **[Agents & Work Sessions](agents-and-work-sessions.md)** — the live workforce and the branch/PR ledger.
- **[Projects & Products](projects-and-products.md)** — the repositories the company works on, and multi-repo products.
- **[Git](git.md)** — browse live git state and run operations per project.
- **[Knowledge Base](knowledge-base.md)** — the in-house RAG: search, ask, and reindex.
- **[Communications & Journals](communications-and-journals.md)** — the live message stream, agent journals, and your notifications.
- **[Auditor](auditor.md)** — read-only quality oversight across the whole company.
- **[Business](business.md)** — the charter, the Scorecard, the Cockpit, and pitches.
- **[Metrics](metrics.md)** — delivery performance and the token-usage dashboard.
- **[Settings](settings.md)** — feature flags, transcript retention, and configuration.
</div>
!!! tip "Provider configuration lives in its own section"
Picking which models power the agents is on the **Settings → AI Providers** page — see [Choosing & Running Models](../models/index.md).