docs: remove diagram, restructure Why DevClaw into clean bullet lists

Replaced dense inline-linked paragraphs with a short intro sentence
per pillar followed by bullet points. Each bullet is one concept with
one link. Removed the ASCII parallelization diagram.

https://claude.ai/code/session_01R3rGevPY748gP4uK2ggYag
This commit is contained in:
Claude
2026-02-11 07:23:04 +00:00
parent 348b33f40b
commit 13abef8bc1

View File

@@ -50,43 +50,27 @@ Multiple issues shipped, a QA failure automatically retried, and a second projec
### Autonomous multi-project development ### Autonomous multi-project development
Every project runs in [complete isolation](#execution-modes) with its own queue, workers, and sessions. DEV and QA [execute in parallel](#execution-modes) within each project, and [multiple projects run simultaneously](#execution-modes). The [scheduling engine](#automatic-scheduling) ties it together: a token-free `work_heartbeat` continuously scans queues, dispatches workers, and drives [DEV → QA → DEV feedback loops](#how-tasks-flow-between-roles) — no human in the loop. Workers receive [custom instructions per project per role](#custom-instructions-per-project) at dispatch time: test commands, coding standards, deployment steps. Each project is fully isolated — own queue, workers, sessions, and state. DEV and QA execute in parallel within each project, and multiple projects run simultaneously. A token-free scheduling engine drives it all autonomously:
``` - **[Scheduling engine](#automatic-scheduling)** — `work_heartbeat` continuously scans queues, dispatches workers, and drives DEV → QA → DEV [feedback loops](#how-tasks-flow-between-roles)
┌─ work_heartbeat ─────────────────┐ - **[Project isolation](#execution-modes)** — parallel workers per project, parallel projects across the system
│ health → queue → dispatch - **[Role instructions](#custom-instructions-per-project)** — per-project, per-role prompts injected at dispatch time
│ every 60s · zero LLM tokens │
└──────────┬───────────────────────┘
┌─────▼─────────────────────┐
│ My Webapp │
│ │
│ DEV (medior) ──▶ QA │
│ #43 #42 │
│ │
│ dev.md · qa.md │
└───────────────────────────┘
┌─────▼─────────────────────┐
│ My API │
│ │
│ DEV (senior) ──▶ QA │
│ #19 #18 │
│ │
│ dev.md · qa.md │
└───────────────────────────┘
each project fully isolated:
own queue · own workers · own sessions
```
### Process enforcement ### Process enforcement
Task state lives in your [existing issue tracker](#your-issues-stay-in-your-tracker) — GitHub or GitLab issues — as the single source of truth. Every tool call is an [atomic operation with rollback](#what-atomic-means-here): label transitions, state updates, session dispatch, and audit logging happen in deterministic code. The agent says what to do; [11 tools enforce how it gets done](#the-toolbox). GitHub/GitLab issues are the single source of truth — not an internal database. Every tool call wraps the full operation into deterministic code with rollback on failure:
- **[External task state](#your-issues-stay-in-your-tracker)** — labels, transitions, and status queries go through your issue tracker
- **[Atomic operations](#what-atomic-means-here)** — label transition + state update + session dispatch + audit log in one call
- **[Tool-based guardrails](#the-toolbox)** — 11 tools enforce the process; the agent provides intent, the plugin handles mechanics
### ~60-80% token savings ### ~60-80% token savings
[Tier selection](#meet-your-team) routes tasks to the cheapest model that can handle them — Haiku for typos, Opus for architecture (~30-50% on simple tasks). [Session reuse](#sessions-accumulate-context) preserves accumulated codebase knowledge across tasks (~40-60% per task). The [scheduling engine](#automatic-scheduling) runs on pure CLI calls — zero LLM tokens for orchestration. Three mechanisms compound to cut token usage dramatically versus running one large model with fresh context each time:
- **[Tier selection](#meet-your-team)** — Haiku for typos, Sonnet for features, Opus for architecture (~30-50% on simple tasks)
- **[Session reuse](#sessions-accumulate-context)** — workers accumulate codebase knowledge across tasks (~40-60% per task)
- **[Token-free scheduling](#automatic-scheduling)** — `work_heartbeat` runs on pure CLI calls, zero LLM tokens for orchestration
--- ---