Разработчик читает код чаще, чем пишет, и чужой — чаще, чем свой. Легаси без документации, проект после ушедшего автора, модуль типовой конфигурации, регекс из чужого коммита — на всё это уходят часы и дни, и результат живёт в голове одного человека. Нейросеть держит модуль на тысячи строк или репозиторий на десятки файлов целиком и возвращает карту: назначение, сценарии, схему вызовов, состояние, опасные места, точки правки. Это онбординг за час и документация, которой никогда не было. Решение, что трогать, и проверка там, где собираетесь править, — за человеком. Работает из России без VPN, объяснение можно забрать файлом.
Цель меняет ответ
«Объясни код» без цели даёт пересказ. «Нужно добавить тариф» даёт места правки, «принимаю проект» — обзор структуры, «ищу, где теряется заказ» — путь данных. Одна фраза о том, зачем вы читаете, превращает стену текста в карту с нужным масштабом. Вторая фраза — формат: «по сценариям, схема вызовов текстом, состояние отдельно».
Сценарии вместо строк
Построчное объяснение — это тот же код, только длиннее. Полезное объяснение идёт по действиям: что происходит при оформлении заказа, при расчёте пени, при смене тарифа — какие функции участвуют, в каком порядке, что читают и что меняют. Так код читает опытный разработчик, и так его стоит просить читать модель.
Состояние — то, что ломается первым
Глобальные переменные, кеш, файлы на диске, записи в базу, вызовы внешних систем — побочные эффекты, которых не видно в сигнатуре функции. Именно они превращают безобидную правку в инцидент. Попросите перечислить их отдельно: кто пишет, кто читает, где перезаписывается молча. Для легаси этот список ценнее схемы вызовов.
Где править и что сломается
Финальный вопрос к чужому коду всегда практический: куда вносить изменение и что проверить после. Модель даёт места с номерами строк, минимальный дифф и список рисков — что ещё читает это поле, что сравнивает с числами, что уходит наружу. Вы открываете каждое место и решаете. Это быстрее, чем искать самому, и безопаснее, чем править первое найденное.
Где модель опасна
В полноте и в том, чего нет в чате. Вызовы через рефлексию или по строковому имени модель может не связать; функцию из файла, который вы не приложили, — объяснит по названию, то есть догадкой. Оба случая закрываются проверкой там, где собираетесь править, — поиском по проекту и приложением недостающих файлов. Всё остальное — карта, сценарии, состояние, опасные места — модель делает стабильно, и для больших модулей это её сильнейшая сторона.
