«Это не обязательно нейрослоп, но читается ровно как нейрослоп!» — так Саймон Уиллисон, соавтор Django и создатель Datasette, в свежей заметке описал побочный эффект кодинг-агентов. Почти все правки в его проектах открывают Claude Code и Codex, оформляя их в пулл-реквесты (pull request, или PR — заявка на вливание кода в общую ветку). Модели пишут к ним образцово точные пояснения, но первая же реакция живого человека одна: «Я не буду всё это читать».
Уиллисон ловит себя на этом раздражении даже тогда, когда сам пару минут назад запустил агента: читать машинное эссе дольше, чем ставить задачу, и командная проверка буксует. Как сохранить подробный журнал нейросети для истории, но вернуть в разработку уважение к чужому вниманию?
Ловушка идеального отчёта: почему точность превращается в белый шум
Дело не в галлюцинациях — агенты чересчур исполнительны. В заявке № 3042 для Datasette агент переделал загрузку скрипта edit-tools.js (~220 КБ): раньше файл скачивался на каждой странице у всех посетителей подряд, а теперь подгружается только для редакторов при наведении мыши или клике на ссылку правки. Задача прозрачная, но к готовому коду модель приложила отчёт на 150 строк с предысторией, развилками и логом проверок, от которого у ревьюера мгновенно стекленеют глаза.
Когда в тексте одинаково важно всё подряд, читатель теряет главное.
Это как вызвать сантехника к капающему крану и спросить, в чём была поломка. Вместо короткого «Лопнула прокладка на горячей воде, заменил — сухо» мастер кладёт на стол пухлый акт: марка латуни, давление в стояке и хронометраж каждого поворота ключа. Ни слова лжи, но на втором листе ты теряешь нить и пропускаешь важную деталь — что резьба вентиля еле держится. У меня при виде многоэкранных ИИ-описаний на GitHub включается тот же защитный рефлекс.
На код-ревью — проверке кода перед публикацией — коллеге нужна не стенограмма робота, а живой редакторский фильтр.
Двухслойный шаблон details и правило для агента
Чтобы вернуть этот фильтр и сохранить журнал аудита, Уиллисон разделил описание PR на два этажа. Наверху остаётся пара предложений от автора (иногда со скриншотом или выводом --help), которые сразу вводят в курс дела; часто эту точную фразу достаточно просто вытащить из черновика самой модели.
А весь подробный доклад агента уходит под спойлер HTML-тегов <details> и <summary>.
Согласно документации GitHub, разметка GitHub Flavored Markdown поддерживает их штатно (как и GitLab с Bitbucket). Саймон ставит в <summary> имя модели и уровень усилий — вроде Claude Opus 5.5 Medium, а чтобы не путать порядок тегов, советует проговорить вслух «details-summary»: два слога плюс три звучат складнее, чем «summary-details». Важная тонкость: сразу после </summary> обязана стоять пустая строка, иначе списки и код внутри сломаются в сырую кашу. Упакуем нашу заявку со скриптом edit-tools.js в такой шаблон:
Скрипт `edit-tools.js` (~220 КБ) раньше скачивался на каждой странице у всех посетителей. Теперь он подгружается через лёгкий загрузчик только для редакторов при наведении мыши или клике на правку.
<details>
<summary>Детали работы агента (Claude Opus 5.5 Medium)</summary>
**Что изменилось в коде:**
- Вынесен загрузчик для отложенной инициализации инструментов правки.
- Проверены сценарии доступа для читателей и редакторов.
</details>
На странице GitHub длинная простыня схлопывается в аккуратную плашку под двумя ясными предложениями. Коллега за пару секунд считывает суть оптимизации и открывает вкладку с кодом, а при поиске редкого бага через полгода вся история проверок раскроется в один клик. Чтобы не набирать скобки вручную (тем более с телефона, где у GitHub нет кнопки спойлера), пропиши это правило одной строкой в CLAUDE.md — только не перегружай конфиг бюрократией, о чём мы говорили в разборе про аудит системных промптов в Claude Code.
Свёрнутое описание бережёт глаза ревьюера, но не позволяет одобрять код вслепую: вычитывать правки и тесты нужно лично (как выстроить эту дисциплину, разобрано в статье про контроль качества и код-ревью при работе с ИИ-ассистентами).
А если оглянуться на твой сегодняшний день — в каких ещё рабочих отчётах, письмах или чатах людям вокруг не хватает твоих двух живых предложений поверх длинного текста от нейросети?


