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.

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

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

Tool failures trigger observation automatically:

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

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

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

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)

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"])`

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