# tdd-guide

Субагент tdd-guide ведёт разработку по циклу TDD: сначала тесты, затем код и рефакторинг. Подключайте его при создании функций, исправлении ошибок и переработке кода.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 6739 у репозитория
- Автор: Affaan Mustafa
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/WorldFlowAI/everything-claude-code/tree/HEAD/agents/tdd-guide.md
- Обновлён: 2026-01-23
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/affaan-mustafa-tdd-guide

## Что делает

tdd-guide просит сначала написать тест и проверить, что он падает, затем добавить минимальную реализацию и убедиться, что тест проходит. После этого он направляет рефакторинг и проверку покрытия; целевой порог — 80% для ветвей, функций, строк и выражений.

Субагент помогает составлять модульные и интеграционные тесты, а для критических пользовательских сценариев — E2E-тесты с Playwright. Он также обращает внимание на граничные случаи, ошибки внешних сервисов и независимость тестов. В примерах используются команды `npm test` и `npm run test:coverage`; если проект не использует эти команды, их придётся заменить на подходящие для него.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add WorldFlowAI/everything-claude-code
```
В чате агента (не в терминале):
```text
/plugin install everything-claude-code@everything-claude-code
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/tdd-guide.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/tdd-guide.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/tdd-guide.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/WorldFlowAI/everything-claude-code/tree/HEAD/agents/tdd-guide.md

## Когда брать
- написать тест до реализации новой функции
- проверить обработку пустых и некорректных данных
- покрыть API интеграционными тестами
- проверить критический пользовательский сценарий через Playwright
- найти тесты, зависящие от общего состояния

## Примеры запросов агенту
- Сначала составь тесты для новой функции, запусти их, а затем предложи минимальную реализацию.
- Проверь обработку пустого ввода и ошибок базы данных в тестах этого API.
- Добавь E2E-проверку критического пользовательского сценария с Playwright.

## Похожие
- [tdd](https://affpapa.org/nevibecode/skills/backnotprop-tdd.md) — скилл · 10000 установок
- [rtk-tdd](https://affpapa.org/nevibecode/skills/rtk-tdd.md) — скилл · 2300 установок
- [tdd-rust](https://affpapa.org/nevibecode/skills/tdd-rust.md) — скилл · 1500 установок
- [tdd-workflow](https://affpapa.org/nevibecode/skills/ruvnet-tdd-workflow.md) — скилл · 743 установки
- [w-tdd](https://affpapa.org/nevibecode/skills/w-tdd.md) — скилл · 647 установок
- [python-tdd-with-uv](https://affpapa.org/nevibecode/skills/python-tdd-with-uv.md) — скилл · 449 установок

Из того же набора: [worldflowai/everything-claude-code](https://affpapa.org/nevibecode/by/worldflowai/everything-claude-code.md) — 29 карточек

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

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