Menu
Obey Plan 1A hook session phases so mutating tools, delegate_task sizing, and re-planning do not waste turns or trigger blocks.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Keep coordinator and leaf context lean-batch reads, cap logs, use execute_code to filter-so swarms stay fast and within token limits.
Use at the start of non-trivial software tasks. Gather repo ground truth with batched reads and searches before planning or delegate_task.
Use when spawning delegate_task leaves for coding work. Pack self-contained goals and context so parallel Composer workers ship verifiable patches without coordinator chat history.
Require structured candidate-result JSON from swarm leaves so critique_candidates.py and synthesis run on evidence, not prose self-reports.
Enrich slim hook-injected delegate_tasks with touch map, failure excerpts, and verification commands so parallel leaves produce verifiable patches without coordinator chat history.
After failed candidates or a red ship gate, spawn a narrow focused delegate_task wave with failure evidence instead of re-running a full-width council.
| name | heavy-hook-phases |
| description | Obey Plan 1A hook session phases so mutating tools, delegate_task sizing, and re-planning do not waste turns or trigger blocks. |
| version | 0.1.0 |
| author | CodeGraphTheory |
| license | MIT |
| metadata | {"hermes":{"tags":["heavy-coder","hooks","coordinator","performance"],"related_skills":["heavy-swarm-dispatch","heavy-synthesize-winner","heavy-single-mode"]}} |
Shell hooks track a session phase per coordinator session. Ignoring phases causes blocked patch calls, duplicate council plans, and confused users. This skill is the operational cheatsheet aligned with agent-hooks/*.py.
patch, write_file, delegate_task, or write-like terminalASYNC DELEGATION BATCH COMPLETE or mid-swarm| Phase | Typical trigger | Coordinator may | Coordinator must not |
|---|---|---|---|
IDLE | Session start, trivial chat | Read-only tools | Assume swarm already ran |
AWAITING_DELEGATE | pre_llm_heavy_team injected plan | Full-width delegate_task; read/todo | Repo writes; undersized delegate |
AWAITING_SYNTHESIS | post_delegate_task after dispatch | Synthesis reads; then writes after merge plan | New full council for same task |
| (implicit complete) | After ship gate / user new task | Normal tools for new task | Re-use old width state blindly |
Single mode (from task excerpt) relaxes delegate minimum and write blocks-see heavy-single-mode.
delegate_taskprofile_cfg.delegate_minimum(width) (default 8 when council_width and min_delegate_tasks are 8).heavy-swarm-dispatch).patch / write_fileAWAITING_DELEGATE unless single mode.heavy-synthesize-winner).terminalsed -i, destructive git) blocked before delegation.heavy-ship-gate).pre_llm_call re-injectionAWAITING_SYNTHESIS or message contains batch complete marker.| Path | Purpose |
|---|---|
.heavy-coder/plans/<session>.json | Full plan + delegate_tasks |
.heavy-coder/evidence/<child>.json | Leaf evidence from subagent_stop |
.heavy-coder/swarm-progress.json | Live dashboard for swarm_watch.py |
When blocked, explain in one sentence: phase, required next step (delegate_task with N tasks), or single-mode opt-out.
Done when: next tool call matches the phase column above.