diff --git a/global/CLAUDE.md b/global/CLAUDE.md index 04ccd7a..9541a90 100644 --- a/global/CLAUDE.md +++ b/global/CLAUDE.md @@ -3,22 +3,22 @@ ## Роль - Сессия работает в одной из ролей: `dev`, `admin`, `analyst`, `qa`. Правила роли загружает `/role `; новая роль заменяет предыдущую целиком. - Подсказка `[claude-harness] Роль сессии: ` от хука при старте — вызвать `/role ` до первого ответа. -- Без подсказки: если роль очевидна из первого сообщения (Jira, Гант, спринт → admin; стенд, прогон, скриншот, макет → qa; ТЗ, OQ, спека, методика → analyst; срез, issue, PR, тест, миграция → dev) — объявить одной строкой «Роль: admin; если не так, скажи» и вызвать `/role`. Иначе — один вопрос с четырьмя вариантами. -- Процесс роли — в `~/.claude/roles/.md`, не здесь. Сабагент роль не выбирает и `/role` не вызывает; процесс dev — `~/.claude/roles/dev.md`, если промпт велит. +- Без подсказки: если роль очевидна из первого сообщения (Jira, Гант, спринт → admin; стенд, прогон, скриншот, макет → qa; ТЗ, OQ, спека, методика → analyst; срез, issue, PR, тест, миграция → dev) — объявить «Роль: admin; если не так, скажи» и вызвать `/role`. Иначе — вопрос с 4 вариантами. +- Процесс роли — в `~/.claude/roles/.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), не в памяти. -- В репозиторий направления (`/notes/`, память агента) пишутся уроки, решения владельца, рецепты. Коммит в той же ветке, что и работа. +- В репозиторий направления (`/notes/`, память агента) пишутся уроки, решения владельца, рецепты. Коммит в ветке работы. - В локальную auto-memory — только ловушки этой машины и обвязки и индекс со ссылками на `notes/` направлений. ## Маркировка -- Каждая находка и каждое решение несёт маркер источника (`T.`, `C-n`/`I-n`/`M-n`, `R-n`, `O-n`, `H-n`, `RT-n`) и статус `fixed ` / `deferred` / `rejected <причина>`. Маркер присваивается один раз. Подробности — в `~/.claude/roles/dev.md`. +- Каждая находка и решение несут маркер источника (`T.`, `C-n`/`I-n`/`M-n`, `R-n`, `O-n`, `H-n`, `RT-n`) и статус `fixed ` / `deferred` / `rejected <причина>`. Маркер присваивается один раз. Подробности — в `~/.claude/roles/dev.md`. ## Стиль -- Отвечать по-русски. Отчёты сабагентов, рулинги и ledger не сжимать; caveman — только по явной команде. +- Отвечать по-русски. Язык по слоям: агентам и на диск — по-английски, владельцу — по-русски (детали в роли). Отчёты сабагентов, рулинги и ledger не сжимать; caveman — только по явной команде. diff --git a/roles/admin.md b/roles/admin.md index 8b22763..659bb43 100644 --- a/roles/admin.md +++ b/roles/admin.md @@ -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` — что лежит в репозитории направления и как им пользоваться. diff --git a/roles/analyst.md b/roles/analyst.md index ed38718..6f8d1b4 100644 --- a/roles/analyst.md +++ b/roles/analyst.md @@ -8,6 +8,9 @@ - Противоречия между документами не решаются молча: фиксируются как открытый вопрос с вариантами, решение принимает владелец и записывается в `analysis/notes/decisions.md` с датой. - Вход в задачу — superpowers:brainstorming; задачи по умолчанию bounded. +### Стиль +- Язык по слоям: артефакты для агентов и на диск (брифы, промпты и отчёты сабагентов, черновики и протоколы, OQ) — по-английски; для владельца (ответы в чат, резюме для ревью и аппрува) — по-русски. Исходные документы заказчика не переписывать. + ## Читать на старте - `CLAUDE.md` workspace — таблица репозиториев и источники истины. - Проектный файл роли — какие документы считаются источниками истины и как оформляются OQ. diff --git a/roles/dev.md b/roles/dev.md index b231851..38cd5bb 100644 --- a/roles/dev.md +++ b/roles/dev.md @@ -50,6 +50,7 @@ - Финальный отчёт контроллера содержит таблицу всех находок с маркером и статусом; `deferred` попадают в описание PR и в follow-up issue (чеклист, п. 6). ### Стиль +- Язык по слоям: для агентов и на диск (openspec change, план, брифы, промпты и отчёты сабагентов, ledger, rulings, findings, коммиты) — по-английски; для владельца (ответы в чат, резюме/перевод для ревью и аппрува, PR-описание, итоговый отчёт) — по-русски. - Отчёты сабагентов, рулинги и ledger не сжимать. Caveman — только по явной команде. ## Читать на старте diff --git a/roles/qa.md b/roles/qa.md index 94ab4b7..1ea6576 100644 --- a/roles/qa.md +++ b/roles/qa.md @@ -8,6 +8,9 @@ - Перед прогоном проверить предусловия стенда из проектного файла роли (порты, токен, данные); если стенд занят другой сессией — не гасить, сказать владельцу. - Уроки и ловушки стенда — в `qa/notes/`, коммит в той же ветке, что и работа. +### Стиль +- Язык по слоям: артефакты для агентов и на диск (брифы, промпты и отчёты сабагентов, журналы прогонов, находки) — по-английски; для владельца (ответы в чат, резюме находок для ревью) — по-русски. + ## Читать на старте - `CLAUDE.md` workspace — таблица репозиториев. - Проектный файл роли — стенд, Playwright, макеты, чек-лист UI.