# debt-ops

Плагин debt-ops для Claude Code и Codex записывает отложенные решения агента в реестр репозитория; скилл ревью сортирует долги по частоте правок файлов.

- плагин · `type=plugin` · Claude Code, Codex · ★ 1596 у репозитория
- Автор: Brandin Canfield
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/bcanfield/agentic-tech-debt
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст и 8 файлов скриптов) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/plugins/debt-ops

## Что делает

Плагин вешает хуки на каждый шаг агента. `SessionStart` подсовывает дисциплины и кэширует команды проверки качества вместе с путями к ADR и реестру. После `apply_patch`, `Edit` или `Write` хук `PostToolUse` прогоняет эти команды по изменённым файлам с бюджетом 3 секунды на команду. `Stop` ищет свежие TODO и напоминает, если отложенное решение так и не попало в реестр.

Сами записи лежат в репозитории. Скилл `$add` заводит долг и выдаёт ему букву партии, `$review` разбирает реестр и сортирует, что гасить первым, по частоте правок файла, `$metrics` печатает сводку из лога. Ещё есть `$init`: он пишет в `AGENTS.md` раздел `## Tech debt operations`, откуда хуки читают команды качества. Именно `AGENTS.md`, а не `CLAUDE.md`, потому что это адаптер под Codex.

Нужен git-репозиторий и Python 3.10+, причём только стандартная библиотека: без репозитория реестру негде лежать. Кэш живёт в `~/.cache/debt-ops/cache/<repo-hash>/`, другой путь задаётся через `DEBT_OPS_CACHE`. В Codex можно писать в промпте `drop A`, `drop A,C` или `drop all`, а `DEBT_OPS_DEBUG=1` складывает лог каждого срабатывания хука в файл в кэше.

## Установка

### Claude Code (родная платформа)

**Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add hashgraph-online/awesome-codex-plugins
```
В чате агента (не в терминале):
```text
/plugin install debt-ops@awesome-codex-plugins
```

## Когда брать
- поймать отложенное решение агента в момент правки
- свести все долги в один реестр внутри репозитория
- отсортировать, что чинить первым, по частоте правок файла
- не забыть вернуться к TODO, оставшимся в коде
- снять сводку по накопленному долгу перед рефакторингом

## Примеры запросов агенту
- Занеси в реестр: заглушка в `billing/tax.py`, вернуться после релиза — `$add`
- Покажи, что гасить первым: `$review`
- Сколько долгов накопилось? Дай сводку: `$metrics`

## Похожие
- [zero-tech-debt](https://affpapa.org/nevibecode/skills/zero-tech-debt.md) — скилл · 555 установок
- [tech-debt-mcp](https://affpapa.org/nevibecode/mcp/tech-debt-mcp.md) — MCP-сервер · ★ 7 у репозитория
- [Act as a Senior Codebase Auditor & Tech Debt Refactorer](https://affpapa.org/nevibecode/prompts/act-as-a-senior-codebase-auditor-tech-debt-refactorer.md) — промпт · ★ 178201 у репозитория
- [tech-debt-ci-review](https://affpapa.org/nevibecode/skills/zaxbyhub-tech-debt-ci-review.md) — скилл · ★ 539 у репозитория
- [tech-debt](https://affpapa.org/nevibecode/skills/tech-debt.md) — скилл · 6800 установок
- [ponytail-debt](https://affpapa.org/nevibecode/skills/ponytail-debt.md) — скилл · 59300 установок

Из того же набора: [hashgraph-online/awesome-codex-plugins](https://affpapa.org/nevibecode/by/hashgraph-online/awesome-codex-plugins.md) — 391 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
