1. Задачи бывают разных жанров
Когда Тёма собрал первый TASK_SPEC, Лёха замечает, что тот пишет любую задачу одним и тем же тоном — будто всё на свете это «сделай что-нибудь в проекте». И притормаживает его коротким ликбезом.
— Слушай, а ты заметил, что задачи-то разные бывают? Не по теме разные — по жанру.
— В смысле жанру? — Тёма правда не понимает. — Задача и задача. Сделать что-то.
— Не-а. Смотри. «Добавь новую кнопку», «почини баг», «наведи порядок в коде», «разберись, как тут всё устроено» — снаружи это всё звучит как «сделай что-то в проекте». А внутри — четыре совершенно разных дела, с разными рисками. Перепутаешь — дашь агенту не ту свободу, и он натворит лишнего. Ровно как вчера.
— Офигеть. И сколько их, этих жанров?
— Четыре. Давай я покажу на примере ремонта в квартире, так дойдёт быстрее.
2. Четыре жанра на ремонте квартиры
Лёха раскладывает на пальцах, и каждый жанр привязывает к понятной картинке из ремонта.
Фича — это добавить новое поведение. Пристроить балкон: появляется то, чего не было. Главный вопрос тут — что именно строим и, главное, как новое стыкуется со старым: балкон надо прицепить к стене, а не поставить рядом в воздухе. В коде так же — новый кусок должен состыковаться с тем, что уже есть, в точке соединения, и не развалить соседнее.
Багфикс — починить одно, не трогая остального. Капает кран. Проблема в одной точке, и задача — убрать её, ничего вокруг не задев. Самое опасное в багфиксе — это «заодно». Пришёл чинить кран, а заодно решил переделать всю сантехнику. Не просили. И тут есть техническая ловушка: чиня одно, легко нечаянно сломать то, что рядом работало. Поэтому после багфикса всегда проверяют не только «кран больше не течёт», но и «а остальное всё ещё работает, как работало». Починил — убедись, что не отломил соседнее.
Рефакторинг — навести порядок внутри, не меняя поведения снаружи. Переставить мебель. Квартира снаружи та же, жить удобнее. Ключевое — снаружи ничего не должно измениться. Технический признак настоящего рефакторинга ровно такой: поведение прежнее, и все проверки, что были зелёными, остаются зелёными. Ты трогаешь только внутреннее устройство, а не то, что видит пользователь. Если после «уборки» что-то заработало иначе — это уже не рефакторинг, это поломка.
Разведка — разобраться, прежде чем трогать. Позвать мастера осмотреть проводку до того, как сверлить стену. В коде так же: иногда сперва надо понять, как всё устроено, — прочитать файлы, увидеть, что от чего зависит, — и только потом лезть. Главное свойство разведки: она код не меняет вообще, ни строчки. Только читаем и разбираемся. Результат разведки — не правка, а понимание.
Тёма слушает и узнаёт во всём этом свои собственные грабли:
— Слушай, так вчера-то и был багфикс! Я хотел починить одно. А агент пришёл и «заодно» снёс соседнее. Кран чинил, а перекрасил всю кухню.
— Ну вот ты и сам дошёл. Теперь понимаешь, почему важно знать жанр заранее.
Тёма прогоняет через эту сетку свои прошлые проекты — и они вдруг ложатся по-другому.
— Слушай, а Змейка-то была сплошная фича, — говорит он. — С нуля, на пустом месте, ломать нечего — потому и можно было давать агенту полную волю. А портал — совсем другой зверь. Рядом чужой работающий код, любая правка пахнет багфиксом или аккуратной фичей в тесноте: трогаешь одно, а вокруг то, что ронять нельзя.
— Ровно так, — кивает Лёха.
— То есть портал — это не «твори что хочешь», как пустая игрушка. Это «зайди аккуратно, рядом чужое».
— В точку. И под такую работу руль держат совсем не так, как под игрушку с нуля.
3. Жанр диктует, насколько отпускать руль
— А теперь главное, ради чего я всё это завёл, — Лёха переходит к сути. — Перепутал жанр — дал агенту неверную свободу. И вот это вчера тебя и убило.
Он возвращается к крану:
— Представь. Зовёшь рабочего: почини кран. Это багфикс — одна точка, одна протечка. И по доброте даёшь ему полную свободу действовать. А он чинит кран и заодно перекрашивает всю кухню, потому что «так же красивее». Двигает шкаф, меняет плитку — он же старается. Ты этого не просил, ты просил кран. Но свободу-то дал широкую — вот он и развернулся. На багфиксе нужна узкая свобода: почини ровно это, к остальному не прикасайся. Чем уже задача — тем короче поводок.
— А разведка тогда наоборот? — Тёма уже сам тянет нить.
— Соображаешь. Разведке давать свободу трогать код нельзя вообще. Её дело — понять, а не менять. Тут место режиму «только смотри, руками не лезь».
Тёма складывает всю карту сам, вслух, по жанрам:
— Получается так. Багфикс — узкие заборы, агент держится одного места. Рефакторинг — следи, чтоб снаружи поведение не поехало. Разведка — вообще не давай трогать, пусть только разбирается. Фича — опиши новое поведение и где оно стыкуется. И под каждый жанр — своё, сколько свободы дать.
— Запомни рефлекс: прежде чем ставить задачу агенту, спроси себя — какой это жанр? И от ответа решай, насколько отпускать руль и что писать в постановке. Один вопрос про жанр — и сразу ясно и что писать, и как держать.
— Один вопрос, — Тёма крутит это на языке, и в глазах знакомый блеск пройдохи, нашедшего короткий путь. — Слушай, а удобно. Не надо каждый раз заново башку ломать. Спросил «жанр?» — и уже полдела понятно.
— Вот теперь соображаешь, — хмыкает Лёха.
Для Тёмы это не экзамен по классификации, а простая линза: один вопрос — и TASK_SPEC сразу точнее, и ясно, как держать тот самый руль из утреннего сообщения. Чем этот руль крутят — какими кнопками, какими командами — он пока не знает. Но уже понимает, зачем крутить и в какую сторону под какую задачу. Осталось найти сам руль.
ПЕРЕЙДИТЕ В ПОЛНУЮ ВЕРСИЮ