Outcome

Что получится в конце

Вечер работы — и вы перестаёте пересказывать нейросети контекст. Она сама знает, какие у вас проекты, что в каждом лежит и куда отнести новую задачу.

Собирается это из трёх вещей: одна корневая папка, один файл с правилами внутри неё и короткий реестр проектов. Ни серверов, ни подписок на сторонние сервисы, ни строчки кода.

Шаг 1

Поставить приложение

Нужно ровно одно из двух: Claude Code от Anthropic или Codex от OpenAI. Оба ставятся как обычное десктопное приложение и оба умеют читать файлы на вашем компьютере — на этом всё и держится.

Дальше по тексту я показываю на Claude Code, потому что работаю в нём. В Codex всё то же самое, отличается только имя файла с правилами: CLAUDE.md против AGENTS.md.

Выбирать между ними на старте не нужно. Файл с правилами — обычный текст, он переносится из одного в другой копированием.
Шаг 2

Выбрать одну корневую папку

Это решение, от которого зависит всё остальное. Нужна одна папка, внутри которой лежит вся ваша работа. Не «папка под текущий проект», а корень.

У меня это ~/Documents целиком. Внутри — Projects/ с продуктами и Instruments/ с инструментами, и там же всё остальное. Вход в систему начинается отсюда.

Почему именно одна: нейросеть видит только то, что вы ей открыли. Пока проекты разбросаны по разным местам, каждый разговор начинается с нуля. Как только у них появляется общий корень, появляется и общий контекст.

Шаг 3

Создать один файл с правилами

В корне папки создаёте CLAUDE.md. Всё. Это и есть система в первой итерации.

Главное, что в нём должно быть, — правило, что проекты внутри этой папки связаны и видят друг друга. Вот минимальная рабочая версия, с которой можно начать сегодня:

~/Documents/CLAUDE.md
# Правила для всех проектов в этой папке

## Проекты связаны

Все проекты внутри этой папки — части одной системы. Они видят друг друга.

Общая карта лежит в `PROJECTS.md` рядом с этим файлом.
**Прочитай её в начале работы.**

Если в разговоре про один проект всплывает тема другого — скажи об этом
и предложи посмотреть туда. Не заставляй меня пересказывать, что где лежит.

## Если задача пришла в корень

Не начинай выполнять сразу:

1. Прочитай `PROJECTS.md` и сопоставь задачу с описаниями.
2. Один явный кандидат — скажи одной строкой: «Это про X. Переключаюсь?»
3. Несколько — перечисли два-три варианта, спроси, какой.
4. Ничего не подходит — скажи прямо, не выдумывай.

## Локальные правила важнее

У проекта может быть свой `CLAUDE.md`. Его правила приоритетнее этих.

Это буквально всё, что нужно для первой версии. Файл читается автоматически, вставлять его в каждый разговор не надо.

Шаг 4

Написать реестр проектов

Второй файл — PROJECTS.md. Он отвечает на вопрос «что у меня вообще есть», и без него правило из шага 3 не на что опереться.

По одному блоку на проект. Не документация — одна строка о сути и путь:

~/Documents/PROJECTS.md
# Реестр моих проектов

Обновлено: 2026-08-11
Источник правды: этот файл.

## Активные

### youtube-analyst
- **Путь:** `~/Documents/Instruments/youtube-analyst`
- **Что:** разбор чужих видео — скачивание, расшифровка, кадры.
- **Заметки:**
  - 2026-07-30 — добавил поддержку Instagram.

### instagram_analitics
- **Путь:** `~/Documents/Instruments/instagram_analitics`
- **Что:** сборка каруселей для соцсетей. Разбор видео — не здесь,
  он делегирован в `youtube-analyst`.

Обратите внимание на последнюю строку: она не описывает проект, а разводит границу между двумя. Именно такие строчки экономят больше всего времени — без них нейросеть начнёт заново решать задачу, которая уже решена в соседней папке.

Чтобы реестр не устарел через неделю, добавьте в CLAUDE.md правило, когда его дописывать:

дополнение к ~/Documents/CLAUDE.md
## Когда обновлять PROJECTS.md

Добавь строку в раздел проекта после любого из этого:
— завершена фича или фикс,
— сменился статус проекта,
— появилась новая внешняя зависимость.

Формат: `ГГГГ-ММ-ДД — одна строка, максимум 100 символов.`

Не пиши про мелочи: форматирование, опечатки, эксперименты без результата.
Если заметок больше пяти — старые сожми в одну строку-итог.
Результат

Что меняется на практике

До системы каждая задача начиналась с пересказа: что за проект, где лежит, что там уже сделано.

После — я пишу в корне папки «нужно разобрать вот это видео», и в ответ получаю: «Это про youtube-analyst. Переключаюсь?» Дальше он уже знает, что кэш складывается в data/, что расшифровка идёт через whisper и что переписывать это заново не нужно.

Второй эффект заметен не сразу, но он важнее. Когда проекты видят друг друга, перестают появляться дубли. У меня половина строк в реестре — это границы вида «здесь только карусели, разбор видео в соседнем проекте». Без них я бы третий раз написал одно и то же.

Дальше

Как это растёт

Не пишите все правила сразу. Работает обратный порядок: столкнулись с тем, что приходится объяснять одно и то же второй раз — дописали строку в CLAUDE.md.

У меня так появились правила про напоминание о коммитах, про формат заметок и про то, что контентные папки — не код и в реестр их писать не нужно. Каждое родилось из конкретного раздражения, а не из попытки продумать всё заранее.

Следующий уровень — свой CLAUDE.md внутри каждого проекта, со специфическими правилами. Но это уже вторая итерация, и без первой она не нужна.

Границы

Где это ломается

Файл на пять страниц работает хуже файла на одну. Правила начинают противоречить друг другу, и поведение плывёт. Дошли до страницы — режьте.

Реестр устаревает молча. Если не дописывать заметки, через месяц он будет врать, а врущий реестр хуже отсутствующего. Поэтому правило обновления — часть системы, а не пожелание.

Это не заменяет вас. Система забирает пересказ контекста и рутину. Что делать, что публиковать, что выбросить — остаётся человеку, и в следующем году тоже.

Что делать прямо сейчас

Поставьте приложение, выберите корневую папку, создайте в ней CLAUDE.md с правилом из шага 3 и выпишите в PROJECTS.md хотя бы три своих проекта по одной строке.

Это вечер. Дальше система дописывается по ходу.

Если застрянете на своей задаче — пишите в Telegram или в директ @alan_apekov_ai.