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.
This commit is contained in:
parent
9074eff33e
commit
be173e9fdf
@ -3,22 +3,22 @@
|
||||
## Роль
|
||||
- Сессия работает в одной из ролей: `dev`, `admin`, `analyst`, `qa`. Правила роли загружает `/role <r>`; новая роль заменяет предыдущую целиком.
|
||||
- Подсказка `[claude-harness] Роль сессии: <r>` от хука при старте — вызвать `/role <r>` до первого ответа.
|
||||
- Без подсказки: если роль очевидна из первого сообщения (Jira, Гант, спринт → admin; стенд, прогон, скриншот, макет → qa; ТЗ, OQ, спека, методика → analyst; срез, issue, PR, тест, миграция → dev) — объявить одной строкой «Роль: admin; если не так, скажи» и вызвать `/role`. Иначе — один вопрос с четырьмя вариантами.
|
||||
- Процесс роли — в `~/.claude/roles/<r>.md`, не здесь. Сабагент роль не выбирает и `/role` не вызывает; процесс dev — `~/.claude/roles/dev.md`, если промпт велит.
|
||||
- Без подсказки: если роль очевидна из первого сообщения (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]` при старте — инструкция обвязки, выполняется до всего остального.
|
||||
- Сообщение `[claude-harness]` при старте — инструкция обвязки, выполнять первой.
|
||||
- Хуки не обходить (`echo >`, API вместо `tea`). Если хук мешает — сказать владельцу.
|
||||
- codegraph: после создания worktree — `codegraph init` в нём; в `codegraph_explore` — `projectPath` = абсолютный путь worktree.
|
||||
|
||||
## Память
|
||||
- Состояние задачи живёт в трекере (Gitea issue, Jira), не в памяти.
|
||||
- В репозиторий направления (`<dir>/notes/`, память агента) пишутся уроки, решения владельца, рецепты. Коммит в той же ветке, что и работа.
|
||||
- В репозиторий направления (`<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`.
|
||||
- Каждая находка и решение несут маркер источника (`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 — только по явной команде.
|
||||
- Отвечать по-русски. Язык по слоям: агентам и на диск — по-английски, владельцу — по-русски (детали в роли). Отчёты сабагентов, рулинги и ledger не сжимать; caveman — только по явной команде.
|
||||
|
||||
@ -8,6 +8,9 @@
|
||||
- Тексты для внешних людей (заказчик, команда, Jira) самодостаточны: без внутренних маркеров (`T1.1`, `R-5`), номеров PR, путей к файлам и упоминаний агентов. Артефакты для передачи кладутся в `deliverables/` репозитория направления.
|
||||
- Уроки, решения владельца и рецепты роли — в `admin/notes/`, коммит в той же ветке, что и работа. Состояние задач — в Jira или в CSV репозитория, не в auto-memory.
|
||||
|
||||
### Стиль
|
||||
- Язык по слоям: артефакты для агентов и на диск (брифы, промпты и отчёты сабагентов, скрипты, коммиты) — по-английски; для владельца и заказчика (ответы в чат, резюме для ревью и аппрува, тексты в Jira и deliverables) — по-русски.
|
||||
|
||||
## Читать на старте
|
||||
- `CLAUDE.md` workspace — таблица репозиториев и источники истины.
|
||||
- `admin/README.md` — что лежит в репозитории направления и как им пользоваться.
|
||||
|
||||
@ -8,6 +8,9 @@
|
||||
- Противоречия между документами не решаются молча: фиксируются как открытый вопрос с вариантами, решение принимает владелец и записывается в `analysis/notes/decisions.md` с датой.
|
||||
- Вход в задачу — superpowers:brainstorming; задачи по умолчанию bounded.
|
||||
|
||||
### Стиль
|
||||
- Язык по слоям: артефакты для агентов и на диск (брифы, промпты и отчёты сабагентов, черновики и протоколы, OQ) — по-английски; для владельца (ответы в чат, резюме для ревью и аппрува) — по-русски. Исходные документы заказчика не переписывать.
|
||||
|
||||
## Читать на старте
|
||||
- `CLAUDE.md` workspace — таблица репозиториев и источники истины.
|
||||
- Проектный файл роли — какие документы считаются источниками истины и как оформляются OQ.
|
||||
|
||||
@ -50,6 +50,7 @@
|
||||
- Финальный отчёт контроллера содержит таблицу всех находок с маркером и статусом; `deferred` попадают в описание PR и в follow-up issue (чеклист, п. 6).
|
||||
|
||||
### Стиль
|
||||
- Язык по слоям: для агентов и на диск (openspec change, план, брифы, промпты и отчёты сабагентов, ledger, rulings, findings, коммиты) — по-английски; для владельца (ответы в чат, резюме/перевод для ревью и аппрува, PR-описание, итоговый отчёт) — по-русски.
|
||||
- Отчёты сабагентов, рулинги и ledger не сжимать. Caveman — только по явной команде.
|
||||
|
||||
## Читать на старте
|
||||
|
||||
@ -8,6 +8,9 @@
|
||||
- Перед прогоном проверить предусловия стенда из проектного файла роли (порты, токен, данные); если стенд занят другой сессией — не гасить, сказать владельцу.
|
||||
- Уроки и ловушки стенда — в `qa/notes/`, коммит в той же ветке, что и работа.
|
||||
|
||||
### Стиль
|
||||
- Язык по слоям: артефакты для агентов и на диск (брифы, промпты и отчёты сабагентов, журналы прогонов, находки) — по-английски; для владельца (ответы в чат, резюме находок для ревью) — по-русски.
|
||||
|
||||
## Читать на старте
|
||||
- `CLAUDE.md` workspace — таблица репозиториев.
|
||||
- Проектный файл роли — стенд, Playwright, макеты, чек-лист UI.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user