docs(skill): admin-runbooks v1.1.0 — ранбуки только в mappa wiki (индекс wiki:3316), файловый канал закрыт — task:1517

.agents/skills/admin-runbooks/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: admin-runbooks
 author: ours
-version: 1.0.0
+version: 1.1.0
 description: >
   Единый контур ранбуков зоны админа (.admin): НАЙТИ нужный ранбук перед любой
   прод-операцией → ИСПОЛНИТЬ по нему (чек-лист + verify + откат + письмо/таска) →
@@ -24,18 +24,21 @@ description: >
 
 ## 0. ИНДЕКС РАНБУКОВ (всегда первый шаг)
 
-**Индекс:** `.admin/.wiki/concepts/runbooks-index.md` (единственный источник
+**Индекс:** mappa wiki-сущность [[wiki:3316]] (`concepts/runbooks-index`, .admin) —
-«какой ранбук для чего»). **Прибит в AGENTS.md** — контур обязателен.
+единственный источник «какой ранбук для чего». **Прибит в AGENTS.md** — контур обязателен.
+> Файловый канал `.admin/.wiki/concepts/` закрыт (2026-08-29, task:1507): файлы — стубы
+> «не читать, не править», канон — mappa wiki-сущности.
 
 Перед ЛЮБОЙ прод-операцией (деплой/редеплой/рестарт/ротация/миграция/инцидент):
 
-1. **Прочитай индекс** (`read .admin/.wiki/concepts/runbooks-index.md`) — найди
+1. **Прочитай индекс** (`wiki_get(project=".admin", slug="concepts/runbooks-index")`,
-   строку по проекту/операции → путь ранбука.
+   или [[wiki:3316]]) — найди строку по проекту/операции → ранбук (wiki-сущность).
-2. Ранбук может жить в трёх местах (индекс указывает, где):
+2. Ранбук может жить в двух местах (индекс указывает, где):
-   - `.admin/.wiki/concepts/*-runbook*.md` — канон для VDS-проектов;
+   - mappa wiki-сущности `.admin` (`wiki_get`/`wiki_search`) — канон для VDS-проектов
+     ([[wiki:160]], [[wiki:1254]], [[wiki:3330]] и т.д.; полный список — в индексе);
    - `<репо-проекта>/.wiki/concepts/docker-deploy.md` и т.п. — репо-вики проекта
-     (pilorama98.ru: `apps/web/.wiki/concepts/docker-deploy.md`);
+     (pilorama98.ru: `apps/web/.wiki/concepts/docker-deploy.md`) — репо-вики живут файлом,
-   - mappa wiki (`wiki_search`) — если индекса ещё нет, искать там.
+     это канал самого проекта, не `.admin`.
 3. **Нет ранбука → НЕ деплоить молча.** Создать (см. WRITE) до/вместе с операцией:
    отдельной таской или в теле операционной таски (пункт «нужен ранбук»).
    Это не бюрократия: отсутствие ранбука = повторное рыскание в следующий раз.
@@ -120,13 +123,11 @@ description: >
 
 ## Порядок записи (мутации вики)
 
-- **Ранбук ОБЯЗАН быть в mappa как wiki-сущность, не только файлом** (2026-08-28, инцидент
+- **Ранбук живёт ТОЛЬКО в mappa как wiki-сущность** (канон стуб wiki:3328 р.10, 2026-08-29):
-  skills-catalog-deploy: записал только файл → ранбук невидим через wiki_search, оператор
+  `wiki_create(project=".admin", slug="concepts/<имя>")` (или `wiki_update` при правках).
-  вернул «в mappa нужно писать»). Двойная запись:
+  Файл `.admin/.wiki/concepts/<имя>.md` — стуб-указатель «не читать, не править»;
-  1. Файл в `.admin/.wiki/concepts/` (репо .admin, git) → commit → push (push свободно);
+  git-история стуба хранит прежний контент (`git show <parent>:<path>`).
-  2. Wiki-сущность в mappa: `wiki_create(project=".admin", slug="concepts/<имя>")`
+- Индекс ([[wiki:3316]]) — обновить строку/ссылку на новый ранбук.
-     (или `wiki_update` при правках) — тело = содержимое файла. НЕ полагаться на
-     mappa-импорт: он может отставать/не покрывать `.admin`.
 - Секрет-сканер: `mcp__mappa__admin_secret_scan` после записи — 0 hits.
 
 ## Место жительства этого скила
@@ -138,7 +139,8 @@ description: >
 
 ## Связи
 
-- `concepts/runbooks-index.md` — индекс ранбуков (обязательный первый шаг).
+- [[wiki:3316]] (`concepts/runbooks-index`) — индекс ранбуков (обязательный первый шаг).
+- [[wiki:2608]] (AGENTS .admin) — канон зоны: runbooks rule, artifact placement rule.
 - `writing-skills` — RED-GREEN-REFACTOR для скилов (если править сам скил).
 - `using-vds-ops` — диагностика контейнеров (read-only), не деплой.
 - `project-discipline` — семвер/пуш-правила при правке версионируемых артефактов.