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)
gladiator_reflect()— cluster observations into recommendations- For each recommendation: read the existing artifact (if overlap detected)
- Propose UPDATE to existing artifact, not a new duplicate
- Present to user with reasoning
- Apply changes one at a time after approval
Reflect (with siblings)
- 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 gladiator_reflect()— cluster observations- 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 - Present enriched recommendations: pattern + history + available tools
- Apply changes one at a time after approval
Batch Review (/review-gladiator)
- If historian active:
list_recent_sessions()to get session refs gladiator_observe(source: "conversation", session_ref: <ref>)for relevant sessionsgladiator_reflect()to cluster all observations- If oracle active: search for existing solutions before creating new
- 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
