---
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