Про сам тезис — он спорный, и это нормально
Утверждение «ИИ-агенты не читают файлы-подсказки, проверено по логам» расходится с частью индустрии, где такой файл считают обязательной гигиеной. Мы держим свою позицию по одной причине: у нас есть логи обращений, и в них этих запросов нет. Проверка повторялась дважды с тем же результатом.
Если у вас в логах картина другая — это интереснее нашей: значит, поведение агентов зависит от чего-то, чего мы не учли. Мы бы такое опровержение опубликовали.
Как заводится расхождение направления
Механика простая и повторяемая у любого, у кого больше одного документа:
- Решение принимается и записывается в методический документ, с датой и обоснованием.
- Другой документ живёт своей жизнью. В нём — состав возможностей фабрики, и туда пункт попадает как «умеем, включено».
- Второй документ ближе к коду. Разработка сверяется с ним, а не с методикой: он конкретнее и в нём написано, что генерировать.
- Через неделю никто не помнит, что был запрет: он лежит в документе, который читают на входе в проект, а не ежедневно.
Отменённое решение опаснее непринятого. Непринятое видно как пробел, о нём спорят. Отменённое выглядит как действующая практика — оно уже в коде, уже работает и не вызывает вопросов.
Родственный случай: 44 страницы, которых не видел ни один гейт
Второй пример того же рода — не про расхождение решений, а про дыру в покрытии проверок. На 44 страницах в заголовках стояло удвоение слова: «в Алматы в Алматы», «Аренда Аренда». Такие же удвоения были в названии услуги внутри разметки.
Через эти страницы прошли все наши проверки — и ни одна не покраснела, потому что ни одна не проверяла этот класс. Дефект видно человеческим глазом за секунду, и именно поэтому его никто не искал: он казался невозможным.
Закрыли отдельным детектором. Через некоторое время выяснилось, что и он был слеп к казахскому тексту — то есть проверка, написанная под один язык, на двуязычном сайте покрывает половину. Починили и это.
Вывод, который мы держим отдельно: «через это прошли все проверки» не значит «здесь нет дефектов». Это значит только, что нет дефектов тех классов, которые проверяются. Список классов конечен, и его надо знать наизусть — иначе зелёный отчёт читается шире, чем он есть.
Что мы поменяли
- Сплошная сверка требований против кода вместо выборочной. Выборка попадает на то, что помнишь, — то есть на действующее.
- Решение «не делать» фиксируется так же строго, как решение «делать»: с датой, причиной и указанием, что именно отменено.
- Новый пункт в фабрику добавляется со ссылкой на решение, которое его разрешает. Пункт без ссылки — кандидат на проверку, а не на включение.
- Список проверяемых классов дефектов ведётся явно. Не «у нас есть гейты», а перечень: вот эти классы ловятся, эти — нет.