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

iterative-development — скилл для Claude Code

Скилл iterative-development для Claude Code запускает тесты после каждого ответа и возвращает ошибки модели, продолжая TDD-цикл до успешных проверок.

MIT 286 установок ★ 713 обновлён 2026-10-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add alinaqi/maggy --skill iterative-development -a claude-code
Открыть на GitHub

Что делает iterative-development

Stop hook в Claude Code срабатывает перед завершением ответа. Если скрипт вернёт exit код 2, его stderr попадёт в следующее сообщение модели, и диалог продолжится автоматически. Это создаёт настоящий feedback loop: Claude пишет код, тесты валятся, ошибка показывается моделью, Claude видит, что чинить.

Скилл включает готовые скрипты для Node.js и Python. После каждого ответа проверяются тесты, линтер (если npm run lint или ruff check в проекте) и типы (TypeScript или mypy). Счётчик итераций предотвращает бесконечные циклы — по умолчанию 25 попыток. Если тестов нет, скрипт спокойно выходит и не трогает Claude.

Настраивается через .claude/settings.json: указываешь путь к скрипту, таймаут, и Stop hook сам запускает проверку. Позиция: без npm или pytest в PATH скрипт завалится и покажет ошибку в stderr — убедись, что инструменты установлены перед первым запуском.

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

  • Создать TDD-петлю без внешних плагинов и макросов
  • Автоматически запускать тесты после каждого ответа Claude
  • Скармливать ошибки модели обратно, не прерывая диалог
  • Проверять линтер и типы прямо в цикле разработки
  • Остановить бесконечный loop, если тесты не зеленеют

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

  • Попроси Claude: «Напиши функцию со 100% тестовым покрытием». Stop hook сам запустит тесты, и если что сломается, Claude это увидит в следующем сообщении.
  • После редактора: «Рефакторь компонент React, сохраняя логику». Каждый ответ будет пройден через npm test и npm run lint перед отправкой.
  • В Python-проекте: «Добавь валидацию входных данных». Stop hook вызовет pytest и mypy, и если type check не пройдёт, Claude сразу узнаёт об ошибке.

Как установить iterative-development

1Через Skills CLI (Vercel)

npx skills add alinaqi/maggy --skill iterative-development -a claude-code

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

~/.claude/skills/iterative-development/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/iterative-development/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об iterative-development

Как установить iterative-development в Claude Code?

Запусти npx skills add alinaqi/maggy --skill iterative-development -a claude-code, затем открой ~/.claude/skills/iterative-development/SKILL.md и скопируй конфигурацию Stop hook в .claude/settings.json проекта.

Что делает iterative-development?

Автоматизирует TDD-петли через Stop hooks Claude Code. После каждого ответа модели запускаются тесты, линтер и проверка типов. Если что-то падает, ошибка показывается Claude, и модель тут же пытается исправить код.

Что нужно, чтобы скилл работал?

Для Node.js: npm, тесты в одном из форматов *.test.*, *.spec.* или test_*. Для Python: pytest и опционально ruff, mypy. Без инструментов сборки скрипт не будет работать — убедись, что они в PATH.

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

SKILL.md · MIT
---
name: iterative-development
description: TDD iteration loops using Claude Code Stop hooks - runs tests after each response, feeds failures back automatically
when-to-use: When setting up or configuring TDD loops via Stop hooks
user-invocable: false
effort: medium
---

# Iterative Development Skill (Stop Hook TDD Loops)


**Concept:** Claude Code's Stop hook fires right before Claude finishes a response. Exit code 2 feeds stderr back to the model and continues the conversation. This creates a real TDD loop without any plugins.

---

## How It Actually Works

Claude Code has a **Stop hook** that runs when Claude is about to conclude its response. If the hook script exits with code 2, its stderr is shown to the model and the conversation continues automatically.

```
┌─────────────────────────────────────────────────────────────┐
│  1. User asks Claude to implement a feature                 │
├─────────────────────────────────────────────────────────────┤
│  2. Claude writes tests + implementation                    │
├─────────────────────────────────────────────────────────────┤
│  3. Claude finishes its response                            │
├─────────────────────────────────────────────────────────────┤
│  4. Stop hook runs: executes tests, lint, typecheck         │
├─────────────────────────────────────────────────────────────┤
│  5a. All pass (exit 0) → Claude stops, work is done         │
│  5b. Failures (exit 2) → stderr fed back to Claude          │
├─────────────────────────────────────────────────────────────┤
│  6. Claude sees failures, fixes code, response ends         │
├─────────────────────────────────────────────────────────────┤
│  7. Stop hook runs again → repeat until green or max tries  │
└─────────────────────────────────────────────────────────────┘
```

**Key insight:** No fake plugins, no `/ralph-loop` command. The hook is real Claude Code infrastructure that runs automatically.

---

## Setup: Stop Hook Configuration

Add this to your project's `.claude/settings.json`:

```json
{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "scripts/tdd-loop-check.sh",
            "timeout": 60,
            "statusMessage": "Running tests..."
          }
        ]
      }
    ]
  }
}
```

### The TDD Loop Check Script

Create `scripts/tdd-loop-check.sh` in your project:

```bash
#!/bin/bash
# TDD Loop Check - runs after each Claude response
# Exit 0 = all good, Claude stops
# Exit 2 = failures, stderr fed back to Claude to fix

MAX_ITERATIONS=25
ITERATION_FILE=".claude/.tdd-iteration-count"

# Track iteration count
if [ -f "$ITERATION_FILE" ]; then
    count=$(cat "$ITERATION_FILE")
    count=$((count + 1))
else
    count=1
fi
echo "$count" > "$ITERATION_FILE"

# Safety: stop after max iterations
if [ "$count" -ge "$MAX_ITERATIONS" ]; then
    rm -f "$ITERATION_FILE"
    echo "Max iterations ($MAX_ITERATIONS) reached. Stopping loop." >&2
    exit 0
fi

# Skip if no test files exist yet
if ! find . -name "*.test.*" -o -name "*.spec.*" -o -name "test_*" 2>/dev/null | grep -q .; then
    rm -f "$ITERATION_FILE"
    exit 0
fi

# Run tests
TEST_OUTPUT=$(npm test 2>&1) || {
    echo "ITERATION $count/$MAX_ITERATIONS - Tests failing:" >&2
    echo "$TEST_OUTPUT" | tail -30 >&2
    echo "" >&2
    echo "Fix the failing tests and try again." >&2
    exit 2
}

# Run lint (if configured)
if [ -f "package.json" ] && grep -q '"lint"' package.json; then
    LINT_OUTPUT=$(npm run lint 2>&1) || {
        echo "ITERATION $count/$MAX_ITERATIONS - Lint errors:" >&2
        echo "$LINT_OUTPUT" | tail -20 >&2
        echo "" >&2
        echo "Fix lint errors and try again." >&2
        exit 2
    }
fi

# Run typecheck (if configured)
if [ -f "tsconfig.json" ]; then
    TYPE_OUTPUT=$(npx tsc --noEmit 2>&1) || {
        echo "ITERATION $count/$MAX_ITERATIONS - Type errors:" >&2
        echo "$TYPE_OUTPUT" | tail -20 >&2
        echo "" >&2
        echo "Fix type errors and try again." >&2
        exit 2
    }
fi

# All green - reset counter and let Claude stop
rm -f "$ITERATION_FILE"
exit 0
```

### Python Variant

```bash
#!/bin/bash
# Python TDD Loop Check

MAX_ITERATIONS=25
ITERATION_FILE=".claude/.tdd-iteration-count"

if [ -f "$ITERATION_FILE" ]; then
    count=$(cat "$ITERATION_FILE")
    count=$((count + 1))
else
    count=1
fi
echo "$count" > "$ITERATION_FILE"

if [ "$count" -ge "$MAX_ITERATIONS" ]; then
    rm -f "$ITERATION_FILE"
    echo "Max iterations ($MAX_ITERATIONS) reached." >&2
    exit 0
fi

if ! find . -name "test_*" -o -name "*_test.py" 2>/dev/null | grep -q .; then
    rm -f "$ITERATION_FILE"
    exit 0
fi

TEST_OUTPUT=$(pytest -v 2>&1) || {
    echo "ITERATION $count/$MAX_ITERATIONS - Tests failing:" >&2
    echo "$TEST_OUTPUT" | tail -30 >&2
    exit 2
}

if command -v ruff &>/dev/null; then
    LINT_OUTPUT=$(ruff check . 2>&1) || {
        echo "ITERATION $count/$MAX_ITERATIONS - Lint errors:" >&2
        echo "$LINT_OUTPUT" | tail -20 >&2
        exit 2
    }
fi

if command -v mypy &>/dev/null; then
    TYPE_OUTPUT=$(mypy . 2>&1) || {
        echo "ITERATION $count/$MAX_ITERATIONS - Type errors:" >&2
        echo "$TYPE_OUTPUT" | tail -20 >&2
        exit 2
    }
fi

rm -f "$ITERATION_FILE"
exit 0
```

---

## Additional Hooks for Quality Enforcement

### PreToolUse Hook: Lint Before File Writes

Runs a linter before any Write/Edit lands:

```json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "scripts/pre-write-lint.sh",
            "timeout": 10,
            "statusMessage": "Checking code quality..."
          }
        ]
      }
    ]
  }
}
```

### SessionStart Hook: Auto-Inject Context

Runs at session start to inject project info:

```json
{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo 'TDD loop active. Tests run automatically after each response. Fix failures to continue.'",
            "statusMessage": "Loading project context..."
          }
        ]
      }
    ]
  }
}
```

---

## Core Philosophy

```
┌─────────────────────────────────────────────────────────────┐
│  ITERATION > PERFECTION                                     │
│  ─────────────────────────────────────────────────────────  │
│  Don't aim for perfect on first try.                        │
│  Let the loop refine the work. Each iteration builds on     │
│  previous attempts visible in files and git history.        │
├─────────────────────────────────────────────────────────────┤
│  FAILURES ARE DATA                                          │
│  ─────────────────────────────────────────────────────────  │
│  Failed tests, lint errors, type mismatches are signals.    │
│  The Stop hook feeds them directly to Claude as context.    │
├─────────────────────────────────────────────────────────────┤
│  CLEAR COMPLETION CRITERIA                                  │
│  ─────────────────────────────────────────────────────────  │
│  The hook defines "done": tests pass, lint clean, types ok. │
│  No ambiguity about when to stop.                           │
└─────────────────────────────────────────────────────────────┘
```

---

## Error Classification

Not all failures should loop. The hook script should distinguish:

| Type | Examples | Action |
|------|----------|--------|
| **Code Error** | Logic bug, wrong assertion, type mismatch | Exit 2 → loop continues |
| **Access Error** | Missing API key, DB connection refused | Exit 0 → stop, report to user |
| **Environment Error** | Missing package, wrong runtime version | Exit 0 → stop, report to user |

The sample scripts above handle this — they only exit 2 for test/lint/type failures, not for environment issues.

---

## When to Use TDD Loops

### Good For
| Use Case | Why |
|----------|-----|
| Feature development | Tests provide clear pass/fail signal |
| Bug fixes | Write failing test, fix, loop until green |
| Refactoring | Existing tests catch regressions |
| API development | Each endpoint independently testable |

### Not Good For
| Use Case | Why |
|----------|-----|
| UI/UX work | Requires human judgment |
| One-shot operations | No iteration needed |
| Unclear requirements | No clear "done" criteria |
| Subjective design | No objective success metric |

---

## Disabling the Loop

To temporarily disable the TDD loop for a session:

1. Remove or rename the Stop hook in `.claude/settings.json`
2. Or set `MAX_ITERATIONS=1` in the script
3. Or delete `scripts/tdd-loop-check.sh`

The hook only fires if the script exists and is configured.

---

## Gitignore Additions

```gitignore
# TDD loop state
.claude/.tdd-iteration-count
```

© alinaqi · MIT · alinaqi/maggy

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
iterative-loop proffesor-for-testing Скилл iterative-loop запускает циклы разработки «сборка-тест-исправление» до выполнения критериев готовности. Помогает доводить фичи по TDD и устранять баги без ручного контроля каждого шага. CX Codex +1 118установок test-driven-development Jesse Vincent Скилл test-driven-development для Claude Code задаёт цикл TDD: тест, проверка падения, минимальный код и рефакторинг. Цикл охватывает новые функции, исправления и изменения поведения. CX Codex +1 259 292установок development-team mvschwarz Скилл development-team организует разработку и тестирование внутри пода. Помогает агенту доводить задачу до готового кода с проверкой через открытые интерфейсы. CX Codex +1 ★ 8 928звёзд репо fix-tests NeoLabHQ Скилл fix-tests для Claude Code и других платформ восстанавливает упавшие тесты после рефакторинга и изменений бизнес-логики, запуская параллельных агентов для каждого проваленного файла. CX Codex +1 1 300установок behavior-driven-development FradSer Скилл behavior-driven-development задаёт BDD-процесс для фич, исправлений и тестов: сначала сценарий и падающий тест, затем код. CX Codex +1 151установок qe-iterative-loop proffesor-for-testing Скилл qe-iterative-loop для Claude Code запускает автономные циклы red-green-refactor: агент чинит падающие тесты, достигает целевого покрытия и проходит quality gates. Циклы устраняют падения тестов и повышают покрытие. CX Codex +1 126установок

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

Весь набор →
existing-repo Скилл existing-repo для быстрого разбора существующего репозитория: определит структуру проекта, обнаружит уже настроенные инструменты и настроит недостающие guardrails без ломки. CX Codex +1 292установок aws-aurora Скилл aws-aurora подсказывает архитектуру и код для Amazon Aurora: настройку RDS Proxy, работу через Data API и пул соединений для AWS Lambda. CX Codex +1 288установок reddit-ads Помогает автоматизировать работу с Reddit Ads API: управлять кампаниями, настраивать группы объявлений и авторизацию через OAuth 2.0. CX Codex +1 287установок credentials Скилл credentials ищет API-ключи в централизованном файле и сопоставляет их с переменными окружения. Пригодится при настройке проекта, которому нужны ключи сервисов. CX Codex +1 287установок code-graph Скилл code-graph индексирует весь кодовый проект как граф символов и связей. Вместо чтения файлов подряд запрашиваешь у графа сигнатуры функций, цепи вызовов и зону влияния изменений за миллисекунды. CX Codex +1 285установок medusa Скилл помогает собирать headless-магазины на Medusa: модули, API-маршруты, workflow и админский интерфейс. Подходит для backend-задач в e-commerce. CX Codex +1 285установок gemini-review Скилл gemini-review подключает Gemini CLI для ревью кода, проверки безопасности и анализа больших репозиториев. Подходит для локальной работы и CI/CD. CX Codex +1 283установок ticket-craft Скилл ticket-craft форматирует задачи в Jira, Linear или Asana так, чтобы ИИ-агент выполнял их автономно без наводящих вопросов. CX Codex +1 283установок

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

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