From 390f9386584304f444e52cda6c9f7fd236382bed Mon Sep 17 00:00:00 2001 From: vitya Date: Tue, 5 May 2026 14:29:18 +0300 Subject: [PATCH] Add .wiki/ Karpathy skeleton Local room-meta wiki: index, overview, log, schema (CLAUDE.md), and empty raw/entities/concepts/packages/sources subtrees with .gitkeep placeholders. Co-Authored-By: Claude Opus 4.7 (1M context) --- .wiki/CLAUDE.md | 68 ++++++++++++++++++++++++++++++++ .wiki/concepts/.gitkeep | 0 .wiki/entities/persons/.gitkeep | 0 .wiki/entities/projects/.gitkeep | 0 .wiki/index.md | 19 +++++++++ .wiki/log.md | 9 +++++ .wiki/overview.md | 19 +++++++++ .wiki/packages/.gitkeep | 0 .wiki/raw/README.md | 8 ++++ .wiki/raw/research/.gitkeep | 0 .wiki/raw/transcripts/.gitkeep | 0 .wiki/sources/.gitkeep | 0 12 files changed, 123 insertions(+) create mode 100644 .wiki/CLAUDE.md create mode 100644 .wiki/concepts/.gitkeep create mode 100644 .wiki/entities/persons/.gitkeep create mode 100644 .wiki/entities/projects/.gitkeep create mode 100644 .wiki/index.md create mode 100644 .wiki/log.md create mode 100644 .wiki/overview.md create mode 100644 .wiki/packages/.gitkeep create mode 100644 .wiki/raw/README.md create mode 100644 .wiki/raw/research/.gitkeep create mode 100644 .wiki/raw/transcripts/.gitkeep create mode 100644 .wiki/sources/.gitkeep diff --git a/.wiki/CLAUDE.md b/.wiki/CLAUDE.md new file mode 100644 index 0000000..6d68c73 --- /dev/null +++ b/.wiki/CLAUDE.md @@ -0,0 +1,68 @@ +# .wiki — Schema (room-meta only) + +Эта `.wiki/` — локальная и узко-доменная: **только знание о том, как работает meeting-room**. Доменное содержимое из совещаний промочивается в глобальную вику через `mcp__projects-meta__knowledge_ingest`, не сюда. + +## Layout (Karpathy LLM Wiki canonical) + +- `index.md` — навигация +- `overview.md` — что такое meeting-room на одной странице +- `log.md` — append-only хронологический лог: ` [details]` +- `raw/research/-.md` — внешние clippings, immutable +- `raw/transcripts/-.md` — транскрипты совещаний, immutable +- `entities/persons/.md` — карточки persona (генерируются скилом `meeting-room-register-persona` из `config/config.yaml`) +- `entities/projects/.md` — pointer-карточки целевых проектов +- `concepts/.md` — room-meta: методология, ретроспективы, паттерны фасилитации +- `packages/.md` — инструменты комнаты (runner, framework, schema) +- `sources/.md` — внешняя литература + +## Frontmatter requirements + +**`entities/persons/<role-id>.md`:** + +```yaml +--- +role-id: analyst +model: glm-5.1 +provider: ollama_cloud +source: config/config.yaml +--- +``` + +**`raw/research/<date>-<topic>.md`:** + +```yaml +--- +date: 2026-05-03 +source: <URL> +topic: <topic> +--- +``` + +**`raw/transcripts/<date>-<topic>.md`:** + +```yaml +--- +date: 2026-05-03 +scenario: scenarios/<topic>.md +participants: [moderator, skeptic, idea_generator, analyst] +problem: <one-line> +--- +``` + +**`concepts/<topic>.md`:** + +```yaml +--- +date: 2026-05-05 +source: .brainstorm/<topic>.md +status: promoted +type: room-meta +--- +``` + +## Hard rules + +1. **Никакого доменного содержимого** в `concepts/`. Если контент пригодился бы в чужом проекте — он не room-meta, а domain → `mcp__projects-meta__knowledge_ingest` в целевой проект. +2. `raw/` immutable: append-only, не редактируем после фиксации. +3. `entities/persons/` пишет **только** скил `meeting-room-register-persona`. Source-of-truth — `config/config.yaml`. +4. `log.md` append-only, формат строки: `<YYYY-MM-DD> <event> <topic> [details]`. Никаких удалений. diff --git a/.wiki/concepts/.gitkeep b/.wiki/concepts/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/.wiki/entities/persons/.gitkeep b/.wiki/entities/persons/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/.wiki/entities/projects/.gitkeep b/.wiki/entities/projects/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/.wiki/index.md b/.wiki/index.md new file mode 100644 index 0000000..bcb20a6 --- /dev/null +++ b/.wiki/index.md @@ -0,0 +1,19 @@ +# Meeting-Room Wiki — index + +> Knowledge about how this meeting-room itself works. Domain content lives in `~/projects/.wiki/`. + +## Navigation + +- [Overview](overview.md) — что такое meeting-room +- [Log](log.md) — хронология встреч, промоушенов, изменений persona +- [Schema](CLAUDE.md) — раскладка и frontmatter-требования + +## Sections + +- [Personas](entities/persons/) — карточки ролей (генерируются из `config/config.yaml`) +- [Projects](entities/projects/) — pointer-карточки целевых проектов +- [Concepts](concepts/) — методология, ретро, паттерны +- [Raw research](raw/research/) — clippings и внешние транскрипты +- [Raw transcripts](raw/transcripts/) — транскрипты совещаний +- [Packages](packages/) — инструменты комнаты +- [Sources](sources/) — внешняя литература diff --git a/.wiki/log.md b/.wiki/log.md new file mode 100644 index 0000000..4736d90 --- /dev/null +++ b/.wiki/log.md @@ -0,0 +1,9 @@ +# Log + +Append-only. Format: `<YYYY-MM-DD> <event> <topic> [details]`. + +Events: `started`, `promoted`, `registered`, `archived`. + +--- + +2026-05-05 bootstrapped meeting-room redesign (initial .wiki/ skeleton) diff --git a/.wiki/overview.md b/.wiki/overview.md new file mode 100644 index 0000000..3d609be --- /dev/null +++ b/.wiki/overview.md @@ -0,0 +1,19 @@ +# Meeting-Room — overview + +`.meeting-room/` — кросс-проектное рабочее пространство для брейнштормов и круглых столов агентов. Не код-проект. + +## Зачем + +Место, где агенты из разных проектов пересекаются ради задач, которые не помещаются в один backlog. Брейнсторм-зона: артефакты вызревают здесь и потом промочиваются — либо в локальный `.wiki/concepts/` (если это знание про саму комнату), либо в глобальную вику и `.tasks/` целевого проекта (если доменное). + +## Что внутри + +- `scenarios/` — frontmatter-сценарии для запуска multi-agent совещания +- `config/config.yaml` — реестр persona (рантайм-конфиг) +- `.brainstorm/` — рабочий буфер: черновики, single-agent capture +- `.archive/` — буфер после промоушена +- `.wiki/` — Karpathy-style room-meta wiki (этот раздел) + +## Как пользоваться + +См. корневой `CLAUDE.md` — там семантика и триггер-фразы скилов. diff --git a/.wiki/packages/.gitkeep b/.wiki/packages/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/.wiki/raw/README.md b/.wiki/raw/README.md new file mode 100644 index 0000000..4bab20d --- /dev/null +++ b/.wiki/raw/README.md @@ -0,0 +1,8 @@ +# raw/ + +Immutable, append-only. Никаких редактур после фиксации. + +- `research/` — внешние clippings, pre-loaded материалы перед совещанием. +- `transcripts/` — транскрипты прошедших совещаний. + +При промоушене `concepts/<topic>.md` ссылается сюда через frontmatter `source:`. diff --git a/.wiki/raw/research/.gitkeep b/.wiki/raw/research/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/.wiki/raw/transcripts/.gitkeep b/.wiki/raw/transcripts/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/.wiki/sources/.gitkeep b/.wiki/sources/.gitkeep new file mode 100644 index 0000000..e69de29