subtask-dispatch
Skill2 starsChanged 22 days agoMITView on GitHub
When the host allows dispatch and the task can close independently, split subtasks, reserve resources, dispatch and verify results, and handle unknown in-flight work and recovery. Does not dispatch automatically because there are several files or for the sake of concurrency.
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Start from the current goal, approved scope, dependencies and acceptance:
- Distinctive: line 25
Verify dependencies are satisfied.
≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Subtask dispatch and acceptance
Split an authorised goal into independently acceptable work while every write location always has exactly one executor. If the host allows dispatch only when the user explicitly asks, satisfy that condition first; this package itself grants no dispatch permission.
Decide first whether splitting is worth it
Start from the current goal, approved scope, dependencies and acceptance:
- Several problems can each be solved with their own minimal input, their artefacts accepted separately, and they do not contend for written files or run resources: parallel is possible.
- Two items depend on the same undecided interface, the same database state or the same written file: one writer fixes the boundary first, then hand over serially; read-only review may run in parallel, but never sign off an old version while it is being modified.
- A single small change, a shared root cause not yet understood, or integration cost above the parallel gain: the main task does it directly. When independent review is valuable, split only the review; do not split root-cause work by test-file count.
Without a goal/approval boundary, dispatch no implementation; read-only organisation may continue. Without resource-pool configuration, real run state or stop evidence, do not guess that capacity is free.
Dispatch loop
- Give every task a stable logical ID, goal, minimal sources and exact artefacts; use the task brief template to state readable/writable scope, sole writer, acceptance, failure and stop conditions. Do not paste the whole history; whether context is inherited depends on host capability and task need.
- Verify dependencies are satisfied. Check for conflicts on the same file, environment or resource pool; resource conversion, main-task accounting and unknown in-flight work follow Resource accounting.
- Reserve first, then call dispatch. Record the mapping from request to real execution handle; when the result is unclear keep the occupancy and query the same request first — never send a replacement directly.
- Record the requested grade words (cost tier/reasoning tier) and the actually verifiable result per Host adapters; start only when both host slots and resource-pool units suffice. If either is short, wait, shrink the task or adjust resources per approval.
- The main task continues independent integration preparation. On a block, stop only actions depending on it; when the estimate clearly deviates, report the reason, usage so far and remaining expectation, and offer continue / shrink scope / keep results and end — never treat a timeout as new authorisation.
- On receiving a receipt, read the header first, then verify key body, changes and verification evidence via the locators. Check that the content identifier still matches the current result; if stale, refresh the receipt before review. A summary or "done" label is not acceptance.
- Confirm the author has stopped writing before taking over changes. Check artefact conflicts, omissions and interface consistency; run the necessary combined verification by impact, not a mechanical full run because an upstream example asked for it. Arrange independent review by risk and project requirement; do not treat author self-checks as independent conclusions.
- Release occupancy only after all related executions are confirmed terminated; keep the accumulated actual usage. Hand pass, rework, abort and unverified separately to the existing status maintainer; build no separate status store outside the package.
Recovery and output
On recovery, read existing checkpoints, approvals and the task-to-handle mapping first and query in-flight work; context compaction, message interruption or a business block does not prove execution stopped. While the old writer may still be running stay read-only; hand over write permission only after a confirmed stop. Retries continue the logical task record; a new execution attempt gets its own handle, and existing usage is not counted twice.
Output is the designated result files, a verifiable receipt and the necessary update to the current task status. The plan body belongs to plan-design, the user workbench and continuation status to context-handoff; consume only their locators and approvals, do not copy their templates. Without those packages use the project's existing contracts.
Wrap-up cleanup: containers, processes, temporary files and test data created by subtasks are listed with the receipt; on acceptance the dispatcher takes over unreclaimed items and handles them per the local resource cleanup rule of task-implementation. A subtask ending does not mean cleanup happened.
Resources and counterexamples
Coordination and routine tasks may start the estimate at normal/high; fully mechanical tasks may use low/low; cross-domain root causes or high-risk integration raise reasoning or verify serially. Grade words are suggestions mapped to actual execution configuration through the project resource mapping. Executors, weights, independent resource pools, slots and budgets are host limits supplied by project configuration; insufficient resources cannot be drawn again under another name.
Normal example: two independent documents with fixed interfaces go to different writers, dispatched after reservation and integrated once receipts confirm stop-writing. Misuse example: two test files fail from the same shared-state bug and two implementers are told to change the same module at once; the root-cause investigation should be merged first. Failure example: a dispatch request times out without returning a handle; keep the reservation and query the execution, do not infer failure from a missing receipt and re-dispatch.
Sources
- Pinned source: SP03 dispatching-parallel-agents.
- Adapted independent problem domains, self-contained task briefs and conflict acceptance; resource reservation, unknown in-flight work, stop-writing, accumulated usage and recovery are own-authored for this package. Dropped fixed task counts, never inheriting full history, splitting by test file and automatic full test runs.
- License: shipped with the package as LICENSE-SP.txt (SP, MIT); library-wide third-party summary in the root THIRD_PARTY_NOTICES.md. Copy the license file along when copying this package alone.
In this repository39 other files it gives its agents.
- ai-trace-auditSkill
- ai-workspace-governanceSkill
- archive-maintenanceSkill
- change-reviewSkill
- cloud-api-integrationSkill
- coding-conventionsSkill
- container-image-managementSkill
- context-handoffSkill
- deployment-patternsSkill
- docker-local-environmentSkill
- documentation-authoringSkill
- estimationSkill
- external-dependency-simulationSkill
- gitlab-webhook-local-gitSkill
- go-patternsSkill
- go-testingSkill
- grpc-proto-contractSkill
- guided-evidence-collectionSkill
- http-api-designSkill
- jenkins-pipeline-jjbSkill
- ldap-rbacSkill
- mysql-migration-safetySkill
- plan-designSkill
- plan-reviewSkill
- playwright-e2eSkill
- project-contextSkill
- pytest-patternsSkill
- readonly-ops-diagnosticsSkill
- redis-patternsSkill
- release-readinessSkill
- role-bootstrapSkill
- security-reviewSkill
- skill-maintenanceSkill
- systematic-diagnosisSkill
- task-implementationSkill
- test-strategySkill
- verification-gateSkill
- vue3-developmentSkill
- vue-testingSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

