agents-canon: migrate CLAUDE.md -> AGENTS.md (canon) + legacy pointer
This commit is contained in:
76
AGENTS.md
Normal file
76
AGENTS.md
Normal file
@@ -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/<topic>.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/<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-start-meeting` | «запусти совещание `<topic>`», «start meeting `<scenario>`», «новое совещание `<topic>`» |
|
||||
| `meeting-room-register-persona` | «добавь персону», «новый агент в комнату», «register persona `<role>`» |
|
||||
|
||||
Скил `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/<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` — производные.
|
||||
|
||||
## Pointers
|
||||
|
||||
- Schema локальной вики: `.wiki/CLAUDE.md`
|
||||
- Архитектура runtime'а: `.wiki/concepts/meeting-room-architecture.md`
|
||||
- Архитектура boss-зоны: `.workshop/.wiki/concepts/workshop-architecture.md`
|
||||
77
CLAUDE.md
77
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/<topic>.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/<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-start-meeting` | «запусти совещание `<topic>`», «start meeting `<scenario>`», «новое совещание `<topic>`» |
|
||||
| `meeting-room-register-persona` | «добавь персону», «новый агент в комнату», «register persona `<role>`» |
|
||||
|
||||
Скил `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/<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` — производные.
|
||||
|
||||
## 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.
|
||||
|
||||
Reference in New Issue
Block a user