Skip to content

kydechuk01/claude-code-practices

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Claude Code Practices

Автор: Александр Климок, 2026 Язык: русский / Language: Russian

Настройте Claude Code один раз — и он будет помнить ваш контекст, проверять факты, работать по вашим правилам. И не терять рабочую нить: каждая новая сессия продолжает с того места, где предыдущая остановилась.

9 практик с пояснениями, 19 готовых рецептов настройки. Интерактивный чеклист, который адаптируется под любую вашу сферу — разработка ПО, аналитика, управление проектами, юриспруденция, медицина.

Что нового (v1.9)

Релиз «Параллельные подпроекты». Крупный проект разрастается — и появляется потребность работать над несколькими его подпроектами одновременно: каждое окно Claude Code со своим контекстом, но с одной общей памятью и общими правилами. Наивный запуск из подкаталога даёт изоляцию, но рвёт общую память (каждый каталог получает пустой силос) и крадёт идентичность (подпроект считает себя головным проектом).

  • Новый рецепт «Параллельные подпроекты: общая память, изолированный контекст» (parallel-subprojects-shared-memory.md) — штамп из трёх файлов на подпроект: настройка autoMemoryDirectory возвращает общую память (чтение и запись), тонкий CLAUDE.md даёт локальную идентичность, README-файл владеет состоянием подпроекта. Без миграции памяти и без хуков доставки; правила, скилы и агенты наследуются от корня сами.
  • Таблица наследования — что доходит из корня вниз при запуске из подкаталога (CLAUDE.md, скилы, агенты), а что нет (permissions, хуки, авто-память) — с механизмами по документации.
  • Проверки-канарейки — три проверки после настройки: подпроект знает, кто он; запись из подпроекта ложится в общую папку, а не в силос; корневые правила и скилы действительно унаследовались.
  • Отвергнутые тупики — пять решений, которые не работают (папка-канон, хук доставки индекса, опора на path-keyed имена и др.), задокументированы, чтобы не повторять.

Как пользоваться: после настройки пакета откройте Claude Code в корне вашего проекта и скажите обычной фразой: «создай подпроект <имя>» или «онбордь подпроект <имя>». Claude Code проверит версию и структуру, поставит штамп из трёх файлов и прогонит с вами проверки-канарейки. Дальше работайте над подпроектом, просто запуская Claude Code из его каталога — отдельное окно на каждый подпроект.

Паттерн проверен вживую на крупном рабочем проекте и прошёл несколько раундов состязательного разбора.

Ранее в v1.8/1.8.1: гигиена документации — рецепт «Один факт — один владелец», инвентаризация v2 (дубли устраняются, а не «актуализируются»), правило 8 «Профилактика на записи», документированный лимит памяти, dogfooding пакета. В v1.7: сеансовая эстафета, правило 7 «Надёжность доставки». В v1.6: параллельные агенты с watchdog. В v1.5: Anti-Hallucination протокол, унификация журнала ловушек, автономия агентов, агенты-персоны. В v1.4: непрерывность контекста. В v1.3: активация навыков. В v1.2: MCP-серверы. В v1.1: RTK-оптимизация.


Идея

Настройка Claude Code — через разговор с ним же.

Перед вами интерактивный AI-инсталлятор, написанный полностью на человеческом языке! Никакого кода, никаких скриптов и конфигов. Возможно, это первый в мире случай, когда README — и есть программа.

Запуск — файл START.md. Вы говорите Claude Code «прочитай его и проведи меня по настройке» — и дальше он сам читает инструкции, спрашивает о вашей работе, адаптирует примеры под вашу сферу и контекст, настраивает окружение шаг за шагом. Вы просто отвечаете на вопросы и одобряете результат. В любой момент можно прервать или отменить инсталляцию и потом к ней вернуться, ИИ запомнит, где вы остановились и какие настройки уже сделаны.

Весь пакет также написан при помощи Claude Code, с применением большинства описанных здесь практик.

На чём основано

Ежедневная работа с Claude Code на проектах, у которых нет ничего общего между собой: веб-платформы с полным циклом разработки, координированная настройка сетевой инфраструктуры, аудит веб-сайтов, сбор финансовой и бизнес-аналитики, тестирование корпоративной BPM-системы, юридическая практика, бухгалтерия. Разные домены сошлись на одних и тех же приёмах — это и есть критерий, по которому практика попадает в пакет.

Чтобы прийти к этому набору, пришлось пересмотреть десятки YouTube-роликов и разобраться:

  • как вести мега-сессии на десятки дней и не терять управление контекстом
  • как передавать состояние проекта между сессиями без обрыва нити
  • как запускать несколько AI-агентов на одну задачу с разными ролями
  • как строить автономную работу без участия оператора
  • как организовывать память проекта — так, чтобы он сам за собой следил

Что-то заработало с первого раза, что-то приходилось переделывать. В итоге здесь отобрано то, что реально работает на нескольких проектах одновременно. Работа над пакетом продолжается.

Что даёт

Без практик С практиками
AI не знает контекст — объясняете заново каждый раз CLAUDE.md хранит контекст, AI работает сразу
AI иногда додумывает то, чего нет Правила поведения требуют проверять факты
Один промпт — один запрос Агенты-специалисты решают типовые задачи
Контекст теряется между сессиями Память сохраняет решения и факты
После паузы — снова восстанавливать «где остановились» Сеансовая эстафета: новая сессия читает ядро за минуту и продолжает
Каждая задача — с нуля AI Factory: конвейер от исследования до результата

Настройка фундамента — 30 минут. Полный чеклист — 1-2 часа.


Быстрый старт

Требования:

  • Claude Code должен быть установлен. Если нет — инструкция
  • Рекомендуемая модель: Sonnet или выше. На модели Haiku настройка может работать менее точно

Шаг 1. Скачайте и распакуйте

Нажмите зелёную кнопку Code вверху этой страницы → Download ZIP.

Распакуйте архив куда удобно — на рабочий стол, в папку «Документы», на сетевой диск, куда угодно. Пакет — это справочник, а не программа. Ему не нужно быть в определённом месте.

Примечание: при распаковке ZIP с GitHub создаётся папка с суффиксом -main (например, claude-code-practices-main). Это нормально — внутри неё всё содержимое пакета.

Шаг 2. Откройте Claude Code в вашей рабочей папке

Откройте Claude Code в той папке, где вы обычно работаете — ваш проект, рабочие документы, данные. Это важно: настройка будет выполнена именно для этой папки.

Если вы уже запускаете Claude Code из определённой папки — запустите как обычно и переходите к шагу 3.

Если вы ещё не запускали Claude Code самостоятельно — попросите коллегу, который вам его показал, помочь с первым запуском в вашей рабочей папке. Это занимает 1 минуту. После первого раза вы будете запускать так же.

Для тех, кто знаком с терминалом — перейдите в папку проекта и запустите claude:

Windows (PowerShell):

cd "D:\Работа\Мой проект"
claude

macOS / Linux:

cd ~/my-project
claude

Шаг 3. Скажите Claude Code одну фразу

Скопируйте путь к файлу START.md из распакованной папки и скажите Claude Code:

Прочитай файл [путь к START.md] и проведи меня по настройке.

Как узнать путь к файлу:

  • Windows: откройте папку пакета в Проводнике, найдите файл START.md, кликните правой кнопкой → «Копировать как путь». Вставьте в Claude Code
  • macOS: перетащите файл START.md из Finder в окно терминала — путь вставится автоматически

Примеры (зависят от того, куда вы распаковали):

Прочитай файл D:\Загрузки\claude-code-practices-main\START.md и проведи меня по настройке.
Прочитай файл C:\Users\Марина\Desktop\claude-code-practices-main\START.md и проведи меня по настройке.

Что произойдёт дальше

Claude Code прочитает инструкцию и начнёт интерактивную настройку:

  • Спросит, чем вы занимаетесь (разработка, аналитика, документы...)
  • Адаптирует все примеры под вашу сферу
  • На каждом шаге объяснит, зачем это нужно
  • Вы решаете, что настроить сейчас, а что отложить на потом

Что создаёт пакет

Сам пакет остаётся справочником — его содержимое не изменяется. Все настройки создаются в других местах:

В вашей рабочей папке (откуда вы запустили Claude Code):

  • CLAUDE.md — файл с контекстом вашей работы. Claude Code читает его автоматически при каждом запуске
  • docs/SESSION-HANDOFF-*.md — эстафетные файлы, если включена практика сеансовой эстафеты (создаются в конце дня или при передаче проекта)

В настройках Claude Code (создаются автоматически, вам не нужно знать точный путь):

  • Агенты — специалисты под ваши задачи
  • Навыки — автоматические процедуры (вызываются командами типа /silent-mode)
  • Память — контекст, который сохраняется между запусками Claude Code
  • SessionStart hook — гарантирует, что критичный контекст загружается при старте каждой сессии

После настройки пакет можно удалить — все созданные настройки продолжат работать без него.


Что внутри пакета

claude-code-practices/
├── START.md              ← Точка входа — скажите Claude Code прочитать этот файл
├── recipes/              ← Рецепты: пошаговые инструкции для Claude Code
├── practices/            ← 9 практик: фоновое чтение, принципы и теория
├── VERSION.md            ← Версия и история изменений
└── README.md             ← Этот файл

recipes/ — главное содержимое. Claude Code читает рецепты и создаёт настройки под ваш контекст.

practices/ — дополнительное чтение о принципах работы с Claude Code. Полезно для понимания, но не обязательно для настройки.


Чеклист настройки

Уровень Шаг Что даёт
Фундамент CLAUDE.md AI знает контекст вашей работы
Фундамент Правила поведения AI проверяет факты, не выдумывает
Фундамент Голосовой ввод Скорость ввода x3-x5
Фундамент Разрешения Безопасность и скорость
Продуктивность Superpowers Дисциплина: думай → планируй → делай → проверяй
Продуктивность AI Factory Конвейер: исследование → план → реализация → обучение
Продуктивность Агенты Специалисты под ваши задачи
Продуктивность Память AI помнит между сессиями
Продуктивность Карта владельцев фактов Документация не протухает: один факт — один владелец
Продуктивность Параллельные подпроекты Общая память и правила, изолированный контекст на подпроект
Продуктивность Прогресс Не терять нить при длинной работе (закладка в книге)
Продуктивность Сеансовая эстафета Полный снимок состояния перед паузой/передачей (досье по делу)
Продуктивность Мультиагентная работа Несколько специалистов на одну задачу
Продуктивность TDD / Контракт Определи результат до начала работы
Продуктивность Инвентаризация Порядок в проекте, актуальный CLAUDE.md
Продуктивность Навыки Автоматические процедуры
Продуктивность MCP-серверы Доступ к документации, браузеру, БД
Масштабирование Тиринг моделей Контроль бюджета
Масштабирование RTK (токены) Экономия 50-90% токенов на командах

Экономия токенов — RTK

RTK — CLI-прокси, который сжимает вывод консольных команд перед попаданием в контекст Claude Code. Один бинарник, без зависимостей, задержка <10 мс.

Реальные результаты на React-проекте (5.8 МБ, 243 JSX-файла):

Операция Без RTK С RTK Экономия
Рекурсивный листинг каталога 39.8 КБ 0.2 КБ 99.5%
Поиск файлов (243 .jsx) 79.1 КБ 1.8 КБ 97.7%
Поиск по коду (grep) 64.3 КБ 0.6 КБ 99.0%
Чтение файла (aggressive) 5.4 КБ 1.2 КБ 77.8%

Подробнее: recipes/optimize-tokens.md

Ключевые принципы

  1. CLAUDE.md — главный актив. Минута на качество экономит часы.
  2. Правила > надежды. Пропишите поведение AI явно.
  3. Агенты > промпты. Настроенный агент лучше длинного промпта.
  4. Память > повторение. AI помнит контекст, а не вы пересказываете.
  5. Ответственность > угодливость. AI не должен молча делать глупость.
  6. Эстафета > перезапуск. Сессия передаёт состояние следующей, а не уходит в пустоту.
  7. Доставка > надежда. Критичные триггеры доставляются механизмом, а не одной строкой в CLAUDE.md.
  8. Один владелец > актуальные копии. Волатильный факт живёт в одном документе; копию нельзя актуализировать — её можно только устранить.

Несколько проектов

Пакет скачивается один раз. Для каждого проекта запускайте START.md отдельно — откройте Claude Code в папке нужного проекта и передайте путь к START.md. Claude Code создаст отдельные настройки для каждого проекта.

Обновление

  1. Скачайте новый ZIP с этой страницы
  2. Распакуйте в новую папку (старую можно удалить — ваши настройки хранятся отдельно)
  3. Запустите START.md в каждом проекте, указав путь к новой папке

Claude Code определит, что уже настроено, и предложит только новые практики. Существующие настройки не будут изменены без вашего согласия.

Удаление

Удалить пакет: просто удалите папку с пакетом (через Проводник, Finder или файловый менеджер). Это безопасно — ваши настройки продолжат работать.

Удалить созданные настройки (опционально): откройте Claude Code и скажите: «Удали из CLAUDE.md секции, которые были добавлены пакетом claude-code-practices. Также удали агентов, навыки и память, которые были созданы при настройке этого пакета. Мои собственные настройки не трогай». Claude Code найдёт блоки, помеченные меткой пакета, и удалит только их.


Обратная связь

Нашли ошибку или хотите предложить новую практику? Откройте Issue в этом репозитории.

About

Interactive AI installer for Claude Code: setup once, keep context across sessions, keep docs from rotting, work on subprojects in parallel with shared memory. Recipes + practices + adaptive checklist for any field — dev, analytics, legal, BPM. Written in human language. Russian.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors