Verify

Слой верификации для Claude Code. Читает вашу спецификацию, запускает браузерный агент против локального dev-сервера для каждого критерия приёмки и возвращает результат pass/fail со скриншотами — до пуша. Без CI. Без инфраструктуры.

Установка

Предварительные требования

• Claude Code с OAuth-авторизацией (claude login)
• Настроенный Playwright MCP (см. ниже)

Использование

Скиллы Claude Code

# Однократная настройка — автоопределяет dev-сервер, индексирует приложение
/verify-setup

# Запуск верификации по спецификации
/verify

/verify-setup автоматически определяет порт dev-сервера, индексирует маршруты и селекторы из кодовой базы, записывает .verify/config.json и .verify/app.json. Установка npm не требуется.

/verify запрашивает спецификацию, проверяет её на неоднозначности, затем верифицирует каждый критерий приёмки с помощью Playwright MCP. Результаты отображаются inline со скриншотами.

Настройка Playwright MCP

claude mcp add playwright -- npx @playwright/mcp@latest --storage-state .verify/auth.json --isolated

Перезапустите Claude Code после добавления MCP-сервера.

Отладка ошибок

После запуска все данные хранятся в .verify/runs/<run_id>/:

# Просмотр сырых данных для конкретного критерия приёмки
ls .verify/runs/*/evidence/<ac_id>/

Директория evidence каждого критерия приёмки содержит:

• result.json — вердикт, уверенность, обоснование, выполненные шаги
• *.png — скриншоты, сделанные в ходе выполнения

Архитектура

/verify работает как скилл Claude Code, используя Playwright MCP для взаимодействия с браузером:

1. Интерпретатор спецификации — проверяет критерии приёмки на неоднозначности, задаёт уточняющие вопросы
2. Экстрактор критериев приёмки — разбирает спецификацию на конкретные, проверяемые критерии с использованием seed-данных и известных маршрутов
3. Браузерная верификация — навигирует по приложению через Playwright MCP, проверяет каждый критерий, собирает скриншоты
4. Отчёт — записывает result.json для каждого критерия и общий verdicts.json

Настройка для разработки

См. CLAUDE.md — полный список команд, соглашений и инструкций по тестированию.