docs: convert legacy execution-agent readmes to wrappers

This commit is contained in:
2026-03-13 19:31:06 +10:00
parent 5519b1dd1c
commit 960fc6409e
2 changed files with 53 additions and 89 deletions
+26 -44
View File
@@ -1,59 +1,41 @@
# execution-agent-dispatch # execution-agent-dispatch
A lightweight skill for turning PM decisions into clear worker handoffs. Compatibility wrapper for the dispatch/supervision half of **`worker-orchestrator`**.
## Why this exists ## Status
It is not enough to have execution agents. This README is kept only as a compatibility aid.
They also need a consistent way to receive work and report results. The maintained source of truth is now:
Without that, the system drifts into familiar failure modes: - `skills/worker-orchestrator/SKILL.md`
- vague delegation
- role boundary drift
- workers doing too much or too little
- silent blocking
- messy result reporting
This skill exists to standardize the handoff layer between **main** and execution agents. ## What this wrapper still means
## What it standardizes Use `execution-agent-dispatch` only when you specifically want the **dispatch / handoff / reporting-discipline** half of the orchestration workflow:
- the task packet main sends to a worker - turn a worker plan into a clear task packet
- the result format a worker returns - standardize worker reply format
- when a worker must escalate instead of staying silent - enforce milestone / blocker / completion reporting
- milestone / ETA discipline for delegated work - keep main-to-Tao forwarding discipline explicit
## Core idea ## What it is not
A good worker handoff should answer: This wrapper is **not**:
1. What exactly should be done? - a runtime transport fix
2. What is out of bounds? - evidence that worker↔worker or agent↔agent communication is stable
3. What does success look like? - a substitute for upstream OpenClaw / ACP runtime support
4. When should the worker report back?
5. What should trigger escalation?
## Recommended task packet ## Preferred modern usage
- Task If the task involves both:
- Scope - deciding the worker split
- Deliverable - and dispatching / supervising workers
- Constraints
- Milestone 1 + ETA
## Recommended result packet then use **`worker-orchestrator`** directly.
- `status:` accepted | milestone | blocked | failed | done ## Practical takeaway
- `summary:` ...
- `evidence:` ...
- `risk:` ...
- `next:` ...
## Added operational aids Current safe operating model remains:
- main dispatches workers
- `CHECKLIST.md` — pre-dispatch / post-dispatch / evidence-gate checklist for main - workers execute and report back to main
- `FAILURE_TEMPLATE.md` — compact template for documenting launch failure, stall, or misreporting cases - main integrates and reports to Tao
## Notes
This is a dispatch / coordination skill, not an implementation skill.
It works best after `execution-agent-planner` has already decided which workers should exist and what they should own.
+27 -45
View File
@@ -1,60 +1,42 @@
# execution-agent-planner # execution-agent-planner
A lightweight skill for deciding when a project should stay with one execution agent and when it should be split into multiple specialized execution agents. Compatibility wrapper for the planning half of **`worker-orchestrator`**.
## Why this exists ## Status
Once main takes the PM / architect role, a new question appears: This README is kept only as a compatibility aid.
The maintained source of truth is now:
- Should this project go to one execution agent? - `skills/worker-orchestrator/SKILL.md`
- Or should it be split across several workers with different roles?
Without a repeatable rule, it is easy to drift into two bad extremes: ## What this wrapper still means
- **under-splitting**: main or one worker becomes a catch-all bucket
- **over-splitting**: too many agents, too much coordination, not enough real progress
This skill exists to keep that decision disciplined. Use `execution-agent-planner` only when you specifically want the **planning / splitting** half of the orchestration workflow:
## What it helps decide - decide whether work should stay with one worker or split into several
- define worker roles and boundaries
- avoid over-splitting or under-splitting
- decide what stays with main as PM / reviewer
- whether multiple execution agents are justified ## What it is not
- how many workers to create
- what each worker should own
- what should remain with main as PM / reviewer
- how to split tasks without creating coordination theater
## Core rule This wrapper is **not**:
- a communication-layer fix
- evidence that OpenClaw / ACP inter-agent communication is stable
- a transport or routing solution
Start simple. ## Preferred modern usage
- If work is small, linear, or tightly coupled: keep one execution agent. If the task involves both:
- If work is parallelizable, role-distinct, and context-heavy: split into multiple execution agents. - planning the worker architecture
- and dispatching / supervising workers
## Good reasons to split then use **`worker-orchestrator`** directly.
- frontend / backend / docs / ops / QA are genuinely different tracks ## Practical takeaway
- tasks can run in parallel
- one worker would otherwise mix too many contexts
- outputs need separate validation paths
- the project spans multiple repos or operational domains
## Bad reasons to split Current safe operating model remains:
- main plans
- the project only sounds important - workers execute
- requirements are still fuzzy - workers report back to main
- tasks are tiny - main integrates and reports to Tao
- most agents would just wait on each other
## Suggested output
A good plan should answer:
1. Do we keep one execution agent or use several?
2. What is each agent called?
3. What does each agent own?
4. What does main keep as PM?
5. What is milestone 1?
## Notes
This is not an implementation skill.
It is a planning skill for execution architecture.