# tdd-cycle

Команда проводит разработку по циклу red-green-refactor: от требований и архитектуры тестов до первых падающих тестов. Между фазами она ждёт подтверждения.

- команда · `type=command` · Claude Code, Codex, Cursor · ★ 41823
- Автор: Seth Hobson
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/wshobson/agents/tree/HEAD/plugins/tdd-workflows/commands/tdd-cycle.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/commands/tdd-cycle

## Что делает

\`tdd-cycle` организует TDD-цикл для выбранной функции или модуля. Сначала команда проверяет предыдущую сессию, создаёт `.tdd-cycle/state.json`, разбирает аргументы и сохраняет результаты шагов в файлы. В первой фазе субагент анализирует требования и проектирует архитектуру тестов, включая фикстуры, моки и порядок запуска.

После этого команда останавливается на контрольной точке и показывает документы для проверки. При одобрении она переходит к RED-фазе и пишет падающие модульные тесты по соглашениям проекта, с проверками крайних случаев и ошибок. Без явного одобрения первая фаза дальше не продолжится.

Режим по умолчанию — `suite`, целевое покрытие строк — `80`; их можно изменить флагами `--incremental`, `--suite` и `--coverage`. Команда доступна для Claude Code, Codex и Cursor, а установка через маркетплейс описана для Claude Code.

## Установка

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

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

2. **Вручную: положить файлы**
- Файл: `.claude/commands/tdd-cycle.md` — Вызов — /tdd-cycle. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/tdd-cycle.md` — Вызов — /prompts:tdd-cycle. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/tdd-cycle.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/tdd-cycle.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/wshobson/agents/tree/HEAD/plugins/tdd-workflows/commands/tdd-cycle.md

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

## Примеры запросов агенту
- Запусти `/tdd-cycle <feature or module to implement>` для новой функции.
- Проведи `/tdd-cycle <feature or module to implement> --incremental` по шагам.
- Задай для `/tdd-cycle <feature or module to implement> --coverage 80` целевое покрытие.

## Похожие
- [tdd-gate](https://affpapa.org/nevibecode/hooks/tdd-gate.md) — хук · 192 установки
- [rtk-tdd](https://affpapa.org/nevibecode/skills/rtk-tdd.md) — скилл · 2100 установок
- [tdd-rust](https://affpapa.org/nevibecode/skills/tdd-rust.md) — скилл · 1400 установок
- [review-pr](https://affpapa.org/nevibecode/commands/review-pr.md) — команда · ★ 44770
- [modernize-uplift](https://affpapa.org/nevibecode/commands/modernize-uplift.md) — команда · ★ 44770
- [docs-maintenance](https://affpapa.org/nevibecode/commands/docs-maintenance.md) — команда · 1146 установок
- [nextjs-performance-audit](https://affpapa.org/nevibecode/commands/nextjs-performance-audit.md) — команда · 694 установки
- [web-design-reviewer](https://affpapa.org/nevibecode/commands/web-design-reviewer.md) — команда · 605 установок

Из того же набора: [wshobson/agents](https://affpapa.org/nevibecode/by/wshobson/agents.md) — 432 карточки

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

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