diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..78d1550 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,76 @@ +# .meeting-room — workspace contract + +> ⚠️ **RETIRED 2026-06-08.** Зона распущена. НЕ запускать `meeting-room-start-meeting` / `register-persona` и не заводить совещания здесь. Multi-agent round-table теперь — тир consult-лестницы рантайма: **K локальных read-only coworker-спавнов через SpawnAdapter в worktree воркера** (federation-native, не центральная зона). Причина: несовместимость с federation-per-machine вердиктом (`agent-orchestration-without-user` Q9) + механическое дублирование `consult-arbiter-spawn`. Решение/размотка: `.workshop/.brainstorm/meeting-room-dissolve.md`. Дизайн: общая вики `concepts/consult-tier-escalation.md`. Контракт ниже сохранён как исторический record. + +`.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/.md` | runtime: сценарии запуска multi-agent совещания (frontmatter: `name`, `participants`, `problem`, `max_rounds`) | +| `config/config.yaml` | runtime: реестр persona (single source of truth) | +| `.wiki/raw/research/` | immutable: внешние clippings, релевантные совещанию | +| `.wiki/raw/transcripts/` | immutable: транскрипты прошедших совещаний | +| `.wiki/entities/persons/` | карточки persona, генерируются из `config.yaml` | +| `.wiki/entities/projects/` | pointer-карточки целевых проектов | +| `.wiki/concepts/` | room-meta: методология совещаний, ретро runtime'а | + +**Перед предложением tooling/архитектуры — прочитать `.wiki/raw/research/` для текущего топика** (если research-материалы для совещания загружены). + +## Жёсткие правила + +1. **Доменное содержимое никогда не оседает в локальном `.wiki/`** — всегда в global через `mcp__projects-meta__knowledge_ingest` в `~/projects//.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/.md` — переехать в `.workshop/`. Workshop делает дистилляцию транскриптов отсюда — пользовательским явным запросом, не автоматически. + +## Триггеры скилов v1 + +| Скил | Триггер-фразы | +|---|---| +| `meeting-room-start-meeting` | «запусти совещание ``», «start meeting ``», «новое совещание ``» | +| `meeting-room-register-persona` | «добавь персону», «новый агент в комнату», «register persona ``» | + +Скил `workshop-promote-brainstorm` — в зоне `.workshop/`, не здесь. Дистилляция transcripts → концепт делается там. + +## Override `project-discipline` + +В этой комнате применяются: + +- ✅ master-only (никаких feature-веток) +- ✅ commit freely / push by permission + +**Не применяются:** + +- ❌ semver-bump — нет versioned-артефактов (`SKILL.md` скилов живут в `~/projects/claude-skills/`, у них свой semver) +- ❌ локальный `.tasks/` — запрещён правилом §3 + +## Handoff с `.workshop/` + +``` +.meeting-room/.wiki/raw/transcripts/-.md ← runtime артефакт + │ + │ user явно: «дистиллируй транскрипт » + ▼ +.workshop/.brainstorm/-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/.md` — производные. + +## Pointers + +- Schema локальной вики: `.wiki/CLAUDE.md` +- Архитектура runtime'а: `.wiki/concepts/meeting-room-architecture.md` +- Архитектура boss-зоны: `.workshop/.wiki/concepts/workshop-architecture.md` diff --git a/CLAUDE.md b/CLAUDE.md index 78d1550..9d52a54 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,76 +1,3 @@ -# .meeting-room — workspace contract +# CLAUDE.md — legacy pointer -> ⚠️ **RETIRED 2026-06-08.** Зона распущена. НЕ запускать `meeting-room-start-meeting` / `register-persona` и не заводить совещания здесь. Multi-agent round-table теперь — тир consult-лестницы рантайма: **K локальных read-only coworker-спавнов через SpawnAdapter в worktree воркера** (federation-native, не центральная зона). Причина: несовместимость с federation-per-machine вердиктом (`agent-orchestration-without-user` Q9) + механическое дублирование `consult-arbiter-spawn`. Решение/размотка: `.workshop/.brainstorm/meeting-room-dissolve.md`. Дизайн: общая вики `concepts/consult-tier-escalation.md`. Контракт ниже сохранён как исторический record. - -`.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/.md` | runtime: сценарии запуска multi-agent совещания (frontmatter: `name`, `participants`, `problem`, `max_rounds`) | -| `config/config.yaml` | runtime: реестр persona (single source of truth) | -| `.wiki/raw/research/` | immutable: внешние clippings, релевантные совещанию | -| `.wiki/raw/transcripts/` | immutable: транскрипты прошедших совещаний | -| `.wiki/entities/persons/` | карточки persona, генерируются из `config.yaml` | -| `.wiki/entities/projects/` | pointer-карточки целевых проектов | -| `.wiki/concepts/` | room-meta: методология совещаний, ретро runtime'а | - -**Перед предложением tooling/архитектуры — прочитать `.wiki/raw/research/` для текущего топика** (если research-материалы для совещания загружены). - -## Жёсткие правила - -1. **Доменное содержимое никогда не оседает в локальном `.wiki/`** — всегда в global через `mcp__projects-meta__knowledge_ingest` в `~/projects//.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/.md` — переехать в `.workshop/`. Workshop делает дистилляцию транскриптов отсюда — пользовательским явным запросом, не автоматически. - -## Триггеры скилов v1 - -| Скил | Триггер-фразы | -|---|---| -| `meeting-room-start-meeting` | «запусти совещание ``», «start meeting ``», «новое совещание ``» | -| `meeting-room-register-persona` | «добавь персону», «новый агент в комнату», «register persona ``» | - -Скил `workshop-promote-brainstorm` — в зоне `.workshop/`, не здесь. Дистилляция transcripts → концепт делается там. - -## Override `project-discipline` - -В этой комнате применяются: - -- ✅ master-only (никаких feature-веток) -- ✅ commit freely / push by permission - -**Не применяются:** - -- ❌ semver-bump — нет versioned-артефактов (`SKILL.md` скилов живут в `~/projects/claude-skills/`, у них свой semver) -- ❌ локальный `.tasks/` — запрещён правилом §3 - -## Handoff с `.workshop/` - -``` -.meeting-room/.wiki/raw/transcripts/-.md ← runtime артефакт - │ - │ user явно: «дистиллируй транскрипт » - ▼ -.workshop/.brainstorm/-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/.md` — производные. - -## Pointers - -- Schema локальной вики: `.wiki/CLAUDE.md` -- Архитектура runtime'а: `.wiki/concepts/meeting-room-architecture.md` -- Архитектура boss-зоны: `.workshop/.wiki/concepts/workshop-architecture.md` +Canon is `AGENTS.md`. Read `AGENTS.md` — it contains all project instructions.