Menu
Launch a subagent with proper template, ports, branch verification, and user announcement
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
Use when bringing the harness method to a NEW or non-sentropic repo — maps the repo's conventions into a harness profile so the same scope/branch/verify kernel applies anywhere.
Use before any creative/design work (a feature, a package, an evolution) — explores intent and design via the spec-ladder with multi-peer adversarial review BEFORE implementation.
Use on any bug, test failure, or unexpected behaviour BEFORE proposing a fix — runs the generic evidence-first root-cause loop.
Use when you have a spec/decisions and need an executable plan — writes a lot-based BRANCH.md from the template and completes with track for realization state.
Use when completing a feature, a design step, or before merging — runs a ≥2-peer consensus review and reconciles the findings, instead of a single rubber-stamp pass.
Use when adding or evolving tests for a feature/bugfix — applies the sentropic test-pyramid, scoped-test loop, environment isolation, and AI-flaky policy.
| name | launch-agent |
| description | Launch a subagent with proper template, ports, branch verification, and user announcement |
| allowed-tools | Read Bash Agent Glob Grep |
Workflow skill to launch sub-agents following the mandatory SUBAGENT_PROMPT_TEMPLATE contract.
Verify branch
git -C <worktree-path> branch --show-current
Abort if the current branch does not match the expected branch from BRANCH.md or PLAN.md.
Read the template
Read plan/SUBAGENT_PROMPT_TEMPLATE.md in full. This is the source of truth for the agent prompt structure.
Fill the launch packet Populate every field from the template:
tmp/<slug>)planning-only or implementationAllocate ports (all 3 mandatory) Every sub-agent MUST receive all three ports:
API_PORT (convention: 87xx based on branch index)UI_PORT (convention: 51xx based on branch index)MAILDEV_UI_PORT (convention: 10xx based on branch index)
Missing even ONE port kills the dev environment. Verify port availability before assignment.Announce to user Before launching, present:
WAIT for user validation Do NOT launch any agent until the user explicitly confirms. This is a blocking gate.
Launch with AGENT_SIG
Include AGENT_SIG:7f3a9c2e1b in every agent prompt. This signature allows tracking which agents are active.
rules/MASTER.md -> rules/workflow.md -> rules/subagents.md -> rules/testing.md -> rules/security.md -> domain rules -> PLAN.md -> SPEC files -> BRANCH.md -> plan/BRANCH_TEMPLATE.mdplan/BRANCH_TEMPLATE.md strictlymake commit MSG="type: description" onlygit add <specific-files> then make commit — never git add .ENV=<dev|test|e2e>-<branch-slug>, ENV as last argument