Skip to content

kydechuk01/claude-code-practices

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Claude Code Practices

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

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

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

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

Релиз посвящён гигиене документации — болезни, которая поражает любой зрелый проект: пересказ изменчивого факта (версия, статус, текущая фаза) в «стабильном» документе протухает за дни и начинает дезинформировать AI. Аудит зрелого проекта через 3 месяца работы по пакету нашёл ~80 дефектов — все критичные имели одну природу. Валидация на четырёх других контекстах (включая сам пакет) подтвердила: болезнь воспроизводится везде, где факт живёт в двух местах.

  • Новый рецепт «Один факт — один владелец» (fact-ownership.md) — карта владельцев: каждый класс изменчивых фактов живёт ровно в одном документе, остальные ссылаются без пересказа значения. Формула: копия не бывает актуальной — либо ссылка, либо дефект. Плюс самопроверка документации: от ручной проверки по запросу до скрипта инвариантов (для разработчиков).
  • Инвентаризация v2 — главная правка существующего рецепта: дубли изменчивых фактов теперь устраняются, а не «актуализируются». Старый промпт сам был анти-паттерном: исполнитель добросовестно обновлял копию — и она протухала снова. Плюс машинная самопроверка прежде глаз, регресс-трекинг отчётов, явный мандат исполнителя.
  • Правило 8 «Профилактика на записи > периодическая уборка» — у повторяющегося дефекта документации есть событие-источник; чек-лист из 3 строк на событии закрывает кран, уборка только выгребает лужу.
  • Документированный лимит памяти: Claude Code загружает первые 200 строк или 25 KB файла MEMORY.md — что наступит раньше, хвост обрезается молча. На зрелом проекте так незаметно потерялись 8 записей с действующими правилами.
  • Гигиена агентов — факты среды не хардкодить: на проекте бухгалтерской аналитики налоговая ставка, зашитая в трёх агентах, устарела при смене регионального закона — агенты продолжали уверенно советовать по старой.
  • Dogfooding: сам пакет вылечен по собственному рецепту — версия живёт только в VERSION.md, счётчик рецептов только в README.

Ранее в 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. Recipes + practices + adaptive checklist for any field — dev, analytics, legal, BPM. Written in human language. Russian.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors