This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

English

codeharness

codeharness — общий набор правил Claude Code для разных проектов, источник шаблонов, а не обычный прикладной репозиторий. Он определяет, как Claude должен себя вести в любом проекте, который его подключает: когда планировать перед действием, когда заводить issue, как коммитить, как сохранять состояние между сессиями и куда маршрутизировать задачу (inline / skill / agent).

Он не задуман для копирования «как есть» — каждый проект-потребитель адаптирует его под себя: что-то убирает, что-то дописывает.

Зачем он нужен

Держать все правила в одном CLAUDE.md не масштабируется — файл разрастается, и Claude вынужден грузить его целиком на каждую задачу. codeharness делит набор правил на два слоя:

• Ядро (CLAUDE.md) — грузится всегда. Короткая таблица-маршрутизатор («собираешься делать X — сначала открой файл Y») плюс горстка правил, применимых к любой задаче: цикл план → согласие → выполнение → проверка, язык, коммиты/push, персистентная память, секреты.
• Тематические файлы (.ai-workflow/*.md) — грузятся по требованию, только когда на них указывает таблица-маршрутизатор. Это и есть progressive disclosure: детали существуют, но не занимают контекст, пока реально не понадобились.

Таблица-маршрутизатор — в CLAUDE.md §0, единая точка входа. Полная таблица со ссылками на все файлы правил — на странице Карта файлов.

Для кого

Для тех, кто ведёт несколько проектов через Claude Code и хочет единого поведения агента — дисциплина issue, гигиена коммитов, передача состояния между сессиями, работа с секретами — без переписывания одних и тех же правил в CLAUDE.md каждого репозитория заново.

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

1. Прочитать Карту файлов — какие темы покрывает codeharness и где какой файл лежит в исходном репозитории.
2. Прочитать Подключение — как внедрить codeharness в новый проект (копирование/адаптация CLAUDE.md и .ai-workflow/, донастройка под проект). Важно: точный механизм подключения ещё дорабатывается апстримом — страница описывает текущий ручной подход.
3. Прочитать Процесс — рабочий цикл, который задаёт codeharness: план → согласие → issue → работа → проверка → ревью, SemVer-версионирование и маршрутизация задач.

Статус

codeharness версионируется по собственному правилу versioning.md: единый источник правды — файл VERSION, текущий релиз описан в CHANGELOG.md (смотреть там, чтобы вика не отставала при каждом bump).

CLAUDE.md и .ai-workflow/*.md сейчас ведутся только на русском — это задокументированное временное состояние (см. documentation.md); переход на английский запланирован отдельным осознанным батчем, не тихой перегенерацией.

Где живёт канон

Эта вики — материал для onboarding, не свод правил. Нормативный текст живёт в git-репозитории codeharness:

• Ядро: CLAUDE.md
• Тематические файлы: .ai-workflow/

При расхождении текста вики и репозитория побеждает репозиторий — ссылки прямо на исходники см. на странице Карта файлов.