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

Структура из главы 02 разваливается за месяц, если её не поддерживать. Хорошая новость: большую часть поддержки можно отдать агенту. Нужны четыре привычки и одно правило.

Inbox-дисциплина

Всё сырое входящее попадает в одно место: письмо с вложением, файл от коллеги, скриншот, выгрузка, «посмотри потом». Для воркспейса это _inbox/, для конкретной компании - clients/<имя>/inbox/. Прямо в docs/ или _templates/ ничего не кладётся.

Разбор inbox - по правилам «что куда», и правила записаны:

## Разбор _inbox/

- Договор, счёт, акт, КП с именем компании - в clients/<имя>/docs/, дата в начале имени
- Транскрипт или запись созвона - в clients/<имя>/calls/, дата в начале имени
- Файл без имени компании, похожий на шаблон - обезличить, в _templates/, строка в README
- Заметка про метод или процесс - в _methods/
- Относится к проекту - в projects/<имя>/, если код или план
- Непонятно куда - оставить в _inbox/, пометить в INBOX-LOG.md вопросом

После разбора в inbox остаётся только журнал INBOX-LOG.md: дата, что пришло, куда ушло. Это и история, и способ найти файл, который «точно был».

## 2026-09-15
- Акт от Acme за август (pdf) -> clients/Acme/docs/2026-09-15-act-august.pdf
- Черновик структуры интервью (md) -> _methods/interview.md, README обновлён
- Скриншот дашборда без контекста -> остаётся, вопрос: чей?

Разбирать inbox может агент, по промпту «разбери _inbox/ по правилам из AGENTS.md / CLAUDE.md, спорное - спроси». Но подтверждение перемещений оставьте за собой хотя бы первый месяц.

Журнал NOTES.md

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

## 2026-09-15
### Добавлено
- Генератор КП читает реквизиты из clients/<имя>/requisites.md вместо
  аргументов командной строки. Юрлицо выбирается по флагу --entity.

## 2026-09-10
### Изменено
- Шаблон _templates/kp.md: блок «Сроки» перенесён выше «Цены» по итогам
  трёх созвонов - компании спрашивают о сроках раньше.

Записывать стоит фичи, рефакторинги, исправления, подключения сервисов, изменения структуры. Правки опечаток - нет. Правило для агента: «после значимого изменения добавь запись в NOTES.md, сверху». Через полгода этот файл заменит вам память о том, почему проект устроен именно так.

Архив вместо удаления

Закрытый проект, старый шаблон, завершённый клиент - не удаляются, а переезжают в _archive/YYYY-MM/. Месяц в имени папки - когда заархивировали.

_archive/
├── 2026-07/
│   └── site-landing-v1/       # старая версия лендинга
└── 2026-08/
    ├── kp-old-template.md     # шаблон до редизайна
    └── Beta Corp/             # клиент, работа завершена

Смысл в двух вещах. Первая: агент не видит архив при обычном поиске, если в файле правил написано «в _archive/ не заходить без явной задачи». Старый шаблон перестаёт конкурировать с новым. Вторая: когда через год спросят «а как мы делали для Beta», ответ лежит в известном месте.

Регулярная ревизия силами агента

Раз в неделю - один промпт. Агент проходит по воркспейсу и предлагает, что поправить. Вы подтверждаете.

Пройди по воркспейсу и проверь порядок:
1. Дубли шаблонов: файлы с похожим содержимым в _templates/, projects/ и _inbox/.
2. Файлы вне своих уровней: реквизиты или имена компаний вне clients/,
   код вне projects/, заполненные документы в _templates/.
3. Папки верхнего уровня без README.md.
4. Файлы в _inbox/ старше недели.
5. Ссылки в AGENTS.md / CLAUDE.md на файлы, которых больше нет.
Ничего не перемещай. Выдай список: файл, проблема, куда предлагаешь.

Первые ревизии дадут длинный список. Через месяц - три-четыре строки. Это и есть признак, что порядок держится.

Ретро после сбоя

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

Правильная реакция - короткое ретро с одним вопросом: какого правила или файла не хватило, чтобы агент сделал верно? Ответ записывается в AGENTS.md / CLAUDE.md, README или скилл. Один сбой - одна строка правил.

Так файл правил растёт из реальных ошибок, а не из абстрактных пожеланий. Этот цикл «сбой - правило - проверка» подробно разобран в курсах Система артефактов и Harness engineering.