Вайбкодинг: агент не читает документацию без прямой ссылки — 57 из 88 файлов ни разу не открыты

Разработчик проанализировал журналы работы Claude Code над своим проектом за пять недель и выяснил, как агент взаимодействует с документацией. Оказалось, что без явной ссылки из точки входа (файлов слеш-команд или описаний субагентов) агент практически не открывает документы: в среднем 1,2 раза на файл, а 57 из 88 таких файлов не были открыты ни разу.

Для сравнения: документы, на которые есть ссылка в точке входа, агент открывал в среднем 12,3 раза. Это подтверждает гипотезу: в вайбкодинге агент получает только ту документацию, которую ему явно «подсовывают». Раньше документацию писали в конце цикла для человека, теперь её нужно подавать агенту как часть промпта или контекста.

Вывод практический: чтобы агент использовал документацию, её нужно включать в точку входа — через ссылки или прямое включение. Иначе файлы остаются мёртвым грузом, а агент работает вслепую.