claude-gladiator
// Continuous learning — hooks observe failures and prompt reflection, sibling synergy deepens analysis with history and tool discovery
$ git log --oneline --stat
stars:290
forks:55
updated:February 22, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
nameclaude-gladiator
descriptionContinuous learning — hooks observe failures and prompt reflection, sibling synergy deepens analysis with history and tool discovery
triggersPostToolUse,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)
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 workget_error_solutions("specific error")— for error clustersfind_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