contract: rewrite .meeting-room/CLAUDE.md — runtime only (step 5)
Removed: .brainstorm/.archive/ semantics, promote-brainstorm trigger, .wiki/concepts/ as workshop-domain. Added: handoff diagram with .workshop/, pointer to workshop-architecture.md, explicit boss-mode-not-here rule.
This commit is contained in:
55
CLAUDE.md
55
CLAUDE.md
@@ -1,38 +1,40 @@
|
||||
# .meeting-room — workspace contract
|
||||
|
||||
`.meeting-room/` — brainstorm-зона для кросс-проектных совещаний. **Не код-проект.**
|
||||
`.meeting-room/` — multi-agent runtime для кросс-проектных круглых столов: тематических совещаний с ролями, сценарием, транскриптом. **Не код-проект.**
|
||||
|
||||
Single-agent брэйнсторм + дистилляция — это `.workshop/` (отдельная зона после split'а 2026-05-08, см. `.wiki/concepts/meeting-room-architecture.md` §1, и `.workshop/.wiki/concepts/meeting-room-split.md` после промоушена).
|
||||
|
||||
## Семантика артефактов
|
||||
|
||||
| Папка | Что |
|
||||
|---|---|
|
||||
| `scenarios/` | runtime: сценарии запуска multi-agent совещания (frontmatter: `name`, `participants`, `problem`, `max_rounds`) |
|
||||
| `scenarios/<topic>.md` | runtime: сценарии запуска multi-agent совещания (frontmatter: `name`, `participants`, `problem`, `max_rounds`) |
|
||||
| `config/config.yaml` | runtime: реестр persona (single source of truth) |
|
||||
| `.brainstorm/<topic>.md` | рабочий буфер до промоушена |
|
||||
| `.archive/<date>-<topic>.md` | post-promotion: исходник из `.brainstorm/` |
|
||||
| `.wiki/raw/research/` | immutable: внешние clippings (бывший `source/`) |
|
||||
| `.wiki/raw/transcripts/` | immutable: транскрипты совещаний (бывший `sessions/`) |
|
||||
| `.wiki/raw/research/` | immutable: внешние clippings, релевантные совещанию |
|
||||
| `.wiki/raw/transcripts/` | immutable: транскрипты прошедших совещаний |
|
||||
| `.wiki/entities/persons/` | карточки persona, генерируются из `config.yaml` |
|
||||
| `.wiki/concepts/` | room-meta: методология, ретро, паттерны |
|
||||
| `.wiki/entities/projects/` | pointer-карточки целевых проектов |
|
||||
| `.wiki/concepts/` | room-meta: методология совещаний, ретро runtime'а |
|
||||
|
||||
**Перед предложением tooling/архитектуры — прочитать `.wiki/raw/research/` для текущего топика.** Это закрепляет урок из `feedback_read_source_transcripts.md` (память).
|
||||
**Перед предложением tooling/архитектуры — прочитать `.wiki/raw/research/` для текущего топика** (если research-материалы для совещания загружены).
|
||||
|
||||
## Жёсткие правила
|
||||
|
||||
1. **Доменное содержимое никогда не оседает в локальном `.wiki/`** — всегда в глобал через `mcp__projects-meta__knowledge_ingest` в `~/projects/<proj>/.wiki/`.
|
||||
2. **Локальный `.wiki/concepts/` — только room-meta** (про саму комнату).
|
||||
3. **Локальные `.tasks/` не создавать** — экшены идут в `.tasks/` целевого проекта через `mcp__projects-meta__tasks_create`.
|
||||
4. **`entities/persons/` пишет только скил `meeting-room-register-persona`.** SoT — `config/config.yaml`.
|
||||
5. **Domain-промоушен с импл-тасками автоматически создаёт review-чекпоинт.** Скил `meeting-room-promote-brainstorm` после успешного `tasks_create` импл-тасок дополнительно создаёт зонтичную `<topic>-review` (status=blocked, blocker=impl-slugs) в том же target-проекте. Reviewer — следующая сессия в target, **не имплементер** (борьба с «я только что это написал»-bias). Агент в `.meeting-room` сам код-ревью **не делает** — только генерирует review-таску при промоушене.
|
||||
1. **Доменное содержимое никогда не оседает в локальном `.wiki/`** — всегда в global через `mcp__projects-meta__knowledge_ingest` в `~/projects/<proj>/.wiki/`. Промоушен делается **из `.workshop/`** на основании дистилляционного буфера (см. handoff ниже).
|
||||
2. **Локальный `.wiki/concepts/` — только room-meta** (про runtime: methodology совещаний, ретро, паттерны фасилитации).
|
||||
3. **Локальные `.tasks/` не создавать** — workshop-meta таски (миграции, апгрейды скилов) живут в `.workshop/.tasks/`. Если runtime'у понадобятся свои таски — открыть отдельным решением.
|
||||
4. **`entities/persons/` пишет только скил `meeting-room-register-persona`.** SoT — `config/config.yaml`. Ручные правки только в `config.yaml`; регенерация карточки — снова `register-persona`.
|
||||
5. **Boss-режим (single-agent + user) сюда не приезжает.** Если возник полу-структурированный диалог требующий running-record `.brainstorm/<topic>.md` — переехать в `.workshop/`. Workshop делает дистилляцию транскриптов отсюда — пользовательским явным запросом, не автоматически.
|
||||
|
||||
## Триггеры скилов v1
|
||||
|
||||
| Скил | Триггер-фразы |
|
||||
|---|---|
|
||||
| `meeting-room-promote-brainstorm` | «промоутни брейнсторм», «finalize `<topic>`», «выкати в вики», «promote `<topic>`» |
|
||||
| `meeting-room-start-meeting` | «запусти совещание `<topic>`», «start meeting `<scenario>`», «новое совещание `<topic>`» |
|
||||
| `meeting-room-register-persona` | «добавь персону», «новый агент в комнату», «register persona `<role>`» |
|
||||
|
||||
Скил `workshop-promote-brainstorm` — в зоне `.workshop/`, не здесь. Дистилляция transcripts → концепт делается там.
|
||||
|
||||
## Override `project-discipline`
|
||||
|
||||
В этой комнате применяются:
|
||||
@@ -42,14 +44,31 @@
|
||||
|
||||
**Не применяются:**
|
||||
|
||||
- ❌ semver-bump — нет versioned-артефактов (`SKILL.md` без version в frontmatter, нет `package.json`/`pyproject.toml`)
|
||||
- ❌ локальный `.tasks/` — запрещён правилом §3 выше
|
||||
- ❌ semver-bump — нет versioned-артефактов (`SKILL.md` скилов живут в `~/projects/claude-skills/`, у них свой semver)
|
||||
- ❌ локальный `.tasks/` — запрещён правилом §3
|
||||
|
||||
## Handoff с `.workshop/`
|
||||
|
||||
```
|
||||
.meeting-room/.wiki/raw/transcripts/<date>-<topic>.md ← runtime артефакт
|
||||
│
|
||||
│ user явно: «дистиллируй транскрипт <topic>»
|
||||
▼
|
||||
.workshop/.brainstorm/<topic>-distill.md
|
||||
│
|
||||
│ workshop-promote-brainstorm
|
||||
▼
|
||||
target (workshop-meta / domain via projects-meta / skill)
|
||||
```
|
||||
|
||||
Никакого автоматического hop'а. Multi-agent runtime производит сырьё (транскрипт), workshop производит дистилляты. Два разных режима, не смешиваются.
|
||||
|
||||
## Persona registry
|
||||
|
||||
SoT — `config/config.yaml`. Карточки `.wiki/entities/persons/<role-id>.md` — производные. Ручные правки разрешены **только** в `config.yaml`. Регенерация карточки — снова `meeting-room-register-persona <role-id>`.
|
||||
SoT — `config/config.yaml`. Карточки `.wiki/entities/persons/<role-id>.md` — производные.
|
||||
|
||||
## Pointers
|
||||
|
||||
- Schema локальной вики: `.wiki/CLAUDE.md`
|
||||
- Архитектура комнаты: `.wiki/concepts/meeting-room-architecture.md`
|
||||
- Архитектура runtime'а: `.wiki/concepts/meeting-room-architecture.md`
|
||||
- Архитектура boss-зоны: `.workshop/.wiki/concepts/workshop-architecture.md`
|
||||
|
||||
Reference in New Issue
Block a user