Файловая система и «второй мозг»
Единая структура папок и два файла в корне делают проект понятным без объяснений. Это основа, на которой потом работают и команда, и агент.
Самый скучный гайд и самый важный. Без порядка в файлах не работают ни люди, ни ИИ-агенты. Агент, который не знает, где что лежит, путается ровно так же, как новый сотрудник.
Единая структура проекта
Одинаковая для всех клиентов. Открыл любую папку — знаешь, где что, без объяснений.
- Context — что за бизнес, цели, договорённости, история решений
- Design — макеты, айдентика, исходники графики
- Prod — то, что уходит в производство: код сайта, готовые файлы
- ADS — креативы, тексты объявлений, скриншоты кабинета
- CRM — заявки и клиенты
- Finance — договор, счета, акты, расчёты
- References — референсы и примеры, собранные под задачу
- Systems — служебное: скрипты и настройки, нужные только этому проекту
Два файла в корне — важнее всех папок
Рядом с папками лежат два коротких файла. Они и делают проект понятным без объяснений — и человеку, и ИИ-агенту.
- PROJECT.md — паспорт: что за бизнес, кому продаём, как зарабатываем, что уже запущено, что дальше
- CLAUDE.md — правила работы именно в этом проекте: стек, что нельзя трогать, в каком порядке выкатывать
Зачем это. Через полгода ты не вспомнишь, почему сайт собран без сборщика и почему нельзя переименовывать пару странных файлов в корне. Паспорт и правила вспомнят за тебя. Их же первым делом читает агент, когда просишь разобраться в проекте — без них он угадывает.
Правила именования
- Дата спереди в формате ГГГГ-ММ-ДД — файлы сами встают по порядку
- Без пробелов и русских букв в именах рабочих файлов — ломается на серверах и в ссылках
- Никаких «финал», «финал2», «точно_финал». Версия числом: v1, v2, v3
- Имя говорит, что внутри:
2026-08-06-beton-reels-v2.mp4 - Черновики — в подпапку _draft
Облако и доступы
- Рабочие файлы живут в облаке. Ноутбук может умереть, проект — нет
- У каждого проекта своя папка с доступом для команды
- Права: чтение по умолчанию, редактирование — только тем, кто правит
- Доступ выдаётся аккаунту, а не паролем «на всех». Ушёл человек — забрал доступ
«Второй мозг». Отдельное место, где лежат не файлы, а решения и знания: что пробовали, что сработало, какие связки живут, что клиент просил не делать. Через полгода ты не вспомнишь, почему отключили ту кампанию — а запись вспомнит. Это же читает ИИ-агент, когда просишь его разобраться в проекте.
Агенты работают с файлами и заметками. Порядок — не эстетика, а условие работы: в хаосе агент выдаёт мусор и уверенно ссылается не на те данные.
Где ошибаются
- Заводят структуру и через неделю кидают файлы на рабочий стол
- Называют файлы «финал_последний_2» — потом никто не знает, какой актуальный
- Держат всё на личном ноутбуке без копии
- Дают команде общий пароль вместо доступов
- Ведут заметки в голове и теряют их при смене исполнителя
Проверь себя
- Структура 01–06 создана и одинакова для всех проектов
- Имена файлов по правилу: дата, латиница, версия числом
- Проект живёт в облаке, доступы выданы аккаунтам
- Есть заметка «второй мозг» хотя бы по одному проекту