
claude-gladiator
Continuous learning hooks for gladiator MCP (observe patterns, reflect on them)
- version
- 1.0.0
- GitHub stars
- 80
Install
/plugin install claude-gladiator@claude-emporiumRun it inside Claude Code after adding the marketplace with /plugin marketplace add Vvkmnn/claude-emporium.
Contents
Discovered from sourceSkills 1
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
Commands 1
/review-gladiator
Review accumulated observations, enrich with session history, and generate recommendations.
Usage
/review-gladiator- Reflect on all unprocessed observations/review-gladiator auth- Focus reflection on auth-related patterns
Action
- If historian sibling is active:
list_recent_sessions()to get session referencesgladiator_observe(source: "conversation", session_ref: <ref>)for relevant sessions
- Call
gladiator_reflect()to cluster observations and generate recommendations - If oracle sibling is active:
- Search for existing solutions before proposing new artifacts
- Present recommendations to user with proposed changes
When to Use
- After a long session: Before context is lost
- After shipping: Natural checkpoint to capture learnings
- Periodically: Every few sessions to evolve your workflow
- After repeated errors: When patterns emerge worth encoding
Example Output
gladiator_reflect()
3 clusters found:
1. "Edit failures" (5 observations)
→ Recommendation: Add context lines to Edit calls
→ Existing rule at ~/.claude/rules/avoid.md could be updated
2. "Test-first pattern" (3 observations)
→ Recommendation: Encode TDD workflow for this project
→ 🔮 oracle found: tdd-workflows plugin (already installed)
Hooks 2
MCP servers 1
Sponsors
Details
- Marketplace
- Vvkmnn/claude-emporium
- Source
- plugins/claude-gladiator
- Author
- vvkmnn
- Category
- Productivity