| 1 | # Contributing to {ORG_DISPLAY} KB (group) |
| 2 | |
| 3 | Спасибо за вклад в **организационный** слой знаний `{REPO_GROUP}`. Это **не** личный канон участника и **не** замена `{REPO_PUBLIC}` для внешнего мира. |
| 4 | |
| 5 | ## Три контура (куда писать) |
| 6 | |
| 7 | | Контур | Репозиторий | Ты пишешь сюда? | |
| 8 | |--------|-------------|-----------------| |
| 9 | | **Personal** | свой `agent-notes` (или fork) | `personal/`, `work/local/` с путями диска, hot ниже `public-cut` | |
| 10 | | **Group** | **`{REPO_GROUP}`** (этот репо) | `knowledge/worlds/`, playbooks, router, **`work/projects/`** (без путей диска) | |
| 11 | | **Public** | **`{REPO_PUBLIC}`** | сборка и push — **canon-maintainer**; скрипты в **`scripts/`** group-репо | |
| 12 | |
| 13 | Подробнее: `knowledge/domains/agent-operations/map-kb-three-contours-v1.md`, `playbook-org-kb-white-label-v1.md` (в kb-public). |
| 14 | |
| 15 | ## Перед первым PR |
| 16 | |
| 17 | 1. **Карта workspace** — только в **личном** каноне: `knowledge/work/local/workspace-scope-map-v1.md` (не коммитить в group). |
| 18 | 2. **MCP** — `agent-notes-mcp.toml` с `[[knowledge.read_only]]` id `group` → clone `{REPO_GROUP}`. |
| 19 | 3. Проверка: `read_knowledge_file(..., knowledge_root_id=group)`; `write_knowledge_file` в group → отклонение. |
| 20 | |
| 21 | ## Что можно менять в group |
| 22 | |
| 23 | - `knowledge/worlds/**`, `knowledge/domains/**`, router, META, ADR |
| 24 | - `knowledge/work/projects/**` — карточки без абсолютных путей |
| 25 | - `knowledge/group/**` — team-wide stubs (например smoke) |
| 26 | |
| 27 | ## Чего не должно быть в group |
| 28 | |
| 29 | - `knowledge/personal/**` |
| 30 | - Реальные `work/local/*` с дисками (кроме шаблонов / `.gitignore`) |
| 31 | - Секреты, токены, `public-kb.push` с личными remotes |
| 32 | |
| 33 | ## Review |
| 34 | |
| 35 | Минимум один **org-maintainer** (`@{ORG_SLUG}/kb-maintainers` или CODEOWNERS). |
| 36 | |
| 37 | ## Лицензия |
| 38 | |
| 39 | Тексты KB — **CC BY-SA 4.0** (см. `LICENSE`). |
| 40 | |
| 41 | |