admin/.mappa/share/runbooks/index.md

title: Runbooks — каталог сущностей mappa summary: Каталог сущностей mappa (тип → тулы → runbook). Единая карта «что существует и как с этим работать» для агента. Обновлять при добавлении новых типов. Источник: brainstorm:173. type: runbook tags: [mappa, runbooks, entities, agent]

Каталог сущностей mappa

Карта «тип → MCP-тулы → процедура». Runbook — агентский слой «как сделать X» (по запросу). Справочные описания тулов — в MCP-поверхности/docs; здесь маршрутизация.

Основные (есть runbook)

Тип	Что это	Тул-поверхность	Процедура
task	таска на доске	task_list/get/create/update/close, comment_*	runbooks/tasks
wiki	страница вики (project/shared/private)	wiki_get/search/create/update, entity_*	runbooks/wiki
inbox	почта проекта	inbox_monitor/send/mark_read	runbooks/inbox
session/handoff	сессии live-ingest, handoff	session_*, handoff_write	runbooks/session
поиск/граф	найти/связать	search/entity_search/wiki_search, graph_*	runbooks/search

Остальные типы (справка: MCP-описания + docs; наполнение runbooks — post-pilot, task:2071)

Тип	Тул-поверхность	Цикл
brainstorm	brainstorm_create/update/promote	шторм-буфер → промоут (wiki+archive)
issue	issue_create/get/list/update, mark_duplicate, add_addresses	репорт bug/feature/question/incident
requirements	requirements_create/get/list/update/add_addresses	спека-контракт «что должно быть» (status: draft→approved→implemented→verified)
plan	plan_create/get/list/update/add_addresses	этапы/фазы планирования
comment	comment_create/list	короткий след на таске (Г2: не носитель вердиктов)
tag	tag_create/list/get/apply	метки, scope=project
attachment	attachment_create/get/list/delete	вложения (url/blob) к task/wiki/brainstorm/session
release	release_create/list/get/close	версии + fixed_in-рёбра (деплой-гейт через .admin)
agent/operator	agent_, operator_	реестры субъектов
repo/commit	git_index_*	git-индекс (поиск кода через mappa, волна brainstorm:171)
project	projects_list/register/resolve/create_repo/owners	реестр проектов (канон = папка)
skill	skill_list/get/create/update/delete	каталог скилов сервера
entity-слой	entity_get/search/move/versions/diff/restore/transform	общий слой сущностей
sched/telemetry	scheduler_, telemetry_	расписания, метрики (зона админа)

Правила каталога

• Каталог — единая карта. При добавлении нового типа сущности (напр. requirements/plan 2026-08-28) — расширение этого каталога обязательным шагом в постановке серверной таски (конвенция).
• Slug'и: runbooks/<тип> (kebab, латиница).
• Связь: canon/index (гейты) · canon/gates · docs/index (wiki:3341, ответы человеку) · mappa-wiki-topology (wiki:3378)

Связано

canon/index · canon/gates · runbooks/tasks · runbooks/wiki · runbooks/inbox · runbooks/session · runbooks/search · brainstorm:173 · requirements:23