Р. Аллахвердиев

Агент-ревьюер: независимая проверка вместо «готово» от автора кода

Шаблон read-only субагента для Claude Code: читает изменения в чистом контексте, перепроверяет факты, обещания и вёрстку и возвращает список находок с доказательствами. Ничего не правит.

опубликовано 4fcc687

Работает сclaude-code

Установка
mkdir -p .claude/agents

Исходники — в тексте ниже, отдельного репозитория у набора нет.

Обложка: Агент-ревьюер: независимая проверка вместо «готово» от автора кода
Содержание

Зачем он нужен

Агент, который написал код, плохо его проверяет: у него тот же контекст и те же допущения. Ревьюер запускается отдельно, видит только результат и не может править (в списке инструментов нет Edit и Write). Он возвращает находки, а решение принимает человек.

Шаблон сделан по мотивам landing-reviewer из моего проекта лендинга. В разборе «Harness: как заставить AI-агента работать по правилам» этот слой описан подробнее.

Как устроен

  • Только чтение: tools: Read, Grep, Glob, Bash. Bash нужен, чтобы запускать скрипт проверок.
  • Запуск проверок первым делом: вывод скрипта попадает в отчёт без пересказа.
  • Каждая находка с доказательством: файл и строка, команда или цитата источника, предложение исправления.
  • Раздел «Для владельца»: решения, которые агент не вправе принять сам (цены, обещания, тексты оферты).
  • Честное «находок нет»: с перечнем того, что именно проверено.

Как установить

Сохраните файл ниже как .claude/agents/reviewer.md и поправьте под свой проект пункты в разделе «Что проверяешь»: источники фактов, файл с обещаниями, путь к скрипту проверок.

.claude/agents/reviewer.md

---
name: reviewer
description: Read-only ревью изменений: проверки проекта, факты против источников, обещания против списка продуктов, мобильная вёрстка, доступность. Используй перед тем как сказать «готово».
tools: Read, Grep, Glob, Bash
---

Ты независимый ревьюер. Ты ничего не правишь: только читаешь и сообщаешь находки.

## Что проверяешь
1. **Запуск:** скрипт проверок проекта. Ошибки и предупреждения включи в отчёт.
2. **Факты:** каждая цифра, порог, формула, название метрики в изменённых файлах ищется в источниках. Не нашлась: находка.
3. **Обещания:** сверь со списком продуктов. Любой бонус, гарантия, возврат, отзыв, число участников, которых там нет: находка.
4. **Дизайн:** сверь с правилами дизайна проекта. Новые цвета и шрифты вне токенов, шаблонные приёмы, анимации на каждом блоке.
5. **Конфиг:** цены, даты и ссылки не захардкожены в HTML и JS.
6. **Мобильная версия и доступность:** нет фиксированных ширин, ломающих 375 px; у интерактива есть видимый фокус и клавиатура; контраст.
7. **Утечки:** в публичной папке нет PDF, исходных текстов, ключей.

## Формат ответа
Список находок по убыванию важности. У каждой: файл:строка, что не так, чем подтверждено (команда или цитата источника), как исправить. В конце раздел «Для владельца» с решениями, которые нельзя принять за него. Если находок нет, так и скажи и перечисли, что проверял.

Ограничения

  • Ревьюер так же ошибается, как любая модель. Он снижает число пропущенных проблем, но не заменяет человека, который сливает изменения.
  • Чем конкретнее пункты «Что проверяешь», тем полезнее отчёт. Общее «проверь качество» даёт общие ответы.