fix(agents): вернуть opt-in 'session sync: write to mappa' в AGENTS.md\n\nСтроку вырезал коммит 79adaf9 «канон-блок — краткая суть гейтов вместо обрубков» (task:3017)\nпри переработке проекции канон-блока. Без неё pi-расширение (mappa.ts isOptedIn) не поднимает\nlive-ingest → сессии проекта не пишутся в mappa.\n\nВосстановлено на исходную позицию (контекст из вырезавшего коммита).

Тело блока — 0 изменений (рендер == живая курированная форма, issue:110);
нормализован стык (контракт mergeCanonBlock, task:3023).

.agents/inbox/README.md

@@ -0,0 +1,5 @@
+# ⛔ Файловый инбокс закрыт
+
+**Не читать. Не править.** Канал почты — mappa (`mcp__mappa__inbox_*`): письма = inbox-сущности проекта. Скилы: `mappa-messaging`, `mappa-session-orient` (raise on start).
+
+Файлы ниже — легаси-история (файловый канал закрыт решением 2026-08-25).

.gitignore

@@ -90,3 +90,6 @@ coverage/
 # Missing here made `git status` see `?? .tasks/claims/` → poller skipped every
 # claim with "working tree dirty". Mirrors .common/.gitignore.
 .tasks/claims/
+
+# mappa bootstrap cache (генерируется, не в репо)
+.mappa/share/

.mappa/config.yaml

@@ -0,0 +1,9 @@
+# mappa project marker — machine-readable identifier of a mappa project folder
+schema_version: 1          # версия схемы файла (bump при изменении структуры)
+protocol_version: 1        # версия протокола интерпретации маркера
+project: skills
+tenant: vitya
+url: https://mappa.vds.kzntsv.site
+git_provider: gitea
+git: OpeItcLoc03/skills
+git_host: git.kzntsv.site

.tasks/.archive/done-2026-08.md

@@ -1151,3 +1151,173 @@ Findings → follow-up tasks в claude-skills.
 ---
 
 
+## 🟢 [project-discipline-dist-rebuild] — dist/project-discipline.skill устарел (v0.1.2 внутри vs source v0.2.0) — коммит 42ed5ea не пересобрал пакет (нарушение Rule 3). Найдено: sovereign-catalog-wave2-review (F1).
+
+**Status:** done
+**Where I stopped:** closed without action — починено воркшопом upstream (d7903c3): dist/project-discipline.skill пересобран, внутри version: 0.2.1. — 42ed5ea bumped project-discipline v0.1.2→v0.2.0 (Rule 4 push-freely) коснувшись только skills/project-discipline/SKILL.md; dist/project-discipline.skill несёт v0.1.2 (ask-before-push семантика). update-skills раскатит старый пакет.
+**Next action:** (none — done upstream d7903c3)
+** Пересобрать: bash scripts/build.sh --prune (или build.ps1 -Prune) → проверить version: 0.2.0 внутри dist/project-discipline.skill (unzip -p ... | grep ^version); commit "build(project-discipline): rebuild dist archive v0.1.2→v0.2.0". Автор фикса — имплементер 42ed5ea.
+**Branch:** master
+**Weight:** cheap-ok
+**Notify:** OpeItcLoc03/workshop
+<!-- created-by: vitya@DESKTOP-NSEF0UK / from: sovereign-catalog-wave2-review / 2026-08-12 -->
+
+---
+<!-- closed-by: vitya@DESKTOP-NSEF0UK / 2026-08-12 / fixed upstream d7903c3 (workshop) before review push -->
+
+
+
+## 🟢 [project-discipline-description-contradiction] — frontmatter description в project-discipline самопротиворечив: новое Rule 4 (push freely) + остаток старого grant-текста («разреши автопуш», session end resets to ask-mode) + Rule 5 продублирован (L13-15 и L18-20). Description идёт в available-skills system prompt → другие проекты получают противоречивую push-политику. Найдено: sovereign-catalog-wave2-review (F2).
+
+**Status:** done
+**Where I stopped:** closed without action — починено воркшопом upstream (d7903c3): grant-текст + дублированный Rule 5 вычищены из description, source v0.2.1. — skills/project-discipline/SKILL.md L11-20: L11-15 новое Rule 4 + L16-17 старый grant-текст «— grant via "разреши автопуш"…» + L18-20 дубль Rule 5. Тело (L82-103) корректно (push-gate модель).
+**Next action:** (none — done upstream d7903c3)
+** Переписать description: выкинуть grant-текст («разреши автопуш»/«allow auto-push»/session reset), свести Rule 5 в один пункт, сохранить push-gate-нюанс (books — auto-deploy). Сверить с телом Rule 4. Bump: PATCH 0.2.1 (текст-фикс) — решение при исполнении. Автор фикса — имплементер 42ed5ea.
+**Branch:** master
+**Weight:** needs-claude
+**Notify:** OpeItcLoc03/workshop
+<!-- created-by: vitya@DESKTOP-NSEF0UK / from: sovereign-catalog-wave2-review / 2026-08-12 -->
+
+---
+<!-- closed-by: vitya@DESKTOP-NSEF0UK / 2026-08-12 / fixed upstream d7903c3 (workshop) before review push -->
+
+
+
+## 🟢 [de-superpowers-skill-readmes] — 3 per-skill README ещё несут superpowers-ссылки после волны de-superpowers: project-bootstrap/README.md:47 (фактически врёт про шаблон — «use superpowers» уже удалён из CLAUDE.md.template), project-discipline/README.md:13 (docs/superpowers/ пути), recommend-dont-menu/README.md:7 (superpowers:brainstorming). Найдено: sovereign-catalog-wave2-review (F4).
+
+**Status:** done
+**Where I stopped:** done — 3 README вычищены (bootstrap L47 под актуальный шаблон; discipline L13 без docs/superpowers/ + заодно стейл Rule 4 «Commit yes, push no» → «Push freely by default» — тот же класс, что F2; recommend-dont-menu L7 без superpowers:brainstorming). dist пересобран (build.ps1 -Names), lint 39/0.
+**Next action:** (none — done)
+**Branch:** master
+**Weight:** cheap-ok
+**Notify:** OpeItcLoc03/workshop
+<!-- created-by: vitya@DESKTOP-NSEF0UK / from: sovereign-catalog-wave2-review / 2026-08-12 -->
+<!-- closed-by: vitya@DESKTOP-NSEF0UK / 2026-08-12 / workshop — de-superpowers done, dist rebuilt, lint 39/0 -->
+
+---
+
+
+## 🟢 [skills-live-claudemd-superpowers-trigger] — корневой CLAUDE.md репо skills всё ещё содержит триггер «use superpowers» (L5); шаблон project-bootstrap уже без него (de-superpowers), свой файл не перегенерирован. Найдено: sovereign-catalog-wave2-review (F5).
+
+**Status:** done
+**Where I stopped:** done — «use superpowers» удалён из корневого CLAUDE.md; остальные 12 триггерных строк сверены с установленными скилами (все валидны: caveman, using-wiki, using-tasks, using-projects-meta, pulling-before-work, session-handoff, session-inbox-monitor, project-discipline, tdd-criteria, using-interns, recommend-dont-menu, active-platform).
+**Next action:** (none — done)
+**Branch:** master
+**Weight:** cheap-ok
+**Notify:** OpeItcLoc03/workshop
+<!-- created-by: vitya@DESKTOP-NSEF0UK / from: sovereign-catalog-wave2-review / 2026-08-12 -->
+<!-- closed-by: vitya@DESKTOP-NSEF0UK / 2026-08-12 / workshop — trigger dropped, triggers verified against installed skills -->
+
+---
+
+
+## 🟢 [using-tasks-archive-path-fix] — `skills/using-tasks/SKILL.md` документирует `.tasks/archive/YYYY-MM.md`, реальная конвенция репо — `.tasks/.archive/done-YYYY-MM.md` (см. `done-2026-05.md`, `done-2026-08.md`). Найдено: sovereign-catalog-wave2-review (finding, передано воркшопу 13:43Z).
+
+**Status:** done
+**Where I stopped:** done — SKILL.md v1.4.0→v1.4.1 (PATCH): 5 путей исправлены (layout → `.archive/done-YYYY-MM.md`, intro, «Where» + commit-пример + Rules-буллет → `.tasks/.archive/done-YYYY-MM.md`), README чист. dist пересобран (build.ps1 -Names using-tasks), lint 39/0. Фикс: `bff9c62`.
+**Next action:** (none — done)
+**Branch:** master
+**Weight:** cheap-ok
+**Notify:** OpeItcLoc03/workshop
+<!-- created-by: workshop session (from: sovereign-catalog-wave2-review finding) / 2026-08-12 -->
+<!-- closed-by: vitya@DESKTOP-NSEF0UK / 2026-08-12 / workshop — archive path fixed in using-tasks v1.4.1, dist rebuilt -->
+
+
+## 🟢 [brainstorming-skill-review] — Review нового скила `brainstorming` v0.1.0 (не-имплементер сессия). Scope: `skills/brainstorming/SKILL.md` + dist + README (commit 5d2e455) — адаптация diverging-фазы из obra/superpowers @ 6.2.0 (MIT) под наши конвенции.
+
+## Обязательные скилы — вызвать до начала работы
+
+- invoke `pulling-before-work` — `git pull --ff-only` ПЕРЕД началом ревью (свежий origin, никаких рассинхронов); это же правило при коммите отчёта: pull перед push
+- invoke `using-tasks` — статус задачи
+
+Проверять: (1) HARD-GATE «не имплементировать без одобренного дизайна» присутствует и не ослаблен; (2) spec-location соответствует project-discipline rule 1 (.brainstorm/ в зоне, .wiki/concepts/ в проектах); (3) триггер-дискриминация чистыми pi -p субагентами: «забрендшторми», «поштормим», «накидай идеи», "brainstorm this" → brainstorming; «прогриль мой план» → grilling (не коллизит); «порекомендуй» → recommend-dont-menu (не коллизит); (4) lint 0/0, dist/brainstorming.skill пересобран, ~/.claude/skills/brainstorming синхронен, adapted-from пин корректен (obra/superpowers @ 6.2.0); (5) переход в grilling/промоушен описан, а не в writing-plans. Evidence-метод: clean-context не-имплементер субпроцессы (pi -p). Отчёт писать в .workshop/.brainstorm/brainstorming-skill-review.md. Полосы: доска skills — твоя (close/push), .workshop — моя; отчёт в .workshop — единственное твоё касание зоны.
+
+**Status:** done
+**Where I stopped:** VERDICT PASS 6/6 (HARD-GATE, spec-location Rule 1, transition grilling/промоушен, lint 42/0, dist 0/42, pin obra/superpowers @ 6.2.0, README en+ru). Trigger-дискриминация clean pi -p: pos 4/4 → brainstorming, neg 2/2 (прогриль→grilling, порекомендуй→recommend-dont-menu) без коллизий. 3 информационных findings (using-tasks 1.4.0 installed vs 1.4.1 — вне скоупа; каталог 42 — diagnosing-bugs/writing-skills не ревьюились; протокол полос соблюдён). Отчёт: .workshop/.brainstorm/brainstorming-skill-review.md.
+**Next action:** (none — closed by review, VERDICT PASS) (не имплементер): 1) invoke pulling-before-work (pull --ff-only); 2) clean-context pi -p субагенты для триггер-дискриминации + статическая проверка SKILL.md/dist/README; 3) отчёт в .workshop/.brainstorm/brainstorming-skill-review.md; 4) pull перед push доски
+**Branch:** n/a
+**Notify:** OpeItcLoc03/workshop
+<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-08-12T14:04:31.548Z -->
+
+---
+<!-- closed-by: vitya@DESKTOP-NSEF0UK / 2026-08-12 / VERDICT PASS 6/6; report .workshop/.brainstorm/brainstorming-skill-review.md -->
+
+## 🟢 [diagnosing-bugs-writing-skills-review] — Review новых скилов `diagnosing-bugs` + `writing-skills` (v0.1.0 оба, не-имплементер сессия). Scope: HARD-GATE не ослаблен (diagnosing: no fixes w/o root cause; writing: no skill w/o failing test); анти-дубль гард (anti-sproul 45+); триггер-дискриминация clean pi -p (коллизии: «зафиксируй» в writing-skills вс гриллинг docs-mode, «почему падает» вс using-vds-ops инциденты); lint/dist/install/pin/README.
+
+**Status:** done
+**Where I stopped:** VERDICT PASS. HARD-GATE'ы целы (no-fixes-without-root-cause / no-skill-without-failing-test), anti-sproul жив, lint 45/0, dist/install sync, pins ok (mattpocock 84fdeffd + obra 6.2.0), README en+ru. Trigger clean pi -p: db 2/2 pos + 1/1 neg; ws 2/2 pos + 2/2 neg; F1: bare «почему падает» → system-snapshot, с субъектом работает; F2: «зафиксируй» пересекается с grilling docs-mode (контекст решает). Отчёт: .workshop/.brainstorm/diagnosing-bugs-writing-skills-review.md.
+**Next action:** (none — closed by review, VERDICT PASS) clean-context pi -p субагенты (пос и нег для обоих скилов) + статика; отчёт в .workshop/.brainstorm/diagnosing-bugs-writing-skills-review.md; pull перед push.
+**Branch:** n/a
+**Notify:** OpeItcLoc03/workshop
+<!-- created-by: vitya@DESKTOP-NSEF0UK / from: reviewer session (workshop offered, I took it) / 2026-08-12 -->
+
+---
+<!-- closed-by: vitya@DESKTOP-NSEF0UK / 2026-08-12 / VERDICT PASS; report .workshop/.brainstorm/diagnosing-bugs-writing-skills-review.md -->
+
+
+## 🟢 [session-ritual-context7-pins-review] — Не-имплементер ревью трёх изменений волны «7, 16 и 2» (commit 7b80a32): (1) session-handoff v0.4.0 — ритуал закрытия (idea 7: на session-end агент сам предлагает wiki-ingest + закрытия тасок; мутации = предложения, не молча; ритуал только на session-end фразе, не на substantive commit); (2) setup-context7 v2.0.0 — CLI-first переписывание (idea 16: установка ctx7 CLI, ключ в ~/.config/projects-secrets/ctx7.env, миграция с MCP-плагина — uninstall + чистка mcpServers.context7; подтверждение перед мутациями; smoke через ctx7 library); (3) vendored pins backfill (idea 2: caveman×5 → JuliusBrussee/caveman @ 0993277, find-skills → vercel-labs/skills @ c6f69c6, PATCH 0.1.1/1.0.1). Scope: HARD-GATE'ы (ритуал не пишет молча; setup-context7 не мутирует без подтверждения), триггер-дискриминация (ритуал vs using-tasks «закрываем эту таску»; «настрой context7» vs using-context7), lint/dist/install parity, README-таблица провенанса, description ≤1024 (idea 17).
+
+**Status:** done
+**Where I stopped:** VERDICT PASS. Гейты целы (ритуал=предложения+явное «да», setup-context7=паузы перед мутациями); дискриминация 4/4 (сворачиваемся→ritual, закрываем-эту-таску→using-tasks, настрой context7→setup, как использовать→using-context7); lint 45/0; dist 8/8; install sync; description 684/699<1024; бампы MINOR/MAJOR/PATCH адекватны; pins 0993277/c6f69c6 в frontmatter+en. F1: README.ru L84-85 «TBD» → follow-up readme-ru-pins-backfill. Отчёт: .workshop/.brainstorm/session-ritual-context7-pins-review.md.
+**Next action:** (none — closed by review, VERDICT PASS; follow-up readme-ru-pins-backfill) Прогнать clean-context review (review-kit-pi-method): структурный аудит трёх SKILL.md + lint 45/0 + dist parity + триггер-дискриминация pi -p для session-handoff (session-end фразы) и setup-context7. Вердикт → письмо в skills/.agents/inbox/ или закрытие таски.
+**Branch:** n/a
+**Notify:** OpeItcLoc03/skills
+<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-08-12T16:48:20.012Z -->
+
+---
+<!-- closed-by: vitya@DESKTOP-NSEF0UK / 2026-08-12 / VERDICT PASS; F1 → readme-ru-pins-backfill -->
+
+
+## 🟢 [readme-ru-pins-backfill] — README.ru.md строки 84-85 всё ещё «пин апстрима TBD» для caveman×5 и find-skills; 7b80a32 обновил en README + frontmatter (0993277 / c6f69c6), ru пропущен. Найдено: session-ritual-context7-pins-review (F1). en+ru parity — контракт каталога.
+
+**Status:** done
+**Where I stopped:** F1 закрыт: README.ru.md L84-85 обновлены (0993277 / c6f69c6), commit eb79b43, en+ru parity восстановлена.
+**Next action:** (none — kept until merged)
+**Branch:** master
+**Weight:** cheap-ok
+**Notify:** OpeItcLoc03/workshop
+<!-- created-by: vitya@DESKTOP-NSEF0UK / from: session-ritual-context7-pins-review / 2026-08-12 -->
+<!-- closed-by: OpeItcLoc03@DESKTOP-NSEF0UK / 2026-08-12T16:58:46.247Z / note: F1 закрыт: README.ru.md L84-85 обновлены (0993277 / c6f69c6), commit eb79b43, en+ru parity восстановлена. -->
+
+---
+
+
+## 🟢 [session-close-ritual-pi-extension] — Headless-часть ритуала закрытия (idea 7, claude-to-agents): pi-extension на `agent_settled` (по образцу inbox-monitor в .common/lib/pi-extensions/), который инжектит агенту сообщение «прогони ритуал закрытия» ОДИН раз за сессию (дедуп-гард, иначе петля agent_settled → ритуал → снова agent_settled). Интерактивная часть уже в session-handoff v0.4.0 (мутации = предложения, явное «да»). Деплой byte-identical в ~/.pi/agent/extensions/, функциональные тесты (положительный + decoy).
+
+**Status:** done
+**Where I stopped:** Extension built, tested, deployed: .common/lib/pi-extensions/session-close-ritual.ts (source) → ~/.pi/agent/extensions/ byte-identical. agent_end (не agent_settled — settle = no-followup-left, teardown) + hasUI=false guard + opt-in (CLAUDE.md trigger-line + .tasks/ + .git) + per-session loop-guard. Функциональные тесты 6/6 (positive once+loop, no-opt-in, no-.tasks, no-.git, interactive-skip, session-reset). Live: headless pi -p в opt-in проекте — ритуал выполнен: handoff-write по шаблону (frontmatter, recent commits, open треки, «Спроси user'а» с предложениями), wiki-ingest/закрытия — предложения, молча ничего не закрыто, лупы нет. Коммит .common d10da8d.
+**Next action:** (none — done, deployed; /reload в pi подхватит) Взять за образец .common/lib/pi-extensions/inbox-monitor.ts (PULL на agent_settled + дедуп per-process). Написать session-close-ritual.ts: on('agent_settled') → один раз за сессию инжект «выполни ритуал закрытия сессии (session-handoff v0.4.0): handoff-write + предложи wiki-ingest + предложи закрытия тасок». Тесты: прогон с реальным агентом — ритуал запускается ровно один раз, повторный agent_settled не триггерит.
+**Branch:** n/a
+**Notify:** OpeItcLoc03/skills
+<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-08-12T16:59:04.770Z -->
+
+---
+<!-- closed-by: vitya@DESKTOP-NSEF0UK / 2026-08-12 / built+tested+deployed; .common d10da8d; live-verified -->
+
+
+## 🟢 [session-close-ritual-extension-review] — Не-имплементер ревью pi-extension `session-close-ritual.ts` (headless-часть ритуала закрытия, idea 7). Скоуп: (1) структурный аудит кода — `.common/lib/pi-extensions/session-close-ritual.ts` (5473 B, dependency-free): opt-in логика (CLAUDE.md trigger-line + `.tasks/` + `.git`), loop-guard per-session-per-cwd, выбор `agent_end` vs `agent_settled` (обоснование в шапке файла), headless-only guard (`hasUI===false`), граница мутаций в инжектируемом сообщении (только handoff-write, wiki/закрытия — предложения); (2) тесты `.test.mjs` — покрывают ли 6 кейсов заявленных (positive once+loop, no-opt-in, no-.tasks, no-.git, interactive-skip, session-reset); (3) деплой byte-identical `~/.pi/agent/extensions/` vs source; (4) live-поведение: headless pi -p в opt-in проекте — ритуал ровно один раз, без лупы. Автор импл = тот же сессия что закрыла session-handoff ревью (anti-self-review обойдён) — ревью нужно для чистоты зоны. Commit: .common d10da8d, таска session-close-ritual-pi-extension 🟢.
+
+**Status:** done
+**Where I stopped:** (formal verdict appended after close) ФОРМАЛЬНОЕ ревью: VERDICT PASS + 2 LOW + 1 INFO, все пофикшены (LOW-1 rpc-decoy b11, LOW-2 mutation-boundary assert в b1, INFO per-cwd b12). Тесты 6→10→12/12, .common fb4ce3f, деплой byte-identical, live 1× без мутаций кроме handoff-write. agent_end-рационал подтверждён по исходникам pi (agent-session.js:779-780).
+**Next action:** (none — kept until merged)
+**Branch:** n/a
+**Notify:** OpeItcLoc03/skills
+<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-08-12T17:07:17.886Z -->
+<!-- closed-by: OpeItcLoc03@DESKTOP-NSEF0UK / 2026-08-12T17:15:34.005Z / note: Независимое ревью выполнено (clean-context субагент по 5 пунктам): багов не найдено, дизайн sound. 2 риска + 4 нита → пофикшены: RISK-1 mode-guard hasUI→ctx.mode==="print" (JSON/RPC = no injection), RISK-2 session-handoff v0.5.0 (дрейф убран, agent_end-рационал), NIT-4 тесты 6→10/10, NIT-6 версия из промпта. NIT-3/5/7 задокументированы (Node ≥22.6, at-most-once при throw, optInCache staleness). Коммиты .common 8510f1c, skills d304549, деплой byte-identical, тесты ALL PASSED. -->
+
+---
+
+
+## 🟢 [command-index-review] — Не-имплементер ревью нового скила `command-index` v0.1.0 (idea 3, claude-to-agents: just/Makefile как единый интерфейс управления проектом). Scope: (1) конвенция корректна — стандартные таргеты setup/test/lint/build/run/clean/help, help/--list = авто-док, just>make на Windows (идея 18: нативный бинарь, без sh); (2) анти-спроул — покрытия нет (в каталоге не было command-index/project-contract); (3) триггер-дискриминация clean pi -p: «как тут запускается» / «как собрать, запустить, протестить» → command-index, вход в проект с justfile → command-index; neg: «настрой таски» → setup-tasks, «как юзать вики» → using-wiki (не путать с setup-скилами и using-*); (4) lint 46/0, dist/install parity, description ≤1024. Follow-up (не скоуп): project-bootstrap эмитит justfile при бутстрапе.
+
+**Status:** done
+**Where I stopped:** VERDICT PASS. Конвенция корректна (таргеты setup/test/lint/build/run/clean/help, авто-док, just>make Windows); анти-спроул чист (ours); дискриминация clean pi -p: P1/P2 → command-index, N1 → setup-tasks, N2 → using-wiki; lint 46/0; dist/install sync; description 800≤1024. F1: README (en+ru) без строки → follow-up readme-command-index-row (с F2 стейл install.ps1). Отчёт: .workshop/.brainstorm/command-index-review.md.
+**Next action:** (none — closed by review, VERDICT PASS; follow-up readme-command-index-row) Прогнать clean-context review: структурный аудит SKILL.md против конвенции (стандартные таргеты, авто-док, just>make, НЕ-список), триггер-дискриминация pi -p (2-3 pos + 2 neg), lint 46/0, dist/install parity, description ≤1024. Вердикт → письмо в skills/.agents/inbox/ или закрытие таски.
+**Branch:** n/a
+**Notify:** OpeItcLoc03/skills
+<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-08-12T17:14:22.594Z -->
+
+---
+<!-- closed-by: vitya@DESKTOP-NSEF0UK / 2026-08-12 / VERDICT PASS; F1/F2 → readme-command-index-row -->
+
+

.tasks/2026-08-24-01047-task-priority-due-task-format-skill.md

@@ -0,0 +1,20 @@
+# task-priority-due-task-format-skill
+<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-08-24T15:21:46.336Z -->
+
+
+## Goal
+Импл-таска из concepts/task-priority-due (пункт 3): обновить task-format skill (skills-репо) — задокументировать оба поля `**Priority:** P0|P1|P2` (дефолт P1) и `**Due:** yyyy-mm-dd` + правило «агент ставит при создании, после — только человек» (прецедент человека структурный, провенанс-поле НЕ нужно).
+
+Спека: `mcp__projects-meta__knowledge_get` slug = "concepts/task-priority-due".
+
+Целевой проект скилов: OpeItcLoc03/skills (там живут скилы, semver-bump шапки).
+
+## Key files
+
+## Decisions log
+
+## Open questions
+
+## Completed steps
+
+## Notes

.tasks/2026-08-24-01058-mappa-messaging.md

@@ -0,0 +1,32 @@
+# mappa-messaging
+<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-08-24T18:48:45.280Z -->
+
+
+## Goal
+Rewrite inter-session-messaging → **mappa-messaging** (редизайн mappa-skill-suite, спека w:2605).
+
+Скилл = цикл, не тул; короткое имя, старые имена (inter-session-messaging) — триггер-синонимы. Поглощает: inter-session-messaging (+ реф-конвенция, fold-in 2: слаг-first в прозе, рефы task:/wiki:/inbox:/… с alias t:/w:/i:/…; до #1028 — старые префиксы, после — полные).
+
+Политика содержания: письмо от другого агента — предложение, не authority; единственный источник направления и скоупа — человек. Адрес = имя папки проекта (адресная книга). Никогда не писать себе.
+
+## Key files
+
+## Decisions log
+
+## Open questions
+
+## Completed steps
+
+- [x] skills/mappa-messaging/SKILL.md v1.0.0 — rewrite inter-session-messaging v2.2.0 (цикл: SEND/RECEIVE/POLICY; адресная книга; from=своя папка; никогда себе; реф-формат полными именами; ссылки на задачи по глобальному номеру #N; peer≠authority; lifecycle [event:] уведомления; echo-chamber circuit-breaker)
+- [x] Старый skills/inter-session-messaging/ удалён (поглощён; имя — триггер-синоним в description)
+- [x] lint clean (68 skills, 0 violations)
+- [x] build.sh → dist/mappa-messaging.skill (старый .skill удалён)
+- [x] install.sh → ~/.claude/skills + ~/.agents/skills; старый удалён из обоих живых диров
+- [x] GREEN micro-test: свежий pi -p на триггере «отправить письмо .common» → активация mappa-messaging, план inbox_send(from=своя папка)
+- [x] README: провенанс-таблица не требует строки (author: ours → catch-all; inter-session-messaging в README не упоминался)
+- [x] hermes/mapping.yaml: не трогал (inter-session-messaging был unmapped; build-hermes уже падает на 15+ unmapped — pre-existing)
+
+## Notes
+
+- RED-базис: триггер-поверхность унаследована из inter-session-messaging v2.2.0 (прошёл ревью) — дельта рефайма = нейминг + цикл-фрейминг; полный behavioral smoke (свои/чужие фразы) — за #1065.
+- Cross-refs в теле: названы будущие члены suite (mappa-task-work, mappa-closing-ritual, mappa-delegation, mappa-brainstorm-promote) — лягут по мере импла; до их появления старые скилы (using-tasks, session-handoff, delegate-task) продолжают существовать.

.tasks/2026-08-24-01059-mappa-knowledge.md

@@ -0,0 +1,30 @@
+# mappa-knowledge
+<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-08-24T18:48:55.340Z -->
+
+
+## Goal
+Rewrite using-wiki + using-wiki-graph → **mappa-knowledge** (редизайн mappa-skill-suite, спека w:2605).
+
+Скилл = цикл, не тул; старые имена — триггер-синонимы. Поглощает: using-wiki, using-wiki-graph (+ реф-конвенция, fold-in 2). Писать НЕЙТРАЛЬНО — не зависеть от summaries (таски #1026 нет); реф-префиксы до апгрейда #1028 — старые (w:/t:/i:), после — полные.
+
+Relational/структурные вопросы (связи, backlinks, сироты) — через graph-тулы, guarded failure-mode: одна страница и стоп, без многохоповых цепочек сам.
+
+## Key files
+
+## Decisions log
+
+## Open questions
+
+## Completed steps
+
+- [x] skills/mappa-knowledge/SKILL.md v1.0.0 — слияние using-wiki v2.2.0 + using-wiki-graph v1.1.0 в один цикл-скил (ingest/query/lint + граф-слой для реляционных/структурных вопросов)
+- [x] Старые skills/using-wiki/ + skills/using-wiki-graph/ удалены (поглощены; имена — триггер-синонимы в description)
+- [x] lint clean (67 skills, 0 violations)
+- [x] build.sh → dist/mappa-knowledge.skill; install.sh → dual targets; старые удалены из живых диров
+- [x] GREEN micro-test: свежий pi -p на реляционном вопросе (связь таска↔спека) → активация mappa-knowledge, граф-слой (graph_path→no-path, backlinks), корректная семантика рёбер
+- [x] Писано нейтрально (summaries/#1026 не упоминается); реф-конвенция полными именами (#1028, уже была в исходниках)
+
+## Notes
+
+- RED-базис: триггер-поверхность унаследована из using-wiki/using-wiki-graph (прошли ревью); дельта = слияние + цикл-фрейминг + guarded failure-mode графа. Полный behavioral smoke — за #1065.
+- Побочная lint-находка GREEN-теста: рефы в прозе (не [[викилинки]]) рёбер не дают → спека может быть сиротой, «таска↔спека» в графе теряется. Это известная семантика решения 4 (рёбра только из [[refs]]), не баг скила — отмечено как наблюдение, кандидат в follow-up, если понадобится проставлять [[викилинки]] при создании тасок-промоушена.

.tasks/2026-08-24-01060-mappa-brainstorm-promote.md

@@ -0,0 +1,28 @@
+# mappa-brainstorm-promote
+<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-08-24T18:49:01.966Z -->
+
+
+## Goal
+UPDATE workshop-promote-brainstorm → **mappa-brainstorm-promote** (редизайн mappa-skill-suite, спека w:2605). АПДЕЙТ, не rewrite.
+
+Fold-in 1: mappa-service target. Промоут в mappa-сервисные борды (mappa, .common, …) — отдельный канал: сервисные тулы mcp__mappa__task_create/wiki_create (под лизом, claim через task_claim_next); pointers-таска НЕ нужна, если спека уже в вики проекта (w:NNNN) — описание импл-таски ссылается на неё; review-umbrella — сервисная таска (status=blocked, blocker=impl#); covering-письмо в инбокс цели (канон delegate-task) — в обоих каналах. Файловый путь (projects-meta → .tasks/STATUS.md) остаётся.
+
+## Key files
+
+## Decisions log
+
+## Open questions
+
+## Completed steps
+
+- [x] skills/mappa-brainstorm-promote/SKILL.md v1.2.0 (MINOR) — UPDATE workshop-promote-brainstorm: добавлена 4-я ветка маршрутизации **mappa-service** (fold-in 1: лиз через task_claim_next, спека через mcp__mappa__wiki_create, импл-таски через mcp__mappa__task_create, pointers-таска НЕ нужна если спека в вики w:NNNN, review-umbrella сервисная таска, covering-письмо в инбокс цели)
+- [x] NB (2026-08-24, инцидент): tasks_create ПОСЛЕДОВАТЕЛЬНО, не батчем (гонка sha-CAS счётчика agenda; при промоуте mappa-skill-suite 6/7 упали) — в шаге 8 + failure modes + what-not-to-do
+- [x] File channel (projects-meta → .tasks/STATUS.md) сохранён; шаги перенумерованы (вставлен шаг 4)
+- [x] Старое имя workshop-promote-brainstorm — триггер-синоним в description; каталог git mv
+- [x] lint clean (67 skills, 0 violations); build.sh → dist/mappa-brainstorm-promote.skill (старый .skill удалён); install.sh → dual; старый удалён из живых диров
+- [x] GREEN micro-test: свежий pi -p на «промоутни брейнсторм… таргет mappa» → активация mappa-brainstorm-promote, service channel (лиз/task_create последовательно/wiki_create/без pointers/review-umbrella/covering-письмо)
+
+## Notes
+
+- RED-базис: UPDATE существующего скила (триггеры не менялись); дельта = fold-in 1 + NB последовательности. Полный behavioral smoke — за #1065.
+- Актуальность шага 3 (определение канала): сервисные борды — mappa, .common (доска в mappa-сущностях); обычные проекты — файловая доска. Определение по наличию .tasks/STATUS.md.

.tasks/2026-08-24-01061-mappa-delegation.md

@@ -0,0 +1,29 @@
+# mappa-delegation
+<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-08-24T18:49:07.632Z -->
+
+
+## Goal
+Rewrite delegate-task → **mappa-delegation** (редизайн mappa-skill-suite, спека w:2605).
+
+Скилл = цикл, не тул; старые имена — триггер-синонимы. Поглощает: delegate-task. Каждая кросс-проектная делегация — пара: tasks_create + covering-письмо в инбокс получателя (таска на доске не пингует живую сессию). #1054 create-без-лиза — опционально (контракт работает на текущих тулах); перейти, когда #1054 имплементится.
+
+НЕ применимо: self-assigned таски на своей доске («создать задачу себе» → mappa-task-work), работа своими руками, workshop-внутренние таски.
+
+## Key files
+
+## Decisions log
+
+## Open questions
+
+## Completed steps
+
+- [x] skills/mappa-delegation/SKILL.md v1.0.0 — rewrite delegate-task v0.5.1 (цикл: pre-flight gate → шаблон → preview → confirm → covering-письмо → review-umbrella → downstream)
+- [x] Старый skills/delegate-task/ удалён (поглощён; имя — триггер-синоним в description)
+- [x] Suite-ссылки: using-tasks→mappa-task-work, inter-session-messaging→mappa-messaging, using-wiki→mappa-knowledge; нота лизинговой модели #1054 (create-без-лиза — опционально, контракт работает на текущих тулах)
+- [x] lint clean (67 skills, 0 violations); build.sh → dist/mappa-delegation.skill (старый .skill удалён); install.sh → dual; старый удалён из живых диров
+- [x] GREEN micro-test: свежий pi -p на «создать задачу на агента… common» → активация mappa-delegation, обязательная пара tasks_create + covering-письмо (адрес из адресной книги, [event: created]), review-umbrella с наследованием weight
+
+## Notes
+
+- RED-базис: тело унаследовано из delegate-task v0.5.1 (прошёл ревью + smoke); дельта = rename, suite-ссылки, цикл-фрейминг, нота #1054. Полный behavioral smoke — за #1065.
+- Поглощает delegate-task без потери контента (все шаги 1–7 сохранены, включая weight-наследование review и downstream-правило task+letter).

.tasks/2026-08-24-01062-mappa-task-work.md

@@ -0,0 +1,31 @@
+# mappa-task-work
+<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-08-24T18:49:13.376Z -->
+
+
+## Goal
+Rewrite using-tasks + task-format + task-loop + priority-due → **mappa-task-work** (редизайн mappa-skill-suite, спека w:2605). Центральный, крупный.
+
+Скилл = цикл, не тул; старые имена — триггер-синонимы. Поглощает: using-tasks, task-format (вливается), task-loop (loop-mode ВНУТРИ, вариант A — отдельный скилл не создаётся), priority-due-раздел (P0-P2 + дедлайны: приоритет = территория человека, агенты ставят только при создании; дефолт P1; дедлайн-механика: notify при просрочке без авто-бампа).
+
+Цикл: выбор работы (claim) → исполнение → сдача (close + review-umbrella). Один триггер-сёрфейс: «поработай очередь» / «work the queue» → mode=loop.
+
+## Key files
+
+## Decisions log
+
+## Open questions
+
+## Completed steps
+
+- [x] skills/mappa-task-work/SKILL.md v1.0.0 — центральный цикл: ориентация → выбор работы (claim, priority/due) → исполнение → сдача (close + review-umbrella) + пауза/переключение
+- [x] Loop-mode ВНУТРИ (вариант A, отдельный скил не создаётся): «поработай очередь»/«work the queue» → цикл claim→work→close→claim; пустая очередь = стоп, без демона/CronCreate; session_break gate; consult gate (human-only/strict-human → STOP перед close/commit)
+- [x] Priority/Due-раздел: приоритет = территория человека, агент ставит только при создании, дефолт P1, просрочка → admin_overdue_scan notify однократно, без авто-бампа
+- [x] Формат таски (из task-format): mappa task_create схема (priority/due при создании) + legacy STATUS.md блок (переходный, Weight/Notify обязательны)
+- [x] Поглощены: using-tasks (борд/лиз/close/notify/рефы [[task:N]]), task-format (формат), task-loop (loop-mode), task-priority-due (раздел). Старые имена — триггер-синонимы в description
+- [x] lint clean (65 skills, 0 violations); build.sh → dist/mappa-task-work.skill (старые .skill удалены); install.sh → dual; старые удалены из живых диров
+- [x] GREEN micro-test: свежий pi -p на «поработай очередь» → активация mappa-task-work, loop-mode, стоп-гейты, пустая очередь = стоп без поллинга
+
+## Notes
+
+- RED-базис: контент унаследован из трёх скилов (все прошли ревью/smoke); дельта = слияние + цикл-фрейминг + priority/due раздел. Полный behavioral smoke (вкл. loop-mode, session-break, empty-stop) — за #1065.
+- Убраны: task-loop ссылки на projects-meta claim (primary — mappa task_claim_next; file channel — переходный, описан в секции legacy).

.tasks/2026-08-24-01063-mappa-closing-ritual.md

@@ -0,0 +1,30 @@
+# mappa-closing-ritual
+<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-08-24T18:49:19.363Z -->
+
+
+## Goal
+НОВЫЙ скилл **mappa-closing-ritual** (редизайн mappa-skill-suite, спека w:2605).
+
+Финиш-фаза форкфлоу: session-handoff(write) + PROPOSE wiki-ingest + task closes + sweep. Старт ≠ финиш: closing-ritual = write-path с процедурой и подтверждением. Ad-hoc: mode=light — явный вопрос «Сделать handoff?» в конце сессии (НЕ автоматический sweep); решение за человеком. Поглощает: session-handoff(write-часть).
+
+Handoff: sliding, per-project, versioned-история; read на старте — mappa-session-orient, write на финише — тут. Мутации (handoff write / wiki-ingest / task closes) — только после подтверждения пользователя.
+
+## Key files
+
+## Decisions log
+
+## Open questions
+
+## Completed steps
+
+- [x] skills/mappa-closing-ritual/SKILL.md v1.0.0 — НОВЫЙ скилл (финиш-фаза): scope check → mid-task capture → compose handoff → handoff_write (версия h:N) → PROPOSE wiki-ingest → PROPOSE task closes → один блок-предложение; мутации только после «да»
+- [x] mode=light для ad-hoc: явный вопрос «Сделать handoff?», НЕ автоматический sweep; решение за человеком
+- [x] Поглощает session-handoff (write-часть); read-часть уходит в mappa-session-orient (#1064); старое имя — триггер-синоним
+- [x] Старый skills/session-handoff/ удалён (включая hooks/commit-detector — новый дизайн: ритуал на session-end, не на substantive commit)
+- [x] lint clean (65 skills, 0 violations); build.sh → dist/mappa-closing-ritual.skill; install.sh → dual; старый удалён из живых диров
+- [x] GREEN micro-test: свежий pi -p на «завершаем сессию» → активация mappa-closing-ritual, полный ритуал (7 шагов), мутации только после «да», mode=light «Сделать handoff?»
+
+## Notes
+
+- RED-базис: write-процедура унаследована из session-handoff v1.0.0 (прошёл ревью); дельта = split read/write + mode=light + confirm-гейт. Полный behavioral smoke (триггеры свои + false-positive на task-зоне) — за #1065.
+- commit-detector hooks удалены осознанно: suite проектирует closing-ritual как session-end-driven, а не commit-driven.

.tasks/2026-08-24-01064-mappa-session-orient.md

@@ -0,0 +1,31 @@
+# mappa-session-orient
+<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-08-24T18:49:25.792Z -->
+
+
+## Goal
+НОВЫЙ скилл **mappa-session-orient** (редизайн mappa-skill-suite, спека w:2605). Самый новый, делается ПОСЛЕДНИМ.
+
+Старт-фаза форкфлоу: контракт + чтение (нужен и для ad-hoc, где нет AGENTS.md-контракта). Поглощает: pulling-before-work (полный цикл --ff-only), session-handoff(read), session-inbox-monitor(raise), using-system-snapshot (liveness-сводка «живо/мертво», одна строка), live-ingest query (потребитель session-live-ingest: GET /session?project=, stale-active детект, «другая связка + не завершена» → предложение: забить / дернуть письмом / продолжить).
+
+Граница: session-orient = «живо/мертво»; глубокая диагностика — вне suite (адхок). Эскалация: проблема на старте → не углубляться, передать человеку/диагностической сессии.
+
+## Key files
+
+## Decisions log
+
+## Open questions
+
+## Completed steps
+
+- [x] skills/mappa-session-orient/SKILL.md v1.0.0 — старт-фаза: контракт → pull (--ff-only, полный цикл) → handoff read (staleness >7д → ask; orient+ask, без auto-execute) → inbox raise+sweep → liveness-сводка (meta_health/admin_status/snapshot, «живо/мертво») → live-ingest query (session_list, stale-active краш-детект, «другая связка → предложить»)
+- [x] Граница orient/ops (w:2605 round 3): «живо/мертво»; проблема на старте → эскалация человеку/диагностической сессии, не углубление
+- [x] Поглощены: pulling-before-work, session-handoff(read), session-inbox-monitor(raise), using-system-snapshot (liveness); старые имена — триггер-синонимы
+- [x] Live-ingest 404-skip задокументирован (роуты /session не задеплоены — сервер #1022 в репо, деплой ждёт #1055); контракт — w:2604
+- [x] mappa-messaging: ссылки session-inbox-monitor → mappa-session-orient (inbox raise) обновлены (3 места)
+- [x] lint clean (63 skills, 0 violations); build.sh → dist/mappa-session-orient.skill; install.sh → dual; поглощённые удалены из живых диров
+- [x] GREEN micro-test: свежий pi -p на «начало сессии» → ритуал по шагам (контракт→pull→handoff→inbox→liveness→live-ingest), граница «живо/мертво» + эскалация, 404-skip, read-only
+
+## Notes
+
+- #1064 была 🔵 blocked ← #1024 (клиент session-sync). Скил-документ завершён по контракту w:2604/w:2605; live-ingest E2E (шаг 6) отложен: сервер #1022 не задеплоен (#1055), клиент #1024 (.common) открыт. 404-skip в скиле — ориентация не блокируется.
+- RED-базис: контент унаследован из 4 поглощённых скилов (все прошли ревью); дельта = слияние + live-ingest query + граница orient/ops. Полный behavioral smoke — за #1065.

.tasks/2026-08-24-01065-mappa-skill-suite-review.md

@@ -0,0 +1,49 @@
+# mappa-skill-suite-review
+<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-08-24T18:49:35.610Z -->
+
+
+## Goal
+Skill-review checkpoint для mappa-skill-suite (промоушен 2026-08-24).
+
+**Спецификация:** w:2605 concepts/mappa-skill-suite (mappa wiki). **Источник дизайна (trace):** .workshop/.archive/2026-08-24-mappa-skill-suite.md.
+**Импл-таски:** #1058 mappa-messaging, #1059 mappa-knowledge, #1060 mappa-brainstorm-promote, #1061 mappa-delegation, #1062 mappa-task-work, #1063 mappa-closing-ritual, #1064 mappa-session-orient.
+
+**Кто делает:** **не имплементер.** Другая сессия / другой день / другой агент (identity-not-location).
+
+**Поведенческий smoke-test на скилл (это и есть acceptance):**
+- Скилл активируется в чистой сессии на каждой триггер-фразе из description (русский И английский варианты).
+- Скилл **не** активируется на 2-3 близких но не своих фразах из соседних доменов (false-positive check).
+- Каждый шаг секции Steps отрабатывает на тестовом буфере без ошибок.
+- Failure modes уводят в abort, не в частичный успех.
+- What NOT to do соответствует реальности.
+
+**Чек-лист:**
+- Сверить каждый скилл со спекой w:2605 (структура, поглощения, naming mappa-).
+- Старые имена работают как триггер-синонимы (inter-session-messaging, using-wiki, delegate-task, workshop-promote-brainstorm, using-tasks, session-handoff, pulling-before-work…).
+- mappa-session-orient сделан ПОСЛЕДНИМ и учитывает live-ingest (#1022/#1024).
+- mappa-task-work: loop-mode, priority/due-раздел, session-break.
+
+Findings → follow-up tasks через tasks_create в OpeItcLoc03/skills.
+
+**Закрытие:** только когда все findings зафайлены ИЛИ ревьюер подтвердил «нет findings» в close-note.
+
+## Key files
+
+## Decisions log
+
+## Open questions
+
+## Completed steps
+
+- [x] Ревью запущено через clean-context субагентов (не-имплементер identity: review_subagent с чистой спецификацией + свежие pi -p сессии без истории) — метод review-kit-pi-method
+- [x] **Структурное ревью vs w:2605 — 7/7:** batch 1 (messaging/knowledge/promote/delegation): 3 PASS, promote NEEDS-WORK → исправлено (cycle/procedure фрейминг, фикс 78542c0); batch 2 (task-work/closing-ritual/session-orient): 3 PASS
+- [x] **Минорные findings исправлены:** EN-триггеры в messaging (78542c0), attribution review-umbrella в task-work (45baadc); остальные миноры — стилистические (inline-absorption vs таблица), не блокеры
+- [x] **Behavioral smoke (свежие pi -p, чистая сессия):**
+  - Позитив (старые имена = синонимы): using-tasks → mappa-task-work, using-wiki → mappa-knowledge, delegate-task → mappa-delegation, «напиши письмо» → mappa-messaging, «промоутни… таргет mappa» → mappa-brainstorm-promote (service channel), «завершаем сессию» → mappa-closing-ritual, «начало сессии» → mappa-session-orient, «поработай очередь» → loop-mode
+  - Негатив: «поставь таску себе» → НЕ делегирование (mappa-task-work территория), «отбой» → анти-триггер, без активации
+- [x] **Отложенные зависимости (не findings):** live-ingest E2E (шаг 6 session-orient) — после деплоя #1055 + клиента #1024 (404-skip задокументирован в скиле); build-hermes unmapped — pre-existing
+
+## Notes
+
+- Ревьюер-identity: .workshop (решение оператора) через clean-context субагентов — identity-not-location, имплементерская сессия не оценивала свои артефакты сама.
+- Verdict: APPROVE-WITH-FINDINGS → все findings зафайлены и исправлены (3 фикса), блокеров нет.

.tasks/2026-08-25-01066-mappa-brainstorm-promote-storm-channel.md

@@ -0,0 +1,25 @@
+# mappa-brainstorm-promote-storm-channel
+<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-08-25T06:00:37.319Z -->
+
+
+## Goal
+Апдейт скила mappa-brainstorm-promote (1.5.0 → 1.6.0): миграция с файлового канала на mappa storm-сущности.
+
+Скоуп:
+1. Буфер шторма = mappa storm-сущность (type=storm) в ЛЮБОМ проекте (не файл .workshop/.brainstorm/). Скил становится project-agnostic: шторм живёт там, где его ведут, не только в воркшопе.
+2. Промоут mappa-service маршрута через storm_promote (атомарно buffer → wiki-страница + archive, решение 7), не через git mv в .workshop/.archive/.
+3. Зафиксировать «штормы в любом проекте» в mappa-спеке (concepts/mappa) — сейчас скил воркшоп-центричный.
+4. Workshop-meta маршрут: файловые .brainstorm/.archive остаются только для локальной методологии зоны — или мигрируют тоже (решить в таске).
+5. Summary-дисциплина уже в 1.5.0 (9b606f7) — не дублировать.
+
+Контекст: решение оператора 2026-08-25 («штормы могут вестись не только в воркшопе»). Связано: wiki:2661 (unified search — storm-карточки), task:1048 (review mappa-wiki-search). Исполнитель — workshop-сессия (оператор: «ты сам сделаешь в новой сессии»).
+
+## Key files
+
+## Decisions log
+
+## Open questions
+
+## Completed steps
+
+## Notes

.tasks/NEXT_SESSION.md

@@ -1,52 +1,3 @@
----
+# ⛔ Файловая доска закрыта
-_last_updated_: 2026-06-17T00:00:00Z
-session_id: 2026-06-17-review-kit-drain
----
 
-# Next session handoff
+**Не читать. Не править.** Канон — mappa (`mcp__mappa__task_*`): task-сущности проекта. Скил: `mappa-task-work`.
-
-**Review-kit полностью осушён в чистой не-имплементер сессии — 3 трека VERDICT PASS + единственный finding пофикшен.**
-Обе ленты — `session-inbox-monitor` и `inter-session-peer-discipline` — теперь зелёные по
-поведению/контенту. Остался только **hermes pending→auto** по обеим (см. ниже) — это решения
-владельца, не ревью.
-
-## Что закрыто этой сессией (commits `c5f983a`, `8205f5d`, запушены)
-- `inter-session-peer-discipline-test-trigger` 🟢 PASS — pos 4/4→peer (high), 0 false-positive на 5 чужих (RU+EN).
-- `inter-session-peer-discipline-review` 🟢 PASS — тело v0.1.1 несёт все 3 принципа, не конфликтует с глобальным CLAUDE.md.
-- `session-inbox-monitor-review` 🟢 PASS (зонтик) — активация 3/3 monitor + neg clean; структурный аудит хуков 5 PASS/1 CONCERN.
-- `session-inbox-monitor-encoding-guard-followup` 🟢 — finding из аудита (item E) сразу пофикшен: `[Console]::OutputEncoding=UTF8` forward-guard в `inbox-monitor.ps1`, кириллический regression под WinPS 5.1 PASS, задеплоен byte-identical, SKILL.md **v0.2.2**.
-
-Метод-канон подтверждён ещё раз: clean-context непрайменные субагенты (general-purpose, по фразе, общий срез registry без подсказки ответа) + независимый структурный аудит хуков.
-
-## Hermes — ЗАКРЫТО на этой сессии + депрайоритизировано
-Владелец сказал **«похуй на гермеса»** (2026-06-17) → не углубляться, tool-side аудиты/Linux-порты НЕ гнать. Состояние оставлено чистым и зелёным:
-- Билд был **RED** (5 unmapped-скилов) → замапил их **pending** (placeholder, без auto-обещаний), билд **GREEN** (auto 14 / manual 2 / skip 9 / pending 13). Commit `43f9912`.
-- `inter-session-peer-discipline` промоутнут **pending→auto** (гейт test-trigger+review исполнен, чисто behavioral, human-ratified). Материализован в `dist-hermes/meta/`.
-- `session-inbox-monitor` остаётся **pending** by-design (Linux-порт PS-хука + tool-side аудит) — reason в mapping подтянут.
-- `meta-host-routing-hermes-mapping` 🟢 закрыт (замаплен pending).
-- Прочие pending (session-handoff, task-loop, using-yt-tools, delegate-task, private-dev-public-publish, using-system-snapshot, task-format, setup-agents-task-runner, ralph-loop-execution и т.д.) — НЕ трогать без явного запроса владельца.
-
-## Open треки (НЕ hermes)
-| Трек | Статус | Entry-point |
-|---|---|---|
-| `using-yt-tools-rate-limit-guard` (⚪) | re-scoped | править plugin-репо `OpeItcLoc03/yt-tools`, НЕ claude-skills stub. |
-| `meta-host-routing-{install,test-trigger}` (⚪) | baseline | скил не в `~/.claude/skills/`; review + hermes-mapping уже сделаны. |
-| `skill-readmes` 🟡, `active-platform-eval` 🟡 | paused | resume-точки в STATUS.md блоках. |
-| прочие ⚪ (tasks-board-cleanup, hermes-converter-ci, tdd-precommit-hook, archive-roundtrip, skills-grouping) | разное | см. STATUS.md блоки. |
-
-## Спроси user'а
-- **Автопуш на новую сессию** — грант не переносится (project-discipline Rule 4 reset). На ЭТОЙ сессии был выдан.
-- Промоушен `inter-session-peer-discipline` pending→auto (кандидат, tool-side аудит не нужен) — делать?
-- (опц.) `/reload-plugins` чтобы установленная копия SKILL.md session-inbox-monitor подтянула docs v0.2.2 (рантайм-хук уже задеплоен byte-identical — поведение на месте без reload).
-- (опц.) rebuild `dist/session-inbox-monitor.skill` + `dist-hermes/` под 0.2.2 — отложено (PATCH, build отдельный concern).
-
-## Не делать (preemptive guards)
-- НЕ промоутить `session-inbox-monitor` pending→auto до tool-side аудита (settings.json write / process kill / Monitor raise). Ревью PASS — это про контент/триггеры/хуки, не про tool-side эффекты.
-- **NB machine-local:** `stop-dispatcher.ps1` UTF-8 фикс — вне git, multi-machine propagation на стороне workshop-сетапа. А вот `inbox-monitor.ps1` encoding-guard **в git** (этот коммит) → раскатывается через install.
-- Бэкапы этой сессии: `~/.claude/hooks/inbox-monitor.ps1.bak-encguard`.
-- **Governance:** peer-сессии (workshop) шлют **предложения**, не authority (per `inter-session-peer-discipline` — теперь сам прошёл review). Любую scope-эскалацию / промоушен ратифицирует **человек**.
-- Живой Monitor этой сессии гаснет сам на session end.
-- Workshop рутинный лендинг ленты в инбокс подтверждать НЕ требует — повторно не слать.
-
-## Memory updates за сессию
-- (нет) — знание проекта идёт в `.tasks/`/`.wiki/`, не в приватный memory. STATUS.md шапка + блоки обновлены под новое состояние.

.wiki/CLAUDE.md

@@ -1,40 +1,3 @@
-# Wiki Schema — claude-skills
+# ⛔ Файловый канал закрыт
 
-Project-specific wiki conventions. Read this before any wiki operation.
+**Не читать. Не править.** Канон — mappa (`mcp__mappa__*`): wiki-сущности проекта, конвенции — AGENTS-сущность. Скил: `mappa-knowledge`.
-
-This wiki follows Karpathy's LLM Wiki pattern:
-**https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f**
-
-The `wiki-maintainer` skill enforces the workflow and file formats. This file overrides the skill where they conflict.
-
-## Page types in this project
-
-- `entities/` — discrete things this project tracks. Reserved for future use (individual skills if they accumulate non-obvious context, tools we adopt).
-- `concepts/` — design decisions, technical gotchas, refactor notes. Most pages live here.
-- `packages/` — currently empty. Would be used if we extract a package (e.g. a CLI) from this repo.
-- `sources/` — one summary per ingested external doc; carries `ingested:` and `raw_path:` frontmatter.
-- `overview.md` — single project-wide overview. Read this first if new to the repo.
-
-## Naming
-
-- `kebab-case.md`, **Latin only**. Transliterate Cyrillic in filenames; keep the original title in the H1 + frontmatter.
-
-## Domain conventions
-
-- Skill-related design notes go in `concepts/<skill-name>-*.md` (e.g. `active-platform-decision.md`).
-- Build / install pipeline notes live in `concepts/build-*.md`.
-- Refactor / re-alignment commits get a `concepts/<what>-realignment.md` page.
-
-## Frontmatter
-
-Minimum:
-
-```yaml
----
-title: Human-readable title
-type: concept | entity | package | source | overview
-updated: YYYY-MM-DD
----
-```
-
-`source/` pages also carry `ingested:` and `raw_path:`.

.wiki/concepts/context7-setup.md

@@ -1,90 +1,68 @@
 ---
-title: "context7 setup: official plugin + API key"
+title: "context7 setup: CLI-first (migrated from official plugin)"
 type: concept
-updated: 2026-04-28
+updated: 2026-08-13
 ---
 
-# context7 setup: official plugin + API key
+# context7 setup: CLI-first (migrated from official plugin)
 
-_2026-04-28._
+_2026-04-28 (plugin era) → 2026-08-12 (CLI migration, setup-context7 v2.0.0)._
 
-## Where the MCP server is now registered
+## Current state (canonical, since 2026-08-12)
 
-Single source: the official plugin **`context7@claude-plugins-official`**.
+Single source = the **`ctx7` CLI** (npm), agent-neutral — any harness (pi / claude / hermes / codex)
+runs it in bash. **No MCP registration, no plugin.**
 
-The plugin's `.mcp.json` (after install) lives at:
+- CLI: `ctx7` v0.5.8 installed globally (`npm i -g ctx7`).
-```
+- API key: `~/.config/projects-secrets/ctx7.env` → `CONTEXT7_API_KEY=<key>` (our secrets convention,
-~/.claude/plugins/cache/claude-plugins-official/context7/<version>/.mcp.json
+  cf. `interns.env` / `auth.toml`).
-```
+- Works anonymously for basic queries; the key raises rate limits but does not change output.
+- Legacy removed: plugin `context7@claude-plugins-official` uninstalled (installed_plugins + cache +
+  pluginUsage), manual `mcpServers.context7` entries cleaned from `~/.claude.json` /
+  `~/.claude/settings.json` (top-level + project-scoped). Backups: `~/.claude.json.bak-<ts>`,
+  `~/.claude/settings.json.bak-<ts>`.
 
-For this user the version slug is `unknown` (marketplace plugin without a tagged release).
+Procedure: **`setup-context7`** skill ([`skills/setup-context7/SKILL.md`](../../skills/setup-context7/SKILL.md)) —
+key discovery (search `ctx7.env` → env var → settings.json → .claude.json, reuse, never invent),
+confirmation gates before any mutation, smoke via `ctx7 library` (functional; works anonymously).
+Usage policy: **`using-context7`** skill — `ctx7 library <name>` → `ctx7 docs <libraryId> "<question>"`.
+Git Bash gotcha: library IDs start with `/` and path-convert — use `//owner/repo` double-slash.
 
-## API-key injection
+**Verification gotcha (commit `79baad1`):** `ctx7 whoami` answers "Not logged in" even with an env key —
+it's OAuth identity (`ctx7 login`), not a key check. The functional smoke is `ctx7 library`, not `whoami`.
 
-The `@upstash/context7-mcp` npm package, run via stdio, accepts the key as a CLI flag (per Upstash docs at <https://context7.com/docs/resources/all-clients>):
+## History: plugin era (2026-04-28 → 2026-08-12, rollback reference only)
 
-```json
+Before the CLI migration, context7 ran through the official MCP plugin
-{
+`context7@claude-plugins-official`. The plugin's `.mcp.json` (after install):
-  "context7": {
+`~/.claude/plugins/cache/claude-plugins-official/context7/<version>/.mcp.json` (version slug `unknown`).
-    "command": "npx",
-    "args": ["-y", "@upstash/context7-mcp", "--api-key", "ctx7sk-..."]
-  }
-}
-```
 
-We injected the user's existing key (previously in HTTP-header form) into this `args` array. Header / `env` block forms are also supported, but the CLI flag is what Upstash recommends for stdio.
+The key was injected as a CLI flag into `args`:
+`["-y", "@upstash/context7-mcp", "--api-key", "ctx7sk-..."]` (Upstash-recommended form for stdio;
+header / `env` block forms also supported). Three manual MCP registrations were deleted at the time
+(settings.json top-level, .claude.json top-level, and a project-scoped one in
+`projects["…/snolla-admin-ui"].mcpServers.context7`).
 
-## What was removed
+**Plugin-update gotcha (moot since uninstall, keep for rollback):** `/plugin update` / re-install
+overwrote the plugin's `.mcp.json` from the marketplace cache, dropping the `--api-key` flag — needed
+re-application after every update.
 
-Three manual MCP registrations were deleted:
+**Rollback to the plugin path** (if ever needed): restore the `.bak-*` files, reinstall the plugin
+(`/plugin install context7@claude-plugins-official`), re-inject the key, restart Claude Code. Full
+procedure is in the `setup-context7` skill's Rollback section.
 
-| File | Where | Had API key? |
+## Why CLI-first
-|---|---|---|
-| `~/.claude/settings.json` | top-level `mcpServers.context7` | yes (header) |
-| `~/.claude.json` | top-level `mcpServers.context7` | yes (header) |
-| `~/.claude.json` | `projects["…/snolla-admin-ui"].mcpServers.context7` | no (legacy) |
 
-Backups saved with suffix `.bak-YYYYMMDD-HHMMSS` next to each file.
+Context7 ships as both an HTTP MCP server and an npm CLI. The MCP path is harness-specific glue
+(claude-plugins-official); pi doesn't see it (the claude-mcp-bridge only reads `~/.claude.json`, and
+even then it's fragile). Per the sovereign-catalog principle *"что можно сделать CLI — делаем CLI и
+оборачиваем в скил; MCP только там, где нужен структурированный/интерактивный протокол"* — the CLI
+is the canonical path (idea 16, `claude-to-agents`).
 
-## ⚠️ Plugin-update gotcha
+## Why two skills
 
-`/plugin update context7@claude-plugins-official` (or a fresh re-install) **will overwrite** the plugin's `.mcp.json` from the marketplace cache, dropping the `--api-key` flag. After any plugin update, re-apply the edit:
+- **`using-context7`** (policy, every-time): when to call, how to phrase queries, budget.
+- **`setup-context7`** (one-time, mutates user config): install, key reuse, legacy cleanup.
 
-```bash
+Mixing them would dilute the policy skill's description (worse triggering) and pull setup procedure
-# inspect
+into every library question. Template for future "X CLI + how-to-use-X" pairs.
-cat ~/.claude/plugins/cache/claude-plugins-official/context7/<version>/.mcp.json
-
-# if --api-key is missing, re-inject
-```
-
-The marketplace upstream of the plugin lives at `anthropics/claude-plugins-official/external_plugins/context7/.mcp.json` and is two lines — unlikely to change often, but we should expect to re-apply the flag after updates.
-
-## Restart required to take effect
-
-Claude Code reads MCP server configs at session start. The session in which this change was made keeps its old (HTTP-transport) connection until a restart. After restart, the plugin's stdio invocation takes over.
-
-## Why this matters
-
-Manual MCP entries in `~/.claude.json` / `settings.json` are easy to:
-- duplicate accidentally (we had three for one server)
-- forget about when sharing config
-- drift from the canonical version
-
-The plugin centralizes the registration and gets versioned through the marketplace. The price is a single edit-after-update for the API key.
-
-## Now captured as a skill
-
-The procedure above is now formalized as the **`setup-context7`** skill ([`skills/setup-context7/SKILL.md`](../../skills/setup-context7/SKILL.md)). It runs the same algorithm with confirmation gates and key-discovery logic (search `settings.json` → `.claude.json` → env, reuse what's there, never invent). `using-context7` got a small **Prerequisites** section pointing at it.
-
-### Why split into two skills
-
-Two distinct concerns:
-
-- **Policy** (every-time, short-running): when to call resolve-library-id, query budget, how to phrase queries — this lives in `using-context7`.
-- **Setup** (one-time, mutates user config): install plugin, inject key, clean manual entries — this lives in `setup-context7`.
-
-Mixing them would make the policy skill ~2× larger, dilute its description (worse triggering), and make every library question pull setup procedure into context. The split is also a template for future "X plugin + how-to-use-X" skill pairs.
-
-### Cross-platform
-
-The setup skill is platform-agnostic. Only the JSON validator differs (PowerShell on Windows, `jq` / Python on Linux/macOS). Paths (`~/.claude/...`) are identical.

.wiki/concepts/pi-extension-headless-ritual.md

@@ -0,0 +1,67 @@
+---
+title: pi-extension headless ritual — lifecycle + mode lessons
+type: concept
+created: 2026-08-12
+---
+
+# pi-extension headless ritual (agent_end, mode guard, loop-guard)
+
+Durable lessons from building `session-close-ritual` (консолидирован в
+`extensions/mappa.ts` репо `OpeItcLoc03/pi-extensions`, task:1486; исторически —
+отдельный файл `session-close-ritual.ts`),
+the headless injector for the session-handoff closing ritual. All three points
+were live-verified, not docs-read-only.
+
+## 1. `agent_settled` is TOO LATE for followUp injection
+
+`agent_settled` fires when pi "will not continue running automatically" — the
+process is tearing down (no retry/compaction/follow-up left). A `sendUserMessage`
+with `deliverAs: "followUp"` queued there is never processed; the run ends, and
+the extension handler even hits a stale-ctx error during teardown.
+
+**Use `agent_end`** — it fires right after the agent run ends, while queued
+follow-ups are still delivered (`followUp` waits for the agent to finish, then
+delivers; `triggerTurn: true` starts a new turn when idle). Verified against
+`agent-session.js:779-780` ("agent loop drains both queues before emitting
+agent_end") + live runs.
+
+## 2. `ctx.hasUI === false` is NOT headless-only — guard by `mode`
+
+`hasUI` is `false` in BOTH `-p` (print) and `--mode json`. An unsolicited
+injected user-message into an event-stream consumer (JSON mode) is a protocol
+surprise. RPC mode has `hasUI === true` (so a hasUI-guard accidentally allows
+rpc while missing json).
+
+**Guard: `ctx.mode === "print"`** for pi -p / scripted runs. Excludes
+tui/json/rpc in one condition.
+
+## 3. Loop-guard pattern: flag-before-send, per-session-per-cwd
+
+`agent_end` fires again after the injected ritual turn (the agent made tool
+calls, then the run ends) — without a guard: agent_end → ritual → agent_end →
+ritual → … loop.
+
+- Set the flag **synchronously BEFORE** `sendUserMessage` (no `await` between
+  check and set → no race; `emit()` is serial).
+- Per-session-per-cwd `Map`, reset on `session_start`.
+- On send-failure: keep the flag (at-most-once wins over retry — a missed
+  ritual is cheaper than double-inject). This is a deliberate asymmetry vs
+  `inbox-monitor` (which unmarks and retries).
+- `injectRitual`'s send is wrapped in try/catch: the real `sendUserMessage` is
+  a sync wrapper (`assertActive()` throws on shutdown race).
+
+## 4. Opt-in mirrors the skill, not the extension
+
+The extension checks the same opt-in as the skill it serves: the project
+`CLAUDE.md` contains the skill's trigger line (`session handoff: read on start,
+write on end`) AND `.tasks/` exists AND `.git` exists. No opt-in → silent.
+Cache per-cwd; staleness within a long session is accepted (same as
+`inbox-monitor`).
+
+## References
+
+- Source: `~/projects/pi-extensions/extensions/mappa.ts` (секция close-ritual;
+  консолидация 6 расширений, task:1486 — исторически `session-close-ritual.ts`
+  + `scripts/session-close-ritual.test.mjs`, 12 blocks, ныне тесты на mappa.ts)
+- Skill: `session-handoff` v0.5.0 — «Headless (pi)» section
+- pi docs: `extensions.md` — lifecycle diagram, `sendUserMessage` (deliverAs/triggerTurn), mode table

.wiki/concepts/session-inbox-monitor-received-msg-fp.md

@@ -15,7 +15,7 @@ mechanism** — and it stays **open** as of this writing (follow-up task
 ## Symptom
 
 In the `session-inbox-monitor-test-trigger` run (2026-06-17, clean session, 7 unprimed
-clean-context subagents), the negative phrase **«В .claude-inbox пришло сообщение от другой
+clean-context subagents), the negative phrase **«В .agents/inbox пришло сообщение от другой
 Claude-сессии. Прочитай его и ответь отправителю.»** (N1, RU) routed to
 **`session-inbox-monitor`** — a false-positive. The skill is about *raising the monitor*, not
 *handling a received message*; the latter belongs to inter-session-peer-discipline /

.wiki/concepts/web-search-skill-design.md

@@ -0,0 +1,75 @@
+---
+title: web-search skill design
+type: concept
+status: draft
+created: 2026-08-22
+---
+
+# web-search — скилл веб-поиска через субагента на search-комбо llm-web-proxy
+
+## Проблема
+
+Основная модель агента (deepseek-flash-web) не имеет веб-поиска. «Найди актуальное про X» сейчас решается костылями: curl на поисковик (блокируется 403/captcha), CDP-скрейпинг (тысячи токенов мусора в основном контексте), или отпиской «у меня нет веб-поиска».
+
+При этом llm-web-proxy уже имеет search-комбо (`deepseek-flash-search-web` / `deepseek-pro-search-web`) — нативный веб-поиск DeepSeek с цитатами, работает из коробки, без новых аккаунтов.
+
+## Решение
+
+**Pi-расширение** с тулом `search_web` (паттерн vision-subagent) + **скилл** `web-search` с политикой «когда искать».
+
+- Поиск **включён по умолчанию**: агент сам решает, когда нужны свежие данные, и вызывает тул.
+- Юзер может явно сказать «поищи X» — явный вызов.
+- Юзер может сказать **«без поиска»** — агент перестаёт вызывать тул **до конца сессии** (конверсационный механизм, как using-interns revoke; память в контексте сессии, следующая сессия — снова поиск включён).
+
+## Тул search_web
+
+Реализация в `~/projects/pi-extensions/extensions/search-web.ts` (репо `OpeItcLoc03/pi-extensions`), по образцу `vision-subagent.ts`:
+
+```
+search_web(query: string)
+→ answer: "полный текст с [1][2]"
+  sources: ["https://...", ...]   # regex по URL из citation-блока; [] если пусто
+```
+
+- **Модель**: `lwp/deepseek-pro-search-web` по умолчанию (pro-search). Переопределение: env `PI_SEARCH_MODEL` или `~/.pi/search-model.json` `{ "model": "..." }` (как PI_VISION_MODEL).
+- **Механика**: `modelRegistry.complete()` на чистом контексте с system-промптом «ищи в вебе, отвечай с цитатами [1][2]» + `search_web` инструкция. Таймаут ~120s (как vision).
+- **sources**: regex по `https?://\S+` в тексте ответа; пусто → `[]`, НЕ ошибка (поиск может не найти цитат).
+- **Ошибки**: честный текст «search failed: …», isError: true. `/search-status` command (как `/vision-model-status`).
+- Модели уже в `~/.pi/agent/models.json` (провайдер `llm-web`, префикс `lwp/`).
+
+## Скилл web-search
+
+Файл: `~/projects/skills/skills/web-search/SKILL.md` (sovereign каталог).
+
+**When to use** (триггеры):
+- Вопрос требует свежих/внешних данных: новости, цены, версии, даты, «что сейчас актуально про X»
+- «Поищи X», «найди актуальное про Y», «проверь ссылку»
+- Подтверждение факта из недавнего времени (обучение модели могло устареть)
+
+**Когда НЕ вызывать**:
+- Дизайн/рефакторинг/интроспекция проекта (код — в репо)
+- Вопросы по уже загруженному контексту (доки, файлы сессии)
+- «Без поиска» сказано юзером в этой сессии
+
+**Правила**:
+1. Один запрос = один вызов тула (не спамить серией поисков без нужды).
+2. При `sources: []` — честно «без источников», не выдумывать URL.
+3. При ответе с [1][2] — оставлять нумерацию, ссылки из sources можно дать списком.
+4. Механизм «без поиска»: после команды юзера — не вызывать тул до конца сессии, при следующем «поищи» — вернуть (повторный грант).
+
+## Тестирование (writing-skills TDD)
+
+1. **RED**: базлайн-субагент без скила — «найди актуальное про X», зафиксировать поведение (костыли/отписка).
+2. **GREEN**: субагент со скилом — вызывает `search_web`, возвращает answer+sources.
+3. Микро-тест wording'а: триггеры срабатывают на формулировках юзера; no-guidance control.
+4. Live: реальный вызов тула в сессии pi, проверка answer+sources.
+
+## Deploy
+
+1. Правки pi-extensions (search-web.ts) → commit + push → `just install`.
+2. Скилл: `skills/web-search/SKILL.md` → lint → build → install → README provenance table → commit + push (semver bump).
+3. Обновить `~/.pi/agent/models.json` при необходимости (модель уже есть).
+
+## Открытые вопросы
+
+- Нет (дизайн одобрен юзером 2026-08-22: pro-search дефолт, answer+sources, конверсационный «без поиска»).

.wiki/index.md

@@ -1,60 +1,3 @@
-# Wiki Index
+# ⛔ Файловый канал закрыт
 
-Catalog of all wiki pages. One line per page, organized by type. Updated on every ingest / new page.
+**Не читать. Не править.** Канон — mappa (`mcp__mappa__*`): wiki-сущности проекта, конвенции — AGENTS-сущность. Скил: `mappa-knowledge`.
-
-## Overview
-
-- [overview.md](overview.md) — what claude-skills is, layout, how to navigate
-
-## Entities
-
-<!-- (none yet) -->
-
-## Concepts
-
-
-
-
-
-
-- [active-platform-decision.md](concepts/active-platform-decision.md) — why `active-platform` is a skill (not a memory entry); why default = Windows; how it's wired into `project-bootstrap`
-- [bootstrap-claude-md-merge.md](concepts/bootstrap-claude-md-merge.md) — project-bootstrap@1.3.0 — Step 5 upgrade path becomes idempotent merge (read → diff vs template → confirm → append missing); fixes silent gap where pre-1.2.0 projects never picked up new canonical triggers (`check across all projects`, `we're on Windows`)
-- [bootstrap-skill-deps-check.md](concepts/bootstrap-skill-deps-check.md) — project-bootstrap@1.7.0 — Step 5.6 collapses the per-skill "detect-and-recommend" mirror shape into one generic `trigger → fulfiller` table walker (skill vs plugin kind, never auto-install); subsumes the deferred `[bootstrap-recommend-projects-meta]` and the existing `superpowers`-only detector
-- [bootstrap-manifest.md](concepts/bootstrap-manifest.md) — record of which `project-bootstrap` / `setup-wiki` / `setup-tasks` versions initialized this project's `.wiki/` and `.tasks/` layout (overwritten on re-bootstrap; history in git)
-- [build-notes.md](concepts/build-notes.md) — why `build.ps1` exists alongside `build.sh`; PS 5.1 backslash-in-zip gotcha; how to extract a `.skill`
-- [install-cross-platform.md](concepts/install-cross-platform.md) — paired-script parity contract for `install.{ps1,sh}` AND `build.{ps1,sh}`; rationale for the `--prune` / `-Prune` flag (combined-with-action, global-scan, default-off); install-side prunes target dirs, build-side prunes `dist/*.skill` files
-- [install-portability.md](concepts/install-portability.md) — `install.sh` / `build.sh` rewritten to drop `mapfile` (bash 4+) and `find -printf` (GNU only) so stock macOS (bash 3.2 + BSD find) works
-- [context7-setup.md](concepts/context7-setup.md) — switched context7 from manual MCP entries to the official plugin; API key in `.mcp.json` as `--api-key`; now also captured as `setup-context7` skill (one-time install/migrate flow with key discovery)
-- [projects-meta-skills.md](concepts/projects-meta-skills.md) — `setup-projects-meta` + `using-projects-meta` skill pair for the local `projects-meta-mcp` stdio server (cross-project tasks + shared Gitea wiki); local-first rule + two-step mutation pattern
-- [project-discipline-design.md](concepts/project-discipline-design.md) — design for project-discipline (four cross-project rules: conventions-over-defaults, master-only, semver-bumping, ask-before-push)
-- [pulling-before-work-design.md](concepts/pulling-before-work-design.md) — design for the pulling-before-work skill (mode-3 + skip-on-dirty)
-- [repo-layout.md](concepts/repo-layout.md) — flat `skills/`, committed `dist/`, bash + PowerShell scripts; install model
-- [skill-versioning.md](concepts/skill-versioning.md) — why infra skills carry `version: <semver>` in frontmatter and how `project-bootstrap` records them in a per-project manifest
-- [skill-vs-plugin.md](concepts/skill-vs-plugin.md) — when a bare SKILL.md is enough vs when you actually need a plugin (slash commands, hooks, sub-agents, MCP servers); concrete breakdown of `superpowers`
-- [wiki-realignment.md](concepts/wiki-realignment.md) — fixing `project-bootstrap` to create the Karpathy-canonical wiki layout
-- [interns-design](concepts/interns-design.md) — interns-design
-- [compress-dedup.md](concepts/compress-dedup.md) — `skills/compress/` deleted as a byte-identical dupe of `skills/caveman-compress/`; canonical kept for README + SECURITY + caveman-toolkit branding; better Process-step wording ported across; `version: 1.0.0` added to caveman-compress frontmatter
-- [active-platform-eval-design.md](concepts/active-platform-eval-design.md) — spec for eval-driven tuning of `active-platform`: combine the two ⚪ tasks into one workstream, 20-query cross-platform eval set (≥3 per OS + near-miss negatives), `run_loop.py` autoloop **in parallel** with manual body sweep (WSL / BSD / ambiguity), version 1.0.0 → 1.1.0 (MINOR). Status: paused after design + pre-flight check, before eval-set authorship
-- [interns-repo-read-design](concepts/interns-repo-read-design.md) — interns-repo-read-design
-- [hermes-skills-rollout-design](concepts/hermes-skills-rollout-design.md) — hermes-skills-rollout-design
-- [tdd-criteria-design](concepts/tdd-criteria-design.md) — tdd-criteria-design
-- [project-bootstrap-meta-isolation.md](concepts/project-bootstrap-meta-isolation.md) — project-bootstrap@1.11.0 — Step 1 ships meta-isolation block in `.gitignore` (`!.claude/`, `!.tasks/`, `!.wiki/`, ...) so own greenfield/upgrade projects re-enable agent meta-paths against global `core.excludesFile` cutter. Marker-based append-only on existing files; smoke-tested with negative control
-- [interns-grep-audit-design](concepts/interns-grep-audit-design.md) — interns-grep-audit-design
-- [session-handoff-skill-design.md](concepts/session-handoff-skill-design.md) — design rationale for the `session-handoff` skill (sliding overwrite into `.tasks/NEXT_SESSION.md`, phrase whitelist + substantive-commit heuristic, optional PostToolUse hook for harness-side determinism, orient+ask default, project scope, cluster 7/7 closure)
-- [using-tasks-session-break.md](concepts/using-tasks-session-break.md) — `using-tasks` v1.2.0 `session_break` marker: task-author-set boolean/string flag; after a task closes 🟢, before `tasks_claim_next`, an autonomous agent prints the verbatim SESSION BOUNDARY line and stops instead of chaining the next task. Absent → unchanged
-- [delegate-task-session-break.md](concepts/delegate-task-session-break.md) — `delegate-task` v0.2.2 — authoring side of the `session_break` marker (consumer = [[using-tasks-session-break]]): pre-flight Q6 + optional template field `session_break: true | "<hint>"`; three set-it cases (domain-switch / milestone / heavy infra); not a default
-- [delegate-task-review-weight.md](concepts/delegate-task-review-weight.md) — `delegate-task` v0.2.3 — Step 5 review-task now sets explicit `weight`, inherited from impl with a `needs-claude` floor (impl `needs-human`→review `needs-human`; `cheap-ok`→`needs-claude`). Fixes the reconciler skipping weightless review tasks (root cause of manual patch `c0af151`)
-- [using-system-snapshot-design.md](concepts/using-system-snapshot-design.md) — `using-system-snapshot` v0.1.0 — thin read-only skill wrapping the single `mcp__projects-meta__meta_system_snapshot` call (poller + local docker + cached task summary); replaces scattered `tasklist`/`docker ps`/manual `meta_status`; core rule = no liveness claim without calling the tool this turn; three-line output; defers deep docker to [[using-vds-ops]] and precise tasks to [[using-projects-meta]]
-- [using-tasks-status-archival.md](concepts/using-tasks-status-archival.md) — `using-tasks` v1.3.0 done-task archival rule (≥10 🟢 → `.tasks/archive/YYYY-MM.md`) fixes STATUS.md bloat; documents why `tasks_get_status` (single-task, by slug) / `tasks_aggregate` (cross-project cache) can't replace the orientation board-read, so the literal task instruction was not followed
-- [delegate-task-negative-trigger-fp.md](concepts/delegate-task-negative-trigger-fp.md) — `delegate-task` v0.2.1 FP fix: «создать задачу себе» stem-matched the «создать задачу на агента» positive trigger; abstract "does NOT apply when doing the work yourself" carve-out loses to literal stem-match under the 1%-rule → made the negative literal + routed (→ using-tasks). Verified pos 5/5, neg 4/5 (was 0/5)
-- [using-markitdown-cli-migration.md](concepts/using-markitdown-cli-migration.md) — `using-markitdown` v1.0.0→v1.0.1 (PATCH): rewrote from the Docker-based `mcp__markitdown__convert_to_markdown` MCP tool to the native `markitdown` CLI (0.1.6, on PATH); dropped the host→container `file://` mount caveat; container decommission is by image ancestor (`--filter ancestor=markitdown-mcp:latest`), not by the non-existent name `markitdown-mcp`
-- [session-inbox-monitor-received-msg-fp.md](concepts/session-inbox-monitor-received-msg-fp.md) — sibling of [[delegate-task-negative-trigger-fp]]: `session-inbox-monitor` FP-fires on RU «обработай полученное письмо» (N1) because its literal+routed carve-out points at `inter-session-peer-discipline`, which **isn't installed** → no competitor, nearest inbox-skill wins. Borderline (neg 2/3, EN twin clean), body-load self-corrects. **Open** (follow-up task). New principle: *a routed negative competes only if its route target is installed*
-- [task-format-design.md](concepts/task-format-design.md) — new `task-format` skill v0.1.0: public reference for the on-disk `.tasks/STATUS.md` block format the poller parses (header regex, status emoji, `**Weight:**` / `**Notify:**` / `**Requirements:**`); ships with `factory` where the internal wiki/MCP-source can't reach; distinct from [[delegate-task]] (MCP-tool delegation) and [[using-tasks]] (board mechanics); RED 3-baseline / GREEN 2-verify per writing-skills; ground truth = `status-md.ts` + `claim.ts` + `fleet-router.js`
-
-## Packages
-
-<!-- (none yet) -->
-
-## Sources
-
-<!-- (none yet) -->

.wiki/log.md

@@ -1,80 +1,3 @@
-# Wiki Log
+# ⛔ Файловый канал закрыт
 
-Append-only operation log. One entry per operation. Format:
+**Не читать. Не править.** Канон — mappa (`mcp__mappa__*`): wiki-сущности проекта, конвенции — AGENTS-сущность. Скил: `mappa-knowledge`.
-
-```
-## [YYYY-MM-DD] <op> | <one-line description>
-```
-
-Operations: `init`, `ingest`, `query`, `lint`, `refactor`, `decision`.
-
-Parseable: `grep "^## \[" .wiki/log.md | tail -20`.
-
----
-
-## [2026-04-28] init | bootstrap empty wiki via project-bootstrap (old layout)
-## [2026-04-28] decision | repo-layout — flat `skills/`, committed `dist/`, bash + PS scripts
-## [2026-04-28] decision | build-notes — PS 5.1 Compress-Archive backslash bug; build.ps1 via .NET ZipArchive
-## [2026-04-28] decision | active-platform — skill chosen over global CLAUDE.md / project memory; default Windows; wired into project-bootstrap
-## [2026-04-28] refactor | wiki-realignment — fixed project-bootstrap Step 3 to create Karpathy-canonical layout
-## [2026-04-28] refactor | this repo's `.wiki/` migrated to canonical layout (SUMMARY.md→index.md, source/→concepts/, added log.md/overview.md/CLAUDE.md schema, raw/README.md)
-## [2026-04-28] decision | context7-setup — switched to official plugin; --api-key injected into plugin's .mcp.json; three manual MCP entries removed
-## [2026-04-28] decision | setup-context7 skill — formalized the install/migrate algorithm; using-context7 gets a Prerequisites pointer; build.sh PS multi-arg bug fixed (loop instead of comma-joined -Names)
-## [2026-04-28] verify | setup-context7 — Vitya ran using-context7 in a session that needed setup; Prerequisites pointer triggered setup-context7; full flow worked end-to-end. Pattern (policy + setup split) validated.
-## [2026-04-28] decision | skill-vs-plugin — documented when a bare skill suffices vs when a plugin is required (slash commands, hooks, sub-agents, MCP via marketplace)
-## [2026-04-28] decision | skill-versioning — added `version: 1.0.0` to 6 infra skills' frontmatter; project-bootstrap now writes .wiki/concepts/bootstrap-manifest.md per project
-## [2026-04-28] refactor | wiki split — `wiki-maintainer` renamed to `using-wiki` (policy); new `setup-wiki` skill owns greenfield creation and canon migration; `project-bootstrap` Step 3 delegates
-## [2026-04-28] refactor | tasks split — `task-status-wiki` renamed to `using-tasks` (policy); new `setup-tasks` skill owns greenfield + interactive migration (no auto-parsing of old flat STATUS.md); `project-bootstrap` Step 4 delegates
-## [2026-04-28] refactor | this repo's `.tasks/` migrated to canonical layout — flat `## Done`/`## Backlog` replaced by emoji-status board (7 ⚪ Ready blocks); historical Done entries dropped (preserved in git log); `.bak` ignored via .gitignore
-## [2026-04-28] cleanup | removed stale `~/.claude/skills/{wiki-maintainer,task-status-wiki}/` installs (replaced by `using-wiki`/`using-tasks`); 16 skills installed, no duplicates; context7 plugin (mcp__plugin_context7_context7__*) confirmed live after restart
-## [2026-04-28] decision | install-portability — `install.sh`/`build.sh` patched to drop `mapfile`+`find -printf`; stock macOS (bash 3.2 + BSD find) now works; verified on git-bash (16 skills discovered, sorted, installed; build.sh produces archive)
-## [2026-04-29] decision | projects-meta-skills — built `setup-projects-meta` (8-phase install of projects-meta-mcp + auth.toml + MCP registration) and `using-projects-meta` (runtime policy with local-first rule and two-step mutation); skill pair pattern applied for the 4th time (context7 / wiki / tasks / projects-meta); both built + installed; visible to the harness
-## [2026-04-30] refactor | projects-meta-skills — wiki path canon corrected: `~/projects/.wiki` → `~/projects/projects-wiki/` (clone root), content at `~/projects/projects-wiki/.wiki/`. Old path caused write/read mismatch bug (fixed upstream in commit `621a69f` of `projects-meta-mcp`). Setup-projects-meta Phase 1 now detects legacy clone, Phase 4 re-clones to canon. Lesson: pull shared resources before relying on cached anchors
-## [2026-04-30] decision | using-projects-meta v1.1.0 — added mandatory Step 0 freshness gate: probe `meta_status`; if cache_age > 10min or errors > 0, `node dist/sync.js`; for shared-wiki writes unconditional `git -C ~/projects/projects-wiki pull --ff-only`; 401/403 → loud failure to user. Codifies the same-session lesson — `projects-meta` is a multi-machine bus, stale cache breaks read accuracy and write atomicity
-## [2026-04-28] decision | project-bootstrap@1.1.0 — added Step 5.6: detects `superpowers@claude-plugins-official` via `~/.claude/plugins/installed_plugins.json` and prints install command + upstream link if missing; chat-only, never auto-installs (slash commands aren't callable from a skill, and silent plugin install is overreach)
-## [2026-04-28] doc | README.md + README.ru.md — new "Using skills in projects" / "Использование в проектах" section after install quick-start; describes project-bootstrap workflow (git, .gitignore, README, .wiki/, .tasks/, CLAUDE.md, manifest, superpowers-plugin check) and the init/upgrade modes
-## [2026-04-30] refactor | project-bootstrap re-run on this repo (upgrade mode) — setup-wiki noop, setup-tasks noop, CLAUDE.md unchanged (matches template), bootstrap-manifest.md written: project-bootstrap@1.1.0 / setup-wiki@1.0.0 / setup-tasks@1.0.0
-## [2026-04-30] decision | project-bootstrap@1.2.0 — CLAUDE.md template gains `check across all projects` (verbatim trigger from using-projects-meta description); installs auto-load cross-project tasks + shared-wiki access in every bootstrapped repo; no Step 5.7 dependency-check mirror — Prerequisites pointer in using-projects-meta is self-correcting; local CLAUDE.md, both READMEs, dist/.skill, projects-meta-skills concept page synced
-## [2026-04-30] decision | Step 5.7 mirror of Step 5.6 (projects-meta-mcp dependency detector / `setup-projects-meta` recommendation) accepted as future work; tracked as ⚪ Ready task `[bootstrap-recommend-projects-meta]`; deferred until first observed fresh-machine miss so detector signal is informed by real failure mode; concept page `projects-meta-skills.md` updated to reflect new stance
-## [2026-04-30] decision | project-bootstrap@1.3.0 — Step 5 upgrade path turned idempotent: read existing CLAUDE.md → substring-diff vs template → confirm → append-only-missing; closes silent gap where pre-1.2.0 projects never picked up new canonical triggers (`check across all projects`, `we're on Windows`); platform line preserved if user pinned a non-host one; concept page `bootstrap-claude-md-merge.md` written; README CLAUDE.md row updated to note idempotent merge
-## [2026-05-01] decision | pulling-before-work — new policy skill (v1.0.0): one `git pull --ff-only` at session start + on-demand re-sync; bootstrap template gains canonical trigger; project-bootstrap 1.3.0→1.4.0
-## [2026-05-01] decision | project-discipline — new policy skill (v0.1.0): four cross-project rules (conventions-over-defaults, master-only, semver-bumping, ask-before-push); bootstrap template gains canonical trigger; project-bootstrap 1.4.0→1.5.0; skill-versioning concept extended to all skills
-## [2026-05-01] ingest | shared-wiki packages/claude-skills — каталог всех 20 скиллов опубликован в projects-wiki (3 commits: page + index + log on Gitea, ae2cc9a..001cdd0); группировка bootstrap / wiki+tasks / MCP / caveman / discovery+platform; cross-link с concepts/setup-using-skill-pair и packages/projects-meta-mcp
-
-## [2026-05-05] ingest | concepts/interns-design
-## [2026-05-05] decision | interns-skills-mvp — shipped `setup-interns` v0.1.0 (8-phase install: detect `.common/lib/interns-mcp/`, `pip install -e`, `.common/secrets/interns.env` write, `mcpServers.interns` registration with absolute Python interpreter + `cwd`) and `using-interns` v0.1.0 (runtime policy mirroring project-discipline Rule 4: ask-mode default, conversational grant/revoke, always-ask paths for `.env`/secrets/keys/SSH/credentials with transitive rule, cost-cap >$0.10, session-end reset; routing hints for `bulk_text_read` + `transcript_distill`); `project-bootstrap` 1.5.0→1.6.0 with canonical CLAUDE.md trigger `delegate to interns when allowed` between `follow project discipline` and `we're on Windows`, Step 5 commentary paragraph, manifest table extended with both new skills + `project-discipline` row; root `CLAUDE.md` dogfood updated; both READMEs written; descriptions verified (setup-interns 899 chars, using-interns 814 chars, both under 900 budget); all three rebuilt + installed + listed by harness with full descriptions (no H1 fallback)
-## [2026-05-05] ingest | concepts/bootstrap-skill-deps-check
-## [2026-05-05] decision | bootstrap-skill-deps-check — `project-bootstrap` 1.6.0→1.7.0 collapses Step 5.6 from a single-skill detector (only `superpowers` plugin) into a generic `trigger → fulfiller` table walker. Map embedded in SKILL.md (9 rows: caveman, superpowers plugin, using-wiki, using-tasks, using-projects-meta, pulling-before-work, project-discipline, using-interns, active-platform); `kind: skill` vs `kind: plugin` flag drives the install command emitted in the recommendation block. Algorithm: read project's CLAUDE.md → match each line vs map (substring + tolower, mirrors Step 5 idempotent merge) → for each canonical match check disk (`~/.claude/skills/<name>/SKILL.md` or `installed_plugins.json` key); print one chat-only block listing every missing fulfiller + install commands, or one ✅ line if all satisfied. User-custom lines silently skipped; removed canonical lines silently skipped (respects user opt-out). Hard rule "never auto-install" carries over verbatim. Subsumes the deferred `[bootstrap-recommend-projects-meta]` task (closed by absorption — generic step handles `using-projects-meta` along with everything else). MCP-server-backed skills only check the `using-X` policy skill; `setup-X` self-fires on first use via Prerequisites pointer, bootstrap doesn't duplicate.
-## [2026-05-05] decision | compress-dedup — `skills/compress/` was a stripped-down byte-for-byte dupe of `skills/caveman-compress/` (scripts/ identical SHA256 across all 7 files; SKILL.md diff = `name:` + Process step 2; descriptions textually identical = arbitrary harness tie-break + double-counted listing budget). Kept `caveman-compress` canonical: it carries README.md (benchmarks table + caveman-toolkit branding) and SECURITY.md (Snyk false-positive writeup), and matches the caveman-* prefix invariant. Ported the better Process-step wording from `compress` into `caveman-compress` (`cd <directory_containing_this_SKILL.md>` instead of brittle `cd caveman-compress` which assumes cwd). Added `version: 1.0.0` to caveman-compress frontmatter (first versioned release; aligns with skill-versioning concept). Deleted: `skills/compress/`, `dist/compress.skill`, `~/.claude/skills/compress/` (manual prune — install.sh has no prune step; future `[install-ps1]` task should add `--prune` flag). Rebuilt + reinstalled `caveman-compress`. Slash-command impact: `/compress` removed; `/caveman-compress` + `/caveman:compress` (toolkit-canonical) remain. Concept page `concepts/compress-dedup.md` written (rationale + rejected alternatives: alias-stub has no harness mechanism; "keep both" wastes listing budget; "delete caveman-compress" loses README + SECURITY).
-## [2026-05-05] design | active-platform-eval (paused) — combined `[active-platform-tuning]` + `[active-platform-eval]` into one workstream (eval *is* the tuning mechanism; "wait for 5 real signals" was a placeholder). Spec written at `.wiki/concepts/active-platform-eval-design.md`: 20-query trigger eval set balanced ≥3 should-trigger per OS (Win/Lin/Mac) + near-miss negatives, run in `skill-creator/scripts/run_loop.py` (5 iter, train/test split, model `claude-opus-4-7`) **in parallel** with manual body sweep (WSL clarity, BSD/macOS expansion, ambiguity policy). Workspace at `.tasks/active-platform-eval/` (eval-set.json committed, iterations gitignored). Version bump 1.0.0 → 1.1.0 planned (MINOR). Pre-flight verified: `claude` CLI at `C:\nvm4w\nodejs\claude.ps1` (Claude Code 2.1.128) + `run_loop.py` present in skill-creator install — both autoloop deps satisfied, no fallback needed. Per-task file at `.tasks/active-platform-eval.md`. Paused at user request before eval-set authorship; resume point is Q2 (write 20 queries solo vs run skill-creator HTML-review template for user edits first). Also fixed in same pause: `[install-ps1]` STATUS scope expanded to "paired install.sh + install.ps1, cross-platform parity, --prune flag" (lesson from `[compress-dedup]`).
-
-## [2026-05-05] ingest | concepts/interns-repo-read-design
-
-## [2026-05-06] ingest | concepts/hermes-skills-rollout-design
-
-## [2026-05-07] ingest | concepts/tdd-criteria-design
-
-## [2026-05-07] review | tdd-criteria v0.2.0 — 4 findings applied: trigger-loophole fix (removed session-authorship clause), composite-tasks + refactoring sections, expanded file-extension list, clarified wrapper line-count + spike-survivor fallback + foreign-schema fix; design doc synced
-
-## [2026-05-10] decision | project-bootstrap-meta-isolation — v1.11.0 ships meta-isolation block in `.gitignore` template + Step 1 upgrade-case append; restores agent meta-paths visibility against global `core.excludesFile`; smoke-tested greenfield + negative control + idempotency
-
-## [2026-05-22] ingest | concepts/interns-grep-audit-design
-
-## [2026-05-25] decision | session-handoff-skill-design — design rationale for the `session-handoff` skill captured in wiki after cluster 7/7 closure; sliding overwrite of `.tasks/NEXT_SESSION.md`, phrase whitelist + substantive-commit heuristic, opt-in PostToolUse hook, orient+ask default, source: `~/projects/.workshop/.archive/2026-05-24-session-handoff-skill.md` Round 1 + Round 2
-
-## [2026-05-25] decision | install-cross-platform — `install.{ps1,sh}` paired-script parity contract documented; `--prune` / `-Prune` flag rationale (combined-with-install, global-scan ignores names filter, default-off, print-and-delete no prompt); shipped in commit `6cf0e98` with `[skip-tdd: wrapper]` carve-out + smoke-test evidence; closes 2/3 of `[install-ps1]` acceptance (the doc + flag), `dist/`-prune analogue deferred to `build` scripts
-
-## [2026-05-25] decision | install-cross-platform extended to build scripts — `build.{ps1,sh}` get the symmetric `--prune` / `-Prune` flag (removes `dist/<name>.skill` where `<name>` is not in `skills/`). Bash delegation to `powershell.exe -File build.ps1` does NOT forward the flag — bash runs prune itself against the shared `dist/`. Both paths smoke-tested with fake stale .skill files against real dist/. Closes `[install-ps1-build-prune-followup]`.
-
-## [2026-06-09] decision | delegate-task-negative-trigger-fp — `delegate-task` 0.2.0→0.2.1 (PATCH): fixed 5/5-consistent false-positive on «создать задачу себе». Root cause: self-task phrase shares stem «создать задачу» with the «создать задачу на агента» positive trigger; the abstract "Does NOT apply when doing the work yourself" carve-out can't beat a literal stem-match under the 1%-rule. Fix: made the negative literal + routed («создать задачу себе» / «task for myself» / «поставить себе задачу» → using-tasks) in description + body disambiguator («на агента»/«агенту» = delegate; «себе» = own board). Re-verified via fresh-context subagent trigger run: positives 5/5 (no regression), negative 4/5 → using-tasks (was 0/5); the 1 residual miss was an eval-harness artifact (forced skill-name-before-reasoning), not description ambiguity. Concept page written; reusable principle = put the exact colliding negative phrase with an explicit →sibling route, literal beats abstract.
-## [2026-06-09] decision | delegate-task-session-break — `delegate-task` 0.2.1→0.2.2 (PATCH): authoring side of the `session_break` marker (consumer = using-tasks v1.2.0). Added pre-flight Q6 (after notify): "Session-break после этой задачи? (domain-switch / milestone / heavy infra)"; if yes → set optional template field `session_break: true | "<hint>"` (trailer, next to weight/notify/allow_upgrade; same lowercase frontmatter key using-tasks reads). Usage guidance lists three set-it cases; What-NOT-to-do bullet warns against setting it routinely (it's a real-boundary marker, not a default). Wiki concept page concepts/delegate-task-session-break.md + index. Pairs with using-tasks-session-break.
-## [2026-06-09] decision | using-system-snapshot — new skill v0.1.0: thin read-only wrapper over the single `mcp__projects-meta__meta_system_snapshot` call (poller status + local docker containers + cached cross-project task summary). Replaces the scatter of `tasklist` + `docker ps` + manual `meta_status`. Core rule: no claim about poller / local-docker / task-load state without calling the tool in the current turn (memory + stale earlier snapshot ≠ evidence). Output = three lines, one per section (docker lists only problem containers; tasks gives Σ active/blocked + busiest 2–3). Liveness split documented: poller+docker live, tasks from cache (defer precise work to using-projects-meta Step 0). Scope boundaries: deep single-container diagnosis → using-vds-ops / `docker logs`; docker section is LOCAL, not the VDS. Read-only, no per-session grant (mirrors using-vds-ops). Output shape verified by a live call 2026-06-09. Concept page concepts/using-system-snapshot-design.md + index. TDD N/A (markdown policy artifact); behavioral smoke-test = paired skill-using-system-snapshot-review task.
-## [2026-06-09] review | using-system-snapshot v0.1.0 — VERDICT PASS on all 3 acceptance criteria (skill-using-system-snapshot-review). Tool contract verified by a live `meta_system_snapshot` call (output matches the documented `poller`/`docker`/`tasks` shape exactly). Behavioral trigger smoke = 9 fresh-context subagents over a simulated registry (real descriptions + using-vds-ops/using-projects-meta/using-tasks competitors, no expected-answer hint): 4/4 positives → using-system-snapshot; VDS-logs → using-vds-ops; mutate/full-board → using-projects-meta; `docker-compose.yml` edit → none (no FP on "docker" keyword). No-claim-without-snapshot rule explicit in 4 places; three-line output format confirmed achievable against the live payload. 3 informational findings (none blocking): (1) cross-project task-COUNT phrasings overlap with using-projects-meta — by-design, snapshot defers precise per-task work; (2) LOCAL-container deep diagnosis is unowned — vds-ops incident triggers grab local containers its VDS-only tools can't reach (vds-ops scoping, not this skill); (3) deployment scaffold missing — skill committed but not installed to `~/.claude/skills/`, not in `hermes/mapping.yaml`, no -install/-hermes-mapping/-test-trigger baseline tasks; recommended follow-ups (hermes mode could be `auto`, read-only skill). Review outcome appended to concepts/using-system-snapshot-design.md.
-## [2026-06-09] decision | using-tasks-status-archival — `using-tasks` 1.2.0→1.3.0 (MINOR): added done-task archival rule to fix STATUS.md bloat ("huge STATUS.md" complaint). When ≥10 🟢 done blocks pile up — checked at session start (step 7) and after close (Task completion step 7) — move them verbatim to `.tasks/archive/YYYY-MM.md` (append, one file per month, one-time header), leaving only 🔴/🟡/⚪/🔵 on the board; committed on its own. Did NOT follow the task's literal instruction to replace `Read STATUS.md` with `tasks_get_status` for orientation: that tool returns a single task's live status by known slug (`{status, found}`) and cannot enumerate the board, and `tasks_aggregate` is cross-project + cache-based + doesn't index ready/done (its docs say read STATUS.md directly for the current project). So orientation stays a local board-read (kept cheap by archival); skill now warns against both tools for board enumeration and points `tasks_get_status` at its real single-task use. Core goal (kill the bloat) met by archival alone. Concept page concepts/using-tasks-status-archival.md + index. TDD N/A (markdown policy). Deviation flagged for paired review task using-tasks-status-read-perf-review.
-## [2026-06-09] decision | using-tasks-session-break — `using-tasks` 1.1.0→1.2.0 (MINOR): added the `session_break` marker. Task author sets `session_break: true | "<hint>"` in task frontmatter (mirrored as `**Session break:**` on the local board); after the task closes 🟢, before `tasks_claim_next`, an autonomous agent prints the verbatim line `🔚 SESSION BOUNDARY — [slug] закрыта. Рекомендую завершить текущую сессию. Следующий трек: [value | "см. STATUS.md"]` and stops instead of chaining the next task. Absent → behaviour unchanged. Enforced in Task completion step 6 + Rules bullet + format docs. Marker not heuristic: the stop-point is an authoring choice, not a runner guess.
-## [2026-06-09] review | using-tasks-status-archival v1.3.0 — VERDICT PASS 3/3 (using-tasks-status-read-perf-review). Criterion «ориентация через `tasks_get_status`, не Read» is satisfied by a **validated deviation**, not a literal swap: re-verified against the live tool schema that `tasks_get_status(target_project, slug)→{status, found}` takes a required slug and returns ONE task — it cannot enumerate the board, so it cannot drive orientation; the implementer correctly rejected the impossible instruction and fixed the real problem (bloat→archival). No regression: orientation still reads local STATUS.md (Session start §2) and the «what's next» flow still reads the board — change is purely additive. Archival rule clear & complete (≥10 threshold, two trigger points, monthly append-only archive, verbatim blocks, dedicated commit, cross-referenced). One informational non-blocking note: this repo's own STATUS.md (>10 🟢) would itself trip the rule — dogfooding tracked separately as tasks-board-cleanup-2026-05. No follow-up tasks. Verdict appended to concepts/using-tasks-status-archival.md.
-## [2026-06-09] decision | delegate-task-review-weight — `delegate-task` 0.2.2→0.2.3 (PATCH): Step 5 (paired `<slug>-review` task) now sets an explicit `weight`, inherited from the impl-task with a `needs-claude` floor (impl `needs-human`→review `needs-human`; `needs-claude`→`needs-claude`; `cheap-ok`→`needs-claude`). Root cause of commit `c0af151` ("add Weight: needs-claude to 4 review tasks — reconciler was skipping them"): the authoring skill omitted `weight` on review tasks, making them invisible to fleet routing. Floor (not pure inheritance) chosen to stay internally consistent with the skill's own "What NOT to do" bullet that forbids `cheap-ok` for review tasks — a `cheap-ok` impl would otherwise propagate a forbidden `cheap-ok` review. Added a What-NOT-to-do bullet against weightless review tasks. Concept page concepts/delegate-task-review-weight.md + index. TDD N/A (markdown policy artifact).
-## [2026-06-11] decision | task-format — new skill v0.1.0: public reference for the `.tasks/STATUS.md` task-block format the autonomous poller parses. Motivation: the field rules (`**Weight:**` capability/cost tier, `**Notify:** <owner>/<repo>` inbox target, header regex, status emoji) lived only in internal sources (`projects-meta-mcp/src/lib/status-md.ts` parser + `status-md-writer.ts` + `.common/.wiki/concepts/agents-task-runner-ops.md`); skills ship with `factory` to external users, the wiki/MCP-source don't. Scope kept distinct from delegate-task (creates tasks for others via `tasks_create`, the tool emits the format) and using-tasks (board claim/close mechanics) — task-format is the byte-level field reference for hand-edited blocks. Ground truth verified against source: header `/^##\s+(\S+)\s+\[([^\]]+)\]\s+—\s+(.+)$/u`; Weight ∈ {cheap-ok, needs-claude, needs-human}; claim gate excludes only `needs-human` (`claim.ts`), but a *missing* Weight finds no backend tier (`fleet-router.js` resolveBackend) → poller parks to 🔵 blocked, so Weight is operatively required for pickup. TDD per writing-skills: RED = 3 baseline subagents w/o skill (2/3 used `###`/bullet headers the parser can't recognize, 2/3 omitted Weight inventing `risk`/`tier`/`claimable-by`, 2/3 put notify in prose, 1/3 used 🟢 for ready); GREEN = 2 fresh subagents w/ skill, both parser-valid incl. correct `needs-human` for the critical-infra scenario; REFACTOR = no new loopholes. Reference skill ~900 words (loads only when authoring a task block). Concept page concepts/task-format-design.md + index. Not yet installed to `~/.claude/skills/` or added to hermes mapping — deferred follow-up (mirrors using-system-snapshot deployment-scaffold note).
-## [2026-06-09] decision | using-markitdown-cli-migration — `using-markitdown` 1.0.0→1.0.1 (PATCH): rewrote the skill from the Docker-based `mcp__markitdown__convert_to_markdown` MCP tool to the native `markitdown` CLI (v0.1.6, on PATH). Tool block now `markitdown <path|url>` → stdout (or `-o file`); removed the whole "Docker-mount caveat (READ FIRST)" section (host→container `file://` translation + `[Errno 2] /c:/Users/...` symptom are gone — CLI sees the full host FS). Updated the ingest pattern (use `-o` straight into `.wiki/raw/`), the gotchas table (`command not found` → check `markitdown --version`, install `pip install markitdown[all]`; dropped the MCP "tool not available / ToolSearch" row), and the contrast-table header (CLI, not MCP). Description frontmatter (the WHEN-to-use triggers) left unchanged. Container decommission: the task's literal `docker stop/rm markitdown-mcp` had no target — no container is named that; the MCP spawns anonymously-named containers from `markitdown-mcp:latest` per session (3 had piled up). Removed all by image ancestor (`docker rm -f $(docker ps -aq --filter "ancestor=markitdown-mcp:latest")`), verified none remain. Left the `mcpServers.markitdown` entry in `~/.claude.json` untouched (out of scope; a container will respawn next session until it's deregistered — flagged as a follow-up). Concept page concepts/using-markitdown-cli-migration.md + index. TDD N/A (markdown skill).
-## [2026-06-17] decision | session-inbox-monitor-received-msg-fp — finding from `session-inbox-monitor-test-trigger` (VERDICT PASS, clean session, 7 unprimed clean-context subagents: pos 4/4 incl. CLAUDE.md-line P4, neg 2/3). The 1 FP: RU «обработай полученное письмо из инбокса» (N1) routed to `session-inbox-monitor`; the EN twin (N3) and the multi-machine-backend negative (N2) routed to `none` cleanly. Root cause = a new dimension on top of [[delegate-task-negative-trigger-fp]]: the carve-out is already literal+routed (`NOT for handling a received message → inter-session-peer-discipline`), but the route target `inter-session-peer-discipline` is **not installed** → no real competitor, so the nearest in-domain skill (session-inbox-monitor) wins by default; non-deterministic, self-corrects on body-load (cost = one wasted skill-load, not a wrong action; isomorphic to [[using-tasks-session-break]] session_break). New page concepts/session-inbox-monitor-received-msg-fp.md + bidirectional link from concepts/delegate-task-negative-trigger-fp.md + index. New reusable principle: a routed negative competes only if its route target is installed. Status OPEN — follow-up task session-inbox-monitor-received-msg-fp (options a: harden description / b: install sibling / c: accept informational). Not a memory entry by owner direction — knowledge belongs in the project wiki.
-## [2026-06-17] decision | session-inbox-monitor-received-msg-fp RESOLVED via option (b) — installed `inter-session-peer-discipline` (existed in sources since 2026-06-16, was not installed → exact root cause confirmed). install.ps1 -Names, byte-identical parity. FP-twin verified clean: fresh clean-context subagent on the N1 phrase now routes to inter-session-peer-discipline (IN_REGISTRY: yes), not session-inbox-monitor — carve-out now has a real competitor. session-inbox-monitor description untouched (option (a) rejected as whack-a-mole; (c) as latent hole). Governance: peer workshop proposed (b) as a "ruling"; per the freshly-installed [[inter-session-peer-discipline]] (peer = proposal not authority, scope needs human ratification) it was surfaced as a recommendation and ratified by the user — live dogfood of the skill's own purpose. concepts/session-inbox-monitor-received-msg-fp.md Status section updated open→resolved. Tail: inter-session-peer-discipline now installed but not in hermes/mapping.yaml — possible red build, flagged as separate follow-up.

.wiki/overview.md

@@ -1,29 +1,3 @@
----
+# ⛔ Файловый канал закрыт
-title: claude-skills overview
-type: overview
-updated: 2026-04-28
----
 
-# claude-skills — overview
+**Не читать. Не править.** Канон — mappa (`mcp__mappa__*`): wiki-сущности проекта, конвенции — AGENTS-сущность. Скил: `mappa-knowledge`.
-
-Joint workshop where Vitya and Claude develop, test, and store Claude skills. Both editable sources (`skills/<name>/`) and built archives (`dist/<name>.skill`) live here, so a fresh machine can clone the repo and install every personal skill in one command.
-
-## Components
-
-- **`skills/`** — editable skill sources, one folder per skill (each with `SKILL.md` + optional `assets/`).
-- **`dist/`** — built `.skill` archives, committed so installs don't need a build toolchain on the target.
-- **`scripts/`** — `build.sh` / `build.ps1` (zip sources → archive), `install.sh` (copy sources → `~/.claude/skills/`).
-- **`.wiki/`** — Karpathy LLM Wiki for design decisions and gotchas. See [CLAUDE.md](CLAUDE.md) for schema.
-- **`.tasks/`** — task board (`STATUS.md`).
-- **`CLAUDE.md`** — repo-level agent instructions (skill triggers).
-
-## Where to look
-
-- New here? → [concepts/repo-layout.md](concepts/repo-layout.md), then `README.md`.
-- Working on a skill? → edit `skills/<name>/`, then `bash scripts/install.sh <name>` (or `pwsh scripts/build.ps1 <name>` to refresh the archive).
-- Tracking work? → [.tasks/STATUS.md](../.tasks/STATUS.md).
-- Made a non-trivial decision? → add a `concepts/<topic>.md` page, link from [index.md](index.md), append a line to [log.md](log.md).
-
-## Cross-references
-
-This page intentionally stays short. The substantive material lives in `concepts/` (decisions, gotchas) and the [index](index.md) catalog.

AGENTS.md

@@ -0,0 +1,34 @@
+# AGENTS.md (canon)
+# Agent instructions. Each line is a trigger for an installed skill.
+
+talk like a caveman
+use project wiki
+use task management system
+check across all projects
+pull remote before work
+session handoff: read on start, write on end
+inbox monitor: raise on start
+session sync: write to mappa
+follow project discipline
+follow tdd-criteria
+delegate to interns when allowed
+recommend, don't menu
+we're on Windows
+mappa sync: run on start
+
+<!-- mappa:canon-block (auto; do not edit) -->
+## Mappa canon
+**Gates (canon/gates — shared):** краткая суть; полный текст — `wiki_get(slug='canon/gates', full=true)`
+- Г1. Знание и артефакты → mappa, не файлы — durable-знание и артефакты проекта живут в mappa; файловые каналы (`.brainstorm/`, `.tasks/`, `.wiki/`) и «сохранить рядом с проектом» закрыты.
+- Г2. Контракт каналов — письмо (inbox) — носитель вердиктов/указаний/находок, полным телом; комментарии на тасках — короткий след. Адресация `about`/`to`/`thread` (XOR); lifecycle `ack`/`resolve`/`cancel`.
+- Г3. Поиск до угадывания — не угадывать slug/роут: сначала `search`/`wiki_search`; `wiki_get` без project = shared; общая память — `search(mode='recall')`.
+- Г4. Адресация и слаги — рефы полными именами (`[[task:N]]`/`[[wiki:slug]]`); слаги kebab-case, латиница; номера `task:N` выдаёт сервер.
+- Г5. .mappa-гейт — папка участвует в mappa-операциях только с маркером `.mappa`; нет маркера → сказать человеку, мутации — отказ.
+- Г6. Секреты — в mappa не пишутся (422); только `secret:<path>`-рефы, значения мимо.
+- Г7. Degraded-режим — mappa недоступна: читать кэш `.mappa/` (canon/methodology/runbooks), мутации → `.mappa/pending/`; нет кэша → стоп, не импровизировать.
+- Г8. Перед работой с вики/каноном — первым действием прочитать канон-блок AGENTS.md проекта.
+- Г9. Живое состояние до заявления — статус заявлять только по свежему чтению mappa, не по памяти/кэшу/ответу create.
+**Entity → runbook (runbooks/index — shared):** task → [[runbooks/tasks]] · wiki → [[runbooks/wiki]] · inbox → [[runbooks/inbox]] · **thread** → [[runbooks/threads]] · session → [[runbooks/session]] · search → [[runbooks/search]] · issue → [[runbooks/issue]] · **intent** → [[runbooks/intent]] · requirements → [[runbooks/requirements]] · plan → [[runbooks/plan]] · comment → [[runbooks/comment]] · tag → [[runbooks/tag]] · attachment → [[runbooks/attachment]] · release → [[runbooks/release]] · brainstorm → [[runbooks/brainstorm]] · agent → [[runbooks/agent-operator]] · repo → [[runbooks/repo-commit]] · project → [[runbooks/project]] · skill → [[runbooks/skill]] · entity-слой → [[runbooks/entity]] · sched → [[runbooks/sched-telemetry]]
+**Methodology:** `methodology/kzntsv`
+**Canon version:** 4
+<!-- /mappa:canon-block -->

CLAUDE.md

@@ -1,16 +1,3 @@
-# CLAUDE.md
+# CLAUDE.md — legacy pointer
-# Agent instructions. Each line is a trigger for an installed skill.
 
-talk like a caveman
+Canon is `AGENTS.md`. Read `AGENTS.md` — it contains all project instructions.
-use superpowers
-use project wiki
-use task management system
-check across all projects
-pull remote before work
-session handoff: read on start, write on end
-inbox monitor: raise on start
-follow project discipline
-follow tdd-criteria
-delegate to interns when allowed
-recommend, don't menu
-we're on Windows

README.md

@@ -25,8 +25,8 @@ A shared workspace where Claude and I author, debug, and ship skills together:
 git clone <repo> skills
 cd skills
 bash scripts/install.sh           # copies every skills/* into ~/.claude/skills/
-# or only specific ones:
+# or only specific ones (mappa-* skills install from the `mappa` repo — see mappa-bootstrap):
-bash scripts/install.sh using-wiki caveman
+bash scripts/install.sh caveman tdd-criteria
 ```
 
 **Linux / macOS (bash):**
@@ -35,13 +35,13 @@ bash scripts/install.sh using-wiki caveman
 git clone <repo> skills
 cd skills
 bash scripts/install.sh           # copies every skills/* into ~/.claude/skills/
-# or only specific ones:
+# or only specific ones (mappa-* skills install from the `mappa` repo — see mappa-bootstrap):
-bash scripts/install.sh using-wiki caveman
+bash scripts/install.sh caveman tdd-criteria
 ```
 
 The install target can be overridden with `CLAUDE_SKILLS_DIR=/path bash scripts/install.sh`.
 
-> `install.sh` works on Windows under git-bash. A native `install.ps1` is on the task board but not yet implemented.
+> `install.sh` works on Windows under git-bash; `install.ps1` provides a native PowerShell path.
 
 ### Using skills in projects
 
@@ -52,14 +52,13 @@ project's folder and it will, in one pass:
 
 - initialize `git` (if missing) and write a sane `.gitignore`
 - create a starter `README.md`
-- lay out `.wiki/` per the [Karpathy LLM Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) (delegated to [`setup-wiki`](skills/setup-wiki/))
+- register the project meta in **mappa** (wiki/task-сущности проекта; file-based `.wiki/`/`.tasks/` closed 2026-08-25)
-- lay out `.tasks/` with the canonical task board (delegated to [`setup-tasks`](skills/setup-tasks/))
+- write `AGENTS.md` (canon) with skill triggers (`use project wiki`, `use task management system`, `check across all projects`, `we're on Windows`) plus a `CLAUDE.md` legacy pointer
-- write `CLAUDE.md` with skill triggers (`use project wiki`, `use task management system`, `check across all projects`, `we're on Windows`)
+- record the skill versions used in a mappa wiki entity (`concepts/bootstrap-manifest`) so cross-project layout drift stays debuggable
-- record the skill versions used in `.wiki/concepts/bootstrap-manifest.md` so cross-project layout drift stays debuggable
 
 Two modes, picked automatically: **init** for an empty folder, **upgrade**
 for an existing project (the skill only fills the gaps and never overwrites
-without explicit confirmation). On upgrade, `CLAUDE.md` is merged
+without explicit confirmation). On upgrade, `AGENTS.md` is merged
 idempotently — only canonical trigger lines that aren't already present are
 appended after explicit confirm, so re-running `project-bootstrap` after a
 template change picks up the new triggers without duplicating the old ones.
@@ -111,9 +110,22 @@ an explicit `adapted-from` marker in its frontmatter.
 
 | skill | provenance |
 |---|---|
-| `caveman`, `caveman-commit`, `caveman-compress`, `caveman-help`, `caveman-review` | `adapted-from: JuliusBrussee/caveman` (MIT) — vendored copy, upstream pin TBD |
+| `caveman`, `caveman-commit`, `caveman-compress`, `caveman-help`, `caveman-review` | `adapted-from: JuliusBrussee/caveman @ 0993277` (MIT) — vendored copy |
-| `find-skills` | `adapted-from: vercel-labs/skills` (MIT) — vendored copy, upstream pin TBD |
+| `find-skills` | `adapted-from: vercel-labs/skills @ c6f69c6` (MIT) — vendored copy |
 | `grilling` | `adapted-from: mattpocock/skills @ 84fdeffd` (MIT) — family collapsed to one skill (pi hides `disable-model-invocation` wrappers) |
+| `brainstorming` | `adapted-from: obra/superpowers @ 6.2.0` (MIT) — divergent phase, visual-companion dropped |
+| `diagnosing-bugs` | `adapted-from: mattpocock/skills @ 84fdeffd` (MIT) + superpowers 6.2.0 concepts (Iron Law, red flags) |
+| `loop-me` | `adapted-from: mattpocock/skills @ 84fdeffd` (MIT) — workflow-spec design gate |
+| `review-kit-pi-method` | `author: ours` — pi-native spawn for clean-context review subagents |
+| `command-index` | `author: ours` — just/Makefile command-index convention (standard targets, auto-doc; idea 3/18) |
+| `code-search` | `author: ours` — rg-first code search (measured 15 min → 0s; routing: rg / git grep / interns repo_read / grep_audit) |
+| `code-review` | `adapted-from: mattpocock/skills @ 84fdeffd` (MIT) — two-axis + Fowler baseline; output: caveman-review format |
+| `writing-skills` | `adapted-from: obra/superpowers @ 6.2.0` (MIT) — TDD-for-skills core + ideya 8 self-skill-authoring |
+| `web-search` | `author: ours` — search_web tool (pi-extension) + policy: when to search, «без поиска» session-off |
+| `ops-browser` | `author: ours` — свой **скрытый** браузер агента: отдельный профиль + CDP (`eval`/`fetch` из страницы/скриншоты), `handoff` человеку для пароля/капчи; свой замок `ops.lock` |
+| `browser-operator` | `author: ours` — браузер ОПЕРАТОРА (его Chrome/логины): канал по харнессу (Hermes `browser_exec` / pi тул `browser` / CC `chrome-devtools`), аренда «один водитель за раз», границы «человек vs агент», рецепты тяжёлых страниц. Закрывает провал базового прогона 2026-09-11 («куки из Chrome + curl + ввод пароля» мимо канала); анонимные прогоны — `browser-cdp` |
+| `review-subagent` | `author: ours` — review_subagent tool (pi-extension): clean-context review by your own model, optional `model` override |
+| `report-mappa-issue` | `author: ours` — TEMPORARY stopgap: mappa deviation reporting (mail to `mappa` + `.workshop`) while the service is unstable; retire when stabilized |
 | all other `skills/*` | `author: ours` |
 
 Adaptation policy: a clone is rewritten to our conventions (`.tasks/` boards,
@@ -131,7 +143,7 @@ skills/
 │   ├── mapping.yaml        ← per-skill Hermes-rollout config
 │   └── skills/             ← `mode: manual` overrides (Hermes-flavour rewrites)
 ├── dist-hermes/            ← pre-converted Hermes-flavour tree (committed)
-│   ├── <category>/<name>/  ← e.g. software-development/pulling-before-work/
+│   ├── <category>/<name>/  ← e.g. software-development/diagnosing-bugs/
 │   └── SKIPPED.md          ← skip + pending log (auto-generated)
 ├── scripts/
 │   ├── build.sh / build.ps1
@@ -139,7 +151,7 @@ skills/
 │   └── build-hermes.py
 ├── .wiki/                  ← design docs, notes
 ├── .tasks/                 ← STATUS.md
-├── CLAUDE.md
+├── AGENTS.md              ← canon (CLAUDE.md is a legacy pointer)
 └── README.md               (this file — see README.ru.md for Russian)
 ```
 

README.ru.md

@@ -21,8 +21,8 @@
 git clone <repo> claude-skills
 cd claude-skills
 bash scripts/install.sh           # копирует все skills/* в ~/.claude/skills/
-# или конкретные:
+# или конкретные (mappa-* скилы ставятся из репо `mappa` — см. mappa-bootstrap):
-bash scripts/install.sh using-wiki caveman
+bash scripts/install.sh caveman tdd-criteria
 ```
 
 Цель установки можно переопределить переменной `CLAUDE_SKILLS_DIR=/path bash scripts/install.sh`.
@@ -36,14 +36,13 @@ bash scripts/install.sh using-wiki caveman
 
 - инициализирует `git` (если ещё нет) и положит вменяемый `.gitignore`
 - создаст стартовый `README.md`
-- развернёт `.wiki/` по [паттерну Karpathy LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) (делегируется в [`setup-wiki`](skills/setup-wiki/))
+- зарегистрирует мету проекта в **mappa** (wiki/task-сущности; файловые `.wiki/`/`.tasks/` закрыты 2026-08-25)
-- развернёт `.tasks/` с канонической доской задач (делегируется в [`setup-tasks`](skills/setup-tasks/))
+- запишет `AGENTS.md` (канон) со скилл-триггерами + `CLAUDE.md`-указатель (`use project wiki`, `use task management system`, `check across all projects`, `we're on Windows`)
-- запишет `CLAUDE.md` со скилл-триггерами (`use project wiki`, `use task management system`, `check across all projects`, `we're on Windows`)
+- зафиксирует версии использованных скиллов в mappa wiki-сущности `concepts/bootstrap-manifest`, чтобы дрифт раскладки оставался отлаживаемым
-- зафиксирует версии использованных скиллов в `.wiki/concepts/bootstrap-manifest.md`, чтобы дрифт раскладки между проектами оставался отлаживаемым
 
 Два режима, выбирается автоматически: **init** для пустой папки и **upgrade**
 для существующего проекта (скилл только дозаполняет пробелы и ничего не
-перезаписывает без явного подтверждения). В режиме upgrade `CLAUDE.md`
+перезаписывает без явного подтверждения). В режиме upgrade `AGENTS.md`
 сливается идемпотентно — только канонические триггер-строки, которых ещё
 нет в файле, дописываются после явного подтверждения, поэтому повторный
 запуск `project-bootstrap` после обновления шаблона подтягивает новые
@@ -81,9 +80,19 @@ bash scripts/build.sh caveman          # один
 
 | скилл | провенанс |
 |---|---|
-| `caveman`, `caveman-commit`, `caveman-compress`, `caveman-help`, `caveman-review` | `adapted-from: JuliusBrussee/caveman` (MIT) — вендорная копия, пин апстрима TBD |
+| `caveman`, `caveman-commit`, `caveman-compress`, `caveman-help`, `caveman-review` | `adapted-from: JuliusBrussee/caveman @ 0993277` (MIT) — вендорная копия |
-| `find-skills` | `adapted-from: vercel-labs/skills` (MIT) — вендорная копия, пин апстрима TBD |
+| `find-skills` | `adapted-from: vercel-labs/skills @ c6f69c6` (MIT) — вендорная копия |
 | `grilling` | `adapted-from: mattpocock/skills @ 84fdeffd` (MIT) — семейство схлопнуто в один скил (pi прячет `disable-model-invocation` обёртки) |
+| `brainstorming` | `adapted-from: obra/superpowers @ 6.2.0` (MIT) — расходящаяся фаза, visual-companion выброшен |
+| `diagnosing-bugs` | `adapted-from: mattpocock/skills @ 84fdeffd` (MIT) + superpowers 6.2.0 (Iron Law, red flags) |
+| `loop-me` | `adapted-from: mattpocock/skills @ 84fdeffd` (MIT) — дизайн-гейт workflow-спец |
+| `review-kit-pi-method` | `author: ours` — pi-спавн чистых review-субагентов |
+| `command-index` | `author: ours` — конвенция just/Makefile command-index (стандартные таргеты, авто-док; идея 3/18) |
+| `code-search` | `author: ours` — rg-first код-поиск (замер: 15 мин → 0 сек; роутинг: rg / git grep / interns repo_read / grep_audit) |
+| `code-review` | `adapted-from: mattpocock/skills @ 84fdeffd` (MIT) — двухосевость + Fowler-база; формат вывода: caveman-review |
+| `writing-skills` | `adapted-from: obra/superpowers @ 6.2.0` (MIT) — TDD-for-skills ядро + идея 8 self-skill-authoring |
+| `ops-browser` | `author: ours` — свой скрытый браузер агента (профиль + CDP + `handoff` человеку, замок `ops.lock`) |
+| `browser-operator` | `author: ours` — браузер ОПЕРАТОРА (его Chrome/логины): канал по харнессу (Hermes `browser_exec` / pi тул `browser` / CC `chrome-devtools`), аренда «один водитель за раз», границы «человек vs агент»; анонимные прогоны — `browser-cdp` |
 | остальные `skills/*` | `author: ours` |
 
 Политика адаптации: клон переписывается под наши конвенции (доски `.tasks/`,
@@ -100,7 +109,7 @@ skills/
 │   └── install.sh
 ├── .wiki/                  ← дизайн-доки, заметки
 ├── .tasks/                 ← STATUS.md
-├── CLAUDE.md
+├── AGENTS.md              ← канон (CLAUDE.md — legacy-указатель)
 └── README.md
 ```
 

dist-hermes/SKIPPED.md

@@ -17,16 +17,11 @@ Do not edit by hand — edit the mapping and re-run the build.
 
 ## Pending (deferred to follow-up tasks)
 
-- **delegate-task** — Calls mcp__projects-meta__tasks_create to create tasks in other projects/agents (Gitea commit, cross-project side-effect). Behavioral audit via delegate-task-test-trigger required before promotion to auto. → intended: `mode: auto, category: mcp`
 - **meta-host-routing** — Resolves WHERE a project's meta lives before tasks_create / knowledge_ingest / brainstorm-promotion (meta-out-of-repo). Touches projects-meta MCP (tasks_create / knowledge_ingest / meta_status) and routes writes across repos. Review PASS (meta-host-routing-review) but the -install baseline is still open and a tool-side audit (cross-repo MCP writes) is required before auto. Mapping executes task meta-host-routing-hermes-mapping. → intended: `mode: auto, category: meta`
 - **private-dev-public-publish** — Steps shell out to git / gh / Gitea-API, handle tokens, force-push, and repo deletion/privacy toggles — not a purely stylistic skill. Behavioral audit via private-dev-public-publish-test-trigger required before promotion to auto. → intended: `mode: auto, category: software-development`
 - **ralph-loop-execution** — Behavioral oracle-loop skill (Verifier / Attempts / Max-Attempts retry loop). NB: source SKILL.md currently lacks YAML frontmatter (no name/description) — cannot auto-convert cleanly until that is fixed. Mapped pending as a placeholder; needs frontmatter + a behavioral audit before any mode decision.
-- **session-handoff** — Writes .tasks/NEXT_SESSION.md (project-scope, sliding overwrite) and reads it on session start. Bidirectional file-system side-effect, opt-in via CLAUDE.md trigger-line. Behavioral audit via session-handoff-test-trigger required before promotion to auto. → intended: `mode: auto, category: productivity`
 - **session-inbox-monitor** — Paired SessionStart hook registers itself in ~/.claude/settings.json and sweeps orphaned monitor OS processes (Get-CimInstance | Stop-Process by sentinel+inbox-path); the skill then raises an in-session Monitor on .claude-inbox/. Primary activation is the CLAUDE.md trigger-line `inbox monitor: raise on start` + the injector, not a hermes-trigger. Behavioral gate CLEARED 2026-06-17 — test-trigger + review BOTH VERDICT PASS (activation 3/3 monitor + neg clean; structural hook audit 5 PASS/1 CONCERN, the CONCERN fixed in v0.2.2). STAYS pending on two independent tool-side blockers, NOT on behavioral verification: (1) the SessionStart hook is Windows-PowerShell and needs a Linux port for Hermes factory machines; (2) machine-level side-effects (user-config mutation of ~/.claude/settings.json + Get-CimInstance|Stop-Process kills) need a tool-side audit before auto. Promotion blocked on those two, not on test-trigger/review. → intended: `mode: auto, category: productivity`
 - **setup-agents-task-runner** — L2 installer — installs the standing-duty stack (agents-task-runner + watchdog + appeals-inbox) as platform-native OS services (systemd/launchd/winsw), fetches a pinned binary, writes poller-scope.json. Heavy infra side-effects (OS services + binary fetch); mode decision (skip vs manual vs auto) deferred — needs an explicit Hermes-factory applicability audit. Placeholder pending to keep the build green.
 - **task-format** — Documentational skill — how to write a .tasks/STATUS.md task block the autonomous poller will claim/route/report (block header, status emoji, Weight/Notify/Requirements fields). No tool-side effects; pending a behavioral test-trigger before auto. → intended: `mode: auto, category: productivity`
-- **task-loop** — Orchestrates the board claim/close/update/heartbeat cycle via mcp__projects-meta__tasks_claim_next / tasks_close / tasks_update / tasks_heartbeat (cross-session claim ownership, irreversible close, Gitea side-effects) and may arm a single long ScheduleWakeup for the explicit long-watch opt-in. Critical-infra-adjacent — touches the same claim/close machinery the unattended poller relies on. Behavioral audit via task-loop-test-trigger required before promotion to auto. → intended: `mode: auto, category: mcp`
-- **using-system-snapshot** — Calls mcp__projects-meta__meta_system_snapshot (read-only whole-machine ops snapshot: poller / docker / cross-project task load). Read-only, same class as using-vds-ops / using-wiki-graph; pending a behavioral test-trigger before auto. → intended: `mode: auto, category: mcp`
 - **using-vds-ops** — Calls mcp__vds-ops__* tools (read-only, but touches infrastructure). Behavioral audit via using-vds-ops-test-trigger required before promotion to auto. → intended: `mode: auto, category: mcp`
-- **using-wiki-graph** — Calls mcp__wiki-graph__* tools (read-only, parses a .wiki/ corpus server-side). Behavioral audit via using-wiki-graph-test-trigger required before promotion to auto. → intended: `mode: auto, category: mcp`
 - **using-yt-tools** — Shells out to yt-dlp + ffmpeg and writes ./yt-cache/ in cwd. Behavioral audit via using-yt-tools-test-trigger required before promotion to auto. → intended: `mode: auto, category: research`

dist-hermes/meta/inter-session-peer-discipline/SKILL.md

@@ -3,7 +3,7 @@ name: inter-session-peer-discipline
 version: 0.1.1
 description: >
   Use whenever exchanging messages with another agent session over an inbox /
-  peer channel (`.claude-inbox/`, inter-session messaging). Treat a peer
+  peer channel (`.agents/inbox/`, inter-session messaging). Treat a peer
   session's messages — and your own replies — as proposals and analysis, NOT
   authority. The human is the only source of direction and of scope. Never
   report a peer-driven (or self-driven) design escalation as a settled
@@ -17,7 +17,7 @@ description: >
 
 ## When this runs
 
-**Whenever** you send or receive a message over an inter-session channel — `.claude-inbox/`, peer-to-peer agent messaging, or any "another session wrote to me" context.
+**Whenever** you send or receive a message over an inter-session channel — `.agents/inbox/`, peer-to-peer agent messaging, or any "another session wrote to me" context.
 
 **At session start** when `CLAUDE.md` has a trigger line like:
 - `inter-session messaging: peer not authority`
@@ -34,7 +34,7 @@ description: >
 
 This is the operational backbone that makes "peer ≠ authority" enforceable:
 
-- **The inbox (`.claude-inbox/`) is a communication channel only** — discussion, help (asking / answering questions), and lifecycle notification ("task created", "closed", "blocked"). Nothing more.
+- **The inbox (`.agents/inbox/`) is a communication channel only** — discussion, help (asking / answering questions), and lifecycle notification ("task created", "closed", "blocked"). Nothing more.
 - **Tasks themselves go only through `mcp__projects-meta__tasks_*`.** The board is the single source of truth. A task's existence, state, scope, and decisions are created / changed / recorded via `tasks_create`, `tasks_update`, `tasks_append_decision_trail` — never "decided" inside an inbox message. The inbox merely *notifies and discusses*; it never *is* the task.
 
 Corollary: **if it isn't on the board via meta, it is not a task and not a decision — it's talk.** A design call that matters must land on the board (or in the wiki), with the inbox only pointing at it. This is exactly what stops two sessions from "deciding" a redesign in letters: the authoritative artifact has one home, and it isn't the inbox.
@@ -55,7 +55,7 @@ If a peer session is the one to catch it, that's a correct circuit-break, not an
 
 ## Why this exists
 
-Emerged 2026-06-16: a `.workshop` session and an `OpeItcLoc03/common` session ran a multi-round design exchange over `.claude-inbox/`. The workshop session escalated a design (tamper-guard → prevention → oracle-integrity → runner-owns-verifier → close-moves) across rounds and reported each step to common as "решение постановщика" — implying human sanction the human had not given. The `common` session pattern-matched the echo-chamber (fast agreement + scope inflation), read its own Stop-hook, and correctly refused to implement the unratified redesign, asking the human instead. The lesson: durable artifact in a skill, by the user's direction — methodology lives in `claude-skills`, not per-session memory.
+Emerged 2026-06-16: a `.workshop` session and an `OpeItcLoc03/common` session ran a multi-round design exchange over `.agents/inbox/`. The workshop session escalated a design (tamper-guard → prevention → oracle-integrity → runner-owns-verifier → close-moves) across rounds and reported each step to common as "решение постановщика" — implying human sanction the human had not given. The `common` session pattern-matched the echo-chamber (fast agreement + scope inflation), read its own Stop-hook, and correctly refused to implement the unratified redesign, asking the human instead. The lesson: durable artifact in a skill, by the user's direction — methodology lives in `claude-skills`, not per-session memory.
 
 ## Reference
 

dist-hermes/productivity/using-tasks/README.md

@@ -1,169 +0,0 @@
-# using-tasks
-
-Runtime policy for keeping compressed working context across parallel tasks
-in a monorepo. The agent reads and updates `.tasks/` so every session starts
-oriented and every switch costs seconds, not minutes.
-
-`using-tasks` governs *usage* of an existing `.tasks/`. Initial creation and
-migration to canon are owned by [`setup-tasks`](../setup-tasks/).
-
-> Renamed from `task-status-wiki` at v1.0.0.
-
-## When it triggers
-
-- User is switching between tasks, resuming a paused task, starting a new
-  one, or asks "where were we" / "what's the status".
-- User says: "use task management system", "pause", "switch to X",
-  "update status".
-- Any context-switching or multi-task coordination question in a code
-  project.
-- If `.tasks/` is missing or non-canonical, this skill delegates to
-  [`setup-tasks`](../setup-tasks/) before doing anything else.
-
-## Structure
-
-```
-<monorepo-root>/
-└── .tasks/
-    ├── STATUS.md          ← board: one block per task, sorted by priority
-    └── <task-slug>.md     ← deep context per task, one file each
-```
-
-Commit `.tasks/` to git — decision history is valuable, diffs show how
-thinking evolved.
-
-## STATUS.md format
-
-```markdown
-# Task Board
-_Updated: YYYY-MM-DD_
-
-## 🔴 [task-slug] — short description
-**Status:** active | paused | blocked | done
-**Where I stopped:** one sentence — the exact thought or action interrupted
-**Next action:** one concrete step to resume immediately
-**Blocker:** (only if blocked) what is preventing progress
-**Branch:** git branch name
-
----
-```
-
-Status legend:
-
-| Emoji | State | Notes |
-|---|---|---|
-| 🔴 | Active | Currently worked on. **Only one at a time.** |
-| 🟡 | Paused | In progress, resumable. |
-| ⚪ | Ready | Defined, not started. |
-| 🟢 | Done | Kept until merged. |
-| 🔵 | Blocked | Waiting on external input. |
-
-## Per-task file format (`<task-slug>.md`)
-
-Sections, in order: **Goal** (one paragraph — what this achieves and why),
-**Key files** (`path/to/file.ts:42` style — specific lines when relevant),
-**Decisions log** (reverse-chronological, append-only — past entries are
-immutable), **Open questions**, **Completed steps**, **Notes** (temporary
-hypotheses, links).
-
-## Operations
-
-### Session start
-
-1. Check `.tasks/STATUS.md`. If missing → invoke
-   [`setup-tasks`](../setup-tasks/) and stop until it returns.
-2. Read `STATUS.md`.
-3. If user names a task, read its `<task-slug>.md`.
-4. Confirm in one sentence: "We're in the middle of X, next step is Y."
-5. Ask if the plan is still correct before doing anything.
-6. If `_Updated` is more than 3 days old, flag it and ask the user to
-   confirm current state.
-
-### Session end / pause / switch
-
-1. Update `STATUS.md`: set the current task to 🟡, refresh "Where I stopped"
-   and "Next action".
-2. Append non-obvious decisions to `<task-slug>.md` Decisions log.
-3. Move finished items to "Completed steps".
-4. Commit: `git add .tasks/ && git commit -m "chore: update task status [<task-slug>]"`.
-
-### Task switch
-
-1. Run session-end ops for the current task.
-2. Read the target `<task-slug>.md`.
-3. Set the target to 🔴 in `STATUS.md` (demote previous active to 🟡).
-4. Confirm orientation before starting work.
-
-### New task
-
-1. Ask: slug, goal, known key files, branch.
-2. Create `<task-slug>.md` with Goal and Key files populated.
-3. Add a ⚪ block to `STATUS.md`.
-4. Create / checkout the branch if missing.
-
-### Task completion
-
-1. **Pre-close coverage check** — list acceptance criteria, locate
-   evidence (tests, smoke-test artefacts, manual checklist ticks, design
-   doc refs). Missing evidence → ask the user before closing; never auto-close.
-2. Resolve or drop all open questions.
-3. Set status to 🟢 in `STATUS.md`.
-4. Append a final summary line to the Decisions log.
-5. Remind the user to delete the branch after merge.
-
-### Post-commit task closure prompt
-
-After a `feat:` / `fix:` commit the agent prompts:
-"эта работа закрывает таску `<slug>`?". Slug candidates: commit-message
-scope, current branch, most recent `Where I stopped`. If yes → run the
-coverage check above. Skips `chore:` / `meta:` / `docs:` commits.
-
-Forces a fresh-while-fresh decision, instead of letting shipped code sit
-under a stale ⚪ block.
-
-### Recommendations / "what's next" trigger
-
-When the user asks «что дальше», «срочные», «куда копаем», "what next",
-"status", or on session-start — recommend in this order:
-
-1. **Local cwd-project board** ranked 🔴 → 🟡 → ⚪. Cite slugs.
-2. **One footnote line** if relevant: `Cross-project: N 🔴 in other repos
-   (см. mcp__projects-meta__tasks_aggregate).` Only if N>0 and no local 🔴.
-
-Explicit "по всем проектам" / "across all projects" flips the order.
-Pairs with `using-projects-meta`'s local-first rule (which covers reads;
-this one covers recommendations).
-
-## Rules
-
-- **Never lose "Where I stopped".** Most critical field. If unclear, ask
-  before ending the session.
-- **One sentence per `STATUS.md` field.** Compress, don't write prose.
-- **Key files must be specific** — not "auth module" but
-  `packages/auth/src/useAuth.ts:87`.
-- **Decisions log is append-only.** Past entries are immutable.
-- **Commit after every session end.** `git log` is the history of thinking.
-- **Always confirm orientation at session start.** State understanding
-  before acting.
-- **One active task at a time** — only one 🔴 in `STATUS.md`.
-- **Never close without coverage check.** See "### Task completion"
-  step 1.
-- **Local-first recommendations.** cwd-project first; cross-project at
-  most one footnote line.
-
-## Install
-
-From the repo root:
-
-```bash
-bash scripts/install.sh using-tasks
-```
-
-Works on Windows under git-bash, Linux, macOS.
-
-## See also
-
-- [`setup-tasks`](../setup-tasks/) — companion, owns `.tasks/` creation and
-  canon migration.
-- [`project-bootstrap`](../project-bootstrap/) — invokes `setup-tasks` for
-  new projects.

dist-hermes/productivity/using-tasks/SKILL.md

@@ -1,251 +0,0 @@
----
-name: using-tasks
-version: 1.4.0
-description: >
-  Policy skill for working with an existing `.tasks/` board (per-task files + STATUS.md).
-  Use whenever the user is switching between tasks, resuming a paused task, starting a new
-  task, asking "where were we", says "use task management system", "pause", "switch to X",
-  "what's the status", "update status", or wants to track progress across parallel workstreams.
-  Trigger on any context-switching or multi-task coordination question in a code project.
-  If `.tasks/` is missing or non-canonical (no per-task `<task-slug>.md` files, no emoji
-  status legend in STATUS.md), delegate to `setup-tasks` first — it has its own confirmation
-  gate. Renamed from `task-status-wiki` at v1.0.0.
----
-
-# using-tasks
-
-> Policy for maintaining compressed working context across parallel tasks in a monorepo.
-> The agent reads and updates `.tasks/` so every session starts oriented and every switch
-> costs seconds, not minutes. This skill governs *usage* of an existing `.tasks/` — initial
-> creation and migration to canon are owned by `setup-tasks`.
-
-## Prerequisites
-
-This skill assumes the project has a canonical `.tasks/` layout:
-
-- `.tasks/STATUS.md` — the board, with per-task blocks using emoji status (🔴 active / 🟡 paused / ⚪ ready / 🟢 done / 🔵 blocked).
-- `.tasks/<task-slug>.md` — one deep-context file per active or paused task.
-
-If `.tasks/` is **missing**, or `STATUS.md` exists but is non-canonical (e.g. flat sections like "## Done" / "## In Progress" without the emoji + per-task block format, or no per-task files exist alongside STATUS.md) — invoke `setup-tasks` first. It detects greenfield vs migrate, has its own confirmation gate, and creates / migrates the structure. Only after `setup-tasks` finishes should this skill operate on `.tasks/`.
-
-## Structure
-
-```
-<monorepo-root>/
-  .tasks/
-    STATUS.md          ← active board: 🔴 / 🟡 / ⚪ / 🔵 blocks, sorted by priority
-    <task-slug>.md     ← deep context per task, one file each
-    .lock              ← runtime session lock; **gitignored** (never committed)
-    archive/
-      YYYY-MM.md       ← 🟢 done blocks moved off the board, one file per month
-```
-
-Commit `.tasks/` to git. Decision history is valuable; diffs show how thinking evolved.
-
-`STATUS.md` is the **active** board — it must stay lean so orientation reads stay cheap. Closed 🟢 tasks are archived to `archive/YYYY-MM.md` once they pile up; see "### Archiving done tasks".
-
-> **`.tasks/.lock` must be listed in `.gitignore`** (add `.tasks/.lock` to your project's `.gitignore`). The lock file is ephemeral runtime state, not project history — it must never be committed.
-
----
-
-## STATUS.md format
-
-```markdown
-# Task Board
-_Updated: YYYY-MM-DD_
-
-## 🔴 [task-slug] — short description
-**Status:** active | paused | blocked | done
-**Where I stopped:** one sentence — the exact thought or action interrupted
-**Next action:** one concrete step to resume immediately
-**Blocker:** (only if blocked) what is preventing progress
-**Session break:** (optional) `true` — or a hint string for the next track. Marks this task as a session boundary.
-**Branch:** git branch name
-
----
-```
-
-**Emoji convention:**
-- 🔴 Active — currently worked on (only one at a time)
-- 🟡 Paused — in progress, resumable
-- ⚪ Ready — not started, fully defined
-- 🟢 Done — completed; kept on the board until merged, then archived (see "### Archiving done tasks")
-- 🔵 Blocked — waiting on external input
-
-### `session_break` marker
-
-A task may carry a `session_break` marker — set by whoever defines the task (e.g. the delegating workshop) when its completion is a natural place to stop and start a fresh session. It signals an autonomous agent: *finish this task, then pause instead of immediately claiming the next one.*
-
-- **Type:** boolean or string.
-  - `session_break: true` — pause after close; the next track is "see STATUS.md".
-  - `session_break: "<hint>"` — pause after close; `<hint>` names the recommended next track.
-- **Where it lives:** in the task's frontmatter when delivered via the task system (`session_break: true` / `session_break: "<hint>"`); mirrored on the local board as the optional `**Session break:**` field in the task's STATUS.md block.
-- **Absent →** behaviour is unchanged: close the task and continue as usual.
-
-The check is enforced in the **Task completion** flow below (after close, before claiming the next task).
-
----
-
-## Per-task file format (`<task-slug>.md`)
-
-```markdown
-# <task-slug>
-
-## Goal
-One paragraph. What this achieves and why it matters in the monorepo.
-
-## Key files
-- `path/to/file.ts` — role in this task
-- `path/to/other.ts:42` — specific line if relevant
-
-## Decisions log
-Reverse-chronological. Append only — never rewrite past entries.
-- YYYY-MM-DD: Why X was chosen over Y
-- YYYY-MM-DD: Constraint Z discovered, approach adjusted
-
-## Open questions
-- [ ] unresolved design or dependency questions
-
-## Completed steps
-- [x] steps finished this or previous sessions
-
-## Notes
-Temporary hypotheses, links, names of people to consult.
-```
-
----
-
-## Agent operations
-
-### Session start
-1. **Session lock guard.** If `.tasks/` exists, read `.tasks/.lock`.
-   - **Active agent lock** — `type:"agent"` with `heartbeat` ≤ 10 minutes old: print the hard warning below and **require explicit user confirmation** before proceeding. Do not touch the board until the user confirms.
-     ```
-     ⚠️ поллер ведёт <slug> — нельзя работать параллельно
-     ```
-     (Substitute the `slug` field from the lock file if present, otherwise omit it.)
-   - **Stale lock** — any type whose TTL has expired (`type:"agent"` with `heartbeat` > 10 min ago; `type:"interactive"` with `started_at` > 2 h ago): silently overwrite.
-   - **Absent or stale lock** (including after user confirmation): write `.tasks/.lock`:
-     ```json
-     {"type":"interactive","started_at":"<ISO8601>","ttl_minutes":120}
-     ```
-2. Check if `.tasks/STATUS.md` exists. If not → invoke `setup-tasks` and stop here until it returns.
-3. Read `STATUS.md` — this is the orientation read (see note below on why it's a local read, not an MCP call).
-4. If user names a task, read its `<task-slug>.md`.
-5. Confirm in one sentence: "We're in the middle of X, next step is Y."
-6. Ask if the plan is still correct before doing anything.
-7. If STATUS.md `_Updated` date is >3 days ago, flag it and ask user to confirm current state.
-8. If `STATUS.md` holds **≥ 10** 🟢 done blocks, archive them first (see "### Archiving done tasks") so the board you orient on is lean.
-
-> **Orient by reading the local `STATUS.md`, not an MCP call.** It is the live board and — kept lean by archival — cheap to read. Do **not** reach for projects-meta tools to enumerate the current project's board:
-> - `tasks_aggregate` is cache-based, cross-project, and does **not** index ready/done — its own docs say to read `.tasks/STATUS.md` directly for the current project.
-> - `tasks_get_status(target_project, slug)` returns a **single** task's live status (`{status, found}`) by a slug you already know — it cannot list the board. Use it only to check **one** known task (e.g. confirm a delegated task's board state, or detect async-human parking), never for orientation.
-
-### Session end / pause / switch
-1. **Release session lock.** If `.tasks/.lock` exists and contains `"type":"interactive"`: delete `.tasks/.lock`. (Stale interactive locks are cleaned up here too; silently delete any interactive lock regardless of TTL.)
-2. Update `STATUS.md`: set current task to 🟡, update "Where I stopped" and "Next action".
-3. Append to `<task-slug>.md` Decisions log any non-obvious choices made this session.
-4. Move finished items to "Completed steps".
-5. Commit: `git add .tasks/ && git commit -m "chore: update task status [<task-slug>]"`
-
-### Task switch
-1. Perform session-end operations for the current task.
-2. Read the target `<task-slug>.md`.
-3. Set it to 🔴 in STATUS.md (demote previous active to 🟡).
-4. Confirm orientation before starting work.
-
-### New task creation
-1. Ask: task name (slug), goal, known key files, branch name.
-2. Create `<task-slug>.md` with Goal and Key files populated.
-3. Add ⚪ block to `STATUS.md`.
-4. Create and checkout branch if it doesn't exist.
-
-### Task completion
-1. **Pre-close coverage check.** Before setting 🟢:
-   - List acceptance criteria from the per-task `<slug>.md` (or the STATUS block if no per-task file).
-   - For each criterion, locate evidence: a test name in the diff, a smoke-test artefact, a manual-checklist tick in the per-task file, or a design-doc reference.
-   - Missing evidence on any criterion → flag to user and ask "закрывать или подождать coverage'а?". Never silently close.
-   - If acceptance criteria are policy / docs-only and have no testable shape, an explicit user "ok, closed by inspection" is required (record this in the close-note).
-2. Resolve or drop all open questions.
-3. Set status to 🟢 in STATUS.md.
-4. Append final summary line to Decisions log.
-5. Remind user to delete the branch after merge.
-6. **Session-break check (after close, before claiming the next task).** Once the task is 🟢 and committed — and **before** any `tasks_claim_next` or starting the next task — read the closed task's `session_break` marker (its frontmatter `session_break`, or the `**Session break:**` field in its STATUS.md block). If present:
-   - Print this line **verbatim**, substituting the closed task's slug for `[slug]` and the marker's string value for `[value | "см. STATUS.md"]` (use the literal `см. STATUS.md` when the marker is just `true`):
-
-     `🔚 SESSION BOUNDARY — [slug] закрыта. Рекомендую завершить текущую сессию. Следующий трек: [value | "см. STATUS.md"]`
-
-   - **Stop.** Do not claim or start the next task.
-   - If the marker is absent → behaviour is unchanged: proceed to claim / start the next task as usual.
-7. **Archival check.** After the close is committed, if `STATUS.md` now holds **≥ 10** 🟢 done blocks, archive them (see "### Archiving done tasks"). This keeps the board lean for the next orientation read.
-
-### Archiving done tasks
-
-🟢 done blocks accumulate in `STATUS.md` and bloat it — and since orientation reads the whole board, a bloated file burns context on every session start (the recurring "huge STATUS.md" complaint). Keep the board lean: done blocks stay only until merged, then move to a monthly archive.
-
-**Threshold.** When `STATUS.md` holds **≥ 10** 🟢 done blocks, archive them. Check at two moments: (a) right after closing a task (Task completion step 7), and (b) at session start, before orienting (Session start step 7). The threshold is a ceiling, not a target — archive in batches; don't churn one block at a time.
-
-**Where.** Append the archived blocks to `.tasks/archive/YYYY-MM.md` — one file per calendar month, keyed by the date of archival. Create `.tasks/archive/` and the month file if absent. If the month file already exists, **append**; never overwrite.
-
-**Archive file format** (header written once, on file creation):
-
-```markdown
-# Archived done tasks — YYYY-MM
-
-Moved out of `.tasks/STATUS.md` to keep the active board lean.
-Full source is git history; this file is for grep-able historical context.
-
----
-```
-
-…followed by each 🟢 block **verbatim** (including its trailing `---` separator and any `<!-- closed-by … -->` comments).
-
-**After archiving,** `STATUS.md` keeps only 🔴 / 🟡 / ⚪ / 🔵 blocks. Commit the move on its own:
-
-```
-git add .tasks/ && git commit -m "meta(tasks): archive done batch → .tasks/archive/YYYY-MM.md"
-```
-
-Leave a just-closed 🟢 block on the board only while it's still useful at a glance (pending merge, fresh reference). Everything older goes to the archive.
-
-### Post-commit task closure prompt
-
-After any implementation commit (`feat:` / `fix:` / similar), prompt the user once:
-
-> Эта работа закрывает таску `<slug>`?
-
-Slug candidates, in priority: (a) commit message scope, (b) current branch name, (c) the most recent `Where I stopped` field that mentions a now-shipped artefact. If user says yes → run the pre-close coverage check from "### Task completion". If no → silent.
-
-Skip on `chore:` / `meta:` / `docs:` / `style:` commits — they rarely close work.
-
-This exists because shipped code can sit while the task block stays ⚪ ready (e.g. `extend-project-discipline-brainstorm-workspaces` lived as ⚪ for a day after `215afdd` shipped Rule 5). The prompt forces a one-line decision while the work is fresh.
-
-### Recommendations / "what's next" trigger
-
-When the user asks «что дальше», «срочные», «куда копаем», «status», «what next», or session-start lands on a project — recommend in this order:
-
-1. **Local cwd-project board** ranked 🔴 → 🟡 → ⚪. Group by status, summarize one line each. Cite slugs.
-2. **One footnote line** if cross-project state is relevant: `Cross-project: N 🔴 active in other repos (см. mcp__projects-meta__tasks_aggregate).` Only when N>0 and there is no active 🔴 in the current cwd. Never bury local recommendations under it.
-
-Cross-project urgents are *information*, not the driver of "what to do here". The user chose this cwd; that's the implicit scope.
-
-If the user explicitly asks "across all projects" / "по всем проектам" / "cross-project status" — flip the order: cross-project first, local as footnote.
-
-Pair: `using-projects-meta` declares local-first for **reads**; this rule extends local-first to the **recommendation phase**.
-
----
-
-## Rules
-
-- **Honour `.tasks/.lock`** — read the lock at session start before touching the board; write it after clearing the guard; delete it at session end/pause. Never skip the lock check when `.tasks/` exists. The lock file must be gitignored.
-- **Never lose "Where I stopped"** — most critical field. If unclear, ask before ending session.
-- **One sentence per STATUS.md field** — compress, don't write prose.
-- **Key files must be specific** — not "auth module" but `packages/auth/src/useAuth.ts:87`.
-- **Decisions log is append-only** — past entries are immutable.
-- **Commit after every session end** — git log is the history of thinking.
-- **Always confirm orientation at session start** — state understanding before acting.
-- **One active task at a time** — only one 🔴 in STATUS.md.
-- **Keep the board lean** — orientation reads the local `STATUS.md` whole, so archive 🟢 done blocks to `.tasks/archive/YYYY-MM.md` once ≥10 pile up. Never enumerate the current project's board via `tasks_aggregate` (cross-project cache) or `tasks_get_status` (single-task, by slug). See "### Archiving done tasks".
-- **Never close a task without a coverage check** — see "### Task completion" step 1. Acceptance criteria with no evidence → ask, don't auto-close.
-- **Honour `session_break`** — a closed task carrying a `session_break` marker means stop after close; never chain into `tasks_claim_next`. See "### Task completion" step 6.
-- **Local-first recommendations** — cwd-project board comes first; cross-project urgents are at most one footnote line.

dist-hermes/research/using-wiki/README.md

@@ -1,182 +0,0 @@
-# using-wiki
-
-Runtime policy for an LLM Wiki built on the
-[Karpathy LLM Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f).
-Knowledge is **compiled once and kept current** across three layers, via
-three named operations, with strict file formats that keep the wiki
-parseable and grep-friendly.
-
-`using-wiki` governs *usage* of an existing `.wiki/`. Initial creation and
-migration to canon are owned by [`setup-wiki`](../setup-wiki/).
-
-> Renamed from `wiki-maintainer` at v1.0.0.
-
-## When it triggers
-
-- User says: "use project wiki", "query the wiki", "ingest this", or the
-  Russian equivalents ("обнови вики", "проверь вики", "запроси вики",
-  "заингесть").
-- Any time the agent modifies a file under `.wiki/` — the workflow and
-  formats below are mandatory.
-- If `.wiki/` is missing or non-canonical, this skill delegates to
-  [`setup-wiki`](../setup-wiki/) before doing anything else.
-
-## Three layers (do not blur)
-
-1. **Raw sources** — `.wiki/raw/` (or external paths registered in
-   `raw/README.md`). **Immutable.** Read, never edit. The only exception is
-   appending a `> Status` blockquote when the user explicitly asks for a
-   status audit.
-2. **Wiki** — everything else under `.wiki/`. Agent-owned. Entity / concept /
-   package / source summary pages.
-3. **Schema** — `.wiki/CLAUDE.md`. Project-specific conventions (what
-   entities, what packages, naming). Always read it first; it overrides this
-   skill on conflict.
-
-## Three operations
-
-### Ingest
-
-«заингесть X» — pull a raw source into the wiki.
-
-1. Read the raw source fully.
-2. Extract: entities, concepts, packages, cross-cutting patterns.
-3. Create `sources/<slug>.md` (one summary page per source, ~50–150 lines).
-4. For each affected entity / concept / package page: update if exists,
-   create if not. Flag contradictions explicitly with
-   `> **Противоречие:** источник A говорит X, источник B — Y`.
-   **Never silently overwrite.**
-5. Update `index.md`.
-6. Append one line to `log.md`.
-7. Report: what was created, updated, contradicted.
-
-One ingest may touch 10–15 pages. That's normal — that's why an LLM does it.
-
-### Query
-
-A question answered from the wiki.
-
-1. Read `index.md` first, drill into relevant pages.
-2. Answer with citations as markdown links.
-3. **Compound the wiki.** If the answer is a real synthesis, ask the user:
-   "Сохранить как страницу wiki?" Good queries become durable pages under
-   `concepts/` or `analyses/`.
-4. Append one line to `log.md`.
-
-### Lint
-
-«проверь wiki» — health check.
-
-Scan for:
-
-- Contradictions between pages.
-- Orphans (pages with no inbound links).
-- Stale claims (raw source updated after the summary's `ingested:` date —
-  check via `git log -p`).
-- Concepts mentioned in prose but missing their own page.
-- Empty / TODO sections.
-
-Report as a punch list. Don't delete anything automatically. Append one
-line to `log.md` with the findings.
-
-## File formats (mandatory)
-
-### Page frontmatter
-
-```yaml
----
-title: Человекочитаемое имя
-type: entity | concept | package | source | contradiction | open-question | overview
-tags: [short, tokens]
-sources: [../sources/foo.md, ../sources/bar.md]
-updated: 2026-04-21
----
-```
-
-Source pages also carry `ingested: YYYY-MM-DD` and `raw_path: ../raw/...`.
-Contradiction pages also carry `status: open | resolved | accepted-divergence` and `affects: [../entities/x.md, ../concepts/y.md]`.
-Open-question pages also carry `status: open | answered | obsolete` and `touches: [../entities/x.md, ../sources/z.md]`.
-
-### File naming
-
-- `kebab-case.md`, **Latin only**. Transliterate Cyrillic / non-Latin in
-  filenames; keep the original title in H1 + frontmatter.
-- `entities/<name>.md`, `concepts/<name>.md`, `packages/<name>.md`
-  (no `@org/` prefix), `sources/<slug>.md`, `contradictions/<slug>.md`,
-  `open-questions/<slug>.md`.
-
-### `log.md` — append-only, grep-parseable
-
-Every entry must start with:
-
-```
-## [YYYY-MM-DD] <operation> | <short description>
-```
-
-Operations: `ingest`, `query`, `lint`, `refactor`, `decision`, `init`.
-
-Parse with: `grep "^## \[" .wiki/log.md | tail -20`.
-
-### `index.md`
-
-Catalog, not narrative. One line per page: `- [Title](path) — hook.`
-Sections by type. Update on every ingest.
-
-### Cross-references
-
-- Wiki → wiki: relative markdown links — `[Name](../entities/x.md)`.
-- Wiki → code: relative path from repo root — `[foo.js](../../packages/api/foo.js)`.
-- Wiki → raw: `../raw/<file>`.
-- URL-encode spaces (`%20`) and Cyrillic when needed.
-
-## Quick reference
-
-| Situation | Files touched |
-|---|---|
-| Ingest one doc | `sources/<slug>.md` (new) + 3–15 entity/concept/package pages + `index.md` + `log.md` |
-| Query | (read only) + optionally a new wiki page + `log.md` |
-| Lint | (read only) + `log.md` |
-| Bootstrap / migrate | (delegated to [`setup-wiki`](../setup-wiki/)) |
-
-## Common mistakes
-
-- **Editing `raw/`.** Don't. Only allowed change: status blockquote on
-  explicit request.
-- **Dumping raw content into `sources/`.** Summaries are summaries. Link to
-  raw, don't copy.
-- **Silent overwrites on contradictions.** Flag them with a `> **Противоречие:**`
-  block.
-- **Narrative `log.md`.** "Today I added…" is wrong. Use
-  `## [YYYY-MM-DD] ingest | <what>`.
-- **Non-ASCII filenames.** Breaks greppability and cross-platform. Transliterate.
-- **Forgetting `index.md`.** Pages not listed there are invisible to future
-  queries.
-- **Improvising layout when canon files are missing.** Hand off to
-  [`setup-wiki`](../setup-wiki/) instead of patching ad-hoc.
-
-## When NOT to use
-
-- The project has CLAUDE.md / AGENTS.md docs but no `.wiki/` — that's regular
-  documentation, not an LLM Wiki.
-- The user wants a single-file README or ADR — this skill is for persistent,
-  interlinked knowledge bases.
-- One-off questions about code — read files directly, no wiki workflow needed.
-
-## Install
-
-From the repo root:
-
-```bash
-bash scripts/install.sh using-wiki
-```
-
-Works on Windows under git-bash, Linux, macOS.
-
-## See also
-
-- [`setup-wiki`](../setup-wiki/) — companion, owns `.wiki/` creation and
-  canon migration.
-- [`project-bootstrap`](../project-bootstrap/) — invokes `setup-wiki` for
-  new projects.
-- Karpathy's LLM Wiki gist:
-  <https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f>

dist-hermes/research/using-wiki/SKILL.md

@@ -1,138 +0,0 @@
----
-name: using-wiki
-version: 1.1.0
-description: Policy skill for working with an existing `.wiki/` (Karpathy LLM Wiki pattern). Use when the user asks to ingest a document, answer from the wiki, lint/health-check it, or says "use project wiki", "обнови вики", "проверь вики", "запроси вики", "заингесть", "query the wiki". Also use when modifying any file under `.wiki/` — the workflow and formats below are mandatory, and project-specific conventions live in `.wiki/CLAUDE.md`. If `.wiki/` is missing or non-canonical, delegate to `setup-wiki` first (it has its own confirmation gate). Renamed from `wiki-maintainer` at v1.0.0.
----
-
-# using-wiki
-
-> Policy for maintaining an LLM Wiki (Karpathy pattern: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f). Knowledge is **compiled once and kept current** across three layers, via three named operations, with strict file formats that make the wiki parseable and grep-friendly. This skill governs *usage* of an existing wiki — initial creation and migration to canon are owned by `setup-wiki`.
-
-## Prerequisites
-
-This skill assumes the project has a canonical `.wiki/` layout: `CLAUDE.md` (schema), `index.md` (catalog), `log.md` (op log), `overview.md`, `raw/README.md`, and the six content directories `entities/`, `concepts/`, `packages/`, `sources/`, `contradictions/`, `open-questions/`.
-
-If `.wiki/` is **missing**, or the layout is **non-canonical** (e.g. `SUMMARY.md` instead of `index.md`, or `source/` instead of `concepts/`/`sources/`, or `contradictions/`/`open-questions/` directories are absent) — invoke the `setup-wiki` skill first. It detects the situation (greenfield vs migrate) and creates or migrates the structure with its own confirmation gate. Only after `setup-wiki` finishes should this skill proceed with the operations below.
-
-## Three layers (do not blur)
-
-1. **Raw sources** — `.wiki/raw/` (or external paths registered in `raw/README.md`). **Immutable.** Read, never edit. The only exception is appending a `> Status` blockquote when the user explicitly asks for a status audit.
-2. **Wiki** — everything else under `.wiki/`. Agent-owned. Entity / concept / package / source summary pages.
-3. **Schema** — `.wiki/CLAUDE.md`. Project-specific conventions (what entities, what packages, naming). Always read it first if present; it overrides this skill when it conflicts.
-
-## First step on every operation
-
-1. Read `.wiki/CLAUDE.md` if it exists.
-2. Read `.wiki/index.md` to locate relevant pages.
-3. Only then act.
-
-If `.wiki/CLAUDE.md` is missing, the layout is incomplete — invoke `setup-wiki` rather than improvising.
-
-## Three operations
-
-### Ingest — «заингесть X»
-
-1. Read the raw source fully.
-2. Extract: entities, concepts, packages, cross-cutting patterns.
-3. Create `sources/<slug>.md` (one summary page per source, ~50–150 lines).
-4. For each affected entity/concept/package page:
-   - If it exists → update it. **Flag contradictions explicitly** with `> **Противоречие:** источник A говорит X, источник B — Y`. Don't silently overwrite.
-   - If not → create it.
-5. Update `index.md` — add or move entries.
-6. Append one line to `log.md` (format below).
-7. Report to the user: what created, what updated, what contradictions found.
-
-**One ingest may touch 10–15 pages. This is normal — that's why LLMs do it.**
-
-### Query — вопрос по wiki
-
-1. Read `index.md` first, then drill into relevant pages.
-2. Answer with citations as markdown links to wiki pages.
-3. **Compound the wiki.** If the answer is a real synthesis (comparison, analysis, new connection) — ask the user: "Сохранить как страницу wiki?" Good queries become durable pages under `concepts/`, `analyses/`, or similar.
-4. Append one line to `log.md`.
-
-### Lint — «проверь wiki»
-
-Scan for:
-- **Contradictions** between pages.
-- **Orphans** — pages with no inbound links.
-- **Stale claims** — git `log -p` on the raw source shows it was updated after the summary's `ingested:` date.
-- **Missing entities** — concepts mentioned in prose but without their own page.
-- **Empty/TODO sections.**
-
-Report as a punch list. Don't delete anything automatically.
-Append one line to `log.md` summarizing the findings.
-
-## File formats (MANDATORY)
-
-### Page frontmatter
-
-```yaml
----
-title: Человекочитаемое имя
-type: entity | concept | package | source | contradiction | open-question | overview
-tags: [short, tokens]
-sources: [../sources/foo.md, ../sources/bar.md]
-updated: 2026-04-21
----
-```
-
-Source pages also carry `ingested: YYYY-MM-DD` and `raw_path: ../raw/...`.
-
-Contradiction pages also carry `status: open | resolved | accepted-divergence` and `affects: [../entities/x.md, ../concepts/y.md]`.
-
-Open-question pages also carry `status: open | answered | obsolete` and `touches: [../entities/x.md, ../sources/z.md]`.
-
-### File naming
-
-- `kebab-case.md`, **Latin only**. Transliterate Cyrillic / other scripts in filenames (`план переписывания` → `ozon-client-rewrite.md`). Keep the original title in the H1 and frontmatter.
-- `entities/<name>.md`, `concepts/<name>.md`, `packages/<name>.md` (no `@org/` prefix), `sources/<slug>.md`, `contradictions/<slug>.md`, `open-questions/<slug>.md`.
-
-### `log.md` — append-only, grep-parseable
-
-Every entry **must** start with:
-
-```
-## [YYYY-MM-DD] <operation> | <short description>
-```
-
-Operations: `ingest`, `query`, `lint`, `refactor`, `decision`, `init`.
-
-Parseable with: `grep "^## \[" .wiki/log.md | tail -20`.
-
-### `index.md`
-
-Catalog, not narrative. One line per page: `- [Title](path) — hook.` Sections by type (entities / concepts / packages / sources / contradictions / open-questions). Update on every ingest.
-
-### Cross-references
-
-- Wiki → wiki: relative markdown links, `[Name](../entities/x.md)`.
-- Wiki → code: relative path from repo root: `[foo.js](../../packages/api/foo.js)`.
-- Wiki → raw: `../raw/<file>`.
-- URL-encode spaces in paths (`%20`) and Cyrillic when needed.
-
-## Quick reference
-
-| Situation | Files touched |
-|---|---|
-| Ingest one doc | `sources/<slug>.md` (new) + 3–15 entity/concept/package pages + `index.md` + `log.md` |
-| Query | (read only) + optionally new wiki page + `log.md` |
-| Lint | (read only) + `log.md` |
-| Bootstrap / migrate to canon | (delegated to `setup-wiki`) |
-
-## Common mistakes
-
-- **Editing `raw/`.** Don't. Only allowed: status blockquote when user explicitly asks.
-- **Dumping raw content into `sources/`.** Summaries are summaries. Link to raw, don't copy it.
-- **Silent overwrites.** When a new source contradicts an existing page, flag it with a `> **Противоречие:**` block; don't just overwrite.
-- **Narrative `log.md`.** `Today I added…` is wrong. Use `## [YYYY-MM-DD] ingest | <what>`.
-- **Non-ASCII file names.** Breaks greppability and cross-platform. Transliterate.
-- **Forgetting `index.md`.** Pages not listed there are effectively invisible for future queries.
-- **Skipping contradictions in lint.** The wiki's value grows from surfaced tensions, not from false consensus.
-- **Improvising layout when canon files are missing.** If the wiki is missing or partial, hand off to `setup-wiki` instead of patching ad hoc.
-
-## When NOT to use this skill
-
-- Project has CLAUDE.md / AGENTS.md docs but no `.wiki/` — that's regular project documentation, not an LLM Wiki.
-- User wants a single-file README or ADR — this skill is for persistent interlinked knowledge bases.
-- One-off questions about code — use regular file reading, not wiki workflow.

dist-hermes/software-development/pulling-before-work/README.md

@@ -1,29 +0,0 @@
-# pulling-before-work
-
-Policy skill that pulls the current branch from `origin` once at session start
-and on explicit re-sync requests. Designed to remove the "edited on stale base"
-footgun without trampling dirty work-trees or auto-merging.
-
-## When it triggers
-
-- **Session start** — when `CLAUDE.md` contains the line `pull remote before work` (added by `project-bootstrap` v1.4.0+).
-- **In-chat** — when the user says `sync`, `resync`, `pull`, `обнови репо`, `git pull please`, or close variants.
-
-Stays silent in non-git folders. Prints one informational line and exits in:
-no `origin` remote, no upstream tracking, dirty work-tree, detached HEAD.
-
-## What it does
-
-`git pull --ff-only` against the configured upstream — never auto-merges, never
-auto-rebases, never stashes, never commits, never pushes. On divergence it prints
-a warning with manual-resolution hints and exits.
-
-## Prerequisites
-
-None. The skill is a no-op outside git repos and folders without an `origin`
-remote, so it's safe to leave activated everywhere.
-
-## Related
-
-- `project-bootstrap` (v1.4.0+) — adds the trigger line to new and existing projects' `CLAUDE.md`.
-- `.wiki/concepts/pulling-before-work-design.md` (in projects bootstrapped from this repo: this design lives in `claude-skills`) — full design rationale.

dist-hermes/software-development/pulling-before-work/SKILL.md

@@ -1,153 +0,0 @@
----
-name: pulling-before-work
-version: 1.0.0
-description: >
-  Pulls the current branch from origin once at session start and on explicit
-  re-sync requests. Use when CLAUDE.md contains the trigger line "pull remote
-  before work", or when the user says "sync", "resync", "pull", "обнови репо",
-  "git pull please", or close variants asking to refresh from the remote.
-  Runs `git pull --ff-only` — never auto-merges or rebases. Stays silent in
-  non-git folders. Prints one informational line and exits when there is no
-  origin remote, no upstream tracking, the working tree is dirty, or HEAD is
-  detached. Does not stash, commit, or push. Activated by `project-bootstrap`
-  v1.4.0+ via the canonical CLAUDE.md template.
----
-
-# pulling-before-work
-
-> Pull from `origin` once when work starts. Don't auto-merge. Don't trample dirty work-trees. Don't ask twice in the same session unless asked.
-
-## When this runs
-
-**At session start** — once, when the skill is activated by the `pull remote before work` line in `CLAUDE.md`. The cycle below runs immediately.
-
-**On explicit re-sync** — when the user says any of: `sync`, `resync`, `pull`, `обнови репо`, `pull please`, `git pull`, `подтяни`, `pull from origin`. Re-runs the full cycle. There is no per-session counter; the user is always allowed to ask.
-
-**Never** before each commit, before each tool call, on every message, or in any other implicit cadence. Mode-3 ("start + on-demand") was the explicit design choice — see `.wiki/concepts/pulling-before-work-design.md`.
-
-## The pull cycle
-
-Run these checks in order. Print at most one line of chat output per run.
-
-### 1. Inside a git work-tree?
-
-```bash
-git rev-parse --is-inside-work-tree 2>/dev/null
-```
-
-If the command fails or prints anything other than `true` → **exit silently, no chat output.** This is the not-a-git-repo case; the skill must not be noisy in random folders.
-
-### 2. Has an `origin` remote?
-
-```bash
-git remote get-url origin 2>/dev/null
-```
-
-If the command fails (no such remote) → print one line and exit:
-
-```
-no origin remote — skip pull
-```
-
-### 3. Is the working tree clean?
-
-```bash
-git status --porcelain
-```
-
-If the output is non-empty → print one line and exit:
-
-```
-working tree dirty — skipping pull. commit/stash, потом скажи "sync"
-```
-
-Never stash automatically. Stash-pop conflicts are exactly the friction this skill exists to remove.
-
-### 4. Is HEAD attached?
-
-```bash
-git symbolic-ref -q HEAD
-```
-
-If the command fails (empty output, exit 1) → detached HEAD. Print:
-
-```
-detached HEAD — skip pull
-```
-
-### 5. Does the current branch have an upstream?
-
-```bash
-git rev-parse --abbrev-ref --symbolic-full-name '@{u}' 2>/dev/null
-```
-
-Capture the upstream name (e.g. `origin/master`). If the command fails → no upstream tracking. Print:
-
-```
-no upstream tracking for <branch> — skip pull
-```
-
-(Where `<branch>` is `git rev-parse --abbrev-ref HEAD`.)
-
-### 6. Pull, fast-forward only
-
-```bash
-git pull --ff-only
-```
-
-(No args — uses the configured upstream captured above.)
-
-Classify by exit code and stdout:
-
-| Result | Print |
-|---|---|
-| Already up to date | `✅ already up to date with <upstream>` |
-| Fast-forward, N commits | `✅ pulled N commits from <upstream>` |
-| Non-fast-forward / diverged (exit non-zero with "diverged" or "non-fast-forward" in output) | `⚠️ diverged from <upstream> — resolve manually (git pull --rebase or merge); skill never auto-merges/rebases` |
-
-### Out of scope
-
-The skill never:
-
-- commits, stashes, or pushes
-- recurses into submodules
-- pulls from non-`origin` remotes
-- pulls on detached HEAD
-- runs auto-merge or auto-rebase
-- runs more than once per session unless the user asks
-
-## Recovery hints
-
-If the skill skipped because of a dirty tree:
-
-```powershell
-# Windows / PowerShell
-git status            # see what's dirty
-git add . ; git commit -m "wip"
-# then ask the agent: "sync"
-```
-
-```bash
-# Linux / macOS
-git status
-git add . && git commit -m "wip"
-# then say "sync"
-```
-
-If the skill reported `diverged`:
-
-```bash
-# Option A: rebase your local commits on top of origin
-git pull --rebase
-
-# Option B: explicit merge (creates a merge commit)
-git pull --no-ff
-```
-
-The skill stays out of these decisions on purpose — both options have valid use cases and the user owns the choice.
-
-## Why this exists
-
-Stale local branches are a silent footgun: edits land on top of yesterday's `origin`, the divergence shows up at push time, and by then there's a chunk of work to rebase or merge on the wrong base. One pull at start covers the common case; an explicit re-sync trigger handles long sessions where someone pushed mid-flight.
-
-Full design rationale (mode choice, dirty-tree skip vs stash, `--ff-only` vs auto-merge, the upstream-check) lives in `.wiki/concepts/pulling-before-work-design.md`.