харнес · порядок

Папки и артефакты
проекта

Агент в IDE ищет по файлам, а не по памяти. Шаблон КП, который вы обсудили в чате месяц назад, для него не существует: в следующий раз он напишет новый, по-другому. А если реквизиты одного клиента лежат рядом с шаблонами, они рано или поздно попадут в документ для другого. Этот курс про раскладку воркспейса на три уровня - универсальное, проектное, клиентское - и про то, как агент сам находит и переиспользует то, что уже сделано.

Начать с начала →Сразу к дереву папок

о чём этот курс

Агент каждый раз пишет шаблон заново

Договорились о структуре КП, а через неделю агент выдал другую. Шаблон остался в чате, а не в файле, на который ссылается AGENTS.md / CLAUDE.md.

Данные одного клиента всплыли в КП другому

Реквизиты, цифры и цитаты из транскрипта лежали рядом с шаблонами. Агент взял «похожий пример» и вставил чужое.

В папке 300 файлов, и я сам не помню, где что

Версии, черновики, скриншоты и выгрузки в одной куче. Ни вы, ни агент не находите нужное - и оба делают заново.

программа курса

Зачем агенту порядок в папках

Агент ищет по файлам, а не по памяти. Методология в чате или в случайной папке для него не существует - он придумает заново. Порядок в папках = память и безопасность агента. Три уровня одной фразой.

Три уровня: универсальное, проектное, клиентское

Универсальное переиспользуется везде, проектное живёт в папке проекта, клиентское изолировано по папке на клиента. Таблица уровней и примеры «что куда»: шаблон КП, КП для компании, генератор КП.

Эталонная структура папок

Дерево воркспейса: _templates, _methods или skills, projects, clients, _inbox, _archive. AGENTS.md / CLAUDE.md на каждом уровне. Правила именования: даты в начале, латиница в slug, без пробелов в технических папках.

Как агент переиспользует

Ссылки на шаблоны и методологии из AGENTS.md / CLAUDE.md, skills для повторяющихся процессов, README в каждой папке. Промпты-заготовки и способ проверить, откуда агент взял основу документа.

Клиентские данные: изоляция

Папка на клиента, реестр реквизитов с юрлицами, правило «данные одного клиента не попадают в материалы другого», клиентские папки вне общего git, один .env на воркспейс. Faq по спорным случаям.

Поддержание порядка

Inbox-дисциплина, журнал NOTES.md, архив вместо удаления, еженедельная ревизия силами агента и ретро после сбоя «не нашёл / взял не то» - правилом в AGENTS.md / CLAUDE.md, а не напоминанием.

Шпаргалка

Три уровня таблицей, эталонное дерево коротко, чек-лист «новый проект / новый клиент», четыре промпта-заготовки и глоссарий. Всё главное на одной странице.