claude

hydra

Hydra — supervisor that routes work across executive/engineering/creative squads.

4 on GitHubby robv0.1.7MITupdated 14 days ago
/

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-squad

    Scaffold a new squad pack: creates squads/<slug>/squad.yaml from a template + registers keyword fingerprints.

  • approve

    Approve a paused HITL gate and resume the supervisor graph.

  • budget-control

    Per-workflow budget enforcement: tripwire at 80% (downgrade model tier), HITL at 100%. Telemetry pattern for cost-per-task tracking.

  • budget

    Show rolling budget consumption across workflows; optionally set a new cap.

  • campaign

    Multi-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-review

    Read-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-message

    How 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.

  • drive

    Attended (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-review

    Read-only evidence and citation audit for Hydra artifacts. Use before synthesis, legal/compliance handoff, or when claims need source-grounding review.

  • hitl-protocol

    When and how Hydra pauses for human input. Defines HITL gate placement, render format, resume contracts, expiry behavior, and override semantics.

  • legal-summary-intake

    Prepare 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-handles

    Memory fabric usage — ephemeral / episodic / semantic. Read this before reading from or writing to Hydra memory.

  • plan

    The 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).

  • replay

    Replay a past workflow from checkpoint (LangGraph checkpoint → optionally pinned to original model/CLI versions).

  • resume

    Resume a paused workflow with a non-approval action: reject, modify-budget, force-dispatch, change-squads.

  • run

    Run a goal through Hydra's full supervisor lifecycle. Routes to 1+ squads, executes, synthesizes, postchecks.

  • squad-registry-discovery

    How Hydra discovers, resolves, and routes to squad packs. Read this before adding/removing/modifying a squad.

  • squads

    List discovered squad packs (registry resolution: project → user → built-in).

  • status

    Show recent Hydra workflows or the structured state of a specific workflow.

  • workflow-recovery

    Read-only Hydra workflow status and recovery diagnosis. Use when a workflow paused, timed out, surfaced, or needs operator-facing next steps.

Subagents (11)

  • engineer

    Code-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-gate

    Budget 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-gate

    Owns the human-in-the-loop interrupt boundary. Renders pending HITL_REQUEST envelopes to the operator, captures the decision, and resumes the supervisor graph.

  • hydra-planner

    Decomposes 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-plaza

    Hydra, the terse register. Same contract as hydra, with squad slugs and the shortest correct answers.

  • hydra-router

    Routes 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-supervisor

    Top-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-synthesizer

    Joins parallel squad outputs into a single DECISION_RECORD with rationale, artifact links, and preserved dissenting opinions. Runs after dispatch, before postcheck.

  • hydra

    Hydra, the Enterprise Agent Mesh orchestrator. The agent the operator talks to.

  • judge-cross-vendor

    Cross-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-vendor

    Same-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

View source on GitHub

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.

claude & codex pluginslisted