tdd-guard — плагин для Claude Code: контроль TDD
Плагин проверяет операции записи и редактирования файлов и блокирует изменения, которые пропускают тесты или выходят за их рамки. Нужен, чтобы соблюдать TDD во время работы агента.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install tdd-guard@claude-communityЧто делает tdd-guard
Хуки tdd-guard проверяют попытки Claude Code записать или изменить файл. Они блокируют операции, если агент пропускает тесты или реализует больше, чем требуется, и объясняют, что сделать вместо этого. Хуки устанавливаются автоматически вместе с плагином и управляют состоянием сессии.
Команда /tdd-guard:setup определяет тестовый фреймворк проекта и настраивает подходящий репортёр. Для работы нужны Node.js 22+ и поддерживаемый тестовый фреймворк, поэтому без одного из них настройка не подойдёт. После установки иногда нужно перезапустить терминал или расширение IDE, чтобы появилась команда настройки.
Какие задачи решает
- блокировать правки, сделанные до тестов
- останавливать реализацию сверх требований
- настраивать репортёр для тестового фреймворка проекта
- переключать и отслеживать состояние TDD-сессии
Примеры запросов агенту
- Настрой проверку TDD для тестового фреймворка этого проекта:
/tdd-guard:setup. - Добавь функцию через тесты и блокируй изменения, пока они не следуют TDD.
- Выключи проверку TDD командой
tdd-guard off, затем включи её командойtdd-guard on.
Как установить tdd-guard
Через маркетплейс плагинов
/plugin marketplace add anthropics/claude-plugins-community/plugin install tdd-guard@claude-communityПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о tdd-guard
Как установить tdd-guard в Claude Code?
В Claude Code сначала выполните /plugin marketplace add anthropics/claude-plugins-community, затем /plugin install tdd-guard@claude-community.
Что делает tdd-guard?
Плагин проверяет операции с файлами на соответствие TDD и блокирует те, что пропускают тесты или реализуют лишнее. Он также объясняет, что нужно сделать дальше.
Что требуется для настройки tdd-guard?
Нужны Node.js 22+ и поддерживаемый тестовый фреймворк. Команда /tdd-guard:setup обнаруживает фреймворк и настраивает репортёр.
Исходный текст
plugin · MIT
# TDD Guard Plugin Automated Test-Driven Development enforcement for Claude Code. When Claude Code attempts to edit or write files, TDD Guard validates that changes follow TDD principles — blocking operations that skip tests or over-implement. ## Setup After installing the plugin, run the setup skill to configure a test reporter for your project: ``` /tdd-guard:setup ``` This detects your test framework and configures the appropriate [reporter](https://github.com/nizos/tdd-guard). **Note:** You may need to restart your terminal session or IDE extension for the setup skill to appear. ## What's included - **Hooks** — Automatically registered on install. Validate file operations, handle `tdd-guard on/off` commands, and manage session state. - **Setup skill** — `/tdd-guard:setup` detects your test framework and configures the reporter. ## Requirements - Node.js 22+ - A supported test framework ## Learn more - [Documentation](https://github.com/nizos/tdd-guard) - [Configuration options](https://github.com/nizos/tdd-guard/blob/main/docs/configuration.md) - [Custom TDD rules](https://github.com/nizos/tdd-guard/blob/main/docs/custom-instructions.md)
© nizos · MIT · nizos/tdd-guard
