Vvkmnn avatar

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-emporium

Run it inside Claude Code after adding the marketplace with /plugin marketplace add Vvkmnn/claude-emporium.

Contents

Discovered from source

Skills 1

Gladiator Plugin

Continuous learning. Observes tool failures and prompts reflection at session end to evolve rules, hooks, and skills.

Hooks

HookWhenAction
PostToolUse(Bash|Edit|Write)After tool failureObserves the error pattern (silent on success)
StopSession endingPrompts reflection if unprocessed observations exist

Commands

CommandDescription
/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
    • 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
  2. gladiator_reflect() — cluster observations
  3. 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
  4. Present enriched recommendations: pattern + history + available tools
  5. 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

SiblingValueHow
HistorianPast solutions enrich reflectionget_error_solutions(), search_conversations(), find_tool_patterns()
OracleExisting tools found before creating newSearch oracle for best-in-class solutions during reflection
Praetoriann/aGladiator has its own persistence
Vigiln/aDifferent concerns (files vs patterns)

Observation Templates

SituationCall
Tool failure (auto)gladiator_observe(summary, context={error, tool, before, after}, tags=["error", tool])
User correctiongladiator_observe(summary, context={before, after}, tags=["correction"])
Convention foundgladiator_observe(summary, tags=["convention", "domain"])
Decision madegladiator_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

  1. If historian sibling is active:
    • list_recent_sessions() to get session references
    • gladiator_observe(source: "conversation", session_ref: <ref>) for relevant sessions
  2. Call gladiator_reflect() to cluster observations and generate recommendations
  3. If oracle sibling is active:
    • Search for existing solutions before proposing new artifacts
  4. 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)

MCP servers 1

Sponsors

Details

Marketplace
Vvkmnn/claude-emporium
Source
plugins/claude-gladiator
Author
vvkmnn
Category
Productivity

More from Vvkmnn/claude-emporium

All 6