mirror of
https://github.com/rennf93/roboco.git
synced 2026-08-03 07:23:24 +02:00
Renn F
2fb63fed1f
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.
29 lines
1.9 KiB
Markdown
29 lines
1.9 KiB
Markdown
# The shape of the company
|
|
|
|
What keeps twenty-two agents from dissolving into noise is that RoboCo is relentlessly opinionated about *how* work happens: everything is a task, no task moves without acceptance criteria, and every task walks the same strict lifecycle — built, QA'd, documented, PM-reviewed, approved — each step gated by role. The structure is the point. It is what turns a roster of models into a company that actually ships.
|
|
|
|
Work in RoboCo is always a **task**, and tasks nest into a tree that mirrors the org itself:
|
|
|
|
```text
|
|
CEO (you, the human)
|
|
├── Intake (on-demand interviewer — drafts a task with you)
|
|
├── Secretary (your chief-of-staff — acts only on your command)
|
|
└── Board ── Product Owner · Head of Marketing · Auditor (silent) · PR Reviewer (inbound external PRs)
|
|
└── Main PM (coordinates the cells)
|
|
├── UX/UI cell ── PM · 2 Devs · QA · Documenter
|
|
├── Frontend cell ── PM · 2 Devs · QA · Documenter
|
|
└── Backend cell ── PM · 2 Devs · QA · Documenter
|
|
```
|
|
|
|
The walkthrough that follows traces the delivery path — Intake, the Board, the Main PM, the cells. The Secretary and the research and strategy engines sit one layer up, steering the company as a whole; they get their own chapter at the end.
|
|
|
|
In practice, one feature becomes a small tree of work — a parent task at the top, a branch for each cell underneath, every node carrying its own status, git branch, and pull request:
|
|
|
|
|
|
|
|
*A feature in motion. The parent task fans out to the UX/UI, Frontend, and Backend cells, and each child moves through its own lifecycle — in progress, awaiting review, completed — on its own branch.*
|
|
|
|
---
|
|
|
|
Next: **[It starts with you →](02-it-starts-with-you.md)**
|