раздел 01
Три уровня: универсальное, проектное, клиентское
Уровень файла определяется одним вопросом: кому он нужен. Всем проектам - универсальное. Одному проекту - проектное. Одной компании - клиентское.
Универсальное
Всё, что вы делаете больше одного раза и хотите делать одинаково.
- Шаблоны документов: счёт, акт, договор, КП, презентация.
- Методологии: как проводить интервью, как считать цену, как писать план проекта.
- Стиль текстов: слова, которые запрещены, тон, структура поста.
- Скиллы - описанные процессы, которые агент подключает сам, когда задача подходит. Про них отдельный курс Skills.
Универсальное живёт в корне воркспейса, в папках с префиксом подчёркивания (_templates/, _methods/), чтобы они стояли первыми в списке и отличались от проектов. Меняется редко и осознанно: поправили шаблон - изменились все будущие документы.
Проектное
Всё, что относится к одному проекту и другим не нужно.
- Код и конфиги.
- README.md - что это за проект и как его запустить.
- NOTES.md - журнал изменений: что и когда сделали.
- Планы, решения, черновики этого проекта.
- Свой AGENTS.md / CLAUDE.md с уточнениями: стек, команды, ограничения.
Живёт в projects/<имя>/, у каждого проекта свой git-репозиторий. Меняется часто - это рабочая зона.
Клиентское
Всё, что принадлежит конкретной компании.
- Договоры, счета, акты - подписанные, с реквизитами.
- Реестр реквизитов и контактов.
- Транскрипты созвонов, переписка, входящие материалы.
- Персональные данные сотрудников: имена, телефоны, должности.
Живёт в clients/<имя>/, по одной папке на компанию. В общий git проекта не попадает. Меняется по событиям: новый созвон, новый документ.
Сводная таблица
| Уровень | Что лежит | Где | Кто читает | В git | Как часто меняется |
|---|---|---|---|---|---|
| Универсальное | Шаблоны, методологии, стиль, скиллы | _templates/, _methods/, .claude/skills/ | Агент в любом проекте, вы | Да, репозиторий воркспейса | Редко, осознанно |
| Проектное | Код, README, NOTES.md, планы, решения | projects/<имя>/ | Агент в этом проекте, вы, коллеги по проекту | Да, свой репозиторий | Часто |
| Клиентское | Договоры, реквизиты, транскрипты, персданные | clients/<имя>/ | Только вы и агент по явной ссылке | Нет (или отдельный приватный) | По событиям |
Что куда: один пример с трёх сторон
Возьмём коммерческое предложение. Вокруг него три разных файла, и все три лежат в разных местах.
Заметьте: генератор ссылается на шаблон по пути, но не хранит его копию. Готовое КП лежит у клиента, а не в папке генератора «для примера». Если положить готовое КП рядом с генератором, следующий запуск для другой компании рискует взять его за образец.
Ещё несколько примеров
| Файл | Уровень | Почему |
|---|---|---|
| Правила стиля текстов | Универсальное | Применяется ко всем постам и письмам |
| Транскрипт созвона с компанией | Клиентское | Содержит имена и обсуждаемые условия |
| План спринта на две недели | Проектное | Нужен одному проекту |
| Шаблон акта выполненных работ | Универсальное | Одинаков для всех |
| Подписанный акт | Клиентское | Реквизиты и сумма конкретной компании |
| Скрипт выгрузки данных из CRM | Проектное | Часть проекта, живёт с его кодом |
| Промпт «как проводить интервью» | Универсальное | Метод, а не результат |
| Ответы на интервью с сотрудниками | Клиентское | Персональные данные |
Пограничные случаи
Файл нужен двум проектам. Значит, он универсальный. Вынесите в _methods/ или _templates/ и ссылайтесь из обоих проектов. Копия в каждом проекте разъедется через месяц.
Шаблон, в котором «для удобства» вписаны реквизиты одного клиента. Это два файла, слепленные в один. Разлепите: пустой шаблон в _templates/, заполненный - в папку клиента.
Проект делается для одного клиента. Код всё равно проектный: projects/acme-bot/. А договор, доступы и транскрипты - клиентские: clients/acme/. Проект ссылается на клиента в README, но не хранит его данные внутри. Подробнее об этом в главе 04 - Клиентские данные.