# phase-validator

Субагент phase-validator сверяет отчёт о завершении этапа с условиями выхода и выносит вердикт pass или fail. Помогает контролировать автоматические конвейеры разработки.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 937 у репозитория
- Автор: SethGammon
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/SethGammon/Citadel/tree/HEAD/agents/phase-validator.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/phase-validator

## Что делает

Субагент работает механическим аудитором передачи задач между этапами в сценариях Archon и Fleet. Он принимает текст HANDOFF от предыдущего исполнителя и сверяет его со списком условий выхода: наличием созданных файлов, отчётами о прохождении проверок или конкретными числовыми метриками. По итогам агент возвращает структурированный JSON с вердиктом `pass` или `fail` и списком причин.

Внутри задействована легковесная модель `claude-haiku-4-5` с ограничением в 15 шагов. Агенту закрыт доступ к инструментам `Bash`, `Write` и `Edit`, поэтому он не запускает команды повторно и не правит репозиторий. Без заполненного блока HANDOFF агент сразу выносит вердикт о провале, так как самостоятельный поиск по коду для него заблокирован.

Субагент отвечает исключительно за сверку формулировок и не оценивает архитектурное качество решений. Если отчёты требуют субъективной оценки или принудительного перезапуска проверочных тестов, задача передаётся старшему агенту `arbiter`.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add SethGammon/Citadel
```
В чате агента (не в терминале):
```text
/plugin install citadel@citadel-local
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/phase-validator.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/phase-validator.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/phase-validator.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/SethGammon/Citadel/tree/HEAD/agents/phase-validator.md

## Когда брать
- проверить выполнение условий выхода из этапа по тексту сдачи задачи
- подтвердить запуск тестов и сборки перед переходом к следующей фазе
- сформировать машиночитаемый JSON-отчёт с причинами отказа при сбое
- сформировать рекомендации для повторного запуска упавшего шага

## Примеры запросов агенту
- Проверь HANDOFF третьего этапа кампании auth-flow и сопоставь его с условиями выхода.
- Оцени отчёт волнового агента и верни JSON с вердиктом pass или fail.

## Похожие
- [gsd-validate-phase](https://affpapa.org/nevibecode/skills/gsd-validate-phase.md) — скилл · 572 установки
- [Skill Validator](https://affpapa.org/nevibecode/skills/skill-validator.md) — скилл · 131 установка
- [validator](https://affpapa.org/nevibecode/agents/validator.md) — субагент · ★ 3990 у репозитория
- [TDD Refactor Phase - Improve Quality & Security](https://affpapa.org/nevibecode/agents/tdd-refactor-phase-improve-quality-security.md) — субагент · ★ 41430 у репозитория
- [TDD Red Phase - Write Failing Tests First](https://affpapa.org/nevibecode/agents/tdd-red-phase-write-failing-tests-first.md) — субагент · ★ 41430 у репозитория
- [production-validator](https://affpapa.org/nevibecode/agents/production-validator.md) — субагент · ★ 850 у репозитория

Из того же набора: [sethgammon/citadel](https://affpapa.org/nevibecode/by/sethgammon/citadel.md) — 55 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
