hydra
Hydra — supervisor that routes work across executive/engineering/creative squads.
Plugin hydra from marketplace hydra-local in lebobo88/Hydra. Commands read from the repo's manifest — 13 days ago.
This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.
What it installs
Skills (20)
add-squadScaffold a new squad pack: creates squads/<slug>/squad.yaml from a template + registers keyword fingerprints.
approveApprove a paused HITL gate and resume the supervisor graph.
budget-controlPer-workflow budget enforcement: tripwire at 80% (downgrade model tier), HITL at 100%. Telemetry pattern for cost-per-task tracking.
budgetShow rolling budget consumption across workflows; optionally set a new cap.
campaignMulti-squad campaign template: routes executive + creative + engineering in one workflow with explicit dependency wiring. With the plan phase on, a campaign's dependency chain becomes a judged PLAN with real depends_on rather than prose.
claude-native-reviewRead-only review of Hydra's Claude Code configuration, prompts, hooks, and MCP integration. Use when auditing Claude-native adoption or preparing a governed modernization plan.
cross-squad-messageHow to construct, validate, and route Hydra's typed cross-squad message envelopes. Use whenever an agent emits or consumes a CSuiteDecisionPacket, PRD, ArchRFC, DevTask, CreativeBrief, ShotList, AssetJob, HITLRequest, DecisionRecord, or Handoff.
driveAttended (host-bridged) execution: drive the Hydra supervisor lifecycle IN-CONTEXT so you follow along, with engineering generation + judging surfacing as visible Agent subagents.
evidence-citation-reviewRead-only evidence and citation audit for Hydra artifacts. Use before synthesis, legal/compliance handoff, or when claims need source-grounding review.
hitl-protocolWhen and how Hydra pauses for human input. Defines HITL gate placement, render format, resume contracts, expiry behavior, and override semantics.
legal-summary-intakePrepare a citation-grounded legal/compliance intake for the Curia. Use when legal documents need source-first summarization before Hydra routes them to legal-compliance.
memory-handlesMemory fabric usage — ephemeral / episodic / semantic. Read this before reading from or writing to Hydra memory.
planThe planning squad's own runbook: Pyrrha (plan-author) → Momus (plan-critic) → Theseus (plan-scribe) gate a PLAN artifact before any squad is dispatched. Read this before touching squads/planning/ or before wiring the engine to seed a planning task (P5).
replayReplay a past workflow from checkpoint (LangGraph checkpoint → optionally pinned to original model/CLI versions).
resumeResume a paused workflow with a non-approval action: reject, modify-budget, force-dispatch, change-squads.
runRun a goal through Hydra's full supervisor lifecycle. Routes to 1+ squads, executes, synthesizes, postchecks.
squad-registry-discoveryHow Hydra discovers, resolves, and routes to squad packs. Read this before adding/removing/modifying a squad.
squadsList discovered squad packs (registry resolution: project → user → built-in).
statusShow recent Hydra workflows or the structured state of a specific workflow.
workflow-recoveryRead-only Hydra workflow status and recovery diagnosis. Use when a workflow paused, timed out, surfaced, or needs operator-facing next steps.
Subagents (11)
engineerCode-generator sub-agent for Hydra attended engineering. Spawned by hydra.workflow.step/submit_host_result to implement engineering tasks in an isolated worktree. Use ONLY inside an active attended Hydra engineering stage (host_action.agent_type == "engineer").
hydra-cfo-gateBudget tripwire. Re-checks workflow cost against the configured budget after every squad return; downgrades model tier at 80%, blocks at 100% pending HITL. Drives on top of the CFO agent from the executive squad.
hydra-hitl-gateOwns the human-in-the-loop interrupt boundary. Renders pending HITL_REQUEST envelopes to the operator, captures the decision, and resumes the supervisor graph.
hydra-plannerDecomposes a routed goal into typed cross-squad envelopes. When the executive squad is in play, defers to ExecutiveSuite's boardroom for strategic framing first.
hydra-plazaHydra, the terse register. Same contract as hydra, with squad slugs and the shortest correct answers.
hydra-routerRoutes work to the correct squad pack. Uses keyword + industry tags first, then falls back to LLM classification when ambiguous. Used by hydra-supervisor and as the engine behind /hydra:run intake.
hydra-supervisorTop-level Hydra supervisor. Owns the workflow lifecycle: intake → planning → approval → dispatch → executing → synthesis → postcheck. Drives the LangGraph state machine in hydra_core/supervisor.py.
hydra-synthesizerJoins parallel squad outputs into a single DECISION_RECORD with rationale, artifact links, and preserved dissenting opinions. Runs after dispatch, before postcheck.
hydraHydra, the Enterprise Agent Mesh orchestrator. The agent the operator talks to.
judge-cross-vendorCross-vendor judge for Hydra attended engineering. Spawned by hydra.workflow.submit_host_result when gate_eligible_judges returns required_cross_vendor=true. Evaluates the engineer's diff against a rubric using a different vendor than the generator.
judge-same-vendorSame-vendor judge for Hydra attended engineering. Spawned by hydra.workflow.submit_host_result when gate_eligible_judges returns required_cross_vendor=false. Evaluates the engineer's diff against a rubric using the same vendor (Claude).
Hooks (16)
- SessionStart
pwsh -NoProfile -File "${CLAUDE_PLUGIN_ROOT}/hooks/hydra-doctor.ps1" doctor --quick
- SessionStart
pwsh -NoProfile -File "${CLAUDE_PLUGIN_ROOT}/hooks/hydra-session-contract.ps1"
- UserPromptSubmit
pwsh -NoProfile -File "${CLAUDE_PLUGIN_ROOT}/hooks/hydra-doctor.ps1" squads
- UserPromptSubmit
pwsh -NoProfile -File "${CLAUDE_PLUGIN_ROOT}/hooks/hydra-route-directive.ps1"
- PreToolUse
pwsh -NoProfile -File "${CLAUDE_PLUGIN_ROOT}/hooks/hydra-block-direct-write.ps1"
- PreToolUse
pwsh -NoProfile -File "${CLAUDE_PLUGIN_ROOT}/hooks/hydra-block-bash-writes.ps1"
- PreToolUse
pwsh -NoProfile -File "${CLAUDE_PLUGIN_ROOT}/hooks/hydra-block-direct-pp.ps1"
- PreToolUse
python "${CLAUDE_PLUGIN_ROOT}/hooks/iolaus_check.py"
- PreToolUse
pwsh -NoProfile -File "${CLAUDE_PLUGIN_ROOT}/hooks/hydra-doctor.ps1" doctor --quick
- PreToolUse
pwsh -NoProfile -File "${CLAUDE_PLUGIN_ROOT}/hooks/hydra-doctor.ps1" doctor --quick
- PreToolUse
pwsh -NoProfile -File "${CLAUDE_PLUGIN_ROOT}/hooks/hydra-doctor.ps1" doctor --quick
- PreToolUse
pwsh -NoProfile -File "${CLAUDE_PLUGIN_ROOT}/hooks/hydra-doctor.ps1" doctor --quick
- PostToolUse
python "${CLAUDE_PLUGIN_ROOT}/hooks/iolaus_log.py"
- PostToolUse
echo postcheck
- PostToolUse
echo postcheck
- Stop
echo checkpoint-flush
Maintain hydra?
This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.