claude-gladiator — плагин для Claude Code: что делает и как установить
Плагин claude-gladiator непрерывного обучения для Claude Code. Фиксирует сбои инструментов и запускает разбор ошибок перед завершением сессии.
MIT ★ 78 обновлён 2026-03-05
/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-gladiator@claude-emporiumЧто делает claude-gladiator
Плагин добавляет два хука: PostToolUse для команд Bash, Edit и Write, а также Stop перед выходом из сессии. Когда инструмент падает с ошибкой, хук предлагает вызвать gladiator_observe и записать контекст сбоя. При успешном выполнении хук молчит и токенов не расходует.
Перед завершением сессии хук Stop проверяет накопившиеся записи и инициирует вызов gladiator_reflect. Агент группирует наблюдения в кластеры и предлагает обновить правила или хуки. Для пакетного разбора истории также доступна команда /review-gladiator [topic].
Для работы плагина обязательно нужен MCP-сервер claude-gladiator-mcp, без него вызовы инструментов не пройдут. Поведение настраивается в ~/.claude/settings.json параметрами observe_after_failure и reflect_before_stop.
Какие задачи решает
- сохранить контекст падений команд Bash, Edit и Write для анализа
- сгруппировать повторяющиеся ошибки сессии в рекомендации
- обновить проектные правила и хуки на основе реальных сбоев
- провести пакетный разбор истории сессии по выбранной теме
Примеры запросов агенту
- /review-gladiator typescript-errors
- /review-gladiator
- Разбери накопившиеся наблюдения gladiator и предложи правки в правила
Как установить claude-gladiator
Через маркетплейс плагинов
/plugin marketplace add Vvkmnn/claude-emporium/plugin install claude-gladiator@claude-emporiumПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о claude-gladiator
Как установить claude-gladiator в Claude Code?
Сначала добавьте каталог командой /plugin marketplace add Vvkmnn/claude-emporium, затем установите сам плагин через /plugin install claude-gladiator@claude-emporium.
Что делает плагин claude-gladiator?
Он перехватывает сбои инструментов редактирования и терминала, сохраняет их через MCP-сервер и перед выходом предлагает обновить правила проекта.
Что требуется настроить перед использованием?
Нужно подключить MCP-сервер командой claude mcp add gladiator -- npx claude-gladiator-mcp. Без этого инструментам gladiator_observe и gladiator_reflect будет некуда отправлять данные.
Исходный текст
claude-gladiator · MIT
# Claude Gladiator
Continuous learning hooks for Claude Code. Observes tool failure patterns and prompts reflection before session ends.
## Installation
```bash
/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-gladiator@claude-emporium
```
## Requirements
MCP server: [`claude-gladiator-mcp`](https://www.npmjs.com/package/claude-gladiator-mcp)
```bash
claude mcp add gladiator -- npx claude-gladiator-mcp
```
## Hooks
| Event | Trigger | What It Does |
|-------|---------|-------------|
| `PostToolUse` | `Bash` · `Edit` · `Write` | Observes tool failure patterns (silent on success) |
| `Stop` | `*` | Prompts reflection if unprocessed observations exist |
## Commands
| Command | Description |
|---------|-------------|
| `/review-gladiator [topic]` | Batch learn from observations and session history |
## MCP Tools
| Tool | Purpose |
|------|---------|
| `gladiator_observe` | Record a pattern worth learning from |
| `gladiator_reflect` | Cluster observations and get recommendations |
## Settings
Configure in `~/.claude/settings.json` under `claude-emporium`:
```json
{
"claude-emporium": {
"suggest_siblings": false,
"claude-gladiator": {
"observe_after_failure": false,
"reflect_before_stop": false
}
}
}
```
| Key | Default | What It Controls |
|-----|---------|-----------------|
| `observe_after_failure` | `true` | Observe tool failure patterns after errors |
| `reflect_before_stop` | `true` | Prompt reflection before session ends |
| `suggest_siblings` | `true` | Show install suggestions for sibling plugins (global) |
## How It Works
Hooks inject prompts that trigger `claude-gladiator-mcp` tools at high-impact moments. Tool failures are observed with context (error, tool, input), and accumulated observations are clustered into recommendations at session end.
Typical overhead: ~100-200 tokens per session.
## Hook Notifications
**After a tool failure** (PostToolUse) — Claude sees:
```
⚔️ [claude-gladiator] Edit failed — observe this pattern.
gladiator_observe(
summary="<describe what failed and how you fixed it>",
context={error:"old_string not unique", tool:"Edit",
before:"old_string: \"import { z }\"", after:"<what worked>"},
tags=["error", "edit"]
)
Error: old_string not unique
📜 [claude-historian] is active — check past solutions via get_error_solutions()
during reflection.
```
Claude calls `gladiator_observe` with the error context filled in. Silent on success — zero tokens when tools don't fail.
**Before session ends** (Stop) — Claude sees:
```
⚔️ [claude-gladiator] 3 unprocessed observations — consider reflecting before
session ends.
gladiator_reflect()
Review clusters, propose updates to existing rules/skills/hooks (prefer updating
over creating), and apply with user approval.
📜 [claude-historian] is active — enrich reflection with search_conversations()
and get_error_solutions().
🔮 [claude-oracle] is active — search for existing solutions before creating
new artifacts.
```
Claude runs the reflection workflow before context is lost. Only fires when unprocessed observations exist — silent otherwise. Sibling lines only appear when those plugins are installed.
## License
MIT
© vvkmnn · MIT · Vvkmnn/claude-emporium