Repository navigation
epic(llc): AutoBot LLC — Autonomous Company Operating System #8204
Description
Overview
AutoBot LLC is a new first-class module that turns AutoBot into a complete autonomous company operating system. It layers a company-centric, goal-anchored, budget-governed control plane on top of all existing AutoBot capabilities.
Every AI capability AutoBot already provides — Knowledge Base (ChromaDB + RAG), LLM gateway, multi-modal processing, NPU acceleration, WebSocket chat, memory graph, and plugin system — is deeply wired into this module.
PRD: docs/planning/PRD_AutoBot_LLC_Module.md
What This Adds
| Capability | Details |
|---|---|
| Companies as first-order entities | Company-scoped everything — agents, goals, budgets, KB, secrets, work items |
| Sub-companies | Nested subsidiary hierarchy, unlimited depth, budget cascade |
| Full org chart | AI agents + human workers in the same reporting tree |
| Goal hierarchy | Company → Team → Agent → Task ancestry, every work item traces to mission |
| Work item hierarchy | Epic → Feature → PBI → Task → Subtask (5 levels) |
| Sprint / iteration planning | Capacity, velocity history, burndown, sprint KB auto-summary |
| Portfolio / program / project | Multi-level project container hierarchy |
| Heartbeat execution | Agents wake autonomously on schedule via adapter protocol |
| Hybrid human + AI | Humans and agents co-assignable, structured handoff with KB brief |
| Budget governance | Per-agent monthly budgets, hard stop, board approval gates |
| KB-powered execution | RAG context auto-assembled at heartbeat time from company/project/agent KB |
| Board control surface | Approve hires, strategy, budget overrides, sprint closes — full audit trail |
| Instant emergency controls | Board can pause/resume/terminate any agent or company instantly |
| Company portability | Export/import company templates and snapshots |
| Cross-company template library | Platform-level searchable template index with RAG |
Architecture
autobot-backend/llc/
├── models/ ← 25 new/extended SQLAlchemy tables
├── services/ ← Business logic, atomic checkout, budget enforcement
├── adapters/ ← invoke/status/cancel adapter protocol
├── api/ ← /api/llc/ route group + agent-facing API
├── scheduler/ ← Heartbeat, budget watchdog, liveness, sprint auto-close
├── notifications/ ← LLC event router → WebSocket clients
├── sync/ ← Outbound PM sync to external ticketing systems
├── health/ ← LLC system health probe
└── kb/ ← KB collection lifecycle, context builder, handoff briefs
Phase Breakdown
- Phase 1 — Core Control Plane (epic(llc): Phase 1 — Core Control Plane #8205): feat(llc): Module skeleton scaffolding — directory structure, DI wiring, conftest, base models #8251 feat(llc): Company model extension — sub-companies, budget, issue prefix, status lifecycle #8211 feat(llc): 4-level goal hierarchy — CRUD, ancestry traversal, KB indexing #8212 feat(llc): Work item hierarchy — Epic/Feature/PBI/Task/Bug/Subtask with atomic checkout #8213 feat(llc): Board approval gates — hire, strategy, budget override, sprint close #8214 feat(llc): Per-agent budget enforcement — hard stop, soft alert, cost event ingestion #8215 feat(llc): Immutable activity log — company-scoped, all-mutations coverage #8216 feat(llc): Company-scoped secrets — versioned, encrypted, binding model, access log #8217 feat(llc): LLC API route group registration + agent-facing API keys #8218 feat(llc): Work item relations — blocking, blocked-by, duplicate, relates-to #8252 feat(llc): Notification routing service — relay llc:* Redis events to WebSocket clients by company_id #8255 feat(llc): LLC system health probe — heartbeat scheduler uptime, lag, and budget alert metrics #8259
- Phase 2 — Agile Workflow Layer (epic(llc): Phase 2 — Agile Workflow Layer #8206): feat(llc): Portfolio → Program → Project → Sprint hierarchy #8219 feat(llc): Sprint planning — capacity, velocity history, burndown data endpoint #8220 feat(llc): Kanban board + Sprint board — column config, real-time WebSocket push #8221 feat(llc): Backlog view API — priority ordering, bulk sprint assign, type/status filters #8222 feat(llc): Human workers as first-class assignees — user claims, handoff protocol #8223 feat(llc): Sprint auto-close — board approval gate, KB summarization, item rollover #8224 feat(llc): Work item file attachments — upload, storage, text extraction for KB #8253 feat(llc): Work item label management — llc_labels table, CRUD API, label assignment #8254 feat(llc): Outbound project management sync — wire LLC work item completion to connector framework #8257
- Phase 3 — Heartbeat + Adapters (epic(llc): Phase 3 — Heartbeat + Adapters #8207): feat(llc): Heartbeat scheduler — Redis sorted set, cron dispatch, restart-safe #8225 feat(llc): Adapter protocol — invoke/status/cancel base + process + http adapters #8226 feat(llc): AutoBot agent adapter — wraps agents/base_agent.py for heartbeat dispatch #8227 feat(llc): Liveness monitor + watchdog — stuck run detection, recovery action creation #8228 feat(llc): Routine entity — recurring work CRUD, env overlay, run history #8229 feat(llc): Board instant pause/resume/terminate controls — FR-GOV-05 emergency override #8256 feat(llc/agents): Haiku assistant tier — preventive token efficiency for LLC agents #8486 feat(llc/agents): Provider-agnostic cheap/senior model tier for all LLM providers #8487
- Phase 4 — Hybrid Human + AI Orchestration (epic(llc): Phase 4 — Hybrid Human + AI Orchestration #8208): feat(llc): Union assignment model — human | agent co-assignees, co-working mode #8230 feat(llc): Agent → Human handoff — KB-powered brief generation, reviewer notification #8231 feat(llc): Human → Agent handoff — notes ingestion into work item KB, agent pickup #8232 feat(llc): CEO Chat — company-scoped chat resolving to work objects via LLM + KB #8233 feat(llc): Human review gate — mid-work-item approval step, configurable per item type #8234 feat(llc): Claude Code session adapter — claude_code adapter type for agent heartbeat #8258
- Phase 5 — Knowledge Base Integration (epic(llc): Phase 5 — Knowledge Base Integration #8209): feat(llc/kb): KB collection lifecycle manager — create/archive per company/project/sprint/agent #8235 feat(llc/kb): Heartbeat context builder — parallel RAG assembly, fat payload construction #8236 feat(llc/kb): Agent diary → KB writer — post-heartbeat hook on agent_diary.py #8237 feat(llc/kb): Sprint KB summarizer — LLM-summarize and merge into project KB on close #8238 feat(llc/kb): Handoff brief generator — AI→Human and Human→AI KB-powered briefs #8239 feat(llc/kb): AC suggester — RAG over company policies + past PBIs on work item create #8240 feat(llc/kb): Sub-company KB inheritance — parent KB read-through with weight decay #8241 feat(llc/kb): Artifact ingestor — work products indexed into project KB on task completion #8242 feat(llc/kb): Board decision log writer — approvals indexed to company decisions KB #8243 feat(llc/kb): Agent capability indexing — on hire/update, re-index to company:agents KB #8244 feat(llc): Cross-company template KB — platform-level template index for search and import #8260
- Phase 6 — Portability + Frontend Polish (epic(llc): Phase 6 — Portability + Frontend Polish #8210): feat(llc): Company template export — structure, seed tasks, secret scrubbing #8245 feat(llc): Company import — collision detection, preview, namespace remapping #8246 feat(llc/frontend): Company Dashboard + Org Chart + Goal Tree + Sub-Company Tree views #8247 feat(llc/frontend): Backlog + Sprint Board + Kanban Board + Work Item Detail views #8248 feat(llc/frontend): Approvals Inbox + Cost Dashboard + Heartbeat Monitor + CEO Chat views #8249 feat(llc/frontend): Company Portability UI — export, import preview, import execute #8250
Total: 57 issues across 6 phases
Success Metrics (90 days post-launch)
- ≥ 5 agents running autonomously per active company
- ≥ 60% of work items closed by AI agents without human intervention
- 100% budget hard stops firing correctly (no overruns)
- Heartbeat context assembly P95 ≤ 2s
- ≥ 80% KB queries rated relevant by users
Activity
docs(llc): AutoBot LLC Module PRD — 6-phase autonomous company OS des…
mrveiss commentedon May 24, 2026
All 56 feat(llc) issues closed. All 7 phase epics (#8205–#8210) closed. All feature PRs merged into Dev_new_gui. LLC epic complete.
mrveiss commentedon Jun 8, 2026
✅ Epic verified complete on
Dev_new_gui— closingRe-verified the full epic against the codebase (not just issue statuses). The entire original scope — 57 issues across 6 phases — is implemented and merged into
Dev_new_gui.Phase epics: all 6 closed (#8205, #8206, #8207, #8208, #8209, #8210). #8207 and #8210 were verified and closed today; their checklists were stale but every child was already done.
Backend module (
autobot-backend/llc/): 23 models · 30 services · 28 api files · 7 scheduler files · adapters · kb · health · sync · middleware.initialization/router_registry/feature_routers.py:652→("llc.api", "", ["llc"], "llc")llc_*Alembic migrations presentllc.scheduler.sprint_autocloseincelery_app.py:202Frontend (
autobot-frontend/src/): 17 LLC views,/llc/*routes inrouter/index.ts, "Company OS" nav entry →/llc/dashboardinconfig/navItems.ts.Out of scope (tracked separately)
13 follow-up enhancements/fixes filed after this epic remain open and are independent of #8204's checklist: #9657, #9626, #9623, #9622, #9625, #9627, #9628, #9008, #9034, #9020, #8997, #9033, #9715.
The original epic scope has no remaining implementation work. Closing.