feat(skills): mappa-brainstorm-promote 1.5.0→1.6.0 — storm-канал: буфер = mappa storm-сущность, промоут через storm_promote, project-agnostic (#1066)
This commit is contained in:
BIN
dist/mappa-brainstorm-promote.skill
vendored
BIN
dist/mappa-brainstorm-promote.skill
vendored
Binary file not shown.
@@ -1,466 +1,276 @@
|
|||||||
---
|
---
|
||||||
name: mappa-brainstorm-promote
|
name: mappa-brainstorm-promote
|
||||||
author: ours
|
author: ours
|
||||||
version: 1.5.0
|
version: 1.6.0
|
||||||
description: >
|
description: >
|
||||||
Finalize a matured brainstorm buffer on the boss's desk
|
Finalize a matured brainstorm storm-entity in mappa (type=storm, in ANY
|
||||||
(~/projects/.workshop/.brainstorm/): ask routing (workshop-meta → local
|
project): read buffer → route (workshop-meta → .workshop wiki; domain →
|
||||||
.wiki/concepts/, domain → target project wiki via knowledge_ingest,
|
target project wiki; skill → ~/projects/skills skeleton) → promote via
|
||||||
mappa-service → mappa-борд (create — карв-аут без лиза wiki:2660), skill →
|
mcp__mappa__storm_promote (atomic buffer → wiki-страница + archive, решение 7)
|
||||||
claude-skills skeleton),
|
→ extract action-items into target tasks (mcp__mappa__task_create, карв-аут)
|
||||||
extract action-items into target .tasks, create pointers + review umbrella
|
→ review umbrella → covering letter. Старое имя — триггер-синоним:
|
||||||
for impl tasks, archive the buffer. Старое имя — триггер-синоним:
|
workshop-promote-brainstorm. Project-agnostic: storm lives where it is led,
|
||||||
workshop-promote-brainstorm. Location-agnostic: fires from ANY folder; all
|
not only in .workshop; file channels (.brainstorm/.archive) are read-only
|
||||||
paths resolve to ~/projects/.workshop/ regardless of CWD. Triggers (user):
|
legacy (импортированы в mappa). Triggers (user): «промоутни брейнсторм»,
|
||||||
«промоутни брейнсторм», «finalize <topic>», «выкати в вики», «promote
|
«finalize <topic>», «выкати в вики», «promote <topic>».
|
||||||
<topic>».
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# mappa-brainstorm-promote
|
# mappa-brainstorm-promote
|
||||||
|
|
||||||
Финализация созревшего брейнсторм-буфера на столе босса (`~/projects/.workshop/`) — **процедура** (линейная: от чтения буфера до архивации), не цикл в смысле повторения: запускается явно на финальном буфере и доводит его до конца (промоушен + таски + архив). В форкфлоу встаёт между работой (`mappa-task-work`) и финишем (`mappa-closing-ritual`). Четыре ветки маршрутизации:
|
Финализация созревшего шторм-буфера, который живёт **как mappa storm-сущность**
|
||||||
|
(type=storm, status=buffer) в любом проекте — **процедура** (линейная: от чтения
|
||||||
|
буфера до промоута и тасок), не цикл: запускается явно на финальном буфере и
|
||||||
|
доводит его до конца. В форкфлоу встаёт между работой (`mappa-task-work`) и
|
||||||
|
финишем (`mappa-closing-ritual`).
|
||||||
|
|
||||||
> **Location-agnostic.** Скил триггерится из любой папки — босс-штормы
|
> **Project-agnostic.** Шторм ведётся там, где его ведут, — не только в
|
||||||
> происходят где угодно, запись живёт на столе. Все относительные пути ниже
|
> `.workshop/`. Скил триггерится из любой папки; буфер ищется в mappa
|
||||||
> (`.brainstorm/`, `.archive/`, `.wiki/`, `index.md`) разрешаются относительно
|
> (`entity_search` type=storm), а не на диске. Файловые `.brainstorm/`/
|
||||||
> `~/projects/.workshop/` **независимо от CWD**; git-команды явно указывают
|
> `.archive/` — read-only легаси: их содержимое уже импортировано в mappa
|
||||||
> `-C ~/projects/.workshop`.
|
> storm-сущности (решение 15, флип), новые записи в файлы не делаются.
|
||||||
|
|
||||||
- **workshop-meta** → локальный `.wiki/concepts/` (методология самой зоны).
|
Три ветки маршрутизации (спросить пользователя):
|
||||||
- **domain** → глобал через `mcp__projects-meta__knowledge_ingest` в `~/projects/<proj>/.wiki/`.
|
|
||||||
- **mappa-service** → сервисные борды (mappa, .common, …): таски/вики-сущности через `mcp__mappa__task_create`/`wiki_create` (**create — карв-аут без лиза**, wiki:2660; update — version+409); pointers-таска НЕ нужна, если спека уже в вики проекта (wiki:NNNN); review-umbrella — сервисная таска; covering-письмо в инбокс цели.
|
|
||||||
- **skill** → `~/projects/claude-skills/skills/<name>/SKILL.md` (только шапка + пустой каркас тела, локальный коммит без push/install/build-hermes).
|
|
||||||
|
|
||||||
Буфер уезжает в `.archive/`. Action-items уходят тасками в target-проект. **Всегда, при любом маршруте, в воркшоп-вики остаётся summary-страница.**
|
- **workshop-meta** → промоут в `.workshop`: wiki-страница в вики зоны
|
||||||
|
(методология самой зоны).
|
||||||
|
- **domain** → промоут в целевой проект: wiki-страница (спека) в его вики +
|
||||||
|
импл-таски + review-umbrella.
|
||||||
|
- **skill** → каркас скила в `~/projects/skills/skills/<name>/SKILL.md`
|
||||||
|
(только шапка + пустой каркас тела, локальный коммит без push/install).
|
||||||
|
|
||||||
|
Промоут контента — **всегда через `mcp__mappa__storm_promote`**: атомарно
|
||||||
|
создаёт wiki-страницу (slug из шторма, body сохраняется) в проекте из вызова и
|
||||||
|
переводит шторм в `archive` (номер/slug стабильны, решение 20; рёбра parent_of,
|
||||||
|
событие `storm.promoted`). **Никаких git mv и файловых архивов.** Action-items
|
||||||
|
уходят тасками в target-проект через `mcp__mappa__task_create` (карв-аут без
|
||||||
|
лиза, #1054; последовательно, не батчем).
|
||||||
|
|
||||||
## When to use
|
## When to use
|
||||||
|
|
||||||
- «промоутни брейнсторм», «finalize <topic>», «выкати в вики», «promote <topic>».
|
- «промоутни брейнсторм», «finalize <topic>», «выкати в вики», «promote
|
||||||
- Пользователь явно ссылается на `.workshop/.brainstorm/<topic>.md` как на готовый к промоушену.
|
<topic>».
|
||||||
|
- Пользователь ссылается на storm-сущность (storm:N) или на тему шторма,
|
||||||
|
которая созрела и готова к промоушену.
|
||||||
|
|
||||||
## Inputs
|
## Inputs
|
||||||
|
|
||||||
- Путь `.brainstorm/<topic>.md` или просто `<topic>`.
|
- Storm-реф `storm:N` или `<topic>` (slug/тема шторма) + project (если шторм
|
||||||
- Для skill-ветки дополнительно: `<name>` нового скила (если не указан — спросить, предложить производное от topic).
|
не в текущем проекте — спросить).
|
||||||
|
- Для skill-ветки дополнительно: `<name>` нового скила (если не указан —
|
||||||
|
спросить, предложить производное от topic).
|
||||||
|
|
||||||
## Decision flow
|
## Decision flow
|
||||||
|
|
||||||
```
|
```
|
||||||
.brainstorm/<topic>.md
|
storm-сущность в mappa (type=storm, status=buffer)
|
||||||
│
|
│
|
||||||
▼
|
▼
|
||||||
read + summarize (1–2 paragraphs)
|
find + read (entity_search type=storm → entity_get полный body)
|
||||||
│
|
│
|
||||||
▼
|
▼
|
||||||
ask: workshop-meta or domain or skill?
|
ask: workshop-meta or domain or skill?
|
||||||
│ │ │
|
│ │ │
|
||||||
│ ▼ ▼
|
│ ▼ ▼
|
||||||
│ ask: target proj ask: <name> + check
|
│ ask: target proj ask: <name> + check
|
||||||
│ │ ~/projects/claude-skills/
|
│ │ ~/projects/skills/
|
||||||
│ ┌─────┴─────┐ skills/<name>/ NOT exists
|
│ ┌─────┴─────┐ skills/<name>/ NOT exists
|
||||||
│ ▼ ▼ │
|
│ ▼ ▼ │
|
||||||
│ file channel service channel │
|
│ storm_promote storm_promote dialog: description (trigger contract)
|
||||||
│ (.tasks/) (mappa-борд) │
|
│ (project=.workshop) (project=<target>) │
|
||||||
|
│ │ │ ▼
|
||||||
|
│ │ │ preview + confirm
|
||||||
│ │ │ │
|
│ │ │ │
|
||||||
│ ▼ ▼ ▼
|
│ │ │ ▼
|
||||||
│ knowledge_ingest mcp__mappa__wiki_create dialog: description (trigger contract)
|
│ │ │ mkdir + Write SKILL.md
|
||||||
│ │ (карв-аут, wiki:2660) │
|
│ │ │ (header + empty 6-section skeleton)
|
||||||
│ │ │ ▼
|
│ │ │ │
|
||||||
│ │ │ preview + confirm
|
│ │ │ ▼
|
||||||
│ │ │ │
|
│ │ │ git add + commit in ~/projects/skills/
|
||||||
│ │ │ ▼
|
│ │ │ (local, no push, no install.sh)
|
||||||
│ │ │ mkdir + Write SKILL.md
|
│ │ │ │
|
||||||
│ │ │ (header + empty 6-section skeleton)
|
└────────┴───────────┴────────────┘
|
||||||
│ │ │ │
|
|
||||||
│ │ │ ▼
|
|
||||||
│ │ │ git add + commit in claude-skills/
|
|
||||||
│ │ │ (local, no push, no install.sh, no build-hermes)
|
|
||||||
│ │ │ │
|
|
||||||
└────────┴───────────┴─────────────────┘
|
|
||||||
│
|
│
|
||||||
▼
|
▼
|
||||||
parse action-items + (for skill: prepend 3 baselines)
|
parse action-items from storm body
|
||||||
│
|
│
|
||||||
▼
|
▼
|
||||||
for each: tasks_create (ПОСЛЕДОВАТЕЛЬНО, не батчем)
|
for each: mcp__mappa__task_create (ПОСЛЕДОВАТЕЛЬНО, не батчем)
|
||||||
[file: mcp__projects-meta__tasks_create | service: mcp__mappa__task_create]
|
|
||||||
│
|
│
|
||||||
▼
|
▼
|
||||||
if domain && N≥1: tasks_create [<topic>-review] (blocked-by impl)
|
review-umbrella: mcp__mappa__task_create (blocked, blocker=impl#)
|
||||||
if service: review-umbrella — сервисная таска (blocked, blocker=impl#)
|
|
||||||
if skill: tasks_create [<name>-review] (blocked-by impl, behavioral smoke-test)
|
|
||||||
│
|
│
|
||||||
▼
|
▼
|
||||||
covering-письмо в инбокс цели (оба канала; канон mappa-delegation)
|
covering-письмо: mcp__mappa__inbox_send (канон mappa-delegation)
|
||||||
│
|
│
|
||||||
▼
|
▼
|
||||||
Write .wiki/concepts/<topic>.md ← ВСЕГДА, любой маршрут
|
финальный отчёт (wiki:NNNN — спека, storm:N — архив, таски)
|
||||||
(summary: решения, куда промочено, задачи, ссылки)
|
|
||||||
│
|
|
||||||
▼
|
|
||||||
git -C ~/projects/.workshop mv .brainstorm/<topic>.md .archive/<date>-<topic>.md
|
|
||||||
│
|
|
||||||
▼
|
|
||||||
append to .wiki/log.md
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Steps
|
## Steps
|
||||||
|
|
||||||
1. **Прочитать `.brainstorm/<topic>.md`.** Показать summary (≤2 абзаца).
|
1. **Найти шторм в mappa.** `mcp__mappa__entity_search(type='storm',
|
||||||
|
project=<проект>, q=<topic>)` → в результатах storm:N + **internal id**.
|
||||||
|
Прочитать полный буфер: `mcp__mappa__entity_get(id=<internal id>)` — тело =
|
||||||
|
running record шторма (frontmatter + раунды).
|
||||||
|
|
||||||
2. **Спросить тип:**
|
- Если шторм не найден, но пользователь показывает файловый
|
||||||
- **workshop-meta** — методология самой workshop-зоны: ретро дистилляции, паттерны, апгрейды скилов зоны.
|
`.workshop/.brainstorm/<topic>.md` — это легаси: он уже импортирован или
|
||||||
|
доимпортируется в mappa storm-сущность (оператор, 2026-08-25). Скил
|
||||||
|
работает с storm-сущностью; файлы не трогает.
|
||||||
|
- Если шторма нет ни в mappa, ни в файлах — создать storm-сущность:
|
||||||
|
HTTP `POST <MAPPA_CORE_URL>/entities` с `x-api-token: $MAPPA_API_TOKEN`,
|
||||||
|
body `{project, type:'storm', slug, status:'buffer', body}` (MCP-тула
|
||||||
|
`storm.create` пока нет — follow-up на mappa; контракт POST /entities,
|
||||||
|
решение 7/#1054).
|
||||||
|
|
||||||
|
2. **Показать summary буфера (≤2 абзаца).**
|
||||||
|
|
||||||
|
3. **Спросить тип:**
|
||||||
|
- **workshop-meta** — методология самой workshop-зоны: ретро дистилляции,
|
||||||
|
паттерны, апгрейды скилов зоны.
|
||||||
- **domain** — доменное содержимое для какого-то целевого проекта.
|
- **domain** — доменное содержимое для какого-то целевого проекта.
|
||||||
- **skill** — методология общего назначения, оформляется как скил в `~/projects/claude-skills/`.
|
- **skill** — методология общего назначения, оформляется как скил в
|
||||||
|
`~/projects/skills/`.
|
||||||
|
|
||||||
3. **Если domain:**
|
4. **Если domain:** спросить целевой проект (имя папки в `~/projects/`).
|
||||||
- Спросить целевой проект (имя папки в `~/projects/`).
|
Проверить, что проект существует в mappa: `mcp__mappa__entity_search`
|
||||||
- Валидация: вызвать `mcp__projects-meta__meta_status`, убедиться что проект известен; иначе — abort с сообщением «зарегистрируй проект через setup-projects-meta».
|
type=project или `admin_status` (список проектов). Если нет — abort с
|
||||||
- **Определить канал борда:** есть ли у проекта файловая доска `.tasks/STATUS.md` (file channel) или борд живёт в mappa-сущностях (service channel — сервисные проекты: mappa, .common, …). Проверка: файл `.tasks/STATUS.md` в чек-ауте (file) против `mcp__mappa__task_list(project=<proj>)` / `entity_search` (service). Если файловой доски нет, а mappa-сущности есть → **service channel**.
|
сообщением.
|
||||||
|
|
||||||
4. **Если domain + service channel (mappa-борд, fold-in 1):**
|
|
||||||
- **Create — карв-аут, лиз НЕ нужен** (wiki:2660): `task_create`/`wiki_create`
|
|
||||||
без claim_token (интерактивный контракт, поллер вне mappa).
|
|
||||||
- **Спека → вики-сущность:** `mcp__mappa__wiki_create(project, slug, body)` (или `wiki_update(project, id, version, …)`, если страница уже есть). Если спека уже в вики проекта (wiki:NNNN) — не дублировать, описание импл-тасок ссылается на неё. **Frontmatter-summary (wiki:2661):** при создании пиши `summary:` одной строкой в frontmatter — карточки `wiki.search` и поиск по вики читают его.
|
|
||||||
- **Pointers-таска НЕ нужна**, если спека уже в вики проекта — дыра pointers закрыта инлайн (описание импл-тасок прямо ссылается на спеку).
|
|
||||||
- **Импл-таски:** `mcp__mappa__task_create(project, slug, title, description, status='ready')` — **ПОСЛЕДОВАТЕЛЬНО, не батчем** (см. NB в шаге 7).
|
|
||||||
- **Review-umbrella:** сервисная таска `mcp__mappa__task_create(status='blocked', blocker=<номера импл-тасок>)`.
|
|
||||||
- **Covering-письмо:** `mcp__mappa__inbox_send(project=<target>, from=<своя>, subject='Промоушен <topic>: таски <#N>…', body=<перечень>).` — канон mappa-delegation: таска на борде не пингует живую сессию.
|
|
||||||
|
|
||||||
5. **Если skill:**
|
5. **Если skill:**
|
||||||
- Спросить `<name>` нового скила (если не указан) — валидный slug (`[a-z0-9-]+`).
|
- Спросить `<name>` нового скила (если не указан) — валидный slug
|
||||||
- Валидация: `~/projects/claude-skills/skills/<name>/` НЕ должна существовать. Если существует — **abort** с сообщением «скил `<name>` уже существует, обновляйся обычным маршрутом в `claude-skills/`, этот скил не для апдейтов».
|
(`[a-z0-9-]+`).
|
||||||
- Валидация: `~/projects/claude-skills/` сам репозиторий существует. Если нет — abort с сообщением «клонируй claude-skills/ через update-claude-skills или вручную».
|
- Валидация: `~/projects/skills/skills/<name>/` НЕ должна существовать.
|
||||||
|
Если существует — **abort** с сообщением «скил `<name>` уже существует,
|
||||||
|
обновляйся обычным маршрутом в `~/projects/skills/`, этот скил не для
|
||||||
|
апдейтов».
|
||||||
|
- Валидация: `~/projects/skills/` сам репозиторий существует. Если нет —
|
||||||
|
abort с сообщением «клонируй skills через update-skills или вручную».
|
||||||
|
|
||||||
6. **Парсинг action-items:**
|
6. **Промоут контента (всегда через `storm_promote`, решение 7):**
|
||||||
- regex по строкам вида `- [ ] ...`, `- [ ]`, секции после `## Следующие шаги`/`## TODO`/`## Next steps`/`## Action items`.
|
|
||||||
- Показать список, дать редактировать/удалять/добавлять.
|
|
||||||
- Если 0 action-items — продолжить, не блокировать.
|
|
||||||
|
|
||||||
7. **Промоушен контента:**
|
`mcp__mappa__storm_promote(project=<target>, storm_id=<internal id>)`
|
||||||
|
|
||||||
- **workshop-meta:** `Write` → `.wiki/concepts/<topic>.md` с frontmatter:
|
- Атомарно: buffer → wiki-страница (slug из шторма, body сохраняется,
|
||||||
|
рёбра parent_of wiki→storm и refs→storm) + шторм → `archive` +
|
||||||
|
значимое событие `storm.promoted`.
|
||||||
|
- **workshop-meta:** `project='.workshop'` → спека/концепт в вики зоны.
|
||||||
|
- **domain:** `project=<target>` → спека в вики целевого проекта. **Frontmatter-summary
|
||||||
|
(wiki:2661):** убедиться, что в теле шторма есть `summary:` одной строкой
|
||||||
|
в frontmatter — карточки `wiki.search` читают его. Если нет — дописать
|
||||||
|
перед промоутом (через HTTP PATCH body шторма, entities.update).
|
||||||
|
- **skill:** контент шторма НЕ промоутится в вики (каркас пустой, тело
|
||||||
|
дописывается вторым проходом глазами) — но шторм всё равно архивируется
|
||||||
|
`storm_promote(project=<где шторм>)`, чтобы буфер не висел.
|
||||||
|
- Повторный промоут архивированного шторма → ошибка (one-shot, идемпотентно
|
||||||
|
через статус). Сверить `storm_id` (internal) из шага 1.
|
||||||
|
- Если `storm_promote` упал (конфликт версии, 409) → retry со свежим
|
||||||
|
internal id; при стабильном отказе — abort до создания тасок.
|
||||||
|
|
||||||
```yaml
|
7. **Парсинг action-items:** regex по строкам вида `- [ ] ...` в теле шторма,
|
||||||
---
|
секции после `## Следующие шаги`/`## TODO`/`## Next steps`/
|
||||||
date: <YYYY-MM-DD>
|
`## Action items`. Показать список, дать редактировать/удалять/добавлять.
|
||||||
source: .brainstorm/<topic>.md
|
Если 0 action-items — продолжить, не блокировать.
|
||||||
status: promoted
|
|
||||||
type: workshop-meta
|
|
||||||
---
|
|
||||||
```
|
|
||||||
|
|
||||||
Тело — содержимое буфера (можно слегка причесать заголовки, секции типа TODO убрать — они уже сепарированы в action-items).
|
|
||||||
|
|
||||||
- **domain:** `mcp__projects-meta__knowledge_ingest` с параметрами:
|
|
||||||
- `project: <target>`
|
|
||||||
- `path: concepts/<topic>.md` (внутри target wiki)
|
|
||||||
- `content: <тело буфера с frontmatter>`
|
|
||||||
|
|
||||||
Если `knowledge_ingest` падает → abort до tasks_create и до `git mv`. Сообщить пользователю.
|
|
||||||
|
|
||||||
- **skill:** двухпроходной.
|
|
||||||
|
|
||||||
**Проход первый (этот скил):**
|
|
||||||
|
|
||||||
1. **Диалог по `description`** — поведенческий контракт активации скила. Показать пользователю summary буфера и спросить:
|
|
||||||
- На каких триггер-фразах скил должен активироваться? (минимум 2-3, лучше — пары русский/английский)
|
|
||||||
- Что скил делает в одном предложении?
|
|
||||||
- Когда скил **не должен** активироваться (антипаттерны)?
|
|
||||||
|
|
||||||
Из ответов собрать `description` строкой ~200-400 символов в стиле существующих скилов (см. `~/projects/claude-skills/skills/*/SKILL.md` для примеров).
|
|
||||||
|
|
||||||
2. **Preview + confirm** (обязательно):
|
|
||||||
```
|
|
||||||
Писать в: ~/projects/claude-skills/skills/<name>/SKILL.md
|
|
||||||
Frontmatter: name=<name>, version=0.1.0, description=<...>
|
|
||||||
Body: пустой каркас с заголовками
|
|
||||||
When to use / Inputs / Steps / Failure modes / Side effects / What NOT to do
|
|
||||||
Коммит: feat(skills): add <name> v0.1.0 (promoted from .workshop/.brainstorm/<topic>.md)
|
|
||||||
Без: install.sh, push, build-hermes (это в созданных тасках)
|
|
||||||
ОК?
|
|
||||||
```
|
|
||||||
|
|
||||||
3. После confirm:
|
|
||||||
- `mkdir -p ~/projects/claude-skills/skills/<name>/`
|
|
||||||
- `Write` файла `~/projects/claude-skills/skills/<name>/SKILL.md`:
|
|
||||||
|
|
||||||
```markdown
|
|
||||||
---
|
|
||||||
name: <name>
|
|
||||||
version: 0.1.0
|
|
||||||
description: <вписанный пользователем триггер-контракт>
|
|
||||||
---
|
|
||||||
|
|
||||||
# <name>
|
|
||||||
|
|
||||||
<одно-два предложения что скил делает — из диалога>
|
|
||||||
|
|
||||||
## When to use
|
|
||||||
|
|
||||||
<пусто, дописывается во втором проходе>
|
|
||||||
|
|
||||||
## Inputs
|
|
||||||
|
|
||||||
<пусто>
|
|
||||||
|
|
||||||
## Steps
|
|
||||||
|
|
||||||
<пусто>
|
|
||||||
|
|
||||||
## Failure modes
|
|
||||||
|
|
||||||
<пусто>
|
|
||||||
|
|
||||||
## Side effects
|
|
||||||
|
|
||||||
<пусто>
|
|
||||||
|
|
||||||
## What NOT to do
|
|
||||||
|
|
||||||
<пусто>
|
|
||||||
```
|
|
||||||
|
|
||||||
- В `~/projects/claude-skills/`: `git -C ~/projects/claude-skills add skills/<name>/SKILL.md && git -C ~/projects/claude-skills commit -m "feat(skills): add <name> v0.1.0 (promoted from ~/projects/.workshop/.brainstorm/<topic>.md)"`.
|
|
||||||
- **STOP.** Не запускать `install.sh`. Не делать `git push`. Не править `hermes/mapping.yaml`. Это всё уйдёт тасками на шаге 7.
|
|
||||||
|
|
||||||
**Проход второй** — пользователь явно зовёт «доведём `<name>`» в этой же или следующей сессии. Источник лежит в `.archive/<date>-<topic>.md`, тело каркаса дописывается глазами. Вне scope этого скила.
|
|
||||||
|
|
||||||
8. **Создание тасок:**
|
8. **Создание тасок:**
|
||||||
|
|
||||||
> **NB (2026-08-24, инцидент mappa-skill-suite):** таски создавать **ПОСЛЕДОВАТЕЛЬНО**, не батчем и не параллельно. Параллельный `tasks_create` → гонка на sha-CAS общего счётчика (agenda-репо): часть тасок падает с PushRejected (при промоуте mappa-skill-suite 6/7 упали, повторены последовательно). Один `tasks_create` → дождаться ответа → следующий.
|
> **NB:** таски создавать **ПОСЛЕДОВАТЕЛЬНО**, не батчем. Один
|
||||||
|
> `task_create` → дождаться ответа → следующий.
|
||||||
|
|
||||||
- **domain (mandatory pre-impl) — `[<topic>-pointers]`:** **первой** создать таску, заполняющую `.wiki/CLAUDE.md` Domain conventions у target-проекта пойнтерами на спецификацию. Без неё импл-таски будут подняты со stub'ом в Domain conventions, и следующий агент попадёт в дыру: dense `where_stopped` one-liner + пустой stub = угадывание порогов / таксономий / pipeline-этапов. Параметры:
|
- **workshop-meta / domain:** для каждого action-item —
|
||||||
|
`mcp__mappa__task_create(project=<target>, slug=<kebab>, title, description,
|
||||||
|
status='ready')`. Create — карв-аут, лиз не нужен (wiki:2660/#1054).
|
||||||
|
Описание импл-таски ссылается на спеку (wiki:NNNN из шага 6).
|
||||||
|
- **skill:** три baseline-таски в `project='skills'`:
|
||||||
|
- `[<name>-install]` — запустить `install.sh` в `~/projects/skills/`,
|
||||||
|
проверить активацию в новой сессии.
|
||||||
|
- `[<name>-hermes-mapping]` — запись в `~/projects/skills/hermes/mapping.yaml`
|
||||||
|
(режим `auto` для стилевых, `pending` если трогает тулы/окружение).
|
||||||
|
- `[<name>-test-trigger]` — прогнать триггер-фразы из description:
|
||||||
|
активируется на своих, не активируется на 2-3 близких чужих.
|
||||||
|
Плюс content-таски из буфера (если были) — тоже в `project='skills'`,
|
||||||
|
slug-prefix `<name>-`.
|
||||||
|
- Если N-я таска упала — продолжить остальные, в конце сообщить какие
|
||||||
|
созданы / какие нет. Запомнить slug'и для review-umbrella.
|
||||||
|
|
||||||
- `target_project: <target>`
|
9. **Review-umbrella (для domain с импл-тасками и для skill — всегда):**
|
||||||
- `slug: <topic>-pointers`
|
|
||||||
- `status: ready`
|
|
||||||
- `description:` шаблон ниже
|
|
||||||
- `next_action:` готовый блок текста для копирования в `.wiki/CLAUDE.md` (шаблон ниже)
|
|
||||||
|
|
||||||
Description-шаблон:
|
`mcp__mappa__task_create(project=<target>, slug=<topic>-review,
|
||||||
|
status='blocked', blocker=<номера импл-тасок через запятую>, description=<чек-лист>)`
|
||||||
|
|
||||||
```
|
- **Кто делает:** не имплементер. Следующая сессия в этом проекте (другая
|
||||||
Bootstrap-pointers для design <topic>. Pre-fills target's `.wiki/CLAUDE.md`
|
модель / другой день / другой агент) с чистым контекстом. «Я только что
|
||||||
Domain conventions ссылками на спецификацию. Дизайн не лежит в этом репо —
|
это написал» bias = главный риск.
|
||||||
только pointer-stub. Без этой таски следующий агент попадёт в дыру:
|
- Чек-лист: прочитать спеку (wiki:NNNN из шага 6), `git log` shipped-коммитов,
|
||||||
where_stopped one-liner + пустой Domain conventions stub = угадывание
|
для каждой импл-таски прогнать тесты и сверить с acceptance criteria,
|
||||||
порогов / таксономий / pipeline-этапов вместо чтения готовых решений.
|
findings → follow-up tasks через `task_create`.
|
||||||
|
- Закрытие: все findings зафайлены ИЛИ ревьюер подтвердил «нет findings»
|
||||||
|
в close-note.
|
||||||
|
- Если review-таска упала — сообщить, **продолжить** к шагу 10 (промоут уже
|
||||||
|
сделан, шторм в archive).
|
||||||
|
|
||||||
**Кто делает:** любой следующий агент в этом проекте. Это первая по
|
10. **Covering-письмо в инбокс цели (канон mappa-delegation).** Таска на борде
|
||||||
приоритету таска промоушена — все остальные импл-таски ссылаются на
|
не пингует живую сессию, письмо = пинг + контекст:
|
||||||
pointers через .wiki/CLAUDE.md.
|
|
||||||
```
|
|
||||||
|
|
||||||
Next-action шаблон (pre-filled, копировать дословно — подменив `<topic>` и `<YYYY-MM-DD>`):
|
`mcp__mappa__inbox_send(project=<target>, from=<своя папка>, subject='Промоушен
|
||||||
|
<topic>: таски <#N…>', body=<перечень + wiki:NNNN спека>)`
|
||||||
|
|
||||||
```
|
11. **Финальный отчёт пользователю:**
|
||||||
В `.wiki/CLAUDE.md` секции "Domain conventions" вставить блок (или заменить
|
- Куда промочено: `wiki:NNNN` (спека в вики target).
|
||||||
дефолтный setup-wiki stub):
|
- Архив: `storm:N` (status=archive, номер стабилен).
|
||||||
|
- Какие таски созданы (ref, title, проект).
|
||||||
### Mandatory: read design context before implementation
|
- **Для skill:** напомнить про второй проход «доведём `<name>`».
|
||||||
|
|
||||||
Before picking up any task in `.tasks/`, load the full design context. It
|
|
||||||
does **not** live in this repo — only pointers do. Sources, in order:
|
|
||||||
|
|
||||||
1. **Global wiki design (canonical):** `mcp__projects-meta__knowledge_get`
|
|
||||||
с `slug = "concepts/<topic>"`. Architecture decisions, contracts, scope.
|
|
||||||
2. **Brainstorm process trace (rationale):**
|
|
||||||
`~/projects/.workshop/.archive/<YYYY-MM-DD>-<topic>.md`.
|
|
||||||
Why each decision was made, what was rejected and why, anti-patterns.
|
|
||||||
3. **Local `overview.md`** — thin summary of (1), used as quick orientation
|
|
||||||
only — never as the source of truth.
|
|
||||||
|
|
||||||
Do **not** invent thresholds, taxonomies, container topology, or pipeline
|
|
||||||
stages from task `where_stopped` lines alone — those are pointers, not
|
|
||||||
specifications.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
Закоммитить: `wiki(claude): add design-context pointers for <topic>`.
|
|
||||||
```
|
|
||||||
|
|
||||||
Конкретные значения, которые промоутер должен подставить **заранее** в
|
|
||||||
текст next_action перед `tasks_create`:
|
|
||||||
|
|
||||||
- `<topic>` — тема промоушена (тот же slug, что используется в `concepts/<topic>.md` и в `.archive/<YYYY-MM-DD>-<topic>.md`).
|
|
||||||
- `<YYYY-MM-DD>` — сегодняшняя дата (та же, что в шаге 9 архивации).
|
|
||||||
|
|
||||||
Если `tasks_create` для `<topic>-pointers` упала → **abort** до content-тасок и до review. Без pointers оставшиеся таски бесполезны: импл-агент будет угадывать. Сообщить пользователю, буфер оставить на месте.
|
|
||||||
|
|
||||||
- **workshop-meta / domain (content):** для каждого action-item:
|
|
||||||
- `mcp__projects-meta__tasks_create` с `project: <target>` (для domain) или с `project: <inferred>` (для workshop-meta — спросить пользователя если неоднозначно).
|
|
||||||
- Title — первая строка action-item; description — остальное.
|
|
||||||
|
|
||||||
- **skill:** **всегда** добавляются три baseline-таски в `project: claude-skills`:
|
|
||||||
- `[<name>-install]` — запустить `install.sh` в `~/projects/claude-skills/`, проверить что скил активируется в новой сессии, сделать `/reload-plugins`.
|
|
||||||
- `[<name>-hermes-mapping]` — добавить запись в `~/projects/claude-skills/hermes/mapping.yaml`. Режим: `auto` если скил чисто стилевой / response-style, `pending` если скил трогает инструменты или окружение (требует отдельного аудита).
|
|
||||||
- `[<name>-test-trigger]` — прогнать триггер-фразы из `description` на тестовом буфере: убедиться что активируется на своих фразах И не активируется на 2-3 близких чужих (false-positive check).
|
|
||||||
|
|
||||||
Плюс content-таски из самого буфера (если были) — также в `project: claude-skills`, slug-prefix `<name>-`.
|
|
||||||
|
|
||||||
- Если N-я таска упала — продолжить остальные, в конце сообщить какие созданы / какие нет.
|
|
||||||
- Запомнить slug'и созданных импл-тасок для шага 9.
|
|
||||||
|
|
||||||
9. **Review-чекпоинт.** Создаётся всегда для skill-промоушена; для domain-промоушена — только если N≥1 импл-тасок; для workshop-meta или N=0 (domain) — skip с пометкой в логе.
|
|
||||||
|
|
||||||
- **domain (N≥1):**
|
|
||||||
- `mcp__projects-meta__tasks_create`:
|
|
||||||
- `target_project: <target>`
|
|
||||||
- `slug: <topic>-review`
|
|
||||||
- `status: blocked`
|
|
||||||
- `blocker:` `«bootstrap: <topic>-pointers; impl-tasks: <номера #n через запятую>»` — блокеры по номерам (номер = машинный ключ; слаги оставить в скобках для читаемости).
|
|
||||||
- `description:` шаблон ниже.
|
|
||||||
- `next_action:` «Дождаться 🟢 у всех blocker-тасок (включая `<topic>-pointers` — без него pointers в `.wiki/CLAUDE.md` не залиты, и review будет читать stub). Прочитать спецификацию (см. путь в description). Для каждой импл-таски: `git show <commit>`, прогнать тесты в её scope'е, сверить с acceptance criteria. Findings → новые follow-up tasks через `mcp__projects-meta__tasks_create`.»
|
|
||||||
|
|
||||||
Description-шаблон (domain):
|
|
||||||
|
|
||||||
```
|
|
||||||
Code-review checkpoint для брейнсторма <topic> (промоушен <YYYY-MM-DD>).
|
|
||||||
|
|
||||||
**Спецификация:** <путь к промоушенному design-документу — concepts/<topic>.md в target-wiki>.
|
|
||||||
**Pre-impl bootstrap:** `<topic>-pointers` (заполнил `.wiki/CLAUDE.md` Domain conventions — без него review бы читал stub).
|
|
||||||
**Импл-таски (review против их acceptance criteria):** <номера #n из шага 9, слаги в скобках>.
|
|
||||||
|
|
||||||
**Кто делает:** **не имплементер.** Следующая сессия в этом проекте (другая модель / другой день / другой агент) поднимает таску с чистым контекстом. «Я только что это написал» bias = главный риск.
|
|
||||||
|
|
||||||
**Чек-лист ревью:**
|
|
||||||
- Прочитать спецификацию (acceptance criteria каждой импл-таски).
|
|
||||||
- `git log --oneline` shipped-коммитов (по slug или scope в commit-message).
|
|
||||||
- Для каждой импл-таски: прогнать соответствующие тесты, реально проверить что они доходят до своих веток (не coverage-illusion).
|
|
||||||
- Сверить дизайн-decisions со shipped-кодом (signature, params, error-paths, безопасность).
|
|
||||||
- Findings — отдельные follow-up tasks (`<topic>-<gap>-fix` или подобное) через `tasks_create`.
|
|
||||||
|
|
||||||
**Закрытие:** только когда все findings зафайлены ИЛИ ревьюер подтвердил «нет findings» в close-note.
|
|
||||||
```
|
|
||||||
|
|
||||||
- **skill:**
|
|
||||||
- `mcp__projects-meta__tasks_create`:
|
|
||||||
- `target_project: claude-skills`
|
|
||||||
- `slug: <name>-review`
|
|
||||||
- `status: blocked`
|
|
||||||
- `blocker:` `«impl-tasks: <name>-install, <name>-hermes-mapping, <name>-test-trigger[, content-impls если были]»` — номера `#n` из шага 9 (слаги в скобках для читаемости).
|
|
||||||
- `description:` шаблон ниже.
|
|
||||||
- `next_action:` «Дождаться 🟢 у baseline-тасок. Прогнать поведенческий smoke-test (см. чек-лист в description). Findings → follow-up tasks через `tasks_create`.»
|
|
||||||
|
|
||||||
Description-шаблон (skill):
|
|
||||||
|
|
||||||
```
|
|
||||||
Skill-review checkpoint для <name> (промоушен <YYYY-MM-DD>).
|
|
||||||
|
|
||||||
**Источник дизайна:** .workshop/.archive/<YYYY-MM-DD>-<topic>.md.
|
|
||||||
**Импл-таски:** <name>-install, <name>-hermes-mapping, <name>-test-trigger[, content-impls] — номера #n из шага 9.
|
|
||||||
|
|
||||||
**Кто делает:** **не имплементер.** Другая сессия / другой день / другой агент. Identity-not-location: ревьюер работает в любой папке, где есть доступ к файлам (см. `.workshop/.wiki/concepts/workshop-architecture.md` §5.1).
|
|
||||||
|
|
||||||
**Поведенческий smoke-test (это и есть acceptance):**
|
|
||||||
- Скил активируется в чистой сессии на каждой триггер-фразе из `description` (русский И английский варианты).
|
|
||||||
- Скил **не** активируется на 2-3 близких но не своих фразах из соседних доменов (false-positive check).
|
|
||||||
- Каждый шаг секции `Steps` отрабатывает на тестовом буфере без ошибок.
|
|
||||||
- `Failure modes` уводят в abort, не в частичный успех с грязным состоянием.
|
|
||||||
- `What NOT to do` соответствует реальности — нет дыры между правилом и реализацией.
|
|
||||||
|
|
||||||
Findings — обычные follow-up tasks (`<name>-<gap>-fix` или подобное) через `tasks_create` в `claude-skills`.
|
|
||||||
|
|
||||||
**Закрытие:** только когда все findings зафайлены ИЛИ ревьюер подтвердил «нет findings» в close-note.
|
|
||||||
|
|
||||||
**NB по семверу:** `version: 0.1.0` записан промоутером. Дальнейшие инкременты — ответственность владельца `claude-skills/`, **не** этого скила и не ревьюера. Если ревью требует правок — правит владелец, бампит он же.
|
|
||||||
```
|
|
||||||
|
|
||||||
- Если `tasks_create` review-таски упала — сообщить пользователю, **продолжить** к шагу 11 (архивация буфера). Review-таску можно создать вручную позже из `.archive/<date>-<topic>.md`.
|
|
||||||
|
|
||||||
- **domain (service channel):** review-umbrella — **сервисная таска**: `mcp__mappa__task_create(project=<target>, slug=<topic>-review, status='blocked', blocker=<номера импл-тасок через запятую>, description=<шаблон domain выше, спека = wiki:NNNN в вики проекта>)` — create = карв-аут (без лиза). Pointers-таска отсутствует (спека в вики).
|
|
||||||
|
|
||||||
**Covering-письмо в инбокс цели (оба канала; канон mappa-delegation).** После создания тасок — `inbox_send` получателю-проекту: таска на борде не пингует живую сессию, письмо = пинг + контекст. File channel: `mcp__mappa__inbox_send(project=<target>, from=<своя>, subject='[event: created] <topic> — <N> тасок', body=<перечень: #N slug> )`. Service channel: то же, но `from` = своя папка (или сервисный адрес) и тело ссылается на wiki:NNNN-спеку.
|
|
||||||
|
|
||||||
10. **Workshop-wiki summary (обязательно для всех маршрутов):**
|
|
||||||
|
|
||||||
`Write` → `.wiki/concepts/<topic>.md` с frontmatter:
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
---
|
|
||||||
date: <YYYY-MM-DD>
|
|
||||||
source: .brainstorm/<topic>.md → .archive/<YYYY-MM-DD>-<topic>.md
|
|
||||||
status: promoted
|
|
||||||
type: workshop-meta
|
|
||||||
---
|
|
||||||
```
|
|
||||||
|
|
||||||
Содержание (≤60 строк):
|
|
||||||
- **Что решили** — ключевые решения раундов (не пересказ, а outcomes).
|
|
||||||
- **Куда промочено** — полный путь: target-wiki / claude-skills / local concepts.
|
|
||||||
- **Задачи** — перечень slug'ов, созданных в шаге 7.
|
|
||||||
- **Ссылки** — архив буфера + связанные концепты в workshop-вики + глобальная вики.
|
|
||||||
|
|
||||||
Для **workshop-meta**: summary — сокращение полного контента (который уже в `.wiki/concepts/<topic>.md` шага 6); если шаг 6 уже записал туда полный файл — шаг 9 его дополняет секцией «Куда промочено / Задачи» или пропускается (не дублировать).
|
|
||||||
|
|
||||||
Затем обновить `index.md` — добавить строку в нужную секцию.
|
|
||||||
|
|
||||||
Если `Write` упал → сообщить, **не блокировать** архивацию (summary менее критична чем content-промоушен).
|
|
||||||
|
|
||||||
11. **Архивация:**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git -C ~/projects/.workshop mv .brainstorm/<topic>.md .archive/<YYYY-MM-DD>-<topic>.md
|
|
||||||
```
|
|
||||||
|
|
||||||
**Только** если шаги 6 и 7 прошли (или прошли с допустимым partial — пользователь подтвердил). Иначе — оставить буфер на месте, чтобы можно было ретраиить.
|
|
||||||
|
|
||||||
12. **Лог:** дописать в `.wiki/log.md`:
|
|
||||||
|
|
||||||
```
|
|
||||||
<date> promoted <topic> → <destination> [created N tasks in <proj>]
|
|
||||||
```
|
|
||||||
|
|
||||||
Для skill — `<destination>` = `claude-skills/skills/<name>/SKILL.md (skeleton)`.
|
|
||||||
|
|
||||||
13. **Финальный отчёт пользователю:**
|
|
||||||
- Куда промочено (полный путь).
|
|
||||||
- Какие таски созданы (id, title, проект).
|
|
||||||
- Куда уехал исходник.
|
|
||||||
- **Для skill:** напомнить что нужен второй проход «доведём `<name>`» для дописывания тела каркаса.
|
|
||||||
|
|
||||||
## Failure modes
|
## Failure modes
|
||||||
|
|
||||||
- `.brainstorm/<topic>.md` отсутствует → abort.
|
- Шторм не найден в mappa (нет storm-сущности и нет файлового легаси) → abort,
|
||||||
- `mcp__projects-meta` недоступен → abort до записей.
|
сообщить: создать шторм через HTTP POST /entities (шаг 1) или дождаться
|
||||||
- Целевой проект (для domain) не найден в `meta_status` → abort.
|
импорта.
|
||||||
- `knowledge_ingest` упал → abort до `tasks_create` и `git mv`. Буфер остаётся.
|
- Целевой проект (domain) не существует в mappa → abort до промоута.
|
||||||
- **Service channel:** create упал (гонка счётчика/переходный период) → **повторить последовательно**, не батчем; при стабильном отказе — abort до архивации.
|
- `storm_promote` упал (409 версия / стабильный отказ) → retry со свежим
|
||||||
- **Service channel:** спека уже существует в вики проекта (wiki:NNNN) → не дублировать `wiki_create`, ссылаться на неё.
|
internal id; при повторном отказе — abort до создания тасок. Шторм остаётся
|
||||||
- **domain:** `tasks_create` для `[<topic>-pointers]` упал → **abort** до content-тасок и до review-таски. Без pointers оставшиеся таски бесполезны (агент будет угадывать). Сообщить пользователю; буфер оставить на месте для retry.
|
в buffer — ретраится позже.
|
||||||
- `tasks_create` упал на N-й content-таске → продолжить остальные. Сообщить partial. **Не делать** `git mv` без подтверждения пользователя.
|
- Шторм уже `archive` (повторный вызов) → abort: промоут one-shot, идемпотентность
|
||||||
- `tasks_create` упал на review-таске (шаг 8) → не блокировать; перейти к архивации, сообщить пользователю чтобы создал вручную из `.archive/`.
|
через статус (решение 7).
|
||||||
- **Skill:** `~/projects/claude-skills/` не существует → abort с сообщением «клонируй через update-claude-skills или вручную».
|
- `task_create` упал на N-й content-таске → продолжить остальные, сообщить
|
||||||
- **Skill:** `~/projects/claude-skills/skills/<name>/` уже существует → abort с сообщением «скил уже существует, обновляйся обычным маршрутом в `claude-skills/`».
|
partial. Промоут уже сделан — шторм не откатывается.
|
||||||
- **Skill:** пользователь не подтвердил preview перед записью → abort, состояние не меняется.
|
- `task_create` review-umbrella упал → не блокировать, сообщить пользователю
|
||||||
- **Skill:** локальный `git commit` в `claude-skills/` упал (например, не настроен user.email) → файл остаётся, сообщить пользователю что коммит нужно сделать руками; **не** делать `git mv` буфера до подтверждения.
|
(создать вручную из шага 9).
|
||||||
|
- **Skill:** `~/projects/skills/` не существует → abort.
|
||||||
|
- **Skill:** `~/projects/skills/skills/<name>/` уже существует → abort.
|
||||||
|
- **Skill:** пользователь не подтвердил preview → abort, состояние не меняется.
|
||||||
|
- **Skill:** локальный `git commit` в `~/projects/skills/` упал → файл остаётся,
|
||||||
|
сообщить что коммит нужно сделать руками; промоут шторма не блокируется.
|
||||||
|
|
||||||
## Side effects
|
## Side effects
|
||||||
|
|
||||||
- **Всегда (любой маршрут):** создаёт summary-страницу `.wiki/concepts/<topic>.md` в `.workshop/` + добавляет строку в `index.md`.
|
- **Всегда:** `storm_promote` — атомарно wiki-страница в target + шторм →
|
||||||
- **workshop-meta:** summary IS контент (шаг 6 записывает полное тело; шаг 9 дополняет секцию «задачи/ссылки» или пропускается если уже полный).
|
`archive` + рёбра parent_of (wiki→storm, refs→storm) + событие `storm.promoted`.
|
||||||
- **domain:** создаёт запись в target-wiki через MCP (`mcp__projects-meta__knowledge_ingest`).
|
Файловый `.archive/` НЕ трогается (легаси read-only).
|
||||||
- **domain (service channel):** создаёт спека-сущность в вики mappa-проекта (`mcp__mappa__wiki_create`, карв-аут wiki:2660); импл-таски + review-umbrella — сервисные таски (`mcp__mappa__task_create`, карв-аут); covering-письмо в инбокс цели (`inbox_send`). Pointers-таска НЕ создаётся (спека уже в вики).
|
- **workshop-meta:** wiki-страница (концепт) в вики `.workshop`.
|
||||||
- **domain:** создаёт также **mandatory pre-impl** таску `[<topic>-pointers]` в target — pre-filled блок текста для `.wiki/CLAUDE.md` Domain conventions (ссылки на global wiki slug + workshop archive trace + local overview.md). Без неё последующий импл-агент попадает в дыру: where_stopped one-liner + пустой Domain conventions stub.
|
- **domain:** спека-страница в вики целевого проекта (с frontmatter-summary,
|
||||||
- **skill:** создаёт `~/projects/claude-skills/skills/<name>/SKILL.md` — **только шапка + пустой каркас**. Локальный коммит в `claude-skills/`. **Без** установки, push, или build-hermes — это всё в созданных baseline-тасках.
|
wiki:2661) + импл-таски + review-umbrella + covering-письмо.
|
||||||
- Создаёт N тасок в target `.tasks/` через MCP.
|
- **skill:** каркас `~/projects/skills/skills/<name>/SKILL.md` (только шапка +
|
||||||
- Для domain (N≥1) или skill: создаёт зонтичную review-таску (status=blocked, blocker=impl-slugs; для domain — также включает `<topic>-pointers`) в том же target.
|
пустой 6-секционный каркас) + локальный коммит в `~/projects/skills/`.
|
||||||
- Перемещает `.brainstorm/<topic>.md` → `.archive/<date>-<topic>.md`.
|
**Без** install.sh, push, build-hermes — это в baseline-тасках.
|
||||||
- Аппендит строку в `.wiki/log.md`.
|
- Создаёт N тасок в target через `mcp__mappa__task_create` (карв-аут).
|
||||||
- **Семвер скилов:** при target=skill промоутер записывает `version: 0.1.0` в шапку. Дальнейшие инкременты — ответственность владельца `claude-skills/`, **не** этого скила. При попытке промоушена в существующий скил — abort (см. Failure modes).
|
- Создаёт review-umbrella таску (status=blocked, blocker=impl#).
|
||||||
|
- Отправляет covering-письмо в инбокс target.
|
||||||
|
|
||||||
## What NOT to do
|
## What NOT to do
|
||||||
|
|
||||||
- Не писать доменное содержимое в локальный `.wiki/concepts/` (правило #1 из `.workshop/CLAUDE.md`). Summary-страница шага 11 — это trace/навигация, не domain-контент.
|
- **Не писать в файловые `.brainstorm/`/`.archive/`** — read-only легаси после
|
||||||
- Не пропускать шаг 9 (workshop-wiki summary) — именно так следующая сессия узнаёт что буфер был и куда ушёл.
|
флипа (решение 15). Буфер живёт в mappa storm-сущности.
|
||||||
- Не делать `git mv` буфера до успеха promotion+tasks.
|
- **Не использовать `mcp__projects-meta__tasks_create` / `knowledge_ingest` /
|
||||||
- Не удалять буфер вместо `git mv` — теряется история.
|
`knowledge_promote`** — файловые каналы выпилены. Таски — `mcp__mappa__task_create`,
|
||||||
- **Skill:** не пытаться автоматически переформатировать тело буфера в каркас `Steps`/`Failure modes`/etc. — это поведенческий контракт, не косметика. Каркас остаётся пустым; тело дописывается во втором проходе глазами.
|
вики — `storm_promote` (контент) + `wiki_create`/`wiki_update` (доп. страницы).
|
||||||
- **Skill:** не запускать `install.sh`. Не делать `git push` в `claude-skills/`. Не править `hermes/mapping.yaml`. Не запускать `build-hermes.py`. Это работа baseline-тасок, не промоутера.
|
- Не делать `git mv` буфера в архив — промоут архивирует сам.
|
||||||
- **Skill:** не бампить `version` после первой записи (это работа владельца `claude-skills/`).
|
- Не удалять шторм вместо промоута — теряется граф-история (parent_of, refs).
|
||||||
- **Skill:** не промоутить в существующий скил (см. Failure modes — abort).
|
- Не батчить `task_create` (гонка; инцидент 2026-08-24: 6/7 упали) — только
|
||||||
- **Skill:** не пропускать обязательный preview + confirm перед `Write` — действие выходит за пределы мастерской, изменяет соседний репозиторий.
|
последовательно.
|
||||||
- **Service channel:** не батчить `task_create` (гонка sha-CAS счётчика, инцидент 2026-08-24: 6/7 упали) — только последовательно. Create — карв-аут, лиз не нужен.
|
- Не забывать covering-письмо — таска на борде не пингует живую сессию.
|
||||||
- **Service channel:** не плодить pointers-таску, если спека уже в вики проекта (wiki:NNNN) — описание импл-тасок ссылается на неё инлайн.
|
- **Skill:** не переформатировать тело буфера в каркас автоматически — тело
|
||||||
- **Service channel:** не забывать covering-письмо в инбокс цели — таска на борде не пингует живую сессию.
|
дописывается вторым проходом глазами.
|
||||||
|
- **Skill:** не запускать `install.sh`, не делать push, не править
|
||||||
|
`hermes/mapping.yaml` — это baseline-таски.
|
||||||
|
- **Skill:** не промоутить в существующий скил (abort).
|
||||||
|
|||||||
Reference in New Issue
Block a user