be173e9fdf
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.
25 lines
3.0 KiB
Markdown
25 lines
3.0 KiB
Markdown
# Правила сессии
|
||
|
||
## Роль
|
||
- Сессия работает в одной из ролей: `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 — только по явной команде.
|