Claude Gladiator

---
name: claude-gladiator
description: Continuous learning — hooks observe failures and prompt reflection, sibling synergy deepens analysis with history and tool discovery
triggers: [PostToolUse, Stop]
---

# Gladiator Plugin

Continuous learning. Observes tool failures and prompts reflection at session end to evolve rules, hooks, and skills.

## Hooks

| Hook | When | Action |
|------|------|--------|
| **PostToolUse(Bash\|Edit\|Write)** | After tool failure | Observes the error pattern (silent on success) |
| **Stop** | Session ending | Prompts reflection if unprocessed observations exist |

## Commands

| Command | Description |
|---------|-------------|
| `/review-gladiator [topic]` | Batch learn from accumulated observations and session history |

## Workflows

### Observe (automatic via hooks)

Tool failures trigger observation automatically:
```
gladiator_observe(
  summary: "<what failed and how it was fixed>",
  context: {error, tool, before, after},
  tags: ["error", "<tool_name>"]
)
```

### Reflect (standalone)

1. `gladiator_reflect()` — cluster observations into recommendations
2. For each recommendation: read the existing artifact (if overlap detected)
3. Propose UPDATE to existing artifact, not a new duplicate
4. Present to user with reasoning
5. Apply changes one at a time after approval

### Reflect (with siblings)

1. If **historian** active: enrich reflection with broader context
   - `search_conversations("project or topic")` — related past work
   - `get_error_solutions("specific error")` — for error clusters
   - `find_tool_patterns("tool name")` — for tool workflow clusters
2. `gladiator_reflect()` — cluster observations
3. If **oracle** active: for each recommendation involving new artifacts
   - `search("cluster tag")` — check if best-in-class solution already exists
   - Install existing solution instead of reinventing
4. Present enriched recommendations: pattern + history + available tools
5. Apply changes one at a time after approval

### Batch Review (/review-gladiator)

1. If **historian** active: `list_recent_sessions()` to get session refs
2. `gladiator_observe(source: "conversation", session_ref: <ref>)` for relevant sessions
3. `gladiator_reflect()` to cluster all observations
4. If **oracle** active: search for existing solutions before creating new
5. Present recommendations to user

## Sibling Synergy

| Sibling | Value | How |
|---------|-------|-----|
| **Historian** | Past solutions enrich reflection | `get_error_solutions()`, `search_conversations()`, `find_tool_patterns()` |
| **Oracle** | Existing tools found before creating new | Search oracle for best-in-class solutions during reflection |
| **Praetorian** | n/a | Gladiator has its own persistence |
| **Vigil** | n/a | Different concerns (files vs patterns) |

## Observation Templates

| Situation | Call |
|-----------|------|
| Tool failure (auto) | `gladiator_observe(summary, context={error, tool, before, after}, tags=["error", tool])` |
| User correction | `gladiator_observe(summary, context={before, after}, tags=["correction"])` |
| Convention found | `gladiator_observe(summary, tags=["convention", "domain"])` |
| Decision made | `gladiator_observe(summary, tags=["architecture", "decision"])` |

## Requires

```
claude mcp add gladiator -- npx claude-gladiator-mcp
```