# Документация платформы

## Назначение

`docs/platform/**` хранит сквозную документацию всей платформы `kodex`: что строим, какие системные ограничения принимаем, как устроена целевая архитектура, как поставляем изменения и как эксплуатируем платформу.

Этот раздел не должен превращаться в склад документов по отдельным доменам. Если документ относится к конкретному домену, он должен жить в `docs/domains/<domain>/`.

## Разделы

| Раздел | Назначение |
|---|---|
| `product/` | Сквозная продуктовая модель платформы. |
| `architecture/` | Общая архитектура и контейнерная карта платформы. |
| `delivery/` | Общие правила поставки, приёмки и управления волнами. |
| `ops/` | Сквозные эксплуатационные правила платформы. |

## Активная каноника

| Документ | Назначение |
|---|---|
| `product/brief.md` | Краткая продуктовая рамка платформы. |
| `product/constraints.md` | Неподвижные ограничения платформы. |
| `product/product_model.md` | Сквозная продуктовая модель платформы. |
| `product/glossary.md` | Продуктовый глоссарий платформы. |
| `product/requirements.md` | Сквозные продуктовые требования. |
| `architecture/c4_context.md` | C4-контекст платформы. |
| `architecture/c4_container.md` | C4-контейнеры и целевая сервисная карта. |
| `architecture/domain_map.md` | Архитектурная карта доменов и сервисов-владельцев. |
| `architecture/service_boundaries.md` | Границы сервисов-владельцев, пограничного слоя и исполнителей. |
| `architecture/data_model.md` | Сквозная модель данных и владение состоянием. |
| `architecture/provider_integration_model.md` | Модель интеграции с провайдерами и синхронизации. |
| `architecture/mcp_and_interaction_model.md` | Платформенный MCP и модель взаимодействий. |
| `architecture/codex_hooks_and_skills.md` | Варианты использования Codex hooks и skills в платформе. |
| `architecture/repository_onboarding.md` | Варианты bootstrap/adoption репозитория, `services.yaml`, внешней документации и пакетов. |
| `ops/bootstrap_cluster_runbook.md` | Runbook первого bootstrap-контура кластера, проверок registry/Kaniko и backend. |

## Что сюда попадёт позже

- устав проекта;
- общие правила поставки;
- общий runbook платформы.

## Что сюда не класть

- документы конкретного домена;
- карты Issue по домену или волне;
- документацию конкретного сервиса;
- руководящие пакеты для агентов;
- старые материалы из `deprecated/**`.
