claude-gladiator

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
2. search_conversations("project or topic") — related past work
3. get_error_solutions("specific error") — for error clusters
4. find_tool_patterns("tool name") — for tool workflow clusters
5. gladiator_reflect() — cluster observations
6. If oracle active: for each recommendation involving new artifacts
7. search("cluster tag") — check if best-in-class solution already exists
8. Install existing solution instead of reinventing
9. Present enriched recommendations: pattern + history + available tools
10. 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