29 lines
2.9 KiB
Markdown
29 lines
2.9 KiB
Markdown
---
|
||
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.
|
||
|
||
## Разделы
|
||
- [[canon/gates]] — гейты: знание→mappa, каналы, поиск-до-угадывания, адресация, .mappa-гейт, секреты, degraded
|
||
- [[runbooks/index]] — каталог сущностей: тип → тулы → runbook
|
||
- [[methodology/kzntsv/index]] — методология kzntsv (пример выбора: ≤1 на проект, ссылка в AGENTS.md)
|
||
|
||
## Связано
|
||
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) |