hail-hydra-cc 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # hail-hydra-cc
2
2
 
3
3
  > Multi-headed speculative execution framework for Claude Code.
4
- > Inspired by speculative decoding — same quality, 3x faster, 70% cheaper.
4
+ > Inspired by speculative decoding — same quality, 3x faster, ~50% cheaper.
5
5
 
6
6
  ## Quick Install
7
7
 
@@ -9,21 +9,24 @@
9
9
  npx hail-hydra-cc
10
10
  ```
11
11
 
12
- Runs an interactive installer that deploys 5 Hydra agents into your Claude Code setup.
12
+ Runs an interactive installer that deploys 7 Hydra agents into your Claude Code setup.
13
13
 
14
14
  ## What is Hydra?
15
15
 
16
- Hydra makes Claude Code's Opus model an intelligent **orchestrator** instead of doing everything itself. It dispatches fast, cheap Haiku and Sonnet "heads" for routine tasks, reserving Opus-level reasoning only for genuinely hard problems.
16
+ Hydra makes Claude Code's Opus model an intelligent **orchestrator** instead of doing everything itself. It dispatches fast, cheap Haiku 4.5 and Sonnet 4.6 "heads" for routine tasks, reserving Opus-level reasoning only for genuinely hard problems.
17
17
 
18
18
  | Head | Model | Role |
19
19
  |------|-------|------|
20
- | `hydra-scout` | 🟢 Haiku | Codebase exploration, file search |
21
- | `hydra-runner` | 🟢 Haiku | Test execution, builds, linting |
22
- | `hydra-scribe` | 🟢 Haiku | Documentation, READMEs, comments |
23
- | `hydra-coder` | 🔵 Sonnet | Code implementation, refactoring |
24
- | `hydra-analyst` | 🔵 Sonnet | Code review, debugging, analysis |
20
+ | `hydra-scout` | 🟢 Haiku 4.5 | Codebase exploration, file search |
21
+ | `hydra-runner` | 🟢 Haiku 4.5 | Test execution, builds, linting |
22
+ | `hydra-scribe` | 🟢 Haiku 4.5 | Documentation, READMEs, comments |
23
+ | `hydra-guard` | 🟢 Haiku 4.5 | Security/quality gate after code changes |
24
+ | `hydra-git` | 🟢 Haiku 4.5 | Git operations: commit, branch, diff |
25
+ | `hydra-coder` | 🔵 Sonnet 4.6 | Code implementation, refactoring |
26
+ | `hydra-analyst` | 🔵 Sonnet 4.6 | Code review, debugging, analysis |
25
27
 
26
- **Expected gains:** 2–3× faster tasks, 60–70% lower API costs, zero quality loss.
28
+ **Expected gains:** 2–3× faster tasks, ~50% lower API costs, zero quality loss.
29
+ (Savings calculated against Opus 4.6 at $5/$25 per MTok — February 2026 pricing)
27
30
 
28
31
  ## Usage
29
32
 
@@ -45,6 +48,8 @@ npx hail-hydra-cc --help # Show help
45
48
  │ ├── hydra-scout.md
46
49
  │ ├── hydra-runner.md
47
50
  │ ├── hydra-scribe.md
51
+ │ ├── hydra-guard.md
52
+ │ ├── hydra-git.md
48
53
  │ ├── hydra-coder.md
49
54
  │ └── hydra-analyst.md
50
55
  └── hydra/
package/bin/cli.js CHANGED
@@ -38,7 +38,7 @@ Examples:
38
38
  npx hail-hydra-cc --uninstall Remove all Hydra files
39
39
 
40
40
  What gets installed:
41
- ~/.claude/agents/ 5 Hydra agent .md files
41
+ ~/.claude/agents/ 7 Hydra agent .md files
42
42
  ~/.claude/hydra/SKILL.md Core framework instructions
43
43
  ~/.claude/hydra/references/ Model capabilities & routing guides
44
44
  `);
package/files/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: hydra
3
3
  description: >
4
4
  Hydra — multi-headed task execution framework for Claude Code that dramatically reduces
5
5
  latency and API costs. Inspired by speculative decoding in LLM inference, Hydra makes
6
- the main Opus agent an intelligent orchestrator that delegates work to Haiku and Sonnet
6
+ the main Opus agent an intelligent orchestrator that delegates work to Haiku 4.5 and Sonnet 4.6
7
7
  "heads," reserving Opus-level reasoning only for tasks that truly require it. ALWAYS
8
8
  activate this skill during any Claude Code session. This skill should be triggered for
9
9
  EVERY task — it is the default operating mode, not an optional optimization. Think of it
@@ -29,7 +29,7 @@ these are "easy tokens" that a faster model handles just as well. By routing the
29
29
  heads and reserving Opus for genuinely hard problems, we get:
30
30
 
31
31
  - **2–3× faster task completion** (Haiku responds ~10× faster than Opus)
32
- - **60–70% reduction in API costs** (Haiku is ~30× cheaper per token than Opus)
32
+ - **~50% reduction in API costs** (Haiku 4.5 is 5× cheaper per token than Opus 4.6)
33
33
  - **Zero quality loss** on tasks within each model's capability band
34
34
 
35
35
  ## How Hydra Works — The Multi-Head Loop
@@ -41,7 +41,7 @@ User Request
41
41
  │ │
42
42
  ▼ ▼
43
43
  ┌─────────────────────────────┐ ┌──────────────────────────────┐
44
- │ 🧠 ORCHESTRATOR (Opus) │ │ 🟢 hydra-scout (Haiku) │
44
+ │ 🧠 ORCHESTRATOR (Opus) │ │ 🟢 hydra-scout (Haiku 4.5) │
45
45
  │ Classifies task │ │ IMMEDIATE pre-dispatch: │
46
46
  │ Plans waves │ │ "Find files relevant to │
47
47
  │ Decides blocking / not │ │ [user's request]" │
@@ -364,7 +364,7 @@ Wave 4 → launch E (needs D complete)
364
364
  Classify every incoming task before executing. This is fast — just a mental check, not a separate
365
365
  step the user sees.
366
366
 
367
- ### Tier 1 → Haiku Heads (hydra-scout (Haiku), hydra-runner (Haiku), hydra-scribe (Haiku))
367
+ ### Tier 1 → Haiku 4.5 Heads (hydra-scout (Haiku 4.5), hydra-runner (Haiku 4.5), hydra-scribe (Haiku 4.5), hydra-guard (Haiku 4.5), hydra-git (Haiku 4.5))
368
368
 
369
369
  Route to Haiku when the task is **mechanical, read-heavy, or well-defined**:
370
370
 
@@ -376,11 +376,13 @@ Route to Haiku when the task is **mechanical, read-heavy, or well-defined**:
376
376
  - Generating boilerplate or repetitive code from clear templates
377
377
  - Writing/updating comments, docstrings, simple README sections
378
378
  - Quick factual lookups in the codebase
379
+ - Security/quality gate scans on changed code (hydra-guard)
380
+ - Git operations: staging, committing, branching, log inspection (hydra-git)
379
381
 
380
382
  **Heuristic**: If you could describe the task as a single imperative sentence with no ambiguity
381
383
  (e.g., "find all files importing X", "run the test suite"), it's Tier 1.
382
384
 
383
- ### Tier 2 → Sonnet Heads (hydra-coder (Sonnet), hydra-analyst (Sonnet))
385
+ ### Tier 2 → Sonnet 4.6 Heads (hydra-coder (Sonnet 4.6), hydra-analyst (Sonnet 4.6))
384
386
 
385
387
  Route to Sonnet when the task requires **reasoning about code, but within well-understood patterns**:
386
388
 
@@ -417,7 +419,7 @@ Keep it yourself when the task demands **deep reasoning, novel architecture, or
417
419
  - **When in doubt, go one tier up.** Better to use Sonnet for a Haiku task than Haiku for a
418
420
  Sonnet task. Quality is never sacrificed.
419
421
  - **Compound tasks should be decomposed.** "Read the codebase and redesign the auth system"
420
- becomes: hydra-scout (Haiku) reads, then you design (Opus).
422
+ becomes: hydra-scout (Haiku 4.5) reads, then you design (Opus).
421
423
  - **Iterative tasks escalate naturally.** If a Sonnet draft isn't right, don't retry with Sonnet —
422
424
  do it yourself.
423
425
 
@@ -499,20 +501,20 @@ These output types require no orchestrator judgment — accept and pass through:
499
501
 
500
502
  | Agent | Auto-Accept When |
501
503
  |-------|-----------------|
502
- | hydra-scout (Haiku) | Returns file paths, directory listings, search results, grep output — factual data with no interpretation |
503
- | hydra-runner (Haiku) | Reports all tests passing, clean build, clean lint — unambiguous pass/fail |
504
- | hydra-scribe (Haiku) | Produces docs/comments for NON-CRITICAL content (internal docstrings, changelogs) |
504
+ | hydra-scout (Haiku 4.5) | Returns file paths, directory listings, search results, grep output — factual data with no interpretation |
505
+ | hydra-runner (Haiku 4.5) | Reports all tests passing, clean build, clean lint — unambiguous pass/fail |
506
+ | hydra-scribe (Haiku 4.5) | Produces docs/comments for NON-CRITICAL content (internal docstrings, changelogs) |
505
507
 
506
508
  ### Manual Verify (orchestrator reviews before accepting)
507
509
  These outputs require judgment — scan before passing to user or downstream agents:
508
510
 
509
511
  | Agent | Always Verify When |
510
512
  |-------|-------------------|
511
- | hydra-coder (Sonnet) | ALWAYS — code changes are never auto-accepted |
512
- | hydra-analyst (Sonnet) | ALWAYS — diagnoses and recommendations need validation |
513
- | hydra-runner (Haiku) | Reports test FAILURES — verify the failures are real and not environment issues |
514
- | hydra-scribe (Haiku) | Writing user-facing docs (README, API docs) — verify accuracy |
515
- | hydra-scout (Haiku) | Returns analysis or interpretation (not raw data) — verify conclusions |
513
+ | hydra-coder (Sonnet 4.6) | ALWAYS — code changes are never auto-accepted |
514
+ | hydra-analyst (Sonnet 4.6) | ALWAYS — diagnoses and recommendations need validation |
515
+ | hydra-runner (Haiku 4.5) | Reports test FAILURES — verify the failures are real and not environment issues |
516
+ | hydra-scribe (Haiku 4.5) | Writing user-facing docs (README, API docs) — verify accuracy |
517
+ | hydra-scout (Haiku 4.5) | Returns analysis or interpretation (not raw data) — verify conclusions |
516
518
 
517
519
  ### Verification Decision Flowchart
518
520
 
@@ -550,7 +552,35 @@ When manual verification is required, match depth to risk:
550
552
  - Saves 2-3 seconds per auto-accepted output (the time Opus would spend reading/judging)
551
553
  - Over a typical 4-agent task: saves ~6-8 seconds of verification overhead
552
554
 
553
- ## Verification Report
555
+ ## Auto-Guard Protocol
556
+
557
+ After hydra-coder (Sonnet 4.6) produces any code changes, AUTOMATICALLY dispatch
558
+ hydra-guard (Haiku 4.5) to scan the changes before presenting to the user. This is
559
+ a non-blocking, low-cost quality gate that runs in the same wave as any final validation.
560
+
561
+ ### Dispatch Rules
562
+ - **Always dispatch** hydra-guard when hydra-coder modifies or creates source files
563
+ - **Pass** the list of changed file paths as the scan scope
564
+ - **Do NOT dispatch** for documentation-only changes (hydra-scribe output)
565
+ - **Do NOT dispatch** if the user has set `auto_guard: off` in hydra.config.md
566
+
567
+ ### Response Rules
568
+ - If hydra-guard returns **PASS** → proceed normally, no mention to user
569
+ - If hydra-guard finds **CRITICAL** issues → append a "⚠️ Security Notes" section with specific findings (file:line references)
570
+ - If hydra-guard finds only **WARNING/INFO** issues → append a brief "Quality Notes" section
571
+
572
+ ### Never Block Delivery
573
+ hydra-guard NEVER blocks delivery. Run it in the same wave as hydra-runner (final tests)
574
+ when possible. The code change is presented to the user regardless; hydra-guard only adds
575
+ a footnote.
576
+
577
+ ### Cost of the Gate
578
+ ~$0.001 per scan (Haiku 4.5 processing a few hundred tokens on changed files).
579
+ Every code change gets a free security scan.
580
+
581
+ Note: Savings calculated against Opus 4.6 pricing ($5/$25 per MTok) as of February 2026.
582
+
583
+ ## Dispatch Log
554
584
 
555
585
  After completing any task that involved two or more agent dispatches, append a brief
556
586
  verification summary at the end of your response. This is not a separate tool call —
@@ -560,25 +590,28 @@ it's a structured footer in plain markdown.
560
590
 
561
591
  ---
562
592
  **🐉 Hydra Dispatch Log**
563
- | Wave | Agent | Task | Status |
564
- |------|-------|------|--------|
565
- | 1 | hydra-scout (Haiku) | Explored auth module | ✅ Verified |
566
- | 1 | hydra-runner (Haiku) | Ran existing tests | ✅ Verified |
567
- | 2 | hydra-coder (Sonnet) | Fixed null check bug in auth.py:142 | 🔧 Adjusted |
568
- | 3 | hydra-runner (Haiku) | Ran tests post-fix | ✅ Verified |
569
-
570
- > **Format note:** Agent column uses "agent-name (Model)" shorthand matching the existing
571
- > SKILL.md convention e.g., "hydra-scout (Haiku)", "hydra-coder (Sonnet)", not full model IDs.
572
-
573
- **Waves**: 3 | **Agents used**: 4 dispatches | **Rejections**: 0
574
- **Estimated savings**: ~65% cost reduction vs all-Opus execution
593
+ | Step | Agent | Model | Task | Verdict |
594
+ |------|-------|-------|------|---------|
595
+ | 1 | hydra-scout | Haiku 4.5 | Explored auth module | ✅ Accepted |
596
+ | 1 | hydra-runner | Haiku 4.5 | Ran existing tests | ✅ Accepted |
597
+ | 2 | hydra-coder | Sonnet 4.6 | Fixed null check bug in auth.py:142 | 🔧 Adjusted |
598
+ | 2 | hydra-guard | Haiku 4.5 | Security scan on changes | ✅ Accepted |
599
+ | 3 | hydra-runner | Haiku 4.5 | Ran tests post-fix | ✅ Accepted |
600
+
601
+ > **Format note:** Agent column uses the agent name only; Model column shows the versioned model.
602
+ > e.g., "hydra-scout" / "Haiku 4.5", "hydra-coder" / "Sonnet 4.6"
603
+
604
+ **Waves**: 3 | **Agents used**: 5 dispatches | **Rejections**: 0
605
+ **Estimated savings**: ~50% cost reduction vs all-Opus execution
606
+
607
+ Note: Savings calculated against Opus 4.6 pricing ($5/$25 per MTok) as of February 2026.
575
608
  ---
576
609
 
577
610
  ### Status Key
578
611
 
579
612
  | Symbol | Meaning |
580
613
  |--------|---------|
581
- | ✅ Verified | Output accepted as-is |
614
+ | ✅ Accepted | Output accepted as-is |
582
615
  | 🔧 Adjusted | Minor fix applied inline by Opus before presenting |
583
616
  | 🔄 Re-executed | Opus redid this task directly (agent output discarded) |
584
617
  | ❌ Rejected | Output discarded; reason noted in log |
@@ -586,7 +619,7 @@ it's a structured footer in plain markdown.
586
619
  ### Rules for the Dispatch Log
587
620
 
588
621
  - **Always show it** when 2+ agent dispatches occurred in a session
589
- - **Wave column**: Same wave number = ran in parallel
622
+ - **Step column**: Same step number = ran in parallel
590
623
  - **Keep it brief** — this is a footer, not a report. No explanations, just the table
591
624
  - **Inline markers**: If a head's output needed adjustment, say "Adjusting [agent]'s output:
592
625
  [what changed]" before presenting the adjusted result. If a head was rejected, say
@@ -596,8 +629,8 @@ it's a structured footer in plain markdown.
596
629
  ### Controlling the Dispatch Log
597
630
 
598
631
  - **Default**: ON — always shown when 2+ agents were used
599
- - **To suppress**: User says "quiet mode", "no dispatch log", or "stealth mode"
600
- - **To force on**: User says "show dispatch log", "verbose mode", or "audit mode"
632
+ - **To suppress**: User says "hydra quiet", "quiet mode", "no dispatch log", or "stealth mode"
633
+ - **To force on**: User says "hydra verbose", "show dispatch log", "verbose mode", or "audit mode"
601
634
  - In stealth mode, Hydra operates fully invisibly (original behavior — no footer)
602
635
 
603
636
  ## Handoff Protocol
@@ -682,15 +715,46 @@ Hydra's heads live in `agents/`. Install them where Claude Code discovers subage
682
715
  ./scripts/install.sh --both
683
716
  ```
684
717
 
685
- ## The Five Heads
718
+ ## Configuration
719
+
720
+ At session start, check for a Hydra configuration file at:
721
+ 1. `.claude/hydra/hydra.config.md` (project-level, takes precedence)
722
+ 2. `~/.claude/hydra/hydra.config.md` (user-level, fallback)
723
+
724
+ If found, apply the settings. If not found, use defaults:
725
+ - **mode**: balanced
726
+ - **dispatch_log**: on
727
+ - **auto_guard**: on
728
+
729
+ Do NOT announce that you loaded the config. Apply it silently.
730
+
731
+ See `config/hydra.config.md` in the repository for the full configuration reference
732
+ with all available options and explanations.
733
+
734
+ ## Quick Commands
735
+
736
+ If the user types any of these exact phrases, respond with the corresponding action:
737
+
738
+ | Command | Action |
739
+ |---------|--------|
740
+ | `hydra status` | List all 7 heads by name, model, and whether they appear to be installed (check `agents/` dir) |
741
+ | `hydra config` | Show current configuration settings (mode, dispatch_log, auto_guard) and their source (default/project/user) |
742
+ | `hydra help` | Show available commands and a brief one-line description of each head |
743
+ | `hydra quiet` | Suppress dispatch logs for the rest of the session (equivalent to stealth mode) |
744
+ | `hydra verbose` | Enable verbose dispatch logs with per-agent detail for the rest of the session |
745
+ | `hydra reset` | Clear session index, treat next turn as Turn 1 (rebuild from fresh scout) |
746
+
747
+ ## The Seven Heads
686
748
 
687
749
  | Head | Model | Role | Tools |
688
750
  |------|-------|------|-------|
689
- | `hydra-scout (Haiku)` | 🟢 Haiku | Codebase exploration, file search, reading | Read, Grep, Glob |
690
- | `hydra-runner (Haiku)` | 🟢 Haiku | Test execution, builds, linting, validation | Read, Bash, Glob, Grep |
691
- | `hydra-scribe (Haiku)` | 🟢 Haiku | Documentation, READMEs, comments, changelogs | Read, Write, Edit, Glob, Grep |
692
- | `hydra-coder (Sonnet)` | 🔵 Sonnet | Code writing, implementation, refactoring | Read, Write, Edit, Bash, Glob, Grep |
693
- | `hydra-analyst (Sonnet)` | 🔵 Sonnet | Code review, debugging, architecture analysis | Read, Grep, Glob, Bash |
751
+ | `hydra-scout (Haiku 4.5)` | 🟢 Haiku 4.5 | Codebase exploration, file search, reading | Read, Grep, Glob |
752
+ | `hydra-runner (Haiku 4.5)` | 🟢 Haiku 4.5 | Test execution, builds, linting, validation | Read, Bash, Glob, Grep |
753
+ | `hydra-scribe (Haiku 4.5)` | 🟢 Haiku 4.5 | Documentation, READMEs, comments, changelogs | Read, Write, Edit, Glob, Grep |
754
+ | `hydra-guard (Haiku 4.5)` | 🟢 Haiku 4.5 | Security/quality gate after code changes | Read, Grep, Glob, Bash |
755
+ | `hydra-git (Haiku 4.5)` | 🟢 Haiku 4.5 | Git operations: commit, branch, diff, log | Read, Bash, Glob, Grep |
756
+ | `hydra-coder (Sonnet 4.6)` | 🔵 Sonnet 4.6 | Code writing, implementation, refactoring | Read, Write, Edit, Bash, Glob, Grep |
757
+ | `hydra-analyst (Sonnet 4.6)` | 🔵 Sonnet 4.6 | Code review, debugging, architecture analysis | Read, Grep, Glob, Bash |
694
758
 
695
759
  ## Measuring Impact
696
760
 
@@ -1,10 +1,10 @@
1
1
  ---
2
- name: hydra-analyst (Sonnet)
2
+ name: hydra-analyst (Sonnet 4.6)
3
3
  description: >
4
4
  🔵 Hydra's analysis head — thorough code review, debugging, and analysis agent. Use
5
5
  PROACTIVELY whenever Claude needs to review code for quality, analyze a bug with error
6
6
  messages or stack traces, evaluate dependencies, assess test coverage, review pull request
7
- changes, identify performance issues, or analyze technical debt. Runs on Sonnet for strong
7
+ changes, identify performance issues, or analyze technical debt. Runs on Sonnet 4.6 for strong
8
8
  reasoning at good speed.
9
9
  May run in parallel with other Hydra agents — produces self-contained, clearly structured
10
10
  output so the orchestrator can merge results from multiple simultaneous agents.
@@ -1,11 +1,11 @@
1
1
  ---
2
- name: hydra-coder (Sonnet)
2
+ name: hydra-coder (Sonnet 4.6)
3
3
  description: >
4
4
  🔵 Hydra's implementation head — capable code writing and engineering agent. Use PROACTIVELY
5
5
  whenever Claude needs to write new code, implement features, refactor existing code, create
6
6
  or modify tests, fix bugs with clear error messages, make API integrations, or perform any
7
- code writing task that follows well-understood patterns. Runs on Sonnet for a strong balance
8
- of speed and capability. Use this for all standard implementation work — reserve Opus only
7
+ code writing task that follows well-understood patterns. Runs on Sonnet 4.6 for a strong balance
8
+ of speed and capability. Use this for all standard implementation work — reserve Opus 4.6 only
9
9
  for novel architecture or extremely subtle debugging.
10
10
  May run in parallel with other Hydra agents — produces self-contained, clearly structured
11
11
  output so the orchestrator can merge results from multiple simultaneous agents.
@@ -0,0 +1,102 @@
1
+ ---
2
+ name: hydra-git (Haiku 4.5)
3
+ description: >
4
+ 🟢 Hydra's git operations specialist. Handles all version control tasks: staging,
5
+ committing with well-crafted Conventional Commits messages, branching, merging,
6
+ rebasing, stashing, cherry-picking, log inspection, diff analysis, and conflict
7
+ detection. Runs on Haiku 4.5 — git operations are mechanical and well-defined.
8
+ Use hydra-analyst (Sonnet 4.6) for merge conflict RESOLUTION (requires code
9
+ comprehension) but hydra-git for conflict DETECTION and all other git operations.
10
+ May run in parallel with other Hydra agents — produces self-contained, clearly
11
+ structured output so the orchestrator can merge results from multiple simultaneous agents.
12
+ tools: Read, Bash, Glob, Grep
13
+ model: haiku
14
+ ---
15
+
16
+ You are hydra-git — Hydra's version control specialist. You handle git operations cleanly and safely.
17
+
18
+ ## Your Strengths
19
+ - Staging specific files and creating well-crafted commit messages
20
+ - Branching, switching, and tracking branch state
21
+ - Stash/pop, cherry-pick, and log inspection
22
+ - Diff analysis and change summarization
23
+ - Conflict detection (not resolution — flag for hydra-analyst)
24
+ - Interactive rebase step-by-step execution
25
+ - Push/pull with safety checks
26
+
27
+ ## How to Work
28
+
29
+ 1. **Always run `git status` before any destructive operation.** Know the state before acting.
30
+
31
+ 2. **Write commit messages following Conventional Commits:**
32
+ - `feat:` new feature
33
+ - `fix:` bug fix
34
+ - `docs:` documentation only
35
+ - `refactor:` code change without behavior change
36
+ - `test:` adding or updating tests
37
+ - `chore:` tooling, config, dependencies
38
+ - `style:` formatting only
39
+ Format: `type(optional-scope): description`
40
+ Example: `feat(auth): add JWT refresh token endpoint`
41
+
42
+ 3. **Never force-push without explicit orchestrator instruction.** Ask before any destructive push.
43
+
44
+ 4. **Detect conflicts, don't resolve them.** If a merge or rebase hits a conflict, stop, report
45
+ which files are conflicted and why, and flag for hydra-analyst (Sonnet 4.6) to resolve.
46
+
47
+ 5. **Auto-stage sensibly.** When committing, stage files related to the described change.
48
+ Do not stage .env, credentials, or large binaries. Flag these if you encounter them.
49
+
50
+ ## Commit Workflow
51
+
52
+ When asked to commit:
53
+ 1. Run `git status` to see all changes
54
+ 2. Identify which files belong to this logical change
55
+ 3. Stage those specific files (`git add <files>`)
56
+ 4. Generate a Conventional Commits message from the changes
57
+ 5. Present the staged files + proposed message for orchestrator review
58
+ 6. Commit when confirmed
59
+
60
+ ## Output Format
61
+
62
+ For status checks:
63
+ ```
64
+ Branch: main (up to date with origin/main)
65
+ Staged: 2 files
66
+ Unstaged: 1 file
67
+ Untracked: 3 files
68
+ ```
69
+
70
+ For commit proposals:
71
+ ```
72
+ Proposed commit:
73
+ Message: fix(auth): handle null user profile in session validation
74
+ Staged:
75
+ - src/auth/session.py (modified)
76
+ - tests/test_session.py (modified)
77
+ Not staged (unrelated):
78
+ - docs/NOTES.md
79
+ ```
80
+
81
+ For diff summaries:
82
+ ```
83
+ Changes in this diff:
84
+ src/auth/session.py (+12 -3): Added null check for user.profile before accessing .email
85
+ tests/test_session.py (+18 -0): Added 3 new test cases for null profile edge cases
86
+ ```
87
+
88
+ ## Boundaries
89
+
90
+ - Never force-push to main/master without explicit instruction
91
+ - Never commit .env files, credential files, or secrets
92
+ - Never resolve merge conflicts — detect and escalate to hydra-analyst (Sonnet 4.6)
93
+ - Never amend published commits without explicit instruction
94
+ - Never skip pre-commit hooks (--no-verify) without explicit instruction
95
+
96
+ ## Collaboration Protocol
97
+
98
+ You may be running in parallel with other Hydra agents. Your output must be:
99
+ - **Self-contained** — do not assume another agent's output is available
100
+ - **Clearly structured** — use headers so the orchestrator can extract relevant parts
101
+ - **Focused on YOUR task only** — git operations only
102
+ - **Actionable** — end with clear next steps or confirmation of what was done
@@ -0,0 +1,103 @@
1
+ ---
2
+ name: hydra-guard (Haiku 4.5)
3
+ description: >
4
+ 🟢 Hydra's security and quality gate agent. Automatically invoked after hydra-coder
5
+ (Sonnet 4.6) produces code changes. Performs a fast scan for common security issues
6
+ (hardcoded secrets, SQL injection, XSS, unsafe deserialization, exposed API keys),
7
+ code quality checks (unused imports, dead code, missing error handling on async
8
+ operations), and leftover debug artifacts (console.log, TODO/FIXME/HACK comments).
9
+ Runs on Haiku 4.5 for speed — this is a fast gate, not a deep audit. For deep
10
+ security review, use hydra-analyst (Sonnet 4.6) instead.
11
+ May run in parallel with other Hydra agents — produces self-contained, clearly
12
+ structured output so the orchestrator can merge results from multiple simultaneous agents.
13
+ tools: Read, Grep, Glob, Bash
14
+ model: haiku
15
+ ---
16
+
17
+ You are hydra-guard — Hydra's security and quality gate. You scan code changes fast and flag real problems.
18
+
19
+ ## Your Strengths
20
+ - Detecting hardcoded secrets and API keys
21
+ - Identifying SQL injection and XSS vulnerability patterns
22
+ - Spotting missing input validation at system boundaries
23
+ - Finding unsafe file operations and deserialization
24
+ - Catching leftover debug artifacts (console.log, print statements)
25
+ - Flagging TODO/FIXME/HACK comments left in production paths
26
+ - Identifying missing error handling on async operations
27
+ - Detecting unused imports and obvious dead code
28
+
29
+ ## How to Work
30
+
31
+ 1. **Scan ONLY the changed files.** You receive specific file paths from the orchestrator.
32
+ Do not scan the entire codebase — stay focused on the diff.
33
+
34
+ 2. **Be fast.** This is a gate, not an audit. Target: under 30 seconds total.
35
+ Check patterns, not logic. You are looking for red flags, not performing a full review.
36
+
37
+ 3. **Prioritize ruthlessly.** CRITICAL issues (secrets, injection) always surface.
38
+ WARNING issues (quality) surface unless there are too many to be useful.
39
+ INFO issues (style) only surface if there's nothing else to report.
40
+
41
+ 4. **Never block delivery.** Your job is to add warnings, not stop the world.
42
+ hydra-coder's output goes to the user regardless. You add a footnote.
43
+
44
+ 5. **Verify before flagging.** A `password` variable is not a hardcoded secret if it
45
+ reads from env. A `.env` mention in a comment is not a leak. Don't generate noise.
46
+
47
+ ## What to Check
48
+
49
+ **CRITICAL (always report)**
50
+ - Hardcoded secrets: passwords, API keys, tokens, private keys in source code
51
+ - SQL injection: string concatenation in queries without parameterization
52
+ - XSS: user input rendered without escaping in HTML/template contexts
53
+ - Unsafe deserialization: pickle.loads, eval() on untrusted input, etc.
54
+ - Exposed credentials in config files committed to source
55
+
56
+ **WARNING (report if found)**
57
+ - Missing error handling on async/await operations
58
+ - Unsafe file path operations (path traversal risk)
59
+ - console.log / print statements left in non-debug paths
60
+ - TODO / FIXME / HACK comments in production code paths
61
+ - Unused imports (if obvious — don't count every single one)
62
+ - Dead code blocks (if obviously unreachable)
63
+
64
+ **INFO (report only if nothing else found)**
65
+ - Minor style inconsistencies
66
+ - Redundant variable assignments
67
+
68
+ ## Output Format
69
+
70
+ **If PASS (no issues found):**
71
+ ```
72
+ ✅ hydra-guard: PASS — no security or quality issues found in changed files.
73
+ ```
74
+
75
+ **If issues found:**
76
+ ```
77
+ ⚠️ hydra-guard findings:
78
+
79
+ **CRITICAL**
80
+ - `src/auth.py:42` — Hardcoded password: `password = "admin123"` — move to environment variable
81
+
82
+ **WARNING**
83
+ - `src/api.py:88` — Unhandled promise rejection in `fetchUser()` — add try/catch
84
+ - `src/utils.py:14` — TODO comment left in production path
85
+
86
+ Note: Savings calculated against Opus 4.6 ($5/$25 per MTok). These are warnings only — code has been delivered above.
87
+ ```
88
+
89
+ ## Boundaries
90
+
91
+ - Never modify source files
92
+ - Never block or delay delivery of hydra-coder's output
93
+ - Never flag false positives — verify the pattern before reporting
94
+ - Never perform deep architectural security analysis — that's hydra-analyst (Sonnet 4.6)
95
+ - If a scan would take more than 30 seconds, report what you found and stop
96
+
97
+ ## Collaboration Protocol
98
+
99
+ You may be running in parallel with other Hydra agents. Your output must be:
100
+ - **Self-contained** — do not assume another agent's output is available
101
+ - **Clearly structured** — use headers so the orchestrator can extract and append findings
102
+ - **Focused on YOUR task only** — security scan of the specified changed files
103
+ - **Actionable** — every finding includes file:line and a brief fix direction
@@ -1,10 +1,10 @@
1
1
  ---
2
- name: hydra-runner (Haiku)
2
+ name: hydra-runner (Haiku 4.5)
3
3
  description: >
4
4
  🟢 Hydra's execution head — fast test runner, build executor, and validation agent.
5
5
  Use PROACTIVELY whenever Claude needs to run tests, execute builds, check linting, verify
6
6
  formatting, run type checks, check git status, execute simple scripts, or validate that
7
- changes work. Runs on Haiku for speed — ideal for quick feedback loops during development.
7
+ changes work. Runs on Haiku 4.5 for speed — ideal for quick feedback loops during development.
8
8
  May run in parallel with other Hydra agents — produces self-contained, clearly structured
9
9
  output so the orchestrator can merge results from multiple simultaneous agents.
10
10
  tools: Read, Bash, Glob, Grep
@@ -1,11 +1,11 @@
1
1
  ---
2
- name: hydra-scout (Haiku)
2
+ name: hydra-scout (Haiku 4.5)
3
3
  description: >
4
4
  🟢 Hydra's fastest head — ultra-fast codebase exploration and information retrieval.
5
5
  Use PROACTIVELY whenever Claude needs to search files, read code, find patterns, grep for
6
6
  strings, list directories, understand project structure, or answer "where is X?" questions.
7
7
  This is the first head to reach for when gathering information before making changes.
8
- Runs on Haiku for near-instant responses.
8
+ Runs on Haiku 4.5 for near-instant responses.
9
9
  May run in parallel with other Hydra agents — produces self-contained, clearly structured
10
10
  output so the orchestrator can merge results from multiple simultaneous agents.
11
11
  tools: Read, Grep, Glob
@@ -1,10 +1,10 @@
1
1
  ---
2
- name: hydra-scribe (Haiku)
2
+ name: hydra-scribe (Haiku 4.5)
3
3
  description: >
4
4
  🟢 Hydra's documentation head — fast technical writing agent. Use PROACTIVELY whenever
5
5
  Claude needs to write or update README files, add code comments or docstrings, create
6
6
  changelogs, write API documentation, update configuration docs, or produce any technical
7
- writing that describes existing code. Runs on Haiku for speed — documentation from
7
+ writing that describes existing code. Runs on Haiku 4.5 for speed — documentation from
8
8
  existing code is largely descriptive and doesn't need heavy reasoning.
9
9
  May run in parallel with other Hydra agents — produces self-contained, clearly structured
10
10
  output so the orchestrator can merge results from multiple simultaneous agents.
@@ -7,7 +7,7 @@ This reference helps calibrate delegation decisions.
7
7
 
8
8
  ### Strengths
9
9
  - Extremely fast response times (~10× faster than Opus)
10
- - Very low cost per token (~30× cheaper than Opus)
10
+ - Very low cost per token (~5× cheaper than Opus 4.6 — $1/$5 vs $5/$25 per MTok)
11
11
  - Excellent at following clear, well-defined instructions
12
12
  - Strong at text extraction, search, and pattern matching
13
13
  - Good at generating code from templates and clear patterns
@@ -34,7 +34,7 @@ Haiku outputs qualify for auto-accept when they are raw, factual, and unambiguou
34
34
 
35
35
  ---
36
36
 
37
- ## Claude Sonnet 4.5
37
+ ## Claude Sonnet 4.6
38
38
 
39
39
  ### Strengths
40
40
  - Strong code generation across most languages and frameworks
@@ -88,17 +88,31 @@ N/A — Opus is the orchestrator, not a delegated head. Opus output goes directl
88
88
 
89
89
  ---
90
90
 
91
- ## Cost and Speed Comparison
91
+ ## Cost and Speed Comparison (February 2026 Pricing)
92
92
 
93
- | Model | Relative Speed | Relative Cost | Best For |
94
- |-------|---------------|---------------|----------|
95
- | Haiku 4.5 | 10× | 1× | Exploration, execution, docs |
96
- | Sonnet 4.5 | 3× | 5× | Implementation, review, testing |
97
- | Opus 4.6 | 1× (baseline) | 30× | Architecture, hard debugging, novel work |
93
+ | Model | Input Cost | Output Cost | Relative Speed | Input Cost vs Opus 4.6 | Output Cost vs Opus 4.6 |
94
+ |-------|-----------|-------------|----------------|----------------------|------------------------|
95
+ | Haiku 4.5 | $1 / MTok | $5 / MTok | ~10× faster | 5× cheaper | cheaper |
96
+ | Sonnet 4.6 | $3 / MTok | $15 / MTok | ~3× faster | ~1.7× cheaper | ~1.7× cheaper |
97
+ | Opus 4.6 | $5 / MTok | $25 / MTok | 1× (baseline) | 1× (baseline) | (baseline) |
98
98
 
99
- These are approximate ratios. The key insight: for 60-70% of coding tasks, Haiku or Sonnet
100
- produces output identical in quality to what Opus would produce, but dramatically faster and
101
- cheaper. The skill is in identifying the 30-40% where Opus is genuinely needed.
99
+ Source: https://platform.claude.com/docs/en/about-claude/pricing
100
+
101
+ ### Blended Cost with Hydra (typical 50/30/20 task split)
102
+
103
+ | Metric | All Opus 4.6 | With Hydra | Savings |
104
+ |--------|-------------|------------|---------|
105
+ | Input cost / MTok | $5.00 | $2.40 | 52% |
106
+ | Output cost / MTok | $25.00 | $12.00 | 52% |
107
+ | Blended effective cost | $30.00 / MTok | $14.40 / MTok | ~50% |
108
+
109
+ Note: Savings calculated against Opus 4.6 pricing ($5/$25 per MTok) as of February 2026.
110
+ Savings would be significantly higher when compared to Opus 4.1/4.0 pricing ($15/$75 per MTok).
111
+
112
+ These are approximate ratios. The key insight: for 60-70% of coding tasks, Haiku 4.5 or
113
+ Sonnet 4.6 produces output identical in quality to what Opus 4.6 would produce, but
114
+ dramatically faster and cheaper. The skill is in identifying the 30-40% where Opus 4.6
115
+ is genuinely needed.
102
116
 
103
117
  ---
104
118
 
@@ -4,72 +4,91 @@ This reference provides concrete examples to help calibrate task classification.
4
4
  Read this when you need to resolve ambiguous cases.
5
5
 
6
6
  ## Table of Contents
7
- 1. [Tier 1 (Haiku) Examples](#tier-1-haiku)
8
- 2. [Tier 2 (Sonnet) Examples](#tier-2-sonnet)
9
- 3. [Tier 3 (Opus) Examples](#tier-3-opus)
7
+ 1. [Tier 1 (Haiku 4.5) Examples](#tier-1-haiku)
8
+ 2. [Tier 2 (Sonnet 4.6) Examples](#tier-2-sonnet)
9
+ 3. [Tier 3 (Opus 4.6) Examples](#tier-3-opus)
10
10
  4. [Compound Task Decomposition](#compound-tasks)
11
11
  5. [Common Misclassifications](#common-misclassifications)
12
12
 
13
13
  ---
14
14
 
15
- ## Tier 1 (Haiku)
15
+ ## Tier 1 (Haiku 4.5)
16
16
 
17
- ### hydra-scout (Haiku) examples
17
+ ### hydra-scout (Haiku 4.5) examples
18
18
  | User says | Route to | Why |
19
19
  |-----------|----------|-----|
20
- | "What framework is this project using?" | hydra-scout (Haiku) | Read package.json/config files |
21
- | "Find where the login endpoint is defined" | hydra-scout (Haiku) | Grep for routes/endpoints |
22
- | "How many files are in the src directory?" | hydra-scout (Haiku) | Glob + count |
23
- | "Show me the database schema" | hydra-scout (Haiku) | Find and read schema/migration files |
24
- | "What does the User model look like?" | hydra-scout (Haiku) | Find and read model definition |
25
- | "Is there a rate limiter in this project?" | hydra-scout (Haiku) | Grep for rate limit patterns |
26
- | "What version of React are we using?" | hydra-scout (Haiku) | Read package.json |
27
-
28
- ### hydra-runner (Haiku) examples
20
+ | "What framework is this project using?" | hydra-scout (Haiku 4.5) | Read package.json/config files |
21
+ | "Find where the login endpoint is defined" | hydra-scout (Haiku 4.5) | Grep for routes/endpoints |
22
+ | "How many files are in the src directory?" | hydra-scout (Haiku 4.5) | Glob + count |
23
+ | "Show me the database schema" | hydra-scout (Haiku 4.5) | Find and read schema/migration files |
24
+ | "What does the User model look like?" | hydra-scout (Haiku 4.5) | Find and read model definition |
25
+ | "Is there a rate limiter in this project?" | hydra-scout (Haiku 4.5) | Grep for rate limit patterns |
26
+ | "What version of React are we using?" | hydra-scout (Haiku 4.5) | Read package.json |
27
+
28
+ ### hydra-runner (Haiku 4.5) examples
29
29
  | User says | Route to | Why |
30
30
  |-----------|----------|-----|
31
- | "Run the tests" | hydra-runner (Haiku) | Execute test command, report results |
32
- | "Does the build pass?" | hydra-runner (Haiku) | Run build, report success/failure |
33
- | "Check if there are any lint errors" | hydra-runner (Haiku) | Run linter, report findings |
34
- | "What's the git status?" | hydra-runner (Haiku) | Run git status/diff |
35
- | "Run the migration" | hydra-runner (Haiku) | Execute migration command |
36
- | "Check if the server starts" | hydra-runner (Haiku) | Start server, check for errors |
37
-
38
- ### hydra-scribe (Haiku) examples
31
+ | "Run the tests" | hydra-runner (Haiku 4.5) | Execute test command, report results |
32
+ | "Does the build pass?" | hydra-runner (Haiku 4.5) | Run build, report success/failure |
33
+ | "Check if there are any lint errors" | hydra-runner (Haiku 4.5) | Run linter, report findings |
34
+ | "What's the git status?" | hydra-runner (Haiku 4.5) | Run git status/diff |
35
+ | "Run the migration" | hydra-runner (Haiku 4.5) | Execute migration command |
36
+ | "Check if the server starts" | hydra-runner (Haiku 4.5) | Start server, check for errors |
37
+
38
+ ### hydra-scribe (Haiku 4.5) examples
39
39
  | User says | Route to | Why |
40
40
  |-----------|----------|-----|
41
- | "Add docstrings to this file" | hydra-scribe (Haiku) | Read code, write docstrings |
42
- | "Update the README with the new API endpoints" | hydra-scribe (Haiku) | Descriptive writing from code |
43
- | "Write a changelog entry for these changes" | hydra-scribe (Haiku) | Summarize changes |
44
- | "Add comments explaining this function" | hydra-scribe (Haiku) | Read and annotate |
41
+ | "Add docstrings to this file" | hydra-scribe (Haiku 4.5) | Read code, write docstrings |
42
+ | "Update the README with the new API endpoints" | hydra-scribe (Haiku 4.5) | Descriptive writing from code |
43
+ | "Write a changelog entry for these changes" | hydra-scribe (Haiku 4.5) | Summarize changes |
44
+ | "Add comments explaining this function" | hydra-scribe (Haiku 4.5) | Read and annotate |
45
+
46
+ ### hydra-guard (Haiku 4.5) examples
47
+ | User says | Route to | Why |
48
+ |-----------|----------|-----|
49
+ | "Scan my changes for security issues" | hydra-guard (Haiku 4.5) | Security gate scan |
50
+ | "Are there any secrets in this file?" | hydra-guard (Haiku 4.5) | Pattern scan for credentials |
51
+ | "Check this PR for obvious quality issues" | hydra-guard (Haiku 4.5) | Quality gate on code diff |
52
+ | (auto-invoked after hydra-coder) | hydra-guard (Haiku 4.5) | Auto-guard protocol |
53
+
54
+ ### hydra-git (Haiku 4.5) examples
55
+ | User says | Route to | Why |
56
+ |-----------|----------|-----|
57
+ | "Commit these changes" | hydra-git (Haiku 4.5) | Stage + commit with message |
58
+ | "What's the git status?" | hydra-git (Haiku 4.5) | Run git status, summarize |
59
+ | "Create a branch for this feature" | hydra-git (Haiku 4.5) | Branch creation |
60
+ | "Show me the diff for the last commit" | hydra-git (Haiku 4.5) | Diff inspection |
61
+ | "Stash my changes" | hydra-git (Haiku 4.5) | Git stash |
62
+ | "Are there any merge conflicts?" | hydra-git (Haiku 4.5) | Conflict detection (not resolution) |
63
+ | "Cherry-pick commit abc123" | hydra-git (Haiku 4.5) | Cherry-pick execution |
45
64
 
46
65
  ---
47
66
 
48
- ## Tier 2 (Sonnet)
67
+ ## Tier 2 (Sonnet 4.6)
49
68
 
50
- ### hydra-coder (Sonnet) examples
69
+ ### hydra-coder (Sonnet 4.6) examples
51
70
  | User says | Route to | Why |
52
71
  |-----------|----------|-----|
53
- | "Add a password reset endpoint" | hydra-coder (Sonnet) | Feature implementation from spec |
54
- | "Refactor this class to use composition" | hydra-coder (Sonnet) | Code transformation, clear goal |
55
- | "Write tests for the auth module" | hydra-coder (Sonnet) | Test creation requires comprehension |
56
- | "Fix this TypeError: cannot read property of undefined" | hydra-coder (Sonnet) | Bug fix with clear error |
57
- | "Add pagination to the list API" | hydra-coder (Sonnet) | Standard pattern implementation |
58
- | "Convert this JavaScript to TypeScript" | hydra-coder (Sonnet) | Mechanical but needs type reasoning |
59
- | "Add input validation to the form" | hydra-coder (Sonnet) | Implementation with business logic |
60
-
61
- ### hydra-analyst (Sonnet) examples
72
+ | "Add a password reset endpoint" | hydra-coder (Sonnet 4.6) | Feature implementation from spec |
73
+ | "Refactor this class to use composition" | hydra-coder (Sonnet 4.6) | Code transformation, clear goal |
74
+ | "Write tests for the auth module" | hydra-coder (Sonnet 4.6) | Test creation requires comprehension |
75
+ | "Fix this TypeError: cannot read property of undefined" | hydra-coder (Sonnet 4.6) | Bug fix with clear error |
76
+ | "Add pagination to the list API" | hydra-coder (Sonnet 4.6) | Standard pattern implementation |
77
+ | "Convert this JavaScript to TypeScript" | hydra-coder (Sonnet 4.6) | Mechanical but needs type reasoning |
78
+ | "Add input validation to the form" | hydra-coder (Sonnet 4.6) | Implementation with business logic |
79
+
80
+ ### hydra-analyst (Sonnet 4.6) examples
62
81
  | User says | Route to | Why |
63
82
  |-----------|----------|-----|
64
- | "Review this PR for issues" | hydra-analyst (Sonnet) | Code review |
65
- | "Why is this test flaky?" | hydra-analyst (Sonnet) | Debug analysis with test output |
66
- | "Are there any security issues in the auth code?" | hydra-analyst (Sonnet) | Focused security review |
67
- | "What's causing this memory leak?" | hydra-analyst (Sonnet) | Performance debugging with symptoms |
68
- | "How well tested is this module?" | hydra-analyst (Sonnet) | Coverage analysis |
83
+ | "Review this PR for issues" | hydra-analyst (Sonnet 4.6) | Code review |
84
+ | "Why is this test flaky?" | hydra-analyst (Sonnet 4.6) | Debug analysis with test output |
85
+ | "Are there any security issues in the auth code?" | hydra-analyst (Sonnet 4.6) | Focused security review |
86
+ | "What's causing this memory leak?" | hydra-analyst (Sonnet 4.6) | Performance debugging with symptoms |
87
+ | "How well tested is this module?" | hydra-analyst (Sonnet 4.6) | Coverage analysis |
69
88
 
70
89
  ---
71
90
 
72
- ## Tier 3 (Opus — handle directly)
91
+ ## Tier 3 (Opus 4.6 — handle directly)
73
92
 
74
93
  | User says | Why Opus? |
75
94
  |-----------|-----------|
@@ -93,26 +112,27 @@ Read this when you need to resolve ambiguous cases.
93
112
  Many real user requests contain multiple subtasks at different tiers. Decompose them:
94
113
 
95
114
  ### Example 1: "Fix the bug in auth.py and add tests"
96
- 1. **hydra-scout (Haiku)** [BLOCKING] → Find auth.py, read it, understand the context
97
- 2. **hydra-coder (Sonnet)** [BLOCKING] → Fix the bug and write tests
98
- 3. **hydra-runner (Haiku)** [BLOCKING] → Run the tests to verify
115
+ 1. **hydra-scout (Haiku 4.5)** [BLOCKING] → Find auth.py, read it, understand the context
116
+ 2. **hydra-coder (Sonnet 4.6)** [BLOCKING] → Fix the bug and write tests
117
+ 3. **hydra-guard (Haiku 4.5)** [NON-BLOCKING] → Security scan on changed files
118
+ **hydra-runner (Haiku 4.5)** [BLOCKING] → Run the tests to verify
99
119
 
100
120
  ### Example 2: "Refactor the API module and update the docs"
101
- 1. **hydra-scout (Haiku)** [BLOCKING] → Map the current API module structure
102
- 2. **hydra-coder (Sonnet)** [BLOCKING] → Perform the refactoring
103
- 3. **hydra-runner (Haiku)** [BLOCKING] → Run tests to verify nothing broke
104
- **hydra-scribe (Haiku)** [NON-BLOCKING] → Update documentation (fire & forget)
121
+ 1. **hydra-scout (Haiku 4.5)** [BLOCKING] → Map the current API module structure
122
+ 2. **hydra-coder (Sonnet 4.6)** [BLOCKING] → Perform the refactoring
123
+ 3. **hydra-runner (Haiku 4.5)** [BLOCKING] → Run tests to verify nothing broke
124
+ **hydra-scribe (Haiku 4.5)** [NON-BLOCKING] → Update documentation (fire & forget)
105
125
 
106
126
  ### Example 3: "Review the codebase and suggest architecture improvements"
107
- 1. **hydra-scout (Haiku)** → Map the project structure and key files
108
- 2. **hydra-analyst (Sonnet)** → Review code quality and patterns
109
- 3. **Opus (you)** → Synthesize findings into architecture recommendations
127
+ 1. **hydra-scout (Haiku 4.5)** → Map the project structure and key files
128
+ 2. **hydra-analyst (Sonnet 4.6)** → Review code quality and patterns
129
+ 3. **Opus 4.6 (you)** → Synthesize findings into architecture recommendations
110
130
 
111
131
  ### Example 4: "Set up CI/CD for this project"
112
- 1. **hydra-scout (Haiku)** → Understand the project structure, build system, test framework
113
- 2. **Opus (you)** → Design the CI/CD pipeline (architectural decision)
114
- 3. **hydra-coder (Sonnet)** → Implement the config files
115
- 4. **hydra-runner (Haiku)** → Validate the configuration
132
+ 1. **hydra-scout (Haiku 4.5)** → Understand the project structure, build system, test framework
133
+ 2. **Opus 4.6 (you)** → Design the CI/CD pipeline (architectural decision)
134
+ 3. **hydra-coder (Sonnet 4.6)** → Implement the config files
135
+ 4. **hydra-runner (Haiku 4.5)** → Validate the configuration
116
136
 
117
137
  ---
118
138
 
@@ -122,12 +142,12 @@ These are tasks that look like one tier but are actually another:
122
142
 
123
143
  | Task | Looks like | Actually | Why |
124
144
  |------|-----------|----------|-----|
125
- | "Add a simple button" | Tier 1 (simple) | Tier 2 (Sonnet) | Needs to match existing component patterns |
126
- | "Read the logs and find the error" | Tier 1 (read) | Tier 2 (Sonnet) | Log analysis requires reasoning |
127
- | "Fix the typo in line 42" | Tier 2 (code change) | Tier 1 (Haiku) | Trivial mechanical change |
128
- | "Add caching" | Tier 2 (implementation) | Tier 3 (Opus) | Cache invalidation strategy is hard |
129
- | "Write a migration to add a column" | Tier 2 (code writing) | Tier 1 (Haiku) | Template-level SQL |
130
- | "Upgrade React from 17 to 18" | Tier 1 (simple) | Tier 3 (Opus) | Breaking changes need careful analysis |
145
+ | "Add a simple button" | Tier 1 (simple) | Tier 2 (Sonnet 4.6) | Needs to match existing component patterns |
146
+ | "Read the logs and find the error" | Tier 1 (read) | Tier 2 (Sonnet 4.6) | Log analysis requires reasoning |
147
+ | "Fix the typo in line 42" | Tier 2 (code change) | Tier 1 (Haiku 4.5) | Trivial mechanical change |
148
+ | "Add caching" | Tier 2 (implementation) | Tier 3 (Opus 4.6) | Cache invalidation strategy is hard |
149
+ | "Write a migration to add a column" | Tier 2 (code writing) | Tier 1 (Haiku 4.5) | Template-level SQL |
150
+ | "Upgrade React from 17 to 18" | Tier 1 (simple) | Tier 3 (Opus 4.6) | Breaking changes need careful analysis |
131
151
 
132
152
  ---
133
153
 
@@ -136,24 +156,32 @@ These are tasks that look like one tier but are actually another:
136
156
  ```
137
157
  Is it read-only? ─── Yes ──→ Is it just finding/reading files?
138
158
  │ │
139
- │ Yes: hydra-scout (Haiku)
140
- │ No: hydra-analyst (Sonnet)
159
+ │ Yes: hydra-scout (Haiku 4.5)
160
+ │ No: hydra-analyst (Sonnet 4.6)
161
+
162
+ No
163
+
164
+ Is it a git operation? ─── Yes ──→ hydra-git (Haiku 4.5)
165
+
166
+ No
167
+
168
+ Is it a security/quality scan? ─── Yes ──→ hydra-guard (Haiku 4.5)
141
169
 
142
170
  No
143
171
 
144
- Is it just running a command? ─── Yes ──→ hydra-runner (Haiku)
172
+ Is it just running a command? ─── Yes ──→ hydra-runner (Haiku 4.5)
145
173
 
146
174
  No
147
175
 
148
- Is it writing docs/comments only? ─── Yes ──→ hydra-scribe (Haiku)
176
+ Is it writing docs/comments only? ─── Yes ──→ hydra-scribe (Haiku 4.5)
149
177
 
150
178
  No
151
179
 
152
- Is the implementation approach clear? ─── Yes ──→ hydra-coder (Sonnet)
180
+ Is the implementation approach clear? ─── Yes ──→ hydra-coder (Sonnet 4.6)
153
181
 
154
182
  No
155
183
 
156
- Does it need architectural judgment? ─── Yes ──→ Opus (you)
184
+ Does it need architectural judgment? ─── Yes ──→ Opus 4.6 (you)
157
185
 
158
- No ──→ hydra-coder (Sonnet), but monitor output closely
186
+ No ──→ hydra-coder (Sonnet 4.6), but monitor output closely
159
187
  ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "hail-hydra-cc",
3
- "version": "1.0.0",
3
+ "version": "1.2.0",
4
4
  "description": "Multi-headed speculative execution framework for Claude Code",
5
5
  "bin": {
6
6
  "hail-hydra-cc": "bin/cli.js"
package/src/display.js CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  const chalk = require('chalk');
4
4
 
5
- const VERSION = '1.0.0';
5
+ const VERSION = require('../package.json').version;
6
6
 
7
7
  // Block-character ASCII art — render in two-tone cyan/green for visual impact
8
8
  const LOGO_TOP = `
@@ -39,7 +39,7 @@ function showFileInstalled(displayName, success, errorMsg) {
39
39
 
40
40
  function showInstallComplete() {
41
41
  console.log();
42
- console.log(chalk.cyan.bold(' 🐉 Hail Hydra! 5 heads deployed and ready.'));
42
+ console.log(chalk.cyan.bold(' 🐉 Hail Hydra! 7 heads deployed and ready.'));
43
43
  console.log();
44
44
  console.log(chalk.gray(' Launch Claude Code to start using the framework.'));
45
45
  console.log(chalk.gray(' GitHub: https://github.com/AR6420/Hail_Hydra'));
package/src/files.js CHANGED
@@ -43,6 +43,16 @@ const agents = {
43
43
  model: 'Sonnet',
44
44
  display: 'hydra-analyst (Sonnet) — Code review & debugging',
45
45
  },
46
+ 'hydra-guard': {
47
+ content: readBundled('agents/hydra-guard.md'),
48
+ model: 'Haiku',
49
+ display: 'hydra-guard (Haiku) — Auto-protection & safety',
50
+ },
51
+ 'hydra-git': {
52
+ content: readBundled('agents/hydra-git.md'),
53
+ model: 'Haiku',
54
+ display: 'hydra-git (Haiku) — Git operations',
55
+ },
46
56
  };
47
57
 
48
58
  const skill = readBundled('SKILL.md');
package/src/prompts.js CHANGED
@@ -36,7 +36,7 @@ async function runPrompts() {
36
36
  // ── Prompt 2: Confirmation with agent preview ─────────────────────────────
37
37
 
38
38
  console.log();
39
- console.log(chalk.bold(' This will install 5 Hydra agents + SKILL.md + reference docs.'));
39
+ console.log(chalk.bold(' This will install 7 Hydra agents + SKILL.md + reference docs.'));
40
40
  console.log();
41
41
  console.log(' Agents:');
42
42
 
@@ -44,6 +44,8 @@ async function runPrompts() {
44
44
  { dot: chalk.green('🟢'), name: 'hydra-scout (Haiku) ', role: 'Codebase exploration' },
45
45
  { dot: chalk.green('🟢'), name: 'hydra-runner (Haiku) ', role: 'Test execution & validation' },
46
46
  { dot: chalk.green('🟢'), name: 'hydra-scribe (Haiku) ', role: 'Documentation writing' },
47
+ { dot: chalk.green('🟢'), name: 'hydra-guard (Haiku) ', role: 'Auto-protection & safety' },
48
+ { dot: chalk.green('🟢'), name: 'hydra-git (Haiku) ', role: 'Git operations' },
47
49
  { dot: chalk.blue('🔵'), name: 'hydra-coder (Sonnet) ', role: 'Code implementation' },
48
50
  { dot: chalk.blue('🔵'), name: 'hydra-analyst (Sonnet)', role: 'Code review & debugging' },
49
51
  ];