mirror of
https://github.com/dtzp555-max/memory-continuity.git
synced 2026-07-22 13:35:06 +00:00
docs: convert legacy execution-agent readmes to wrappers
This commit is contained in:
@@ -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.
|
|
||||||
|
|||||||
@@ -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.
|
|
||||||
|
|||||||
Reference in New Issue
Block a user