Как не потерять понимание агентского кода

Количество PR в день выросло, а вот наша способность быстро процессить такой объем информации, и достраивать понимание того, как работает система, осталась прежней. Держите несколько интересных техник того, как это понимание не потерять:

1️⃣Просите агента для каждого PR готовить дополнительную объясняшку по следующим принципам:

• Объяснять контекст изменения. Например, архитектуру и основные задачи подсистемы, в которую вносятся правки.
• Настроить общую интуицию до того, как влезать в детали. Например, объяснить простыми словами какие-то ключевые концепции и идеи, чтобы ревьюеру было проще понять суть изменений.
• Чем интерактивнее, тем лучше – такая объясняшка может быть HTML с интерактивными схемами.
• Превращать чистый дифф кода в нарратив. Группировать вместе связанные по смыслу изменения, добавлять объяснение на человеческом языке, показывать только самые важные сниппеты кода.
• Добавлять опрос в конце, чтобы проверить, действительно ли вы поняли суть изменения.

Если что, вот прямо готовый скилл для того, чтобы такую объясняшку по диффу собрать.

2️⃣Делайте себе дополнительный тулинг, который позволяет погрузиться в изучаемый процесс на нужном уровне деталей.

В статье есть прямо классный пример про миграцию сайта с одного фреймворка на другой. В виде диффа смотреть на такие изменения не имеет смысла, вы ничего не поймете и интуицию не наработаете. Вместо этого, автор попросил агента написать для него что-то вроде контрольной панели, в которой он применял миграцию шаг за шагом, и мог видеть, как меняется файловое дерево и внешний вид.