Skip to content

Commit 1a6c992

Browse files
author
Jose Mejia
committed
Cleaning up notification system and renaming pliugin
1 parent 3b32622 commit 1a6c992

84 files changed

Lines changed: 363 additions & 8728 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.claude-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"name": "hydra-framework",
2+
"name": "hydra",
33
"description": "Multi-agent autonomous development loop with review pipeline, context management, and parallel execution",
44
"version": "1.1.0"
55
}

‎CLAUDE.md‎

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
Hydra is a Claude Code plugin that provides multi-agent autonomous development. This repo IS the installable plugin.
66

7-
**Install:** `claude --plugin-dir /path/to/ai-hydra-framework` or clone to `~/.claude/plugins/hydra-framework`.
7+
**Install:** `claude --plugin-dir /path/to/ai-hydra` or clone to `~/.claude/plugins/hydra`.
88

99
## Directory Structure
1010

@@ -13,17 +13,17 @@ Hydra is a Claude Code plugin that provides multi-agent autonomous development.
1313
CONSTITUTION.md # Non-negotiable operating principles
1414
GOVERNANCE.md # Decision authority, conflict resolution, escalation
1515
TEAM_CHARTER.md # Agent roles, communication protocols, coordination
16-
skills/ # User-facing commands (/hydra-*)
17-
│ ├── hydra-init/SKILL.md
18-
│ ├── hydra-start/SKILL.md
19-
│ ├── hydra-status/SKILL.md
20-
│ ├── hydra-review/SKILL.md
21-
│ ├── hydra-discover/SKILL.md
22-
│ ├── hydra-context/SKILL.md
23-
│ ├── hydra-simplify/SKILL.md
24-
│ ├── hydra-docs/SKILL.md
25-
│ ├── hydra-patch/SKILL.md
26-
│ └── hydra-verify/SKILL.md
16+
skills/ # User-facing commands (/hydra:*)
17+
│ ├── init/SKILL.md
18+
│ ├── start/SKILL.md
19+
│ ├── status/SKILL.md
20+
│ ├── review/SKILL.md
21+
│ ├── discover/SKILL.md
22+
│ ├── context/SKILL.md
23+
│ ├── simplify/SKILL.md
24+
│ ├── docs/SKILL.md
25+
│ ├── patch/SKILL.md
26+
│ └── verify/SKILL.md
2727
agents/ # Subagent definitions
2828
│ ├── discovery.md # Pipeline: scans codebase, classifies project
2929
│ ├── doc-generator.md # Pipeline: generates PRD, TRD, ADRs
@@ -49,7 +49,7 @@ scripts/ # Shell scripts for hooks
4949
│ ├── pre-tool-guard.sh
5050
│ └── session-context.sh
5151
templates/ # Objective + document templates
52-
│ ├── CLAUDE.md.template # Injected into target projects by /hydra-init
52+
│ ├── CLAUDE.md.template # Injected into target projects by /hydra:init
5353
│ ├── feature.md / tdd.md / bugfix.md / refactor.md / greenfield.md / migration.md
5454
│ └── docs/ # Document templates for doc-generator
5555
references/ # Shared reference docs for agents
@@ -66,7 +66,7 @@ tests/ # Plugin validation tests
6666

6767
3. **Shell scripts must be POSIX-safe.** All scripts in `scripts/` should pass `bash -n` and `shellcheck`. They use `jq` for JSON manipulation.
6868

69-
4. **Runtime files are NOT part of the plugin.** The `hydra/` directory (config.json, plan.md, tasks/, checkpoints/, etc.) is created per-project by `/hydra-init`. This repo contains only the plugin code.
69+
4. **Runtime files are NOT part of the plugin.** The `hydra/` directory (config.json, plan.md, tasks/, checkpoints/, etc.) is created per-project by `/hydra:init`. This repo contains only the plugin code.
7070

7171
## Code Style
7272

‎CONSTITUTION.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ The supreme operating law of the Hydra Framework. These principles are non-negot
1010

1111
Every piece of state lives on disk, committed to git. The context window is ephemeral and disposable. No agent may rely on conversational memory for state. If it matters, it must be written to a file. If it's only in context, it doesn't exist.
1212

13-
This principle drives every architectural decision in Hydra: task manifests, recovery pointers, checkpoints, notifications, and review artifacts all exist as files.
13+
This principle drives every architectural decision in Hydra: task manifests, recovery pointers, checkpoints, and review artifacts all exist as files.
1414

1515
---
1616

@@ -54,7 +54,7 @@ YOLO: PLANNED → READY → IN_PROGRESS → IMPLEMENTED → IN_REVIEW → AP
5454
| APPROVED | DONE | PR merged (external event, YOLO mode only) | Notification handler or user |
5555
| CHANGES_REQUESTED | IN_PROGRESS | Implementer addresses feedback | Implementer |
5656
| Any active state | BLOCKED | Max retries hit, unresolvable issue, or 3 consecutive test failures | Implementer or Review Gate |
57-
| BLOCKED | READY | Human intervention resolves the blocker | User (manual or /hydra-task unblock) |
57+
| BLOCKED | READY | Human intervention resolves the blocker | User (manual or /hydra:task unblock) |
5858

5959
### Forbidden Transitions
6060

@@ -79,7 +79,7 @@ YOLO: PLANNED → READY → IN_PROGRESS → IMPLEMENTED → IN_REVIEW → AP
7979

8080
4. **Pre-checks before reviews.** Tests and lint must pass BEFORE any reviewer runs. Failed pre-checks send the task back to IN_PROGRESS. Three consecutive test failures block the task.
8181

82-
5. **Security rejections are absolute in AFK mode.** If any reviewer raises a security concern in autonomous mode, the task is BLOCKED and requires human review. This notification fires regardless of the `notifications.enabled` setting.
82+
5. **Security rejections are absolute in AFK mode.** If any reviewer raises a security concern in autonomous mode, the task is BLOCKED and requires human review.
8383

8484
6. **Every finding must be structured.** Each reviewer finding MUST include: severity (HIGH/MEDIUM/LOW), confidence score (0-100), file path, category, verdict (APPROVE/REJECT/CONCERN), issue description, and fix suggestion. Unstructured findings are invalid.
8585

@@ -161,7 +161,7 @@ Classification governs everything downstream:
161161

162162
### AFK vs. HITL Behavior
163163

164-
- **AFK mode:** Ambiguous classification defaults to BROWNFIELD. This is the safest default — it produces the most context without over-generating documents. Discovery logs the ambiguity to `hydra/notifications.jsonl`.
164+
- **AFK mode:** Ambiguous classification defaults to BROWNFIELD. This is the safest default — it produces the most context without over-generating documents.
165165
- **HITL mode:** Classification is confirmed with the user before proceeding. Discovery presents its evidence and recommended classification, and the user approves or overrides.
166166

167167
### Hard Requirement
@@ -228,7 +228,7 @@ These commands are blocked unconditionally:
228228

229229
### Escalation
230230

231-
When a task is BLOCKED, the system always writes a notification. When the blocked reason involves security, the notification fires regardless of the `notifications.enabled` setting. Git conflicts detected during the loop automatically block the active task.
231+
When a task is BLOCKED, the system escalates it. When the blocked reason involves security, the task requires human review. Git conflicts detected during the loop automatically block the active task.
232232

233233
---
234234

@@ -254,7 +254,7 @@ Read-only skills (`hydra-status`, `hydra-review`, `hydra-discover`, `hydra-conte
254254

255255
### Context Rot Detection
256256

257-
After 8+ iterations without compaction, the stop hook warns about potential context degradation. Running `/compact` with Hydra-specific instructions resets the iteration counter. The warning is logged to `hydra/notifications.jsonl` and displayed to the user if in HITL mode.
257+
After 8+ iterations without compaction, the stop hook warns about potential context degradation. Running `/compact` with Hydra-specific instructions resets the iteration counter. The warning is displayed to the user if in HITL mode.
258258

259259
### Compaction Survival
260260

@@ -304,4 +304,4 @@ This constitution may be amended only by:
304304

305305
No agent may unilaterally override these rules during operation. Configuration can adjust thresholds (Article VIII soft limits) but cannot disable fundamental principles (Articles I-VII).
306306

307-
**HYDRA_COMPLETE fires ONLY after post-loop agents complete.** If a post-loop agent fails, HYDRA_COMPLETE does not fire. The failure is logged to `hydra/notifications.jsonl` and the user is notified. Post-loop agents must all succeed for the loop to be considered truly complete.
307+
**HYDRA_COMPLETE fires ONLY after post-loop agents complete.** If a post-loop agent fails, HYDRA_COMPLETE does not fire. The user is notified and post-loop agents must all succeed for the loop to be considered truly complete.

‎GOVERNANCE.md‎

Lines changed: 12 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -114,9 +114,9 @@ When a specialist agent (e.g., Frontend Dev) produces work that the Implementer
114114
|---------|-----------|--------|
115115
| 3 consecutive test failures | Task BLOCKED | Write test output to `hydra/reviews/[TASK-ID]/test-failures.md`. Requires human investigation. |
116116
| Max retries exceeded | Task BLOCKED | Document all attempted approaches. Requires human decision. |
117-
| Security rejection in AFK mode | Task BLOCKED | Notification fires regardless of notification settings. Requires human review. |
118-
| Security blocker vs other blockers | Different handling | Security blockers: notification fires regardless of `notifications.enabled`, requires human unblock (cannot auto-resolve even in YOLO mode). Other blockers: follow normal notification settings, may be auto-resolved by `/hydra-task unblock`. |
119-
| Git conflicts detected | Task BLOCKED | Notification with `requires_human: true`. Merge conflicts need manual resolution. |
117+
| Security rejection in AFK mode | Task BLOCKED | Requires human review. |
118+
| Security blocker vs other blockers | Different handling | Security blockers require human unblock (cannot auto-resolve even in YOLO mode). Other blockers may be auto-resolved by `/hydra:task unblock`. |
119+
| Git conflicts detected | Task BLOCKED | Merge conflicts need manual resolution. |
120120
| 5 consecutive iterations with no progress | Loop STOPS | Suggests human review of blocked tasks and plan. |
121121
| AFK timeout exceeded | Loop STOPS | Session time limit reached. Human resumes when ready. |
122122
| Context rot (8+ iterations since compaction) | WARNING | Recommends running `/compact`. Does not block. |
@@ -127,13 +127,13 @@ Users can intervene at any time:
127127

128128
| Action | Command |
129129
|--------|---------|
130-
| Pause the loop | `/hydra-pause` |
131-
| Check status | `/hydra-status` |
132-
| View history | `/hydra-log` |
133-
| Unblock a task | `/hydra-task unblock TASK-NNN` |
134-
| Skip a task | `/hydra-task skip TASK-NNN` |
135-
| Add a task | `/hydra-task add "description"` |
136-
| Reset everything | `/hydra-reset` |
130+
| Pause the loop | `/hydra:pause` |
131+
| Check status | `/hydra:status` |
132+
| View history | `/hydra:log` |
133+
| Unblock a task | `/hydra:task unblock TASK-NNN` |
134+
| Skip a task | `/hydra:task skip TASK-NNN` |
135+
| Add a task | `/hydra:task add "description"` |
136+
| Reset everything | `/hydra:reset` |
137137
| Edit task directly | Edit `hydra/tasks/TASK-NNN.md` manually |
138138

139139
---
@@ -152,7 +152,7 @@ Users can intervene at any time:
152152
- Classification, documents, and plan proceed automatically
153153
- Auto-commit on every state transition with `hydra:` prefix
154154
- Security rejections auto-block (human reviews later)
155-
- Blockers are logged to notifications; human reviews asynchronously
155+
- Blockers are logged; human reviews asynchronously
156156
- Session time limit enforced (`afk.timeout_minutes`)
157157

158158
### YOLO (Full Berserk)
@@ -283,9 +283,8 @@ They must NOT modify application source code or test files.
283283
### Failure Handling
284284

285285
- If a post-loop agent fails, HYDRA_COMPLETE does NOT fire
286-
- The failure is logged to `hydra/notifications.jsonl` with event type `post_loop_failure`
287286
- The user is notified and must resolve the issue before completion
288-
- The loop can be resumed with `/hydra-start` which will retry the failed post-loop phase
287+
- The loop can be resumed with `/hydra:start` which will retry the failed post-loop phase
289288

290289
### Completion
291290

@@ -345,7 +344,6 @@ The Team Orchestrator manages all parallel coordination:
345344
| Project documents | `hydra/docs/` | Doc Generator |
346345
| Runtime configuration | `hydra/config.json` | Various (mode, iteration, agents) |
347346
| Iteration log | `hydra/logs/iterations.jsonl` | Stop hook |
348-
| External notifications | `hydra/notifications.jsonl` | Stop hook |
349347

350348
### Checkpoint Retention
351349

‎README.md‎

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<p align="center">
22
<picture>
3-
<source media="(prefers-color-scheme: dark)" srcset="assets/hydra-logo-dark.png">
4-
<source media="(prefers-color-scheme: light)" srcset="assets/hydra-logo-light.png">
5-
<img alt="Hydra Framework" src="assets/hydra-logo-light.png" width="400">
3+
<source media="(prefers-color-scheme: dark)" srcset="assets/hydra:logo-dark.png">
4+
<source media="(prefers-color-scheme: light)" srcset="assets/hydra:logo-light.png">
5+
<img alt="Hydra Framework" src="assets/hydra:logo-light.png" width="400">
66
</picture>
77
</p>
88

@@ -45,50 +45,50 @@ flowchart TD
4545
## Install
4646

4747
```bash
48-
git clone https://github.com/Strumtry/ai-hydra-framework.git
49-
claude --plugin-dir /path/to/ai-hydra-framework
48+
git clone https://github.com/Strumtry/ai-hydra.git
49+
claude --plugin-dir /path/to/ai-hydra
5050
```
5151

5252
To load automatically, add to `~/.zshrc` or `~/.bashrc`:
5353
```bash
54-
alias claude='claude --plugin-dir /path/to/ai-hydra-framework'
54+
alias claude='claude --plugin-dir /path/to/ai-hydra'
5555
```
5656

5757
## Quick Start
5858

5959
> [!TIP]
6060
> **3 commands to get started:**
6161
> ```bash
62-
> /hydra-init # Set up Hydra for your project
63-
> /hydra-start # Start the autonomous loop
64-
> /hydra-status # Check progress anytime
62+
> /hydra:init # Set up Hydra for your project
63+
> /hydra:start # Start the autonomous loop
64+
> /hydra:status # Check progress anytime
6565
> ```
6666
67-
Hydra auto-detects project state: active work resumes, existing docs trigger planning, fresh projects scan for TODOs/issues/failing tests. Override with `/hydra-start "specific objective"`.
67+
Hydra auto-detects project state: active work resumes, existing docs trigger planning, fresh projects scan for TODOs/issues/failing tests. Override with `/hydra:start "specific objective"`.
6868
6969
> [!WARNING]
7070
> **Autonomous mode** skips all permission prompts:
7171
> ```bash
7272
> claude --dangerously-skip-permissions
73-
> /hydra-start --yolo --max 30
73+
> /hydra:start --yolo --max 30
7474
> ```
7575
7676
## Commands
7777
7878
| Command | Description |
7979
|---------|-------------|
80-
| `/hydra-init` | First-time setup: discovery, reviewer generation, runtime dirs |
81-
| `/hydra-start` | Smart start/resume — auto-detects state, derives objective |
82-
| `/hydra-status` | Check loop progress, task counts, reviewer board |
83-
| `/hydra-pause` | Gracefully pause at next iteration boundary |
84-
| `/hydra-task` | Task lifecycle: skip, unblock, add, prioritize, list |
85-
| `/hydra-review` | Manually trigger review for a task |
86-
| `/hydra-log` | View run history — iterations, commits, reviews |
87-
| `/hydra-board` | Connect task tracking to GitHub Projects |
88-
| `/hydra-docs` | View or regenerate project documents |
89-
| `/hydra-help` | Quick reference for all commands and modes |
90-
91-
See `/hydra-help` for the full command list and all flags.
80+
| `/hydra:init` | First-time setup: discovery, reviewer generation, runtime dirs |
81+
| `/hydra:start` | Smart start/resume — auto-detects state, derives objective |
82+
| `/hydra:status` | Check loop progress, task counts, reviewer board |
83+
| `/hydra:pause` | Gracefully pause at next iteration boundary |
84+
| `/hydra:task` | Task lifecycle: skip, unblock, add, prioritize, list |
85+
| `/hydra:review` | Manually trigger review for a task |
86+
| `/hydra:log` | View run history — iterations, commits, reviews |
87+
| `/hydra:board` | Connect task tracking to GitHub Projects |
88+
| `/hydra:docs` | View or regenerate project documents |
89+
| `/hydra:help` | Quick reference for all commands and modes |
90+
91+
See `/hydra:help` for the full command list and all flags.
9292
9393
## How It Works
9494
@@ -100,12 +100,12 @@ See [Architecture](docs/ARCHITECTURE.md) for the full agent roster, pipeline det
100100
101101
- `jq` — Required for JSON manipulation in hook scripts
102102
- `git` — Required for commit tracking and state persistence
103-
- Claude Code — Agent Teams is enabled automatically by `/hydra-init`
103+
- Claude Code — Agent Teams is enabled automatically by `/hydra:init`
104104
105105
## Learn More
106106
107107
- [Architecture](docs/ARCHITECTURE.md) — Pipeline, agent roster, recovery, directory structure
108-
- [Configuration](docs/CONFIGURATION.md) — Start flags, local mode, board sync, notifications
108+
- [Configuration](docs/CONFIGURATION.md) — Start flags, local mode, board sync
109109
- [Safety & Rules](docs/SAFETY.md) — The 10 rules, guardrails, troubleshooting
110110
- [Plugins](docs/PLUGINS.md) — Companion plugins, compatibility matrix, OpenClaw
111111

0 commit comments

Comments
 (0)