debt-ops — хук для Claude Code: что делает и как установить
Хук debt-ops для Claude Code фиксирует отложенные задачи по техдолгу в реестре проекта. Скилл ранжирует их для разбора по частоте изменений затронутых файлов.
MIT ★ 1 596 обновлён 2026-10-29
.claude/settings.jsonЧто делает debt-ops
debt-ops записывает каждую отложенную задачу в реестр внутри репозитория. Скилл для разбора расставляет приоритеты по тому, как часто меняются затронутые файлы. Это помогает увидеть техдолг рядом с кодом, а не потерять его в переписке.
Хуки срабатывают при запуске и завершении сессии, отправке сообщения и после вызовов apply_patch, Edit или Write. Для них запускаются скрипты session-start.py, drop.py, feedback.py и stop.py через python3. Без Python 3 эти команды не запустятся.
Для Claude Code настройка размещается в .claude/settings.json. В описании также указана поддержка Codex, но инструкция по установке приведена для Claude Code.
Какие задачи решает
- зафиксировать отложенную задачу по техдолгу в реестре проекта
- разобрать накопленные задачи по частоте изменений файлов
- отслеживать отложенные задачи при правках через
EditиWrite - запускать сбор обратной связи после
apply_patch
Примеры запросов агенту
- Зафиксируй эту отложенную задачу по техдолгу в реестре проекта.
- Разбери реестр и расставь приоритеты по частоте изменений файлов.
- После правок через
Editпроверь, появились ли новые задачи по техдолгу.
Как установить debt-ops
Вручную: положить файлы
.claude/settings.jsonБлок hooks: событие (PreToolUse, PostToolUse, Stop…) → команда. Личные — ~/.claude/settings.json
По шагам, с командами для каждой платформы: Хуки Claude Code: что это, где настраивать и как запретить опасную команду
Вопросы о debt-ops
Как установить debt-ops в Claude Code?
Добавьте настройки хуков в файл .claude/settings.json.
Что делает debt-ops?
Хук записывает отложенные задачи по техдолгу в реестр репозитория. Скилл ранжирует их по частоте изменений файлов.
Какие инструменты запускает debt-ops?
Хуки запускают скрипты Python 3 при старте и завершении сессии, отправке сообщения и после apply_patch, Edit или Write.
Исходный текст
hooks.json · MIT
Hooks bundle shipped with the debt-ops plugin for Claude Code.
Catches AI-introduced tech debt at write-time: hooks log every deferral to a registry in your repo and a review skill ranks paydown by file churn.
Triggers on: PostToolUse, UserPromptSubmit, SessionStart, Stop.
```json
{
"hooks": {
"SessionStart": [
{
"hooks": [
{
"type": "command",
"command": "python3 ${PLUGIN_ROOT}/hooks/session-start.py"
}
]
}
],
"UserPromptSubmit": [
{
"hooks": [
{
"type": "command",
"command": "python3 ${PLUGIN_ROOT}/hooks/drop.py",
"timeout": 3
}
]
}
],
"PostToolUse": [
{
"matcher": "apply_patch|Edit|Write",
"hooks": [
{
"type": "command",
"command": "python3 ${PLUGIN_ROOT}/hooks/feedback.py",
"timeout": 5
}
]
}
],
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "python3 ${PLUGIN_ROOT}/hooks/stop.py",
"timeout": 5
}
]
}
]
}
}
```
© Brandin Canfield · MIT · hashgraph-online/awesome-codex-plugins