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