🧪 Kent Beck

import anthropic

client = anthropic.Anthropic()

def tdd_step_red_to_green(test_code: str, module_path: str) -> str:
    """
    Beck-паттерн: агенту показывают ТОЛЬКО тест и просьбу
    заставить его пройти. Тест — неприкосновенная спецификация.
    """
    prompt = f"""Вот failing-тест, который я написал вручную (Red-фаза TDD):

{test_code}

Задача: реализуй код в {module_path}, чтобы тест стал зелёным.

СТРОГИЕ ПРАВИЛА:
1. Файл теста НЕ трогать. Ни один assert, ни одна строка.
2. Если тест кажется некорректным или недостижимым —
   остановись и опиши проблему, НЕ переписывай тест сам.
3. Реализация должна быть минимальной — ровно тем, что
   нужно для прохождения теста (Green-фаза, не более).
4. Не добавляй новых тестов на этом шаге — только реализацию.

Ответ: только код реализации."""

    message = client.messages.create(
        model="claude-sonnet-5",
        max_tokens=2048,
        messages=[{"role": "user", "content": prompt}]
    )
    return message.content[0].text


def verify_test_file_untouched(test_file: str, original_hash: str) -> bool:
    """После Green-фазы — обязательная проверка, что агент
    не подправил тест, чтобы он 'случайно' стал зелёным."""
    import hashlib
    with open(test_file, "rb") as f:
        current_hash = hashlib.sha256(f.read()).hexdigest()
    return current_hash == original_hash
    # False здесь = агент трогал тест. Это стоп-сигнал, не варнинг.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "python3 .claude/hooks/guard_tests.py"
          }
        ]
      }
    ]
  }
}

#!/usr/bin/env python3
"""
Beck-паттерн: тесты — контракт, который агент не может
менять без явного разрешения человека в текущем запросе.
Блокирует Edit/Write/MultiEdit по *_test.py, test_*.py,
tests/**, *.spec.ts — если это не явно санкционированная задача.
"""
import json
import re
import sys

TEST_PATTERNS = [
    r"(^|/)test_[^/]+\.py$",
    r"(^|/)[^/]+_test\.py$",
    r"(^|/)tests/",
    r"\.spec\.(ts|tsx|js)$",
    r"(^|/)__tests__/",
]

# Флаг явного разрешения — задаётся человеком в переменной окружения
# перед запуском сессии, где правка тестов действительно нужна
ALLOW_TEST_EDITS = "CC_ALLOW_TEST_EDITS"

def is_test_path(path: str) -> bool:
    return any(re.search(p, path) for p in TEST_PATTERNS)

def main():
    payload = json.load(sys.stdin)
    tool_input = payload.get("tool_input", {})
    file_path = tool_input.get("file_path", "")

    import os
    if os.environ.get(ALLOW_TEST_EDITS) == "1":
        sys.exit(0)  # человек явно разрешил на эту сессию

    if is_test_path(file_path):
        print(
            f"BLOCKED: попытка изменить тест-файл {file_path}. "
            f"Тесты — контракт с человеком, агент не правит их "
            f"без явной команды. Если правка теста действительно "
            f"нужна — задай {ALLOW_TEST_EDITS}=1 и повтори запрос.",
            file=sys.stderr,
        )
        sys.exit(2)  # exit code 2 = Claude Code блокирует операцию

    sys.exit(0)

if __name__ == "__main__":
    main()

# Beck-привычка: как только возник вопрос — сформулируй и спроси,
# не додумывай сам "в фоне" пока пишешь код дальше

# Плохо: "наверное, этот метод потокобезопасен, продолжу как есть"
# (додумывание без проверки — источник багов, обнаруженных поздно)

# Хорошо: спросить в моменте, не откладывая
claude -p "Метод OrderQueue.push() в src/queue.py — он потокобезопасен?
Если нет — что нужно добавить, чтобы стал, без лишних абстракций?"

# Хорошо: сомнение в архитектурном решении — тоже сразу
claude -p "Я собираюсь завести отдельный сервис для email-уведомлений.
Прежде чем начну: есть ли в этой кодовой базе уже похожий паттерн,
который стоит переиспользовать вместо нового сервиса?"