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 пока не предписывает механизм подключения; см. примечание внизу.

Что копируется

Из репозитория codeharness в целевой проект:

• CLAUDE.md — ядро: таблица-маршрутизатор + универсальные правила.
• .ai-workflow/*.md — тематические файлы, на которые указывает таблица.

Оба предназначены для адаптации, а не копирования «как есть». Собственный README.md codeharness говорит прямо: это источник шаблонов, и каждый проект-потребитель донастраивает его индивидуально.

Процедура

1. Скопировать CLAUDE.md и .ai-workflow/ в корень целевого проекта (или туда, где ваша настройка Claude Code ожидает проектные инструкции — проверьте свою конфигурацию).
2. Убрать неприменимое. Не каждому проекту нужен каждый тематический файл — например, проекту без формальной спецификации не нужен подключённый spec-discipline.md (этот файл прямо помечен как условный — см. Карту файлов). Заодно убрать соответствующую строку из таблицы-маршрутизатора, чтобы она не указывала на удалённый файл.
3. Адаптировать проектно-специфичное.
   • issue-tracker.md рассчитан на трекер вида Forgejo/Gitea/GitHub (#N, closes #N, лейблы). Для проекта на Jira или аналоге файл нужно переписать — это прямо сказано в самом файле, он не универсален.
   • Роли веток (рабочая/release/default) должны быть явно задокументированы для проекта — codeharness не выводит их из названий веток.
   • Пути статус-файла и файла решений (.ai-workflow/memory/STATUS.md, .ai-workflow/memory/DECISIONS.md) — значения по умолчанию; проект может указать другие пути, если это явно зафиксировано.
4. Дописать недостающее. Если проект хочет принудительно контролировать маршрутизацию через hook, а не по договорённости, task-routing.md содержит опциональный шаблон hook (UserPromptSubmit/PreToolUse) — скопировать и адаптировать, он не обязателен.
5. Зафиксировать происхождение от codeharness, если это полезно для дальнейшего сопровождения — например строка в README проекта о том, что CLAUDE.md/.ai-workflow унаследованы от codeharness и примерно какой версии, чтобы будущие обновления можно было сверить с апстримом.
6. Проверить языковое состояние. На момент написания CLAUDE.md/ .ai-workflow codeharness — только на русском (временно, см. documentation.md). Если проекту нужны английские инструкции — это осознанный перевод на вашей стороне, не механическое копирование.

Чего codeharness пока не даёт

• Нет механизма симлинка/сабмодуля/пакета. codeharness не симлинкается и не копируется в ~/.claude автоматически, и нет устоявшегося механизма распространения обновлений (например «подтянуть новую версию git-discipline.md сразу в 6 проектов»). Это прямо сказано в собственном README codeharness: «механизм подключения к целевым проектам ещё не определён, обсуждается отдельно».
• Нет команды скаффолдинга. Пока нет генератора/init-скрипта, выполняющего шаги 1–4 за вас. Подключение — ручное копирование + правка.

Если вы настраиваете несколько проектов и часто повторяете эту процедуру — само повторение является сигналом для обсуждения механизма подключения апстрим; стоит завести issue в codeharness, а не решать это молча в каждом проекте по отдельности.

После подключения

Когда CLAUDE.md/.ai-workflow на месте, проект следует циклу, описанному на странице Процесс: план → согласие → issue → работа → проверка → ревью, с SemVer, применяемым к собственному VERSION проекта, независимо от версии codeharness.