ai-sdlc — хук для Claude Code: что делает и как установить
Хук ai-sdlc для Claude Code контролирует вызовы инструментов: блокирует запись кода без одобренного плана и защищает чувствительные пути.
MIT ★ 1 596 обновлён 2026-10-29
.claude/settings.jsonЧто делает ai-sdlc
Хуки из состава плагина ai-sdlc встраивают проверки прямо в цикл выполнения команд. На событии PreToolUse скрипт artifact-gate.sh перехватывает операции Write и Edit. Если для изменений нет утверждённого плана в Markdown, запись в исходные файлы блокируется. Тот же барьер не пускает правки с низким уровнем риска в критические пути проекта.
Для вызовов терминала через Bash подключён скрипт prod-guard.sh. На старте сессии запускается session-context.sh, подтягивая контекст разработки. При отправке пользовательского запроса срабатывает prompt-nudge.sh. Без предварительно зафиксированного плана хуки просто остановят модификацию кодовой базы.
Конфигурация прописывается в .claude/settings.json. В составе исходного плагина заявлены также 8 скиллов и 2 субагента только для чтения.
Какие задачи решает
- Заблокировать изменение исходников без согласованного плана в Markdown
- Ограничить выполнение небезопасных команд в
Bashс помощьюprod-guard.sh - Не допустить правки с низким уровнем риска в чувствительные пути
- Подгружать контекст проекта на старте сессии через
session-context.sh
Примеры запросов агенту
- Обнови файл
src/api.tsв соответствии с утверждённым планом - Запусти сборку проекта в терминале
- Подготовь план рефакторинга перед внесением изменений в код
Как установить ai-sdlc
Вручную: положить файлы
.claude/settings.jsonБлок hooks: событие (PreToolUse, PostToolUse, Stop…) → команда. Личные — ~/.claude/settings.json
По шагам, с командами для каждой платформы: Хуки Claude Code: что это, где настраивать и как запретить опасную команду
Вопросы об ai-sdlc
Как установить ai-sdlc в Claude Code?
Добавьте блок конфигурации хуков в файл .claude/settings.json. В настройках указываются пути к скриптам из каталога ${PLUGIN_ROOT}/hooks/.
Что делает набор хуков ai-sdlc?
Он принудительно внедряет шестиэтапный процесс разработки (SDLC) на уровне вызова инструментов. Хуки перехватывают запуск Bash, запись и редактирование файлов, а также обрабатывают события начала сессии и отправки запроса.
Как работает защита от несогласованных правок?
При вызове инструментов Write или Edit срабатывает скрипт artifact-gate.sh. Он проверяет наличие утверждённого плана изменений и отклоняет запись, если нужного артефакта нет.
Исходный текст
hooks.codex.json · MIT
Hooks bundle shipped with the ai-sdlc plugin for Claude Code.
Six-stage SDLC in committed Markdown where hooks enforce the loop at the tool-call level: an artifact gate refuses source writes no approved plan covers and keeps a change declared low-risk away from sensitive paths, with 8 skills and 2 read-only subagents.
Triggers on: PreToolUse, UserPromptSubmit, SessionStart.
```json
{
"hooks": {
"PreToolUse": [
{
"matcher": "Write|Edit",
"hooks": [
{
"type": "command",
"command": "\"${PLUGIN_ROOT}/hooks/artifact-gate.sh\""
}
]
},
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "\"${PLUGIN_ROOT}/hooks/prod-guard.sh\""
}
]
}
],
"SessionStart": [
{
"hooks": [
{
"type": "command",
"command": "\"${PLUGIN_ROOT}/hooks/session-context.sh\""
}
]
}
],
"UserPromptSubmit": [
{
"hooks": [
{
"type": "command",
"command": "\"${PLUGIN_ROOT}/hooks/prompt-nudge.sh\""
}
]
}
]
}
}
```
© Hieuvu7 · MIT · hashgraph-online/awesome-codex-plugins