OpeItcLoc03/admin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(canon): ре-прогон канон-блока на mappa-setup@0.2.8 (task:3030) + refresh .mappa/share

Browse Source
This commit is contained in:
vitya
2026-09-19 09:45:08 +03:00
parent e3fb31112b
commit 7939ce3611
12 changed files with 234 additions and 130 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
.mappa/share/canon/index.md
View File

@@ -12,7 +12,7 @@ tags: [mappa, canon, agent]
| Слой | Что | Кто читает | Где |
|---|---|---|---|
| **canon/** (этот слой) | гейты-правила (обязательно всем) | агенты всех проектов | shared |
| **methodology/\<имя\>/** | стиль зоны (ритуалы/дисциплина), выбор ≤1 | проект, выбравший методологию | shared |
| **methodology/\\<имя\\>/** | стиль зоны (ритуалы/дисциплина), выбор ≤1 | проект, выбравший методологию | shared |
| **runbooks/** | процедуры «как сделать X с сущностью» | агенты по необходимости | shared |
| **docs/** | ответы человеку «как пользоваться mappa» | агент отвечает человеку | проект mappa |
| **concepts/** | «почему так устроено» (решения) | по месту | project/shared |
@@ -20,10 +20,19 @@ tags: [mappa, canon, agent]
## Гейт записи (фаза 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
- [[canon/gates]] — гейты: знание→mappa, каналы, поиск-до-угадывания, адресация, .mappa-гейт, секреты, degraded, живое состояние (Г1–Г9)
- [[runbooks/index]] — каталог сущностей: тип → тулы → runbook
- [[methodology/kzntsv/index]] — методология kzntsv (пример выбора: ≤1 на проект, ссылка в AGENTS.md)
- [[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)
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)