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

tdd-green — команда для Claude Code: что делает и как установить

Реализует минимальный код для прохождения упавших тестов на зелёной фазе TDD. Защищает от преждевременной оптимизации и лишних функций.

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

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

Команда запускает подчинённого агента general-purpose, чтобы закрыть упавшие тесты минимально возможным кодом. Она принимает на вход путь к тестовым файлам или описание ошибок. При реализации агент действует по правилам TDD: подставляет фиктивные значения либо выбирает самое простое очевидное решение.

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

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

  • написать минимальный код под упавшие тесты
  • предотвратить преждевременную оптимизацию логики
  • зафиксировать технический долг перед рефакторингом

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

  • /tdd-green tests/auth.test.ts
  • /tdd-green "исправь падение теста calculateTotal при нулевом балансе"
  • /tdd-green src/orders/order.spec.ts

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

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

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

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

.claude/commands/tdd-green.md

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

Вопросы о tdd-green

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

Сначала подключите репозиторий командой /plugin marketplace add wshobson/agents, затем выполните установку: /plugin install tdd-workflows@claude-code-workflows.

Что делает команда tdd-green?

Она заставляет агента писать ровно столько кода, сколько нужно для прохождения красных тестов. Все архитектурные правки и оптимизации откладываются на следующий этап.

Что происходит при повторном падении тестов?

Команда немедленно останавливает выполнение и выводит ошибку. Агент не пытается угадывать решение или вносить массовые правки без участия разработчика.

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

tdd-green.md · MIT
---
description: "Implement minimal code to make failing tests pass in TDD green phase"
argument-hint: "<description of failing tests or test file paths>"
---

# TDD Green Phase

## CRITICAL BEHAVIORAL RULES

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

1. **Implement only what tests require.** Do NOT add features, optimizations, or error handling beyond what failing tests demand.
2. **Run tests after each change.** Verify progress incrementally — do not batch implement and hope it works.
3. **Halt on failure.** If tests remain red after implementation or existing tests break, 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.

## Implementation Process

Use the Task tool to implement minimal passing code:

```
Task:
  subagent_type: "general-purpose"
  description: "Implement minimal code to pass failing tests"
  prompt: |
    You are a test automation expert implementing the GREEN phase of TDD.

    Implement MINIMAL code to make these failing tests pass: $ARGUMENTS

    Follow TDD green phase principles:

    1. **Pre-Implementation Analysis**
       - Review all failing tests and their error messages
       - Identify the simplest path to make tests pass
       - Map test requirements to minimal implementation needs
       - Avoid premature optimization or over-engineering
       - Focus only on making tests green, not perfect code

    2. **Implementation Strategy**
       - **Fake It**: Return hard-coded values when appropriate
       - **Obvious Implementation**: When solution is trivial and clear
       - **Triangulation**: Generalize only when multiple tests require it
       - Start with the simplest test and work incrementally
       - One test at a time — don't try to pass all at once

    3. **Code Structure Guidelines**
       - Write the minimal code that could possibly work
       - Avoid adding functionality not required by tests
       - Use simple data structures initially
       - Defer architectural decisions until refactor phase
       - Keep methods/functions small and focused
       - Don't add error handling unless tests require it

    4. **Progressive Implementation**
       - Make first test pass with simplest possible code
       - Run tests after each change to verify progress
       - Add just enough code for next failing test
       - Resist urge to implement beyond test requirements
       - Keep track of technical debt for refactor phase
       - Document assumptions and shortcuts taken

    5. **Success Criteria**
       - All tests pass (green)
       - No extra functionality beyond test requirements
       - Code is readable even if not optimal
       - No broken existing functionality
       - Clear path to refactoring identified

    Output should include:
    - Complete implementation code
    - Test execution results showing all green
    - List of shortcuts taken for later refactoring
    - Technical debt documentation
    - Readiness assessment for refactor phase
```

## Post-Implementation Checks

After implementation:

1. Run full test suite to confirm all tests pass
2. Verify no existing tests were broken
3. Document areas needing refactoring
4. Check implementation is truly minimal
5. Record implementation time for metrics

## Recovery Process

If tests still fail:

- Review test requirements carefully
- Check for misunderstood assertions
- Add minimal code to address specific failures
- Avoid the temptation to rewrite from scratch
- Consider if tests themselves need adjustment

## Integration Points

- Follows from tdd-red test creation
- Prepares for tdd-refactor improvements
- Updates test coverage metrics
- Triggers CI/CD pipeline verification
- Documents technical debt for tracking

© Seth Hobson · MIT · wshobson/agents

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

Все слэш-команды по теме «Тесты и QA» →
review-pr официальный Anthropic Команда запускает специализированных агентов для проверки изменений в PR: от тестов и обработки ошибок до типов и комментариев. ★ 44 770звёзд репо modernize-uplift официальный Anthropic Обновляет проект на новую версию рантайма в том же стеке без переписывания логики. Проверяет поведение через параллельный прогон тестов. ★ 44 770звёзд репо docs-maintenance davila7 Команда проверяет документацию, ссылки, структуру и стиль, а затем помогает подготовить обновления. Пригодится для регулярного аудита Markdown-файлов. 1 146установок nextjs-performance-audit davila7 Команда проверяет производительность проекта Next.js по Lighthouse, размеру сборки и работе приложения. Пригодится, когда нужно найти узкие места и получить рекомендации по оптимизации. 694установок web-design-reviewer davila7 Открывает сайт в браузере, ищет проблемы вёрстки, адаптива и доступности и правит их прямо в исходниках. Пригодится, когда нужно проверить UI без ручного обхода страниц. 605установок pr-review davila7 Команда проверяет pull request с шести сторон: от продукта и качества кода до безопасности, DevOps и интерфейса. Она также требует сразу вносить найденные улучшения. 562установок

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

Весь набор →
standup-notes Собирает заметки к асинхронному стендапу из коммитов, тикетов Jira и заметок Obsidian. Пригодится, когда команда разбросана по часовым поясам. CX Codex ★ 41 823звёзд репо issue Разбирает задачу из GitHub от триажа и поиска первопричины до тестов и готового пулл-реквеста. Помогает навести порядок при исправлении дефектов. CX Codex ★ 41 823звёзд репо tdd-refactor Команда проводит рефакторинг по TDD, сохраняя тесты зелёными. Она нужна для поэтапного улучшения структуры без изменения поведения. CX Codex ★ 41 823звёзд репо tdd-red Слэш-команда пишет только тесты, которые обязаны падать, и не трогает рабочий код. Первый шаг TDD, когда нужно зафиксировать поведение до реализации. CX Codex ★ 41 823звёзд репо tdd-cycle Команда проводит разработку по циклу red-green-refactor: от требований и архитектуры тестов до первых падающих тестов. Между фазами она ждёт подтверждения. CX Codex ★ 41 823звёзд репо rust-project Слэш-команда разворачивает структуру Rust-проекта: бинарник, библиотеку, воркспейс или веб-API на Axum. Пригодится, когда нужен старт без ручной раскладки модулей. CX Codex ★ 41 823звёзд репо market-opportunity Слэш-команда проводит интерактивный анализ рынка: считает TAM, SAM и SOM и собирает отчёт в markdown. Пригодится на этапе оценки стартапа. CX Codex ★ 41 823звёзд репо financial-projections Строит финансовую модель стартапа: выручка по когортам, расходы, найм, кэшфлоу и три сценария. Пригодится перед раундом или советом директоров. CX Codex ★ 41 823звёзд репо

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

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