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

title: Runbooks — каталог сущностей mappa summary: Каталог сущностей mappa (тип → тулы → runbook). Единая карта «что существует и как с этим работать» для агента. 21 сущность покрыта runbook'ами (2026-09-18: +thread). Обновлять при добавлении новых типов. Источник: 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
thread	тред-разговор — сущность (тема); канал — inbox	/threads?persona=, GET /thread/<ref>?actor=, inbox_ack/resolve/cancel, catch_stuck_threads	runbooks/threads
session/handoff	сессии live-ingest, handoff	session_*, handoff_write	runbooks/session
поиск/граф	найти/связать	search/entity_search/wiki_search, graph_*	runbooks/search
issue	репорт bug/feature/question/incident	issue_create/get/list/update, add_addresses, mark_duplicate	runbooks/issue
intent	SDKЛ-намерение («что и зачем», без техники)	intent_create/get/list/update/add_addresses/promote	runbooks/intent
requirements	спека-контракт «что должно быть»	requirements_create/get/list/update/add_addresses	runbooks/requirements
plan	этапы/фазы планирования	plan_create/get/list/update/add_addresses	runbooks/plan
comment	короткий след на таске (Г2: не носитель вердиктов)	comment_create/list	runbooks/comment
tag	метки, scope=project	tag_create/list/get/apply	runbooks/tag
attachment	вложения (url/blob) к task/wiki/brainstorm/session	attachment_create/get/list/delete	runbooks/attachment
release	версии + fixed_in-рёбра (деплой-гейт через .admin)	release_create/list/get/close	runbooks/release
brainstorm	шторм-буфер → промоут (wiki+archive)	brainstorm_create/update/promote	runbooks/brainstorm
agent/operator	реестры субъектов	agent_, operator_	runbooks/agent-operator
repo/commit	git-индекс (поиск кода через mappa)	git_index_, code_	runbooks/repo-commit
project	реестр проектов (канон = папка)	projects_list/register/resolve/create_repo/owners	runbooks/project
skill	каталог скилов сервера	skill_list/get/create/update/delete	runbooks/skill
entity-слой	общий слой сущностей	entity_get/search/move/versions/diff/restore/transform	runbooks/entity
sched/telemetry	расписания, метрики (зона админа)	scheduler_, telemetry_	runbooks/sched-telemetry

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

• Каталог — единая карта. При добавлении нового типа сущности — расширение этого каталога обязательным шагом в постановке серверной таски (конвенция).
• 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/threads · runbooks/session · runbooks/search · runbooks/issue · runbooks/intent · brainstorm:173 · requirements:23