docs: refresh published reference docs against current code

- CLAUDE.md + README.md: RAG engine is hybrid retrieval, not HyDE (retired)
- usage.md: org chart + agent-IDs table now show all 22 agents (adds
  secretary-1 + pr-reviewer-1); task-lifecycle diagram adds awaiting_pm_review
  and the awaiting_ceo_approval escalation
- deployment.md: architecture diagram + data-persistence table include ollama,
  panel, nginx, workspaces, and logs
- docs/initiatives + docs/self READMEs: access lists match middleware_docs.py
- CLAUDE.md blueprint pointer no longer references the gitignored docs/internal tree
This commit is contained in:
Renn F
2026-06-17 06:56:59 +02:00
parent 818f2ac7a6
commit 46c1ab8af2
6 changed files with 32 additions and 24 deletions
+18 -9
View File
@@ -59,21 +59,27 @@ Your NAS/Server
│ │
│ ├── roboco-postgres (pgvector)
│ ├── roboco-redis
── roboco-orchestrator
├── Runs FastAPI on port 8000
├── Builds (from source) or pulls (registry) the agent images
── Spawns agent containers:
├── roboco-agent-main-pm
├── roboco-agent-be-dev-1
├── roboco-agent-be-qa
── ... (each mounts ~/.claude for auth)
── roboco-ollama (+ ollama-init: pulls the embedding + local LLM models)
├── roboco-orchestrator
│ │
├── Runs FastAPI on port 8000
── Builds (from source) or pulls (registry) the agent images
│ └── Spawns agent containers:
├── roboco-agent-main-pm
├── roboco-agent-be-dev-1
── roboco-agent-be-qa
│ │ └── ... (each mounts ~/.claude for auth)
│ ├── roboco-panel (Next.js control panel, internal)
│ └── roboco-nginx (single entry point on :3000 → panel + /api,/ws → orchestrator)
├── ~/.claude/ ← Your Claude Code auth (from host)
└── ./data/ ← Persistent data
├── postgres/
├── redis/
├── ollama/ ← model cache (multi-GB)
├── workspaces/ ← per-agent git clones
├── logs/
└── mcp-configs/
```
@@ -143,6 +149,9 @@ All data is persisted to the host:
|----------------|-----------|
| postgres data | `./data/postgres/` |
| redis data | `./data/redis/` |
| Ollama models | `./data/ollama/` |
| Agent workspaces | `./data/workspaces/` |
| Agent + orchestrator logs | `./data/logs/` |
| MCP configs | `./data/mcp-configs/` |
For NAS RAID protection, set `ROBOCO_DATA_DIR` to your RAID volume: