К основному содержанию
плагин

dead-end-registry — плагин для Claude Code: суть и установка

Плагин dead-end-registry сохраняет отменённые решения и предупреждает, если вы или модель снова пытаетесь пойти по тупиковому пути. Помогает не тратить токены на повторные ошибки.

MIT ★ 586 обновлён 2026-10-26

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add karanb192/claude-code-hooks
/plugin install dead-end-registry@claude-code-hooks
Открыть на GitHub

Что делает dead-end-registry

Плагин отслеживает события Stop, SubagentStop и PreCompact. Он парсит стенограмму сессии в фоне без задержек, находит откатанные правки и записывает их причину, дату и расчётную цену по ставке 0.000009 доллара за токен. Данные хранятся локально в ~/.claude/dead-end-registry/<repo>.jsonl, поэтому в git-репозиторий ничего лишнего не попадает.

При отправке нового запроса срабатывает хук UserPromptSubmit. Если запрос совпадает с известным тупиком, плагин выводит предупреждающую карточку с деталями прошлых попыток. А перед изменением файлов через хук PreToolUse плагин принудительно запрашивает подтверждение ask, если свежий патч возвращает ранее удалённый фрагмент кода.

Поведение задано константами в коде: записи старше 60 дней удаляются при сжатии контекста, а поиск по запросу охватывает до 500 последних записей. Посмотреть весь список тупиков текущего репозитория можно командой /dead-end-registry:dead-ends.

Какие задачи решает

  • Предотвратить повторное применение отменённых и тупиковых правок
  • Заблокировать автоматический возврат неудачного кода через запрос подтверждения
  • Сохранить контекст неудачных гипотез между сессиями без засорения git
  • Оценить расход токенов на отменённые эксперименты в проекте

Примеры запросов агенту

  • /dead-end-registry:dead-ends
  • Попробуй переписать авторизацию через сессии
  • Покажи, какие подходы к кэшированию мы уже пробовали и почему отклонили

Как установить dead-end-registry

Через маркетплейс плагинов

/plugin marketplace add karanb192/claude-code-hooks
/plugin install dead-end-registry@claude-code-hooks

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о dead-end-registry

Как установить dead-end-registry в Claude Code?

Выполните по очереди две команды: сначала /plugin marketplace add karanb192/claude-code-hooks, затем /plugin install dead-end-registry@claude-code-hooks. После этого перезапустите Claude Code.

Что делает плагин dead-end-registry?

Он фиксирует отменённые попытки решения задач в отдельном файле реестра и выводит предупреждение, когда вы или ассистент пытаетесь повторить уже забракованный подход.

Куда сохраняются записи и отправляются ли они в сеть?

Плагин не делает сетевых запросов. Записи хранятся локально на вашей машине по пути ~/.claude/dead-end-registry/<repo>.jsonl отдельно от рабочего дерева репозитория.

Исходный текст

dead-end-registry · MIT
# dead-end-registry

> Remembers approaches you tried and reverted (with reason and estimated token cost) and warns before you retry them.

On `Stop`, `SubagentStop`, and `PreCompact` the hook mines the session transcript for approaches you TRIED and then REVERTED or ruled out, recording each with its reason, date, and an estimated token cost of the detour into a per-repo registry. On `UserPromptSubmit` it keyword-matches the new prompt against that registry and injects a "DEAD END: you already tried this" card via `additionalContext`. On `PreToolUse` (Edit|Write) it returns an `ask` decision when the pending diff would reintroduce a previously-reverted hunk. Extraction is deterministic (revert-signal heuristics plus tool-result scanning); an optional model pass is never required and never runs in tests.

## Install

```
/plugin marketplace add karanb192/claude-code-hooks   # once per machine
/plugin install dead-end-registry@claude-code-hooks
```

Restart Claude Code, done. (Or from a shell: `claude plugin install dead-end-registry@claude-code-hooks`.)

## What it does

| Event | Runs | What happens |
|-------|------|--------------|
| UserPromptSubmit | sync | Matches the prompt against the registry; injects a "you already tried this" warning card when it hits a recorded dead end. |
| PreToolUse (Edit\|Write) | sync | Returns permission decision `ask` when the diff would reintroduce a previously-reverted hunk. |
| Stop | async (zero added latency) | Mines the transcript for abandoned approaches into the per-repo registry. |
| SubagentStop | async (zero added latency) | Same mining, at subagent stop. |
| PreCompact | async (zero added latency) | Same mining, before context is compacted away. |

`/dead-end-registry:dead-ends` renders this repo's recorded dead ends, newest first, each with the date tried, why it was walked back, and the estimated token cost of the detour.

## Configuration

No environment variables. Behavior is governed by in-source constants with these defaults:

- `MAX_AGE_DAYS` = 60: entries older than this are ignored on read and dropped at compaction.
- `MAX_CARD_ENTRIES` = 3: entries shown in an injected card.
- `MAX_REGISTRY_ENTRIES` = 500: entries scanned on prompt-submit.
- `MAX_CODE_LINES` = 80 / `MAX_CODE_CHARS` = 4000: truncation caps on stored code snapshots.
- `USD_PER_TOKEN` = 0.000009: rough blended rate for the headline cost figure.

State is stored per-project (keyed by a hash of the repo path) under `~/.claude/dead-end-registry/<repo>.jsonl`, outside the repo so nothing is accidentally committed.

## Data & privacy

Recorded: short summaries and truncated code snapshots of reverted approaches, plus reason, date, and an estimated token cost, all mined from your local transcripts. Everything stays on your machine: the hook makes no network calls.

## Uninstall

```
/plugin uninstall dead-end-registry@claude-code-hooks
```

© Karan Bansal · MIT · karanb192/claude-code-hooks

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
groove-daily-end andreadellacorte Скилл groove-daily-end фиксирует результаты рабочего дня, ведёт журнал в памяти .groove и запускает финальные хуки проекта. CX Codex +1 559установок session-end Sharrmavishal Субагент session-end закрывает сессию: записывает уроки, открытые проблемы, следующие шаги и состояние, которое не успели сохранить другие обработчики. CX Codex ★ 42 780звёзд репо plur-session-end plur-ai Скилл plur-session-end для Claude Code в конце сессии извлекает из разговора исправления, предпочтения, решения и правила проекта. Так знания сохраняются для будущих сессий. CX Codex +1 ★ 318звёзд репо remember rohitg00 Скилл remember сохраняет решения и выводы в долговременную память agentmemory с тегами понятий, чтобы агент мог найти их в будущих сессиях. CX Codex +1 15 000установок handoff rohitg00 Скилл handoff возобновляет последнюю сессию агента для текущей папки и сразу показывает незакрытый вопрос. CX Codex +1 14 400установок memxus memxus Сервер memxus для сохранения контекста проекта, предпочтений и решений, чтобы вспомнить их в Claude, Cursor, Copilot и других MCP-клиентах. Без повторения одного и того же. CX Codex +1 6 038установок

Из того же набора28

Весь набор →
protect-tests Плагин protect-tests останавливает «липовый зелёный» результат: не даёт агенту удалять, переименовывать или отключать тесты через skip/xfail вместо того, чтобы чинить код. Работает с pytest, jest, Go, JUnit, RSpec и другими фреймворками. ★ 586звёзд репо git-safety Плагин git-safety для Claude Code перехватывает вызовы Bash и блокирует опасные команды git и gh CLI до выполнения. ★ 586звёзд репо protect-secrets Плагин protect-secrets для Claude Code проверяет вызовы Read, Edit, Write, Bash и Grep и блокирует доступ к секретам или сначала запрашивает разрешение. ★ 586звёзд репо bounty-board Плагин bounty-board превращает TODO и FIXME в вашем коде в растущие по возрасту XP-бонусы. Плагин сканирует репозиторий, оценивает долг в очки и подсказывает три самых прибыльных задачи прямо в сессии. ★ 586звёзд репо standup-autopilot Плагин standup-autopilot собирает задачи, тесты, PR и блокеры из транскриптов сессий и оформляет сводку для дейли. Открытые блокеры возвращаются в следующую сессию. ★ 586звёзд репо pr-provenance-stamp Плагин pr-provenance-stamp дописывает в тело пулл-реквеста квитанцию: число промптов, оценку расхода, коды возврата тестов и долю строк, написанных агентом. ★ 586звёзд репо dead-rules-audit Плагин dead-rules-audit аудирует соблюдение правил из CLAUDE.md во время сессии Claude Code и отмечает правила, которые агент постоянно игнорирует. ★ 586звёзд репо nerf-receipts Плагин nerf-receipts считает сбои инструментов, повторные правки одного файла и токены на задачу. Помогает увидеть, меняются ли эти показатели вместе со сменой модели. ★ 586звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой