Дорогая, а куда ты положила пульт?

Есть такая штука «Пульт проекта» – это файл, без которого я больше не начинаю разработку. Щас расскажу на примере своей игры, но применяю это вообще везде, в любом проеекте.

Начинается всё с архитектурного файла. Это обязательный минимум: агент должен понимать, из чего собран проект, а не догадываться по коду. Но отдельно живёт дизайн, отдельно бэкенд, отдельно игровые механики. Запихнуть это в одну простыню нельзя: она распухает, и агент начинает читать её по диагонали.

👨‍💻 Значит, файлы разделяем. А как только разделил – нужен место, где всем этим хозяйством управлять. Вот это и есть пульт.

Что в нём лежит:

• ТЗ – что строим и зачем
• принятые решения, причём с формулировкой почему выбрали именно так
• основа проекта: стек, ограничения, что трогать нельзя
• на чём остановились в обсуждениях – точка, к которой возвращаешься
• маршрут по остальным файлам: куда идти за дизайном, куда за бэком

Ты же знаешь что у агента нет памяти между сессиями? И без пульта он начинает додумывать, и ты получаешь на выходе решение, которое вы вдвоём отменили или сделали ещё неделю назад. С пультом стартовая команда каждый раз одна и та же: прочитай пульт – оттуда иди в нужный файл – работай.

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

Узнал в @buyonhigh