What problem does it solve? Delegating ad-hoc work to background coding agents is error-prone: agents launched without permission flags stall on approval prompts, prompts get sent into dialogs, and worktrees leak after tasks finish. This Skill standardizes the whole dispatch lifecycle through one bundled script that launches, verifies, kicks off, and reaps agents consistently. ## Core Features & Use Cases - Role-based dispatch: Launch a worker in a fresh git worktree on its own branch for code changes, or a planner on the primary checkout's main branch for analysis and planning docs. - Verified launch: The bundled herdr-worker.sh script checks herdr version and integration, confirms the agent's argv carries bypass-permission flags, validates the working directory and role, and confirms kickoff before returning a single JSON result. - Structured failure handling: Every failure returns a machine-readable error code (worktree_exists, agent_not_ready, kickoff_failed, not_on_main) with guidance on how to recover, plus lifecycle commands for follow-up prompts, verification, and safe teardown that refuses to destroy uncommitted work. - Use Case: You want a typo fixed or a spike investigated without leaving your current session — delegate the prompt, get back the agent's name, branch, and pane, and check on it later or reap it when done. ## Quick Start Ask the agent to delegate a specific task, for example: delegate fixing the broken links in the README to a background worker.
