25 подписчиков
Сейчас код руками я не пишу. И, честно говоря, не вижу в этом никакой трагедии. Если даже Андрей Карпаты не пишет код руками, то зачем это делать мне?
Но тут есть важный нюанс, который многие пока недооценивают.
Проблема вообще не в том, пишет ли код человек или агент. Проблема в том, что без нормальной документации всё это не живёт вдолгую. Можно быстро собрать что угодно, особенно сейчас, когда агенты реально сильно ускоряют разработку. Но потом это всё надо поддерживать, обновлять, развивать и не развалить архитектуру через месяц.
И вот здесь начинается самое интересное.
Для каждого проекта я веду нормальную, полную документацию:
🐺 архитектура
🐺 логика
🐺 changelog
🐺 запуск
🐺 инструкции по работе
Но недавно дошёл ещё до одной вещи, которая после внедрения кажется почти очевидной: документацию надо делить на два слоя.
👨🦰 Документация для человека
🤖 Документация для агента
Потому что агенту не надо читать весь проект целиком. Это только жрёт контекст и мешает решать узкие задачи. Если в проекте много модулей, сервисов и функций, то правки почти всегда вносятся в конкретные, ограниченные места. Значит и документация должна подтягиваться точечно.
Поэтому я ввёл:
🐺 индексный файл
🐺 старт-сессию
Сначала агент читает базовые правила, понимает, какие файлы за что отвечают, а дальше уже подгружает только нужные куски документации по мере необходимости.
Следующая мысль тоже пришла довольно быстро. Если в каждом проекте я всё равно заново собираю каркас документации, то зачем делать это каждый раз руками?
🚀 Значит нужен стартовый шаблон, который в самом начале проекта сам создаёт нужную структуру и дальше помогает вести её по правилам.
И вот это, как мне кажется, одна из самых недооценённых вещей в AI-разработке сейчас.
AI меняет не только способ писать код.
Он меняет сам способ думать о разработке.
Если работаете с агентами, вайбкодите или просто пытаетесь строить что-то серьёзное с помощью AI, очень советую смотреть не только на генерацию кода.
Смотрите на:
🐺 структуру
🐺 правила
🐺 документацию
🐺 то, как агент входит в контекст
Потому что вдолгую выигрывает не тот, кто быстрее сгенерил код. А тот, кто выстроил систему, в которой это всё можно нормально поддерживать.
✅ Мой канал в MAX
1 минута
19 апреля