$swarm Spawn isolated agents to execute tasks in parallel with Codex session agents. Fresh context per agent. Integration modes: - Via - crank creates waves from beads and invokes for each wave - Standalone - direct invocation for ad-hoc parallel work Requires a multi-agent runtime. Prefer runtime-native Codex session agents. If spawning is unavailable, fall back to sequential execution in the current session. Architecture Runtime preference: 1. If is available, use Codex session agents. 2. If your runtime exposes roles, use for execution and for file discovery. 3. If spawning is unavailable,…

\"\ncheck \"SKILL.md has name: swarm\" \"grep -q '^name: swarm' '$SKILL_DIR/SKILL.md'\"\ncheck \"Local mode documented\" \"grep -q 'Local' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md requires metadata.issue_type\" \"grep -q 'metadata.issue_type' '$SKILL_DIR/SKILL.md'\"\ncheck \"Backend references documented\" \"grep -qE 'backend-codex-subagents' '$SKILL_DIR/SKILL.md'\"\ncheck \"Shared backend docs exist\" \"[ -f '$SKILL_DIR/../shared/references/backend-codex-subagents.md' ]\"\ncheck \"Cleanup lifecycle documented\" \"grep -qiE 'cleanup|close_agent|reaper' '$SKILL_DIR/SKILL.md'\"\n\necho \"\"; echo \"Results: $PASS passed, $FAIL failed\"\n[ $FAIL -eq 0 ] && exit 0 || exit 1\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":1001,"content_sha256":"7413034fbf8a67e3536a235226b7d877ff7135aa3e80e6531447eb257f849246"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"$swarm","type":"text"}]},{"type":"paragraph","content":[{"text":"Spawn isolated agents to execute tasks in parallel with Codex session agents. Fresh context per agent.","type":"text"}]},{"type":"paragraph","content":[{"text":"Integration modes:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Via ","type":"text","marks":[{"type":"strong"}]},{"text":"$crank","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" - crank creates waves from beads and invokes ","type":"text"},{"text":"$swarm","type":"text","marks":[{"type":"code_inline"}]},{"text":" for each wave","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Standalone","type":"text","marks":[{"type":"strong"}]},{"text":" - direct invocation for ad-hoc parallel work","type":"text"}]}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Requires a multi-agent runtime.","type":"text","marks":[{"type":"strong"}]},{"text":" Prefer runtime-native Codex session agents. If spawning is unavailable, fall back to sequential execution in the current session.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Architecture","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"text"},"content":[{"text":"Lead (this session)\n |\n +-> Identify the wave: tasks with no blockers\n +-> Build explicit file manifests\n +-> Pre-spawn conflict check (file ownership)\n +-> Spawn one worker per task\n +-> Wait for completion\n +-> Validate changes and close or retry tasks\n +-> Repeat if more work remains","type":"text"}]},{"type":"paragraph","content":[{"text":"Runtime preference:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"spawn_agent","type":"text","marks":[{"type":"code_inline"}]},{"text":" is available, use Codex session agents.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If your runtime exposes ","type":"text"},{"text":"agent_type","type":"text","marks":[{"type":"code_inline"}]},{"text":" roles, use ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"code_inline"}]},{"text":" for execution and ","type":"text"},{"text":"explorer","type":"text","marks":[{"type":"code_inline"}]},{"text":" for file discovery.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If spawning is unavailable, execute sequentially and keep the same file-manifest contract.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Execution","type":"text"}]},{"type":"paragraph","content":[{"text":"Given ","type":"text"},{"text":"$swarm","type":"text","marks":[{"type":"code_inline"}]},{"text":":","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Local Mode","type":"text"}]},{"type":"paragraph","content":[{"text":"In local mode, keep the same file-manifest contract and execute workers sequentially when the runtime cannot spawn agents.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 0: Detect Multi-Agent Capability","type":"text"}]},{"type":"paragraph","content":[{"text":"Check whether the runtime can spawn agents. If not:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"text"},"content":[{"text":"WARN: Multi-agent not available. Executing tasks sequentially in this session.","type":"text"}]},{"type":"paragraph","content":[{"text":"Fall back to serial execution within the current session.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 1: Ensure Tasks Exist","type":"text"}]},{"type":"paragraph","content":[{"text":"Tasks come from one of:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"bd ready","type":"text","marks":[{"type":"code_inline"}]},{"text":" output","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"An explicit task list from ","type":"text"},{"text":"$crank","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"A user-provided description that you decompose first","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Each task needs:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"id","type":"text","marks":[{"type":"code_inline"}]},{"text":" - unique identifier","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"subject","type":"text","marks":[{"type":"code_inline"}]},{"text":" - what to do","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"description","type":"text","marks":[{"type":"code_inline"}]},{"text":" - detailed instructions","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"files","type":"text","marks":[{"type":"code_inline"}]},{"text":" - file manifest for worker ownership","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"validation","type":"text","marks":[{"type":"code_inline"}]},{"text":" - how to verify completion","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"metadata.issue_type","type":"text","marks":[{"type":"code_inline"}]},{"text":" - the canonical task type used by the lead when tracking work","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 1.5: Populate File Manifests","type":"text"}]},{"type":"paragraph","content":[{"text":"If any task is missing a file manifest, spawn explorer agents to identify files. Use the explorer role if your runtime exposes roles:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"text"},"content":[{"text":"spawn_agent(message=\"You are explorer-1.\n\nTask: Given this task, identify all files that will need to be created or modified.\nReturn a JSON array of file paths only.\nTask subject: \u003csubject>\nTask description: \u003cdescription>\")","type":"text"}]},{"type":"paragraph","content":[{"text":"Inject the discovered file list back into the task manifest before spawning workers.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 1.6: Advisory Bead Clustering","type":"text"}]},{"type":"paragraph","content":[{"text":"When tasks come from bd and ","type":"text"},{"text":"scripts/bd-cluster.sh","type":"text","marks":[{"type":"code_inline"}]},{"text":" exists, run ","type":"text"},{"text":"scripts/bd-cluster.sh --json 2>/dev/null || true","type":"text","marks":[{"type":"code_inline"}]},{"text":" before Step 2. Summarize any clusters as consolidation hints only; never run ","type":"text"},{"text":"--apply","type":"text","marks":[{"type":"code_inline"}]},{"text":" here, and keep Step 2's file-manifest and dependency gates authoritative.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 2: Pre-Spawn Conflict Check","type":"text"}]},{"type":"paragraph","content":[{"text":"Pre-Spawn Friction Gates:","type":"text","marks":[{"type":"strong"}]},{"text":" Before spawning workers, execute all 5 friction gates (base sync, file manifest, dependency graph, misalignment breaker, wave cap). See ","type":"text"},{"text":"references/pre-spawn-friction-gates.md","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"text"},"content":[{"text":"wave_tasks = [tasks with status=pending and no blockers]\nall_files = {}\nfor task in wave_tasks:\n for f in task.files:\n if f in all_files:\n CONFLICT: f claimed by both all_files[f] and task.id\n all_files[f] = task.id","type":"text"}]},{"type":"paragraph","content":[{"text":"On conflict:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Serialize conflicting workers into separate sub-waves","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Do not spawn overlapping file manifests into the same shared-worktree wave","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Display an ownership table before spawning:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"text"},"content":[{"text":"File Ownership Map (Wave N):\n┌─────────────────────────────┬──────────┬──────────┐\n│ File │ Owner │ Conflict │\n├─────────────────────────────┼──────────┼──────────┤\n│ src/auth/middleware.go │ task-1 │ │\n│ src/api/routes.go │ task-2 │ │\n└─────────────────────────────┴──────────┴──────────┘\nConflicts: 0","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 3: Spawn Workers","type":"text"}]},{"type":"paragraph","content":[{"text":"Build one worker prompt per task. Each worker gets a single assignment and a single file manifest.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"text"},"content":[{"text":"spawn_agent(message=\"You are worker-\u003ctask-id>.\n\nAssignment: \u003csubject>\n\n\u003cdescription>\n\nFILE MANIFEST (files you are permitted to modify):\n\u003clist of files>\n\nRules:\n1. Stay within your assigned files\n2. Run validation: \u003cvalidation_cmd>\n3. Write your result to .agents/swarm/results/\u003ctask-id>.json\n4. Keep any message back to the lead short\n\nResult file format:\nOn success:\n{\\\"type\\\":\\\"completion\\\",\\\"issue_id\\\":\\\"\u003ctask-id>\\\",\\\"status\\\":\\\"done\\\",\\\"detail\\\":\\\"\u003cone-line summary>\\\",\\\"artifacts\\\":[\\\"path/to/file1\\\"],\\\"worktreePath\\\":\\\"\u003cabsolute-worktree-path-or-empty>\\\"}\n\nIf blocked:\n{\\\"type\\\":\\\"blocked\\\",\\\"issue_id\\\":\\\"\u003ctask-id>\\\",\\\"status\\\":\\\"blocked\\\",\\\"detail\\\":\\\"\u003creason>\\\",\\\"worktreePath\\\":\\\"\u003cabsolute-worktree-path-or-empty>\\\"}\n\nKnowledge artifacts are in .agents/. See .agents/AGENTS.md for navigation.\")","type":"text"}]},{"type":"paragraph","content":[{"text":"If your runtime supports ","type":"text"},{"text":"agent_type","type":"text","marks":[{"type":"code_inline"}]},{"text":", mark these as ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"code_inline"}]},{"text":" agents and keep any file-discovery agents as ","type":"text"},{"text":"explorer","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 4: Wait and Collect Results","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"text"},"content":[{"text":"wait_agent(targets=[\"agent-id-1\", \"agent-id-2\"])","type":"text"}]},{"type":"paragraph","content":[{"text":"Collect worker result files from ","type":"text"},{"text":".agents/swarm/results/","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"If a worker needs a short correction, use:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"text"},"content":[{"text":"send_input(target=\"agent-id-1\", message=\"Validation failed. Fix the test failure and retry.\")","type":"text"}]},{"type":"paragraph","content":[{"text":"If a worker stalls, use:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"text"},"content":[{"text":"close_agent(target=\"agent-id-1\")","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 5: Validate Wave","type":"text"}]},{"type":"paragraph","content":[{"text":"For each worker result:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"PASS","type":"text","marks":[{"type":"code_inline"}]},{"text":" - accept changes","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"FAIL","type":"text","marks":[{"type":"code_inline"}]},{"text":" - log failure, mark for retry, max 2 retries per task","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"BLOCKED","type":"text","marks":[{"type":"code_inline"}]},{"text":" - escalate to the lead","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"After collecting results, run project-level tests appropriate to the wave.","type":"text"}]},{"type":"paragraph","content":[{"text":"If tests fail, identify which worker's changes caused the break and requeue only that work.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 6: Report Results","type":"text"}]},{"type":"paragraph","content":[{"text":"Output a wave summary with task status, files changed, and any retries.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Test File Naming Validation","type":"text"}]},{"type":"paragraph","content":[{"text":"When workers create test files, validate naming:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Go: ","type":"text"},{"text":"\u003csource>_test.go","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"\u003csource>_extra_test.go","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Python: ","type":"text"},{"text":"test_\u003cmodule>.py","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"\u003cmodule>_test.py","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Output Schema Size Guard","type":"text"}]},{"type":"paragraph","content":[{"text":"When 5+ workers share the same output schema, cache it to ","type":"text"},{"text":".agents/swarm/output-schema.json","type":"text","marks":[{"type":"code_inline"}]},{"text":" and reference it by path instead of inlining it everywhere.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Serial Fallback","type":"text"}]},{"type":"paragraph","content":[{"text":"If spawning is unavailable, execute tasks sequentially:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"text"},"content":[{"text":"for task in wave_tasks:\n 1. Read task details\n 2. Implement changes\n 3. Run validation\n 4. Record result","type":"text"}]},{"type":"paragraph","content":[{"text":"This is slower but functionally identical.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reference Documents","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/conflict-recovery.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/conflict-recovery.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/cold-start-contexts.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/cold-start-contexts.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/backend-background-tasks.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/backend-background-tasks.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/backend-codex-subagents.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/backend-codex-subagents.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/backend-inline.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/backend-inline.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/local-mode.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/local-mode.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/ralph-loop-contract.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/ralph-loop-contract.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/validation-contract.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/validation-contract.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/worker-pitfalls.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/worker-pitfalls.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/pre-spawn-friction-gates.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/pre-spawn-friction-gates.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/scope-escape-template.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/scope-escape-template.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/worker-pre-task-checks.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/worker-pre-task-checks.md","title":null}}]}]}]}]},{"type":"hr","attrs":{"markup":"---"}}]},"metadata":{"date":"2026-06-05","name":"swarm","author":"@skillopedia","source":{"stars":375,"repo_name":"agentops","origin_url":"https://github.com/boshu2/agentops/blob/HEAD/skills-codex/swarm/SKILL.md","repo_owner":"boshu2","body_sha256":"20993b2d50c6055f3ea5a10441e8dd6c24f15975c7c166bc1a78ff49d28cec20","cluster_key":"2df6e8add5ab70660e546c0f6a05ba3764466d4f5127b9e217dd4e5471f00810","clean_bundle":{"format":"clean-skill-bundle-v1","source":"boshu2/agentops/skills-codex/swarm/SKILL.md","attachments":[{"id":"9c675608-6753-5143-980f-d3e1ffef0017","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/9c675608-6753-5143-980f-d3e1ffef0017/attachment.json","path":".agentops-generated.json","size":269,"sha256":"240ad4bd291ee58584007479d619973e0b052c715a533ec0b56ac98a8b110384","contentType":"application/json; charset=utf-8"},{"id":"74aabe8d-49c9-5ba7-8ad5-089de890ddfb","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/74aabe8d-49c9-5ba7-8ad5-089de890ddfb/attachment.md","path":"prompt.md","size":601,"sha256":"6ee99b3791a3ed38971e518f82856b9bcced4f2b17c2d1faba4c9c1e44ad031a","contentType":"text/markdown; charset=utf-8"},{"id":"a92e4198-e041-5a62-ad18-e9903cc6f6ab","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/a92e4198-e041-5a62-ad18-e9903cc6f6ab/attachment.md","path":"references/backend-background-tasks.md","size":1830,"sha256":"b0e3d884426da7eeaffd7c1d806656e7ae115f6c09685f944dcec9feb6038596","contentType":"text/markdown; charset=utf-8"},{"id":"18d8d64c-bcdb-50e5-9f46-3fe61fd3a3a1","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/18d8d64c-bcdb-50e5-9f46-3fe61fd3a3a1/attachment.md","path":"references/backend-codex-subagents.md","size":2211,"sha256":"de636c2c8fa9e11c9a10e5ba9d587cbcbf4847ff3225ccc06ee0d88f9414e222","contentType":"text/markdown; charset=utf-8"},{"id":"e7b93b4c-4781-5944-b766-9f19e4779e9a","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/e7b93b4c-4781-5944-b766-9f19e4779e9a/attachment.md","path":"references/backend-inline.md","size":2059,"sha256":"03ecb27fd2f8cf59d207f2266477d1bb6058b22908dcefbfef417db3932e3ec6","contentType":"text/markdown; charset=utf-8"},{"id":"0063dca7-80b4-563b-bdad-44dc43d869db","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/0063dca7-80b4-563b-bdad-44dc43d869db/attachment.md","path":"references/cold-start-contexts.md","size":4249,"sha256":"431887b1f3b76259304052e6d33b0002ba2bbe31920093b1123cd09eb0da7b0c","contentType":"text/markdown; charset=utf-8"},{"id":"eb84db33-1d55-5ee8-9d9c-e1ee58bdd0cf","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/eb84db33-1d55-5ee8-9d9c-e1ee58bdd0cf/attachment.md","path":"references/conflict-recovery.md","size":3595,"sha256":"787c2fa212669cf00d7291bb9f18b7771039a75784808830431c49d296fd4dcb","contentType":"text/markdown; charset=utf-8"},{"id":"5064c6ee-26c5-5f6c-8866-7d969ae6b6e4","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/5064c6ee-26c5-5f6c-8866-7d969ae6b6e4/attachment.md","path":"references/local-mode.md","size":18099,"sha256":"41e55bb0a4ccb3f8f90e31f6f0ced189dfc63680f4131aa3685d9ab6d54385b1","contentType":"text/markdown; charset=utf-8"},{"id":"476dcc94-e94a-552a-96e4-2aeebcec64a0","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/476dcc94-e94a-552a-96e4-2aeebcec64a0/attachment.md","path":"references/pre-spawn-friction-gates.md","size":3838,"sha256":"9423bd7bdf85ca513ccd1c040a3ffd6ced825f1f58d5cfc6a43e3a34d14375dc","contentType":"text/markdown; charset=utf-8"},{"id":"2b089089-822e-5b7f-9c9f-c5e760147565","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/2b089089-822e-5b7f-9c9f-c5e760147565/attachment.md","path":"references/ralph-loop-contract.md","size":1924,"sha256":"20999f4507ebb1bc22853d0b805064668328ce58bcf8b5c083e6817f39c83f11","contentType":"text/markdown; charset=utf-8"},{"id":"46697c04-0520-5034-a42b-e4a776aade82","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/46697c04-0520-5034-a42b-e4a776aade82/attachment.md","path":"references/scope-escape-template.md","size":2107,"sha256":"1b57d6d7ff623a4cb136aa83c361925d70f1e4b52dd51a9a00e6e987eb88ae56","contentType":"text/markdown; charset=utf-8"},{"id":"987e5915-ec69-5330-a951-5c388338e207","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/987e5915-ec69-5330-a951-5c388338e207/attachment.md","path":"references/validation-contract.md","size":154,"sha256":"72a4cb2749f8c3d49b5d2b37a422019c974186b778cf08f1142703e63d4585da","contentType":"text/markdown; charset=utf-8"},{"id":"58a920a9-ead7-5d7d-ade0-3700a6917010","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/58a920a9-ead7-5d7d-ade0-3700a6917010/attachment.md","path":"references/worker-pitfalls.md","size":4225,"sha256":"e3b87c04a48bf12065f24972ed67911e2f73addd358413aa080127c20dd05748","contentType":"text/markdown; charset=utf-8"},{"id":"ab2ae976-85f6-514b-914a-8da082fe068d","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/ab2ae976-85f6-514b-914a-8da082fe068d/attachment.md","path":"references/worker-pre-task-checks.md","size":3275,"sha256":"b3bc527af8ce6626720fcb1da204295ea5a24def682282b0ed5e0b570f693676","contentType":"text/markdown; charset=utf-8"},{"id":"3d226b17-cefb-5e39-968c-77a0a7bafc22","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/3d226b17-cefb-5e39-968c-77a0a7bafc22/attachment.sh","path":"scripts/validate.sh","size":1001,"sha256":"7413034fbf8a67e3536a235226b7d877ff7135aa3e80e6531447eb257f849246","contentType":"application/x-sh; charset=utf-8"}],"bundle_sha256":"23e1b49c9b9a126db818fa84ceb63cfa1d0fa0caafc84732135506a3751e24fc","attachment_count":15,"text_attachments":15,"attachment_storage":"skillopedia-attachments-v1","binary_attachments":0,"excluded_attachments":[]},"cluster_size":1,"skill_md_path":"skills-codex/swarm/SKILL.md","import_metadata":{"date":"2026-06-05","author":"@skillopedia","version":"v1","category":"general","category_label":"General"},"exact_dupes_collapsed_into_this":0},"version":"v1","category":"general","import_tag":"clean-skills-v1","description":"Dispatch parallel agents."}},"renderedAt":1782981441371}

$swarm Spawn isolated agents to execute tasks in parallel with Codex session agents. Fresh context per agent. Integration modes: - Via - crank creates waves from beads and invokes for each wave - Standalone - direct invocation for ad-hoc parallel work Requires a multi-agent runtime. Prefer runtime-native Codex session agents. If spawning is unavailable, fall back to sequential execution in the current session. Architecture Runtime preference: 1. If is available, use Codex session agents. 2. If your runtime exposes roles, use for execution and for file discovery. 3. If spawning is unavailable,…