Development workflows for AI coding agents in herdr, adapted from obra/superpowers.
Coordinates planning, implementation, testing, and review across agent panes.
- Automatic task delegation from the orchestrator to agent panes.
- Independent pane contexts, with configurable separation of test authors and implementers.
- Superpowers features adapted for development across panes.
| Superpowers | herdrpowers | |
|---|---|---|
| worker | in-process subagent | idle sibling herdr pane; a profile without a separate coder or reviewer, or a role whose pane is not open, uses a fresh subagent |
| task loop | subagent-driven-development |
pane-driven-development |
| parallel work | dispatching-parallel-agents |
panes, bounded by idle panes and worktrees |
| entry point | skills trigger themselves | commands/ workflows, plus the same skills |
| routing | fixed in the skill | .herdrpowers/config.yaml over roles.yaml, plus an optional profile |
| who writes tests | the implementer, always | the test-authoring assignment |
| review | one reviewer subagent | a role bound to a list of agent types: one review per entry |
/plugin marketplace add transparent-pegasus/herdrpowers
/plugin install herdrpowers@herdrpowers
codex plugin marketplace add https://github.com/transparent-pegasus/herdrpowers
codex plugin add herdrpowers@herdrpowerscursor-agent plugin marketplace add https://github.com/transparent-pegasus/herdrpowersAlternatively, install from this repository through the Cursor Marketplace.
opencode plugin add git+https://github.com/transparent-pegasus/herdrpowers.gitUse opencode2 if that is your binary's name.
For OpenCode 1, see OpenCode setup.
agy plugin install https://github.com/transparent-pegasus/herdrpowersRun the same command again to update. Antigravity plugins cannot ship
commands, so each workflow comes as a skill, listed in the interactive CLI as
/herdrpowers:..:.antigravity-plugin:commands:<name>. Typing
/herdrpowers:<name> selects it, except /herdrpowers:plan, which selects
/herdrpowers:writing-plans: pick plan from the menu instead.
Install with agy plugin install, not agy plugin import. Importing
herdrpowers from Claude Code converts it, drops commands/, and leaves the
workflow skills pointing at files that no longer exist. Running the install
command over an imported copy replaces it.
Run the init workflow once per repository:
/herdrpowers:init
Then tell your agent what you want to build.
The agent normally chooses between full_cycle and quick based on the task.
Invoke either command when you want to choose explicitly.
Use plan followed by execute or execute_parallel to separate planning
and execution in time or across execution environments.
Choose execute for sequential execution, or execute_parallel to run
independent tracks in parallel worktrees.
See Workflows for all commands and how to invoke them in each agent.
Repository settings stay outside the plugin and survive updates:
AGENTS.md/CLAUDE.md: base branch, verification commands, and shared worktree directory (WORKTREE_DIRECTORY, default.worktrees/)..herdrpowers/config.yaml: agent roles, task assignments, delegation scope, review settings, the selectedprofile,allow_agent_lifecycle, andreviewer_usage_limit..herdrpowers/profiles/: presets for role targets, models/effort, and optional fallback, delegation, and assignment overrides. Init installs the shipped ones without overwriting yours; their README explains the names.
profile: fable # or name one in the task; null selects none
allow_agent_lifecycle: false # true: the orchestrator may start and end agents in panes
reviewer_usage_limit: skip # wait: hold a review gate until a usage-limited reviewer resetsA profile slot written any takes its target from the task, as in
solo Opus 5.5 max or neon-fable coder: codex; parts left out stay open.
A profile overrides only present keys. Omitted keys keep config/default
values; maps merge per key and lists replace, including empty lists.
Assignment overrides may change modes and review gates; lifecycle permission
remains config-only. Model and effort must match what each pane shows in its
footer; effort: any leaves the effort to the orchestrator, which reports its
choice. A role whose pane is not open, with no usable fallback, runs in a
fresh subagent of the orchestrator's own kind unless
delegation.subagent_fallback is false. With allow_agent_lifecycle: true the orchestrator starts the
selected composition's missing agents in idle shell panes and ends the ones it
started; with false, the default, it never starts or ends an agent. See
Roles for the rules.
Relative worktree paths resolve from the primary checkout so all agents share the same parent directory. Delegation stays within one herdr tab unless configured otherwise.
Delegation requires herdr with herdr --skill support and available agent panes.
Planning, TDD, debugging, and verification skills also work outside herdr.
Verify new or upgraded delegation targets with the composer probe.
Workflows · Roles · Skills · OpenCode setup