// Use after tool failures or user corrections to record patterns, and when accumulated observations need clustering into rule/hook/skill recommendations. Builds project-specific knowledge that persists across sessions.
| name | claude-gladiator |
| description | Use after tool failures or user corrections to record patterns, and when accumulated observations need clustering into rule/hook/skill recommendations. Builds project-specific knowledge that persists across sessions. |
Record mistakes and corrections. Cluster them into actionable recommendations for rules, hooks, and skills.
After tool failures:
old_string not unique → Record disambiguation strategyAfter user corrections:
gladiator_observe(
summary: "Edit failed on config.ts — 3 identical import blocks, fixed by including surrounding function context",
tags: ["edit", "disambiguation"],
context: { error: "old_string not unique", before: "used import line only", after: "included 3 lines above" }
)
When observations have accumulated → gladiator_reflect() clusters unprocessed observations, scans existing ~/.claude/rules/, ~/.claude/hooks/, ~/.claude/skills/, and recommends UPDATE to existing artifacts or CREATE new ones.
Searching past patterns → gladiator_reflect(query: "edit") finds all observations matching a topic.
Checking stats → gladiator_reflect() with nothing unprocessed shows observation counts by type.
| Tool | When | What it does |
|---|---|---|
gladiator_observe | After failures, corrections, discoveries | Record pattern with summary, tags, context. Deduped by SHA-256. |
gladiator_reflect | After accumulating observations | Cluster → scan existing config → recommend artifact changes. |
| Mistake | Fix |
|---|---|
| Only observing failures | Also observe corrections, conventions, non-obvious solutions |
| Vague summaries | Include the specific error message, what was tried, what worked |
| Creating new rules when existing ones apply | Reflect scans existing artifacts — prefer UPDATE over CREATE |