Намеренная непрочитанность · ILUОпережающее любопытство

Yuri Vonchitzki — .claude/ Folder Architecture

13 окт. 2026 г. · время чтения ~2 мин.

Вид: README и файлы шаблона репозитория

Коротко

Вопрос: как устроить папку .claude/ проекта, чтобы поведение Claude Code не зависело от одного разросшегося CLAUDE.md
Ответ: Vonchitzki заявляет, что разнесение знаний Claude, его поведения и состояния работы по отдельным папкам .claude/ устраняет нестабильность одного разросшегося CLAUDE.md.

Тезисы

Т1. Vonchitzki заявляет: проблему решает одно структурное решение — отделить то, что Claude знает, от того, как он себя ведёт, и от того, где сейчас рабочий процесс

  • Против: один файл CLAUDE.md, в который сложены инструкции, знания, состояние сессии и описания агентов
  • Аргумент: по словам Vonchitzki, CLAUDE.md растёт и Claude в каждой сессии читает его по-разному; итог, по мнению Vonchitzki, — разные результаты и невозможность проверить, что Claude было сказано.
  • Цитата: «The fix is a single structural decision: separate what Claude knows from how it behaves from where it is in a workflow. That is what this repo does.» (раздел “The problem this solves”)

Т2. Vonchitzki заявляет: три вопроса образуют основу, остальные папки надстраиваются сверху

  • Аргумент: как вести себя Claude — rules/; что знать — context/, schemas/; где сейчас рабочий процесс — memory/; остальные папки надстраиваются сверху.
  • Цитата: «Everything else (commands/, agents/, skills/, protocols/) layers on top of this foundation.» (раздел “The Core Principle”)

Т3. В шаблоне Vonchitzki единственная папка, которая меняется между запусками, — memory/; она в .gitignore

  • Аргумент: по правилу Vonchitzki в memory/ лежит только состояние рабочего процесса, а инструкции и знания туда не кладут.
  • Цитата: «memory/ is gitignored — it’s the only folder that changes between runs.» (раздел “The three questions”)

Т4. Правило Vonchitzki: условия запуска скиллов записаны явно, в обязательном skills/index.md

  • Аргумент: по правилу Vonchitzki файл skills/index.md обязателен и сопоставляет условия со скиллами.
  • Цитата: «triggering logic should never be implicit.» (раздел “SKILL.md”, “skills/ — Auto-invoked workflows”)

Т5. Правило Vonchitzki: форма структурированного ответа агента не остаётся неявной — агент ссылается на схему из schemas/ в своём определении

  • Аргумент: по правилу Vonchitzki агент со структурированным выходом ссылается на схему в своём определении.
  • Цитата: «Never let output shape be implicit.» (раздел “SKILL.md”, “schemas/ — What Claude must produce”)

Оригинал