раздел 06

Шпаргалка

Всё главное про папки и артефакты на одной странице.

Что
Раскладка воркспейса на три уровня: универсальное, проектное, клиентское. Плюс файл правил, который говорит агенту, куда смотреть.
Зачем
Агент ищет по файлам, а не по памяти. Порядок в папках - это его память (шаблоны находятся) и безопасность (чужое не смешивается).
Как
Эталонное дерево, ссылки на шаблоны из AGENTS.md / CLAUDE.md, README в папках, изоляция клиентов, еженедельная ревизия.

Три уровня

УровеньЧтоГдеВ git
УниверсальноеШаблоны, методологии, стиль, скиллы_templates/, _methods/, .claude/skills/Да
ПроектноеКод, README, NOTES.md, планы, свой AGENTS.md / CLAUDE.mdprojects/<имя>/Да, свой репозиторий
КлиентскоеДоговоры, реквизиты, транскрипты, персданныеclients/<имя>/Нет или отдельный приватный

Эталонное дерево

workspace/
├── AGENTS.md            # общие правила (в Claude Code - CLAUDE.md)
├── .env                 # один на воркспейс, не в git
├── _templates/          # шаблоны документов + README
├── _methods/            # методологии, стиль + README
├── .claude/skills/      # процессы как скиллы
├── projects/<имя>/      # код, README, NOTES.md, AGENTS.md
├── clients/<имя>/       # requisites.md, INBOX-LOG.md, inbox/, docs/, calls/
├── _inbox/              # сырое входящее + INBOX-LOG.md
└── _archive/YYYY-MM/    # закрытое, не удаляем

Чек-лист: новый проект

  1. Папка projects/<имя>/, латиница и дефисы.
  2. git init, свой репозиторий.
  3. README.md: что это, стек, как запустить.
  4. NOTES.md с первой записью.
  5. AGENTS.md / CLAUDE.md проекта: команды, ограничения, ссылка на корневой.
  6. Секреты - в корневой .env, не в проект.

Чек-лист: новый клиент

  1. Папка clients/<Имя компании>/.
  2. README.md: кто, чем занимаемся, контакты, статус.
  3. requisites.md: каждое юрлицо отдельной записью со статусом.
  4. Подпапки inbox/, docs/, calls/, файл INBOX-LOG.md.
  5. Проверить, что clients/ в .gitignore корня или в отдельном приватном репозитории.
  6. Доступы к системам компании - в менеджер паролей, не в папку.

Промпты-заготовки

Прежде чем делать документ, проверь, есть ли шаблон в _templates/.
Если есть - используй его и не меняй структуру. Если нет - скажи мне.

Сделал новый шаблон - положи в _templates/ и добавь строку в README
этой папки. Добавь ссылку в корневой AGENTS.md / CLAUDE.md.

Разбери _inbox/ по правилам из AGENTS.md / CLAUDE.md. Ничего не перемещай
без подтверждения: выдай список «файл - куда - почему». Спорное - вопросом.

Пройди по воркспейсу: найди дубли шаблонов, файлы вне своих уровней,
папки без README, ссылки в правилах на несуществующие файлы. Предложи,
что куда. Ничего не перемещай.

Глоссарий

  • Воркспейс - общая папка, где живут все проекты, шаблоны и клиенты. Один корневой AGENTS.md / CLAUDE.md, один .env.
  • Шаблон - пустая структура документа без имён и сумм. Лежит в _templates/, с него начинается любой документ этого типа.
  • Методология - описание, как делать: считать цену, проводить интервью, писать тексты. Лежит в _methods/.
  • Реестр - файл requisites.md в папке клиента: юрлица со статусом, реквизиты, контакты. Единственный источник реквизитов.
  • Inbox - папка для сырого входящего, _inbox/ или clients/<имя>/inbox/. После разбора в ней остаётся только журнал.
  • Архив - _archive/YYYY-MM/, куда переезжает закрытое вместо удаления. Агент туда не заходит без явной задачи.
  • AGENTS.md / CLAUDE.md - файл правил агента. В Claude Code называется CLAUDE.md. Общий - в корне, уточняющий - в проекте.
  • Скилл - описанный процесс, который агент подключает сам, когда задача подходит. Ссылается на шаблоны по путям.

Куда дальше