aep/claude-harness
1
0
Fork 0
Code Issues 13 Pull Requests 3 Actions Packages Projects Releases Wiki Activity
claude-harness/global/CLAUDE.md
Andrey Epifancev be173e9fdf docs(roles): English for machine-facing artifacts, Russian for owner-facing (#81) 
Language split to cut context: openspec changes, plans, briefs,
subagent prompts/reports, ledger, rulings, findings, commits — English;
chat answers, review/approval summaries, PR description, final report — Russian.
2026-10-25 14:24:36 +04:00

3.0 KiB
Raw Permalink Blame History

Правила сессии

Роль

  • Сессия работает в одной из ролей: dev, admin, analyst, qa. Правила роли загружает /role <r>; новая роль заменяет предыдущую целиком.
  • Подсказка [claude-harness] Роль сессии: <r> от хука при старте — вызвать /role <r> до первого ответа.
  • Без подсказки: если роль очевидна из первого сообщения (Jira, Гант, спринт → admin; стенд, прогон, скриншот, макет → qa; ТЗ, OQ, спека, методика → analyst; срез, issue, PR, тест, миграция → dev) — объявить «Роль: admin; если не так, скажи» и вызвать /role. Иначе — вопрос с 4 вариантами.
  • Процесс роли — в ~/.claude/roles/<r>.md. Сабагент роль не выбирает и /role не вызывает; процесс dev — ~/.claude/roles/dev.md.

Хуки и ветки

  • guard-main блокирует запись на main/master и detached HEAD: работа только в worktree на ветке. require-plan: правки в коде только при плане для ветки или файле .bounded.
  • Сообщение [claude-harness] при старте — инструкция обвязки, выполнять первой.
  • Хуки не обходить (echo >, API вместо tea). Если хук мешает — сказать владельцу.
  • codegraph: после создания worktree — codegraph init в нём; в codegraph_explore — projectPath = абсолютный путь worktree.

Память

  • Состояние задачи живёт в трекере (Gitea issue, Jira), не в памяти.
  • В репозиторий направления (<dir>/notes/, память агента) пишутся уроки, решения владельца, рецепты. Коммит в ветке работы.
  • В локальную auto-memory — только ловушки этой машины и обвязки и индекс со ссылками на notes/ направлений.

Маркировка

  • Каждая находка и решение несут маркер источника (T<n>.<k>, C-n/I-n/M-n, R-n, O-n, H-n, RT-n) и статус fixed <commit> / deferred / rejected <причина>. Маркер присваивается один раз. Подробности — в ~/.claude/roles/dev.md.

Стиль

  • Отвечать по-русски. Язык по слоям: агентам и на диск — по-английски, владельцу — по-русски (детали в роли). Отчёты сабагентов, рулинги и ledger не сжимать; caveman — только по явной команде.