spec: split meeting-room-architecture (runtime-only rewrite, step 4 / part B)

Boss-zone sections moved to .workshop/.wiki/concepts/workshop-architecture.md
(commit aa263fd in workshop repo). Full original spec preserved in git history
prior to this commit.

Also: log.md entries for the split event and this rewrite.

Untracked: .brainstorm/, .wiki/raw/naming/ — these are originals still here,
removal scheduled for step 13 (final split-done commit).
This commit is contained in:
2026-05-08 06:16:04 +03:00
parent 78444f9ef3
commit 4686f53283
2 changed files with 73 additions and 157 deletions

View File

@@ -3,131 +3,83 @@ date: 2026-05-05
source: .brainstorm/meeting-room-redesign.md
status: promoted
type: room-meta
amended: 2026-05-08 (split-rewrite — runtime only, boss-зона выделена в .workshop/.wiki/concepts/workshop-architecture.md)
---
# Meeting-Room Architecture — promoted spec
# Meeting-Room Architecture — promoted spec (runtime-only post-split)
> Промочено 2026-05-05 из `.brainstorm/meeting-room-redesign.md`. Spec, который комната провалидировала на самой себе: первый прогон скила `meeting-room-promote-brainstorm` сделан именно над этим файлом. Implementation plan архивирован отдельно — `.archive/2026-05-05-meeting-room-redesign-plan.md`.
> Промочено 2026-05-05 из `.brainstorm/meeting-room-redesign.md`. Spec, который комната провалидировала на самой себе: первый прогон скила `meeting-room-promote-brainstorm` сделан над этим файлом. Implementation plan архивирован отдельно — `.archive/2026-05-05-meeting-room-redesign-plan.md`.
>
> **2026-05-08 split-rewrite:** комната разделена на multi-agent runtime (`.meeting-room/`, эта зона) и single-agent boss-zone (`.workshop/`). Из текущего документа удалены boss-секции (`.brainstorm/`, `.archive/`, `promote-brainstorm`-скил, single-agent CSO в lifecycle, room-meta concepts) — они переехали в `.workshop/.wiki/concepts/workshop-architecture.md`. Полная исходная версия доступна в git-истории (см. commit перед 2026-05-08). Мотивация и протокол split'а: `.workshop/.wiki/concepts/meeting-room-split.md` (после step #12 миграции).
## 1. Контекст
`.meeting-room/` сейчас объявлена транзитной зоной (`README.md`: «❌ NO `.tasks`/`.wiki` внутри»). На практике:
`.meeting-room/` — multi-agent runtime для срежиссированных круглых столов: тематических совещаний с ролями (analyst, skeptic, idea_generator, moderator …), сценарием и транскриптом. Не код-проект.
- В `.brainstorm/modulair-rag.md` уже копится содержательный артефакт прошедшей сессии — ему некуда уехать кроме `.archive/` или ручного копирования в глобал.
- Реестр персон (`config/config.yaml`) — операционный конфиг без человекочитаемого вики-слоя.
- Два типа сырья (pre-loaded research в `source/` и транскрипты в `sessions/`) разнесены по плоским папкам без общей семантики.
- В памяти `MEMORY.md` есть открытый todo `project_extend_discipline_for_meeting_room.md``project-discipline` молчит про brainstorm-workspace.
Цель редизайна — достроить комнату как **«микро-проект про методологию совещаний»** без превращения её в полноценный проект с локальным backlog. Опереться на Karpathy LLM Wiki pattern для структуры знаний и на `projects-meta` для связи с глобальным скоупом.
Зона выделена под темы, которые выигрывают от **многопозиционного спора** (architect vs implementer vs PM, или иные оппозиции). Single-agent + user брэйнсторм без режиссуры — другой режим, живёт в `.workshop/`. Дистилляция транскрипт → концепт — отдельный явный handoff в `.workshop/`.
## 2. Принятые решения
| # | Развилка | Решение |
|---|---|---|
| 1 | Wiki/Tasks семантика | **B**: локальный `.wiki/` есть, локальных `.tasks/` нет |
| 2 | Folder-миграция | **1 (чистый Karpathy)**: всё «сырое» централизовано в `.wiki/raw/` |
| 3 | Промоушен | **C**: локальный `.wiki/concepts/` зарезервирован под room-meta; доменное идёт сразу в глобал, без hop |
| 4 | Судьба буфера после промоушена | **(ii)**: `.brainstorm/<topic>.md``.archive/<date>-<topic>.md` |
| 5 | Skill v1 | `promote-brainstorm`, `start-meeting`, `register-persona` |
| 6 | Persona sync | **α**: писать в обе стороны имеет право только `register-persona`; `config.yaml` — SoT |
| 7 | Project-discipline | master-only ✅, push-by-permission ✅, semver — N/A, локальные tasks — N/A |
| 8 | Spec этого редизайна | живёт здесь, после сборки промоутим своей же системой в `.wiki/concepts/meeting-room-architecture.md` |
| 1 | Wiki/Tasks семантика | локальный `.wiki/` есть (room-meta), локальный `.tasks/` нет (запрещён §3 в `CLAUDE.md`) |
| 2 | Folder-миграция | Karpathy-канон: всё «сырое» в `.wiki/raw/`, скилы — в `~/projects/claude-skills/` |
| 3 | Skills v1 | `meeting-room-start-meeting`, `meeting-room-register-persona` (boss-скил `workshop-promote-brainstorm` выделен в workshop-зону) |
| 4 | Persona sync | писать в `entities/persons/` имеет право только `register-persona`; `config/config.yaml` — SoT |
| 5 | Project-discipline | master-only ✅, push-by-permission ✅, semver — N/A, локальные tasks — N/A (запрет §3) |
## 3. Целевая структура
```
.meeting-room/
├── CLAUDE.md корневой контракт работы в комнате (см. §6)
├── README.md ← обновлённый, ссылка на CLAUDE.md и .wiki/
├── CLAUDE.md корневой контракт зоны
├── README.md
├── .wiki/ ← Karpathy-canonical, room-meta only
│ ├── CLAUDE.md ← вики-схема (см. §7)
│ ├── index.md ← навигация
│ ├── overview.md ← что такое meeting-room
│ ├── log.md ← хронологический лог: meetings, promotions, persona changes
│ ├── raw/
│ │ ├── README.md
│ │ ├── research/ ← бывший source/: pre-loaded clippings, транскрипты внешних чатов
│ │ └── transcripts/ ← бывший sessions/: транскрипты прошедших совещаний
│ ├── entities/
│ │ ├── persons/ ← карточки persona (генерируются из config.yaml)
│ │ └── projects/ ← pointer-карточки для целевых проектов (modulair-rag, books, …)
│ ├── concepts/ ← room-meta: методология, ретроспективы, паттерны
│ ├── packages/ ← инструменты комнаты (runner, framework, schema)
│ └── sources/ ← внешняя литература (Karpathy gist, фасилитация, multi-agent)
├── scenarios/<topic>.md runtime: frontmatter сценариев multi-agent
├── config/config.yaml runtime: реестр persona (SoT)
── scenarios/ ← runtime: frontmatter-сценарии для запуска multi-agent
├── config/ ← runtime: config.yaml — single source of truth для persona
├── .brainstorm/ ← рабочий буфер: черновики, single-agent capture
├── .archive/ ← post-promotion: исходники из .brainstorm/, старые сценарии
└── .claude/ ← локальные скилы и settings.local.json
── skills/
├── meeting-room/
── promote-brainstorm/SKILL.md
│ ├── start-meeting/SKILL.md
── register-persona/SKILL.md
── .wiki/ Karpathy-canonical, room-meta only
├── CLAUDE.md wiki-схема
├── index.md
├── overview.md
├── log.md append-only хроника
── raw/
├── README.md
── transcripts/<date>-<topic>.md immutable: транскрипты совещаний
├── entities/
── persons/<role-id>.md карточки персон (генерируются)
│ └── projects/<proj>.md pointer-карточки целевых проектов
└── concepts/<topic>.md room-meta: методология, ретро runtime'а
```
**Различие `.wiki/raw/` ↔ `.brainstorm/`:** raw — immutable, append-only, сырое. `.brainstorm/` — рабочий, редактируемый, чистится промоушеном.
**Boss-артефакты (`.brainstorm/`, `.archive/`, дистилляция, методология одиночного мышления) — в `.workshop/`, не здесь.**
**Различие `.wiki/concepts/` ↔ `~/projects/.wiki/concepts/`:** локальный — только про **то, как комната работает**. Глобал — доменное содержимое, рождённое в комнате.
## 4. Lifecycle
## 4. Lifecycle (runtime-only)
```
PRE-MEETING
user clip → .wiki/raw/research/<date>-<topic>.md
user writes → scenarios/<topic>.md (frontmatter: name, participants, problem)
user clip → .meeting-room/.wiki/raw/research/<date>-<topic>.md
(если research-материал, релевантный совещанию)
user writes → scenarios/<topic>.md (frontmatter: name, participants, problem, max_rounds)
MEETING
start-meeting <s> → создаёт .wiki/raw/transcripts/<date>-<topic>.md (skeleton)
создаёт .brainstorm/<topic>.md (shell)
логирует в .wiki/log.md
meeting-room- → создаёт .wiki/raw/transcripts/<date>-<topic>.md (skeleton)
start-meeting логирует в .wiki/log.md
multi-agent run → дописывает транскрипт в .wiki/raw/transcripts/<date>-<topic>.md
single-agent CSO → ведёт активный диалог в .brainstorm/<topic>.md
POST-MEETING
promote-brainstorm → парсит .brainstorm/<topic>.md
спрашивает: room-meta или domain?
room-meta → .wiki/concepts/<topic>.md
domain → ~/projects/<proj>/.wiki/concepts/<topic>.md
via mcp__projects-meta__knowledge_ingest
парсит action-items, создаёт в .tasks/ target-проекта
via mcp__projects-meta__tasks_create
git mv .brainstorm/<topic>.md → .archive/<date>-<topic>.md
логирует в .wiki/log.md
POST-MEETING (handoff в .workshop/)
user явно: «дистиллируй транскрипт <topic>»
→ boss создаёт .workshop/.brainstorm/<topic>-distill.md
→ workshop-promote-brainstorm дальше
```
**Без автоматического hop'а в workshop.** Транскрипт остаётся как primary артефакт runtime'а; распаковка в концепт — явный шаг человека.
## 5. Skills v1
Каждый скил живёт в `.claude/skills/meeting-room/<name>/SKILL.md`. Триггер-фразы — в frontmatter `description`, чтобы автодиспетчер их подхватывал.
Скилы живут в `~/projects/claude-skills/skills/`, не локально. Триггер-фразы — в SKILL.md frontmatter.
### 5.1 `meeting-room:promote-brainstorm`
**Триггеры:** «промоутни брейнсторм», «finalize `<topic>`», «выкати в вики», «promote `<topic>`».
**Аргумент:** путь к файлу `.brainstorm/<topic>.md` или topic-name.
**Интерактивные шаги:**
1. Прочитать файл, показать summary (12 абзаца).
2. Спросить: **room-meta** или **domain**?
3. Если domain — спросить целевой проект; валидация `~/projects/<proj>/` существует и виден `projects-meta`.
4. Распарсить action-items (checkbox `- [ ]`, секции «TODO», «следующие шаги», «next steps»). Показать список, дать отредактировать.
**Действия (в порядке, atomic-ish):**
1. **Промоушен контента:**
- room-meta: `Write``.wiki/concepts/<topic>.md` с frontmatter (`date`, `source: .brainstorm/<topic>.md`, `status: promoted`).
- domain: `mcp__projects-meta__knowledge_ingest` с target-проектом и контентом.
2. **Создание тасок:** для каждого action-item — `mcp__projects-meta__tasks_create` с target-проектом, title, description.
3. **Архивация:** `git mv .brainstorm/<topic>.md .archive/<YYYY-MM-DD>-<topic>.md`.
4. **Лог:** дописать строку в `.wiki/log.md`: `<date> promoted <topic> → <destination>; created N tasks in <proj>`.
**Failure modes:**
- Целевой проект не найден / `projects-meta` недоступен → abort до любых записей.
- Промоушен прошёл, `tasks_create` упал на N-м экшене → продолжить, в логе зафиксировать частичный успех; `.brainstorm/` **не** перемещать пока пользователь не подтвердит.
- Файла `.brainstorm/<topic>.md` нет → abort, ничего не делать.
### 5.2 `meeting-room:start-meeting`
### 5.1 `meeting-room-start-meeting`
**Триггеры:** «запусти совещание `<topic>`», «start meeting `<scenario>`», «новое совещание `<topic>`».
@@ -135,97 +87,59 @@ POST-MEETING
**Шаги:**
1. Прочитать `scenarios/<topic>.md`, распарсить YAML frontmatter.
2. Валидация:
- `name`, `problem` непустые;
- все `participants` присутствуют как роли в `config/config.yaml`;
- `max_rounds` — целое (если есть).
3. Сегодняшняя дата → `<date> = YYYY-MM-DD`.
4. Создать `.wiki/raw/transcripts/<date>-<topic>.md` со скелетом (frontmatter: `date`, `scenario: scenarios/<topic>.md`, `participants`, `problem`).
5. Создать `.brainstorm/<topic>.md` со skeleton (заголовок, ссылки на сценарий и транскрипт).
6. Дописать в `.wiki/log.md`: `<date> started <topic> ({participants})`.
7. Вернуть пользователю созданные пути и подсказку, как запустить multi-agent runner.
2. Валидация: `name`, `problem` непустые; все `participants` — роли в `config/config.yaml`; `max_rounds` целое (если есть).
3. `<date> = YYYY-MM-DD`.
4. Создать `.wiki/raw/transcripts/<date>-<topic>.md` (frontmatter: `date`, `scenario`, `participants`, `problem`).
5. Дописать в `.wiki/log.md`: `<date> started <topic> ({participants})`.
6. Вернуть пользователю созданный путь и подсказку, как запустить multi-agent runner.
**Failure modes:**
- Frontmatter невалидный → перечислить ошибки, ничего не создавать.
- `.brainstorm/<topic>.md` уже есть → спросить: продолжить (append-skip) или прервать.
- `.wiki/raw/transcripts/<date>-<topic>.md` уже есть → спросить: продолжить (append-skip) или прервать.
### 5.3 `meeting-room:register-persona`
### 5.2 `meeting-room-register-persona`
**Триггеры:** «добавь персону», «новый агент в комнату», «register persona `<role>`».
**Интерактивный сбор полей:**
- `role-id` (snake_case, уникальный)
- `name` (display)
- `model`, `provider`, `temperature`, `tools`, `system_prompt`
- `name`, `model`, `provider`, `temperature`, `tools`, `system_prompt`
**Шаги:**
1. Прочитать `config/config.yaml`. Если `roles.<role-id>` существует — спросить: overwrite, abort, новый id.
2. Обновить `config.yaml`, **сохраняя YAML-форматирование** (использовать YAML-парсер с round-trip — иначе комментарии и порядок ключей побьются).
3. Сгенерировать `.wiki/entities/persons/<role-id>.md` с frontmatter (`role-id`, `model`, `provider`, `source: config/config.yaml`) и body summary поведения роли, цитата `system_prompt`, ссылка на `config.yaml`.
2. Обновить `config.yaml`, **сохраняя YAML-форматирование** (round-trip парсер — иначе комментарии и порядок ключей побьются).
3. Сгенерировать `.wiki/entities/persons/<role-id>.md` с frontmatter (`role-id`, `model`, `provider`, `source: config/config.yaml`) и body: summary поведения, цитата `system_prompt`, ссылка на `config.yaml`.
4. Дописать в `.wiki/log.md`: `<date> registered persona <role-id>`.
**Sync-правило (α):** все автоматические записи в `entities/persons/` идут только через этот скил. Ручные правки разрешены только в `config.yaml`; для пере-генерации карточки — снова `register-persona <role>` (он определит, что роль уже есть, и пере-сгенерирует).
**Sync-правило:** все автоматические записи в `entities/persons/` идут только через этот скил. Ручные правки разрешены только в `config.yaml`; для пере-генерации карточки — снова `register-persona <role>`.
## 6. Корневой `CLAUDE.md`
Содержание (outline):
Полный текст — см. `.meeting-room/CLAUDE.md`. Outline:
1. **Идентичность:** «Это `.meeting-room` — workspace для кросс-проектных брейнштормов и круглых столов. Не код-проект.»
2. **Семантика артефактов** (короткая шпаргалка из §3 + §4).
3. **Жёсткие правила:**
- Доменное содержимое **никогда** не оседает в локальном `.wiki/` — всегда в глобал через `projects-meta`.
- Локальный `.wiki/` — только room-meta (методология, persona-карточки, лог встреч, ретро).
- Локальные `.tasks/` **не создавать** — экшены идут в `.tasks/` целевого проекта через `projects-meta__tasks_create`.
- Перед любым предложением tooling/архитектуры — прочитать `.wiki/raw/research/` для текущего топика (закрепляет `feedback_read_source_transcripts.md` из памяти).
4. **Триггеры скилов v1:** перечень фраз → скил.
5. **Override `project-discipline`:**
- master-only ✅
- commit freely / push by permission ✅
- semver-bump — N/A (нет versioned-артефактов в комнате)
- локальные `.tasks/` — N/A (запрещены §6.3)
6. **Persona registry:** SoT — `config/config.yaml`. Карточки `.wiki/entities/persons/` — производное, пишется только скилом `register-persona`.
1. Идентичность: «multi-agent runtime для круглых столов, не код-проект».
2. Семантика артефактов (таблица).
3. Жёсткие правила: доменное содержимое — в global wiki через `projects-meta`, локальный `.wiki/concepts/` — только room-meta, локальный `.tasks/` запрещён, `entities/persons/` пишет только `register-persona`, domain-промоушен с импл-тасками авто-создаёт review-чекпоинт (но сам промоушен теперь — workshop'а, не отсюда).
4. Триггеры скилов v1 (только `start-meeting`, `register-persona`).
5. Override `project-discipline`.
6. Persona registry: SoT — `config/config.yaml`.
## 7. `.wiki/CLAUDE.md` (схема)
Karpathy-канон от `setup-wiki` + meeting-room-специфика:
Karpathy-канон + meeting-room-специфика:
- `entities/persons/<role-id>.md` — frontmatter обязателен (`role-id`, `model`, `provider`, `source`); body — summary и цитата system_prompt.
- `entities/projects/<proj>.md` — pointer-карточка к глобальному проекту (минимум: путь, краткая роль в контексте комнаты, ссылки на встречи где он фигурировал).
- `concepts/<topic>.md` — room-meta: методология, ретро. Frontmatter: `date`, `source: .brainstorm/<topic>.md` (или `.archive/...`).
- `raw/research/<date>-<topic>.md` — внешний clipping. Frontmatter: `date`, `source` (URL), `topic`.
- `raw/transcripts/<date>-<topic>.md` — транскрипт встречи. Frontmatter: `date`, `scenario`, `participants`.
- `log.md` — append-only, формат: `<date> <event-type> <topic> [details]`.
- `entities/projects/<proj>.md` — pointer-карточка к проекту (минимум: путь, краткая роль в контексте комнаты, ссылки на встречи).
- `concepts/<topic>.md` — room-meta runtime'а (методология совещаний, ретро). Frontmatter: `date`, `source`, `status`, `type: room-meta`.
- `raw/research/<date>-<topic>.md` — внешний clipping, frontmatter: `date`, `source` (URL), `topic`.
- `raw/transcripts/<date>-<topic>.md` — транскрипт встречи, frontmatter: `date`, `scenario`, `participants`, `problem`.
- `log.md` — append-only, `<date> <event-type> <topic> [details]`.
## 8. Migration plan
## 8. Handoff с `.workshop/`
### 8.1 Существующие папки
| Источник | Назначение | Способ |
|---|---|---|
| `source/2026-05-03-modulair.md` | `.wiki/raw/research/2026-05-03-modulair.md` | `git mv` |
| `source/2026-05-03-code-review.md` | `.wiki/raw/research/2026-05-03-code-review.md` | `git mv` |
| `sessions/` (пусто) | `.wiki/raw/transcripts/` (пусто) | создать новую |
| `.archive/` (пусто) | остаётся `.archive/` | без изменений |
| `scenarios/` | остаётся `scenarios/` | без изменений |
| `config/` | остаётся `config/` | без изменений |
| `.brainstorm/modulair-rag.md` | особый кейс — см. §8.2 | через `promote-brainstorm` (первый прогон) |
| `README.md` | обновить: ссылки на `CLAUDE.md`, `.wiki/`, удалить устаревшее правило «❌ NO `.wiki` внутри» | edit |
### 8.2 `modulair-rag.md` — особый кейс
Содержимое — process trace прошедшей single-agent сессии. Финальный design уже лежит в `~/projects/.wiki/concepts/modulair-rag-design.md` (упомянут в шапке самого файла). То есть **доменный layer уже промочен**, что осталось в `.brainstorm/` — это методологический след: «как развивался брейнсторм, какие развилки выбрали, что отвергнуто и почему».
Это room-meta. Назначение при промоушене — `.wiki/concepts/modulair-rag-brainstorm-trace.md` (или похожее имя). Тасок не порождает (всё доменное уже зафиксировано). Исходник → `.archive/2026-05-05-modulair-rag.md`.
Использовать как первый end-to-end тест `promote-brainstorm`.
### 8.3 Spec этого редизайна
После сборки структуры и v1-скилов — прогнать `meeting-room:promote-brainstorm` на самом этом файле. Назначение: `.wiki/concepts/meeting-room-architecture.md`. Тасок не порождает (план реализации идёт через `writing-plans` отдельно). Исходник → `.archive/2026-05-05-meeting-room-redesign.md`.
См. `.workshop/.wiki/concepts/workshop-architecture.md` §8. Кратко: транскрипт в `.meeting-room/.wiki/raw/transcripts/` → boss создаёт дистилляционный буфер в `.workshop/.brainstorm/<topic>-distill.md``workshop-promote-brainstorm` → нужный target. Никакой автоматизации, явный шаг человека.
## 9. Открытые вопросы (не блокируют реализацию)
- **Имя файла промо для `modulair-rag.md`** — `modulair-rag-brainstorm-trace.md` рабочая идея, финальное при первом прогоне.
- **Парсер action-items в `promote-brainstorm`** — начнём с regex по `- [ ]` и явным секциям; LLM-парсер только если regex окажется недостаточным.
- **Что писать в `entities/projects/<proj>.md`** — формат карточки утрясём после первой реальной встречи post-redesign (сейчас нет данных).
- **Расширение `project-discipline` для brainstorm-workspaces** — после стабилизации этой комнаты подать как PR в сам `project-discipline` (закрытие memory-todo `project_extend_discipline_for_meeting_room.md`).
- **Что писать в `entities/projects/<proj>.md`** — формат карточки утрясём после первой реальной встречи (сейчас нет данных).
- **Регистрация `.meeting-room` в `mcp__projects-meta`** — после split'а возможно понадобится для cross-project aggregation сценариев. Open вопрос из split-плана.

View File

@@ -32,3 +32,5 @@ Events: `started`, `promoted`, `registered`, `archived`.
2026-05-07 promoted tdd-criteria → claude-skills/.wiki/concepts/tdd-criteria-design.md (commits a03d2804+2ad6f4ce+5fb648d4); tasks created: claude-skills#tdd-criteria-skill-write (ready), claude-skills#tdd-criteria-hermes-mapping (blocked), claude-skills#tdd-criteria-build-install (blocked), claude-skills#tdd-criteria-review (blocked, umbrella per §5)
2026-05-07 archived tdd-criteria → .archive/2026-05-07-tdd-criteria.md
2026-05-07 amended tdd-criteria post-promotion: anti-loophole rule 4 (test-immutability + [test-modify: was X; is Y] marker + separate-commit-from-impl) added; user surfaced symmetric vandalism risk on tests after initial promotion. Patches landed: claude-skills#tdd-criteria-skill-write description updated (commit b7819b17), claude-skills#tdd-criteria-precommit-hook task created (commit d440bb52). Design-doc amendment NOT applied directly (knowledge_ingest is create-only — overwrite blocked); amendment text embedded in skill-write task description for impl session to apply via direct git edit.
2026-05-08 split meeting-room into multi-agent runtime (this zone) + .workshop/ boss-zone; remote workshop repo created at git.kzntsv.site/OpeItcLoc03/workshop.git
2026-05-08 amended meeting-room-architecture.md: split-rewrite (runtime-only); boss sections moved to .workshop/.wiki/concepts/workshop-architecture.md