К основному содержанию
команда CX Codex

tdd-red — команда для Claude Code: падающие тесты до кода

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

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add wshobson/agents
/plugin install tdd-workflows@claude-code-workflows
Открыть на GitHub

Что делает tdd-red

Команда tdd-red запускает фазу red: агент генерирует тесты для указанной фичи или компонента и намеренно не пишет продакшн-код. Все тесты должны упасть при запуске. Если хоть один проходит, команда просит разобраться и поправить — значит, тест проверяет не то поведение.

Внутри — вызов Task с subagent_type: "general-purpose", то есть работают только агенты из этого плагина. Промпт задаёт структуру Arrange-Act-Assert, имена вида should_X_when_Y, изолированные фикстуры без взаимных зависимостей. Покрытие разбито на категории: unit, integration, contract и property. Фреймворк подбирается под проект — Jest, pytest, JUnit, Go или RSpec.

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

Какие задачи решает

  • зафиксировать поведение фичи тестами до реализации
  • получить падающие тесты с осмысленными сообщениями об ошибке
  • разложить покрытие по unit, integration, contract и property
  • проверить граничные случаи: пустые значения, лимиты, Unicode
  • начать цикл TDD с чистого red-шага

Примеры запросов агенту

  • /tdd-red корзина: добавление и удаление товара
  • /tdd-red парсер CSV с пустыми и битыми строками
  • /tdd-red эндпоинт авторизации по токену

Как установить tdd-red

1Через маркетплейс плагинов

/plugin marketplace add wshobson/agents
/plugin install tdd-workflows@claude-code-workflows

2Вручную: положить файлы

.claude/commands/tdd-red.md

Вызов — /tdd-red. Для всех проектов — ~/.claude/commands/

Вопросы о tdd-red

Как установить tdd-red в Claude?

Добавьте маркетплейс: /plugin marketplace add wshobson/agents, затем поставьте плагин: /plugin install tdd-workflows@claude-code-workflows. Файл команды окажется в .claude/commands/tdd-red.md.

Что делает tdd-red?

Генерирует падающие тесты для указанной фичи или компонента и не пишет продакшн-код. Это фаза red в цикле TDD.

Почему тесты должны падать?

Падение подтверждает, что тест проверяет ещё не реализованное поведение. Если тест сразу проходит, команда советует разобраться и поправить его.

Исходный текст

tdd-red.md · MIT
---
description: "Write comprehensive failing tests following TDD red phase principles"
argument-hint: "<feature or component to write tests for>"
---

# TDD Red Phase

## CRITICAL BEHAVIORAL RULES

You MUST follow these rules exactly. Violating any of them is a failure.

1. **Write tests only — no production code.** Do NOT implement any production code during this phase.
2. **Verify tests fail.** All generated tests MUST fail when run. If any test passes, investigate and fix.
3. **Halt on error.** If test generation fails (syntax errors, import issues), STOP and present the error to the user.
4. **Use only local agents.** All `subagent_type` references use agents bundled with this plugin or `general-purpose`. No cross-plugin dependencies.
5. **Never enter plan mode autonomously.** Do NOT use EnterPlanMode. Execute directly.

## Test Generation Process

Use the Task tool to generate failing tests:

```
Task:
  subagent_type: "general-purpose"
  description: "Generate comprehensive failing tests for TDD red phase"
  prompt: |
    You are a test automation expert specializing in TDD red phase test generation.

    Generate comprehensive FAILING tests for: $ARGUMENTS

    ## Core Requirements

    1. **Test Structure**
       - Framework-appropriate setup (Jest/pytest/JUnit/Go/RSpec — match project conventions)
       - Arrange-Act-Assert pattern
       - should_X_when_Y naming convention
       - Isolated fixtures with no interdependencies

    2. **Behavior Coverage**
       - Happy path scenarios
       - Edge cases (empty, null, boundary values)
       - Error handling and exceptions
       - Concurrent access (if applicable)

    3. **Failure Verification**
       - Tests MUST fail when run
       - Failures for RIGHT reasons (not syntax/import errors)
       - Meaningful diagnostic error messages
       - No cascading failures

    4. **Test Categories**
       - Unit: Isolated component behavior
       - Integration: Component interaction
       - Contract: API/interface contracts
       - Property: Mathematical invariants (if applicable)

    ## Quality Checklist

    - Readable test names documenting intent
    - One behavior per test
    - No implementation leakage
    - Meaningful test data (not 'foo'/'bar')
    - Tests serve as living documentation

    ## Anti-Patterns to Avoid

    - Tests passing immediately
    - Testing implementation vs behavior
    - Complex setup code
    - Multiple responsibilities per test
    - Brittle tests tied to specifics

    ## Output Requirements

    - Complete test files with imports
    - Documentation of test purpose
    - Commands to run and verify failures
    - Metrics: test count, coverage areas
    - Next steps for green phase
```

## Validation

After generation:

1. Run tests — confirm they fail
2. Verify helpful failure messages
3. Check test independence
4. Ensure comprehensive coverage

## Edge Case Categories

- **Null/Empty**: undefined, null, empty string/array/object
- **Boundaries**: min/max values, single element, capacity limits
- **Special Cases**: Unicode, whitespace, special characters
- **State**: Invalid transitions, concurrent modifications
- **Errors**: Network failures, timeouts, permissions

© Seth Hobson · MIT · wshobson/agents

Похожие слэш-команды

Всё по теме «Тесты и QA» →
tdd-guide Alireza Rezvani Автоматизирует цикл «красный-зелёный-рефакторинг», генерирует тесты и разбирает пробелы в покрытии. Пригодится при разработке по TDD на Jest, Pytest, JUnit или Vitest. 1 017установок unit-testing-framework aj-geddes Скилл задаёт агенту правила написания юнит-тестов: структура Arrange-Act-Assert, моки, граничные случаи. Пригодится, когда нужно покрыть тестами новую функцию или класс. CX Codex +1 593установок python-tdd-with-uv spencerpauly Ведёт агента по циклу red-green-refactor в Python и настраивает проект на uv. Пригодится, когда пишете тесты до кода. CX Codex +1 409установок django-tdd affaan-m Скилл настраивает TDD-разработку в Django и DRF с помощью pytest-django и factory_boy. Помогает писать тесты для моделей, фикстуры и проверять API. CX Codex +1 4 700установок red-green-proof Alireza Rezvani Заставляет написать тест, который падает на текущем коде, а после фикса — снова убрать фикс и убедиться, что тест краснеет. Для отладки и разбора инцидентов. 3установок tdd backnotprop Скилл заставляет агента сначала написать падающий тест на баг, а потом править код. Включается только когда тест дешёвый и очевидный. CX Codex +1 5 100установок

Из того же набора342

Весь набор →
find Ищет референсы в галерее Meigen по ключевым словам и сразу показывает картинки с короткими выдержками промптов. CX Codex 210установок social-evidence-research Собирает проверяемый отчёт о обсуждении продукта или темы в соцплатформах. Пригодится для поиска, сравнения и аудита социальных данных. CX Codex 201установок design-review Проверяет готовый интерфейс на проблемы вёрстки, юзабилити и кода, а потом складывает отчёт с рекомендациями в файл. CX Codex ★ 41 729звёзд репо standup-notes Собирает заметки к асинхронному стендапу из коммитов, тикетов Jira и заметок Obsidian. Пригодится, когда команда разбросана по часовым поясам. CX Codex ★ 41 729звёзд репо rust-project Слэш-команда разворачивает структуру Rust-проекта: бинарник, библиотеку, воркспейс или веб-API на Axum. Пригодится, когда нужен старт без ручной раскладки модулей. CX Codex ★ 41 729звёзд репо financial-projections Строит финансовую модель стартапа: выручка по когортам, расходы, найм, кэшфлоу и три сценария. Пригодится перед раундом или советом директоров. CX Codex ★ 41 729звёзд репо review Субагент проверяет изменения в коде по трём уровням важности, сам закрывает мелочи и останавливает конвейер на критичных находках. CX Codex ★ 41 729звёзд репо orchestrate Читает активную стори, задаёт уточняющие вопросы по одному и выдаёт однозначную спеку в orchestrator-output.md. CX Codex ★ 41 729звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой