admin/.mappa/share/canon/index.md

title: mappa канон — карта summary: Канон = обязательные правила работы с mappa как системой (любой проект, любой харнесс): гейты целостности. Первоисточник канон-блока в AGENTS.md. Источник: brainstorm:173 (промоут 2026-09-03). type: canon tags: [mappa, canon, agent]

Канон mappa (shared)

Канон — обязательный слой для любого проекта на mappa: правила, защищающие целостность системы и данных. Проекция канон-блока доставляется в AGENTS.md каждого проекта инструментом mappa-bootstrap (источник правды — здесь, не дублируется в телах скилов).

Слои знаний (границы)

Слой	Что	Кто читает	Где
canon/ (этот слой)	гейты-правила (обязательно всем)	агенты всех проектов	shared
methodology/\<имя\>/	стиль зоны (ритуалы/дисциплина), выбор ≤1	проект, выбравший методологию	shared
runbooks/	процедуры «как сделать X с сущностью»	агенты по необходимости	shared
docs/	ответы человеку «как пользоваться mappa»	агент отвечает человеку	проект mappa
concepts/	«почему так устроено» (решения)	по месту	project/shared

Гейт записи (фаза 1, brainstorm:173 р.4)

Запись в canon/*, methodology/*, runbooks/* (shared) — только через промоут (босс/оператор, дистилляция из шторма). Прямые правки агентов запрещены. Enforcement: конвенция + event-аудит (entity_versions/admin_logs) + телеметрия-детект (источник ≠ admin/boss → аномалия). Фаза 2 (серверный write-ACL) — отложена. Откат — entity_restore.

Методология проекта — где искать

• Выбор методологии проекта — свойство реестра: поле methodology (слаг, ≤1) на project-записи. Агент узнаёт её из mappa, НЕ из файла (канон Г1: знание → mappa).
• Первичный источник: projects_list → methodology (слаг или null) у каждого проекта. Контент методологии — из shared-вики methodology/<имя>/index.
• ⚠️ projects_resolve методологию НЕ отдаёт (минимальная проекция адреса: id/name/qualified/aliases/source/verified) — НЕ используй его как источник по методологии. Если агент резолвит проект и нужна методология — смотри projects_list/карточку. (Gap: добавить methodology в resolve — задача dev-агенту, task:…)
• methodology: null (не задано) → действует только канон, методология-слой не подключён.
• Запись methodology: в AGENTS.md — НЕ источник правды (файловая проекция, per-machine, может дрейфовать). Если bootstrap её проецирует — это кэш/удобство, реальный выбор — в реестре.
• Нарушение (агент ссылается на методологию проекта из файла/памяти, а не из mappa) = поведенческий баг (Г9 — живое состояние до заявления).

Разделы

• canon/gates — гейты: знание→mappa, каналы, поиск-до-угадывания, адресация, .mappa-гейт, секреты, degraded, живое состояние (Г1–Г9)
• runbooks/index — каталог сущностей: тип → тулы → runbook
• methodology/kzntsv/index — методология kzntsv (пример выбора: ≤1 на проект)
• concepts/project-methodology-property — концепт «методология = свойство проекта» (wiki:3459)

Связано

brainstorm:173 · wiki:3401 (.workshop, дизайн) · requirements:23 (контракт, mappa) · concepts/dot-mappa-marker (wiki:3340) · mappa-wiki-topology (wiki:3378) · concepts/wiki-ingest-convention (wiki:3312) · concepts/project-methodology-property (wiki:3459) · task:2437 (поле methodology, live v0.58.2)