В понедельник я анонсировал гайд про настройку Claude Code. Сегодня - превью самой важной страницы. Это диаграмма, на которой держится всё остальное.
~/work_repo/.claude/
├── CLAUDE.md ← главный зонт
├── memory/MEMORY.md ← индекс памяти
└── skills/
├── work/ ← рабочий стрим
│ ├── PROJ-101_migration_dwh/ ← ЭПИК Jira
│ │ ├── SKILL.md
│ │ ├── PROJ-1011_vitrina/SKILL.md
│ │ └── PROJ-1012_lineage/SKILL.md
│ └── PROJ-102_core_layer/SKILL.md
└── content/ ← личный стрим
└── partitionbydatalab/
├── styleguide/SKILL.md
└── post-format/SKILL.md
Идея простая: проектная иерархия Jira (Инициатива → Эпик → Таск) зеркалится в файловую структуру скиллов. Когда агент срабатывает на тикете PROJ-1011, он каскадно подтягивает: главный CLAUDE.md (профиль, MCP) → SKILL.md эпика PROJ-101 (цели, общая процедура) → SKILL.md таска (SLA, источники, схема). Контекст набирается слоями, без дублей.
Переключился агент на личный стрим - пропали корпоративные правила, активировались скиллы канала. Один и тот же агент, разные «личности» в зависимости от того, в какой папке он сейчас работает.
Главный вопрос, который встаёт сразу: куда положить новое правило - в зонт или в стрим. У меня в гайде на это есть страница, но если коротко:
▫️ Идёт в корневой CLAUDE.md если правило релевантно двум и более стримам. Профиль пользователя, общие MCP-серверы, безопасность, прокси для Anthropic в РФ-сети - всё это глобально
▫️ Остаётся в стримовом CLAUDE.md если работает только в одном стриме. Расписание публикаций контент-фабрики - только личный стрим. Конвенции PR в DWH-репозитории - только рабочий стрим
▫️ Уходит в SKILL.md если это шаги воспроизводимой процедуры. Лимиты конкретного канала, SLA конкретного таска, эталоны и шаблоны
Ошибка новичков - класть всё в корневой CLAUDE.md «чтобы точно сработало». Корень разрастается, prompt cache рвётся при каждой правке, контекст забивается тем, что нужно одному скрипту в неделю. Дисциплина: правило держится на самом узком уровне, на котором оно ещё работает.
И ещё одна часто встречающаяся ловушка - когда правило живёт в нескольких местах. В CLAUDE.md - «всегда отвечать по-русски». В скилле - пример с английским ответом. Агент срабатывает на скилл, отвечает по-английски. Через месяц вы забываете, где это поправить, чтобы починить.
Но:
▪️ Каскад не делает агента умнее. Он делает контекст осмысленнее
▪️ Дисциплина важнее разовой настройки. Через два месяца, когда вы поймаете себя на «брошу правило куда-нибудь, потом разберусь», - вспомните этот пост
▪️ Это не серебряная пуля. Никакая подготовка контекста - ни моя каскадная система, ни Obsidian, ни графовые БД - не уберёт ошибки и галлюцинации LLM до нуля. Каскад снижает их кратно, но на текущем уровне развития нейросетей часть ошибок останется. К ним нужно относиться спокойно
🚀 Предзаказ открыт до релиза 16 мая. Два тарифа: базовый только pdf, премиум pdf+часовой созвон со мной. Промокод GUIDE20 дает скидку 20%, лимит 10 мест (на сейчас осталось чуть меньше половины). Бот @pbdl_tg_bot - команда /start