---
doc_id: MAP-CK8S-DOMAIN-AGENT-ORCHESTRATION
type: issue-map
title: kodex — карта Issue домена оркестрации агентов
status: active
owner_role: KM
created_at: 2026-04-25
updated_at: 2026-06-04
---

# Карта Issue — оркестрация агентов

## TL;DR

Долгоживущая карта домена `agent-orchestration`.

## Матрица

| Issue/PR | Документы | Волна | Статус | Примечание |
|---|---|---|---|---|
| #733 | `docs/domains/agent-orchestration/product/requirements.md`, `docs/domains/agent-orchestration/architecture/design.md`, `docs/domains/agent-orchestration/architecture/data_model.md`, `docs/domains/agent-orchestration/architecture/api_contract.md`, `docs/domains/agent-orchestration/delivery/agent_manager_delivery.md` | AGO-0 | готово | Стартовый доменный пакет документации: границы `agent-manager`, flow, stage, role, prompt, session, run, acceptance, follow-up и междоменные интеграции. |
| #739 | `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `specs/asyncapi/agent-manager.v1.yaml`, `libs/go/platformevents/agent/**`, `libs/go/accesscatalog/**`, `docs/domains/agent-orchestration/**` | AGO-1 | готово | Контракты `agent-manager`, события `agent.*` и действия доступа готовы; сервисный код, БД, миграции и deploy не входят в срез. |
| #698 | `docs/platform/architecture/codex_hooks_and_skills.md` | architecture | решение выбрано | До MVP выбран минимальный слой hooks со сбором всех поддерживаемых событий для realtime UI; skills остаются после MVP через отдельный слой управляемых возможностей. |
| #744 | `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/delivery/agent_manager_delivery.md`, `docs/domains/agent-orchestration/architecture/api_contract.md` | AGO-2 | готово | Сервисный каркас `agent-manager`: process bootstrap, env-конфигурация, health/readiness/metrics, gRPC registration и outbox skeleton без БД, миграций, deploy и бизнес-операций. |
| #749 | `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/architecture/data_model.md`, `docs/domains/agent-orchestration/delivery/agent_manager_delivery.md` | AGO-3 | готово | PostgreSQL-модель flow, stage, role, prompt template, версий, command result и service-local outbox; storage/use-case слой готов, gRPC handler wiring вынесен в следующий срез. |
| #755 | `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/architecture/api_contract.md`, `docs/domains/agent-orchestration/delivery/agent_manager_delivery.md` | AGO-3b | готово | gRPC handlers, casters и безопасное отображение ошибок для flow, role и prompt подключены к готовому storage/use-case слою; session/run остаются вне среза. |
| #759 | `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/architecture/api_contract.md`, `docs/domains/agent-orchestration/architecture/data_model.md`, `docs/domains/agent-orchestration/delivery/agent_manager_delivery.md` | AGO-4 | готово | Авторитетная модель session/run: PostgreSQL-модель, слой хранения, use-case, gRPC handlers, результат команды, ожидаемая версия, защита активной session от дублей, stage-bound проверка роли и service-local outbox события для запуска сессий, `Run` и снимков состояния. |
| #772 | `services/internal/agent-manager/**`, `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `docs/domains/agent-orchestration/architecture/api_contract.md`, `docs/domains/agent-orchestration/architecture/data_model.md`, `docs/domains/agent-orchestration/architecture/design.md`, `docs/domains/agent-orchestration/delivery/agent_manager_delivery.md` | AGO-5 | готово | `agent-manager` разрешает guidance selection hints через `package-hub`, фиксирует package/version refs, manifest digest и безопасную summary в `AgentRun`, не сохраняя manifest payload или исходники пакета. |
| #782 | `docs/domains/agent-orchestration/architecture/guidance_workspace_context.md`, `docs/domains/agent-orchestration/**`, `docs/domains/package-platform/**`, `docs/domains/runtime-and-fleet/**` | AGO-6 | готово | Контекст руководящих пакетов в workspace зафиксирован: `agent-manager` замораживает refs, `package-hub` остаётся владельцем пакетной истины, `runtime-manager` получает источники `guidance_package` и готовит checkout только для чтения в workspace без копирования текстов в БД `agent-manager`. |
| #795 | `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-7 | готово | `StartAgentRun` читает workspace policy у `project-catalog`, вызывает `runtime-manager.PrepareRuntime` и фиксирует в `Run` только безопасные runtime refs, fingerprint/diagnostic summary и классифицированный статус ошибки. |
| #809 | `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-8 | готово | `agent-manager` реализует базовый machine acceptance lifecycle: pending request, запись результата через expected version, чтение/список, idempotency, безопасный `details_json` и outbox-события без executor, QA runner, Human gate, governance decision engine и provider write pipeline. |
| #820 | `services/internal/agent-manager/**`, `proto/kodex/agents/v1/agent_manager.proto`, `specs/asyncapi/agent-manager.v1.yaml`, `libs/go/platformevents/agent/**`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-9a | готово | `agent-manager` реализует intent-only follow-up lifecycle: `CreateFollowUpIntent` валидирует session/run/stage/acceptance refs, хранит safe provider target refs, тип следующей provider-native задачи, bounded title/summary/hints, idempotency trace и статус, публикует `agent.follow_up.requested` без прямого provider write. |
| #834 | `services/internal/agent-manager/**`, `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `docs/domains/agent-orchestration/**`, `docs/domains/codex-hook-ingress/**`, `docs/platform/architecture/codex_hooks_and_skills.md`, `docs/platform/architecture/service_boundaries.md`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-9b | готово | `agent-manager` реализует safe activity timeline: `RecordAgentActivity`/`ListAgentActivities`, PostgreSQL-модель, idempotency replay/conflict и safe guards для истории действий по session/run без raw tool payload, stdout/stderr, prompt, transcript, provider payload или workspace paths. |
| #842 | `services/internal/agent-manager/**`, `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `specs/asyncapi/agent-manager.v1.yaml`, `libs/go/platformevents/agent/**`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-9c | готово | `agent-manager` реализует create-path provider follow-up dispatch: `DispatchFollowUpIntent` вызывает typed `provider-hub.CreateIssue`, сохраняет `provider_operation_ref`, safe result refs и статус `created`/`failed`, поддерживает idempotency/expected version и не использует прямой GitHub/GitLab доступ. |
| #862 | `services/internal/agent-manager/**`, `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `specs/asyncapi/agent-manager.v1.yaml`, `libs/go/platformevents/agent/**`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-9c.1 | готово | `DispatchFollowUpIntent` приведён к целевой typed-модели: `FollowUpDispatchKind` + typed `oneof` для `create_issue`, `update_issue`, `create_comment`, `update_comment`; `agent-manager` вызывает только typed provider-hub операции, сохраняет safe refs/status/provider operation ref и не использует прямой GitHub/GitLab доступ. |
| #866 | `services/internal/agent-manager/**`, `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `specs/asyncapi/agent-manager.v1.yaml`, `libs/go/platformevents/agent/**`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-9c.2 | готово | `DispatchFollowUpIntent` поддерживает typed `update_pull_request` и `create_review_signal`, вызывает только `provider-hub.UpdatePullRequest`/`CreateReviewSignal`, сохраняет safe refs/status/provider operation ref, требует provider expected version для PR update и не подменяет governance decision. |
| #281, #282 | `docs/platform/architecture/repository_onboarding.md`, `docs/domains/agent-orchestration/**` | междоменное решение | модель выбрана, ждёт реализации | Выбран вариант C. `agent-manager` должен запускать bootstrap/adoption роли и детерминированные запуски по шаблону, готовить отчёт и PR через provider-контур, но не владеть проектной политикой, пакетами или файловой системой workspace. |
| #747 | `docs/domains/platform-mcp-server/**`, `docs/platform/architecture/mcp_and_interaction_model.md`, `docs/platform/architecture/codex_hooks_and_skills.md` | MCP-0 | готово | `platform-mcp-server` зафиксирован как MCP-инструментальная поверхность для будущих agent-manager tools; `Run`, session, flow, role, prompt и ожидания flow остаются у `agent-manager`, а risk/gate decisions выносятся в governance-контур. |
| #753 | `docs/domains/platform-mcp-server/architecture/contract_strategy.md`, `docs/domains/codex-hook-ingress/**`, `docs/platform/architecture/codex_hooks_and_skills.md`, `docs/domains/agent-orchestration/product/requirements.md`, `docs/domains/agent-orchestration/architecture/design.md`, `docs/domains/agent-orchestration/architecture/api_contract.md` | MCP-1 | готово | Codex hooks отделены от MCP-инструментов: сервисы-владельцы будут потреблять hook events через `codex-hook-ingress`, а MCP tools через `platform-mcp-server`. |
| #891 | `services/internal/agent-manager/**`, `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `specs/asyncapi/agent-manager.v1.yaml`, `libs/go/platformevents/agent/**`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-9d | готово | Human gate boundary реализована в `agent-manager` как wait/result lifecycle: orchestration state, refs и normalized outcome хранятся локально; transport request/response остаётся у `interaction-hub`, governance/risk/release decision — у `governance-manager`. |
| #897 | `services/internal/agent-manager/Dockerfile`, `deploy/base/agent-manager/**`, `services.yaml`, `bootstrap/host/config.env.example`, `bootstrap/host/smoke_backend_contour.sh`, `deploy/base/postgres/**`, `scripts/build-agent-manager-images.sh`, `docs/domains/agent-orchestration/ops/**`, `docs/domains/agent-orchestration/delivery/agent_manager_delivery.md`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-10 | готово | Эксплуатационный контур `agent-manager` готов для backend deploy: Dockerfile, manifests, PostgreSQL bootstrap/runtime secrets, migration job, image/env inventory, runbook и monitoring docs без нового бизнес-функционала; доменные проверки идут через Go tests/runner. |
| #905 | `services/internal/agent-manager/**`, `deploy/base/agent-manager/agent-manager.yaml.tpl`, `services.yaml`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-11 | готово | `agent-manager` потребляет safe `interaction.request.response_recorded` из platform event log, находит Human gate wait по `owner_request_ref`, записывает normalized outcome через существующий lifecycle и сохраняет только refs/status/fingerprint/version без raw interaction payload. |
| #918 | `services/internal/agent-manager/**`, `deploy/base/agent-manager/agent-manager.yaml.tpl`, `services.yaml`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-12 | готово | `agent-manager` создаёт owner-visible Human gate request через typed `interaction-hub.RequestHumanGate` при включённом runtime switch, сохраняет только `interaction_request_ref`, safe summary/status/refs и сохраняет idempotent replay без переноса owner inbox, callback body или delivery lifecycle из `interaction-hub`. |
| #937 | `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-13 | готово | Таксономия исходов Human gate выровнена с `interaction-hub`: request-side `RequestHumanGate` передаёт `approve`/`reject`/`request_changes`/`answer`, обработчик события нормализует те же значения из `interaction.request.response_recorded`, а `reject` и `request_changes` разделены по смыслу без raw response payload. |
| #946 | `services/internal/agent-manager/**`, `deploy/base/agent-manager/agent-manager.yaml.tpl`, `bootstrap/host/config.env.example`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-14 | готово | `agent-manager` после `runtime-manager.PrepareRuntime` при включённом dispatch switch ставит `JOB_TYPE_AGENT_RUN` через `runtime-manager.CreateJob`, сохраняет `runtime_job_ref` и safe status/summary в `Run`, классифицирует retryable/permanent ошибки и не работает с Kubernetes напрямую. |
| #954 | `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-15 | готово | `agent-manager` предоставляет безопасную поверхность чтения runtime job по `Run`: `GetAgentRunRuntimeStatus` возвращает сохранённый `runtime_job_ref`, актуальный статус из `runtime-manager.GetJob`, safe error/summary, timestamps, версии и признак ожидания Human gate без Kubernetes, БД runtime, shell, сырые логи, prompt, provider payload или workspace paths. |
| #958 | `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `specs/asyncapi/agent-manager.v1.yaml`, `libs/go/platformevents/agent/**`, `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-16 | готово | `agent-manager` хранит typed governance policy refs в acceptance, follow-up и Human gate state, публикует safe `agent.*` refs и не копирует governance decision body, release evidence, prompt/transcript/logs/PII или provider payload. |
| #968 | `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/**`, `docs/domains/runtime-and-fleet/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-17 | готово | `agent-manager` заполняет typed `AgentRunExecutionSpec` при постановке `JOB_TYPE_AGENT_RUN`: передаёт safe run/slot/materialization/workspace/context refs, digest/fingerprint, runner profile/image, fixed runner mode, optional secret refs без значений и reporting targets только после ready/completed materialization; pending состояние остаётся waiting до replay, terminal failed/cancelled фиксируется как safe failed state. |
| #977 | `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/**`, `docs/domains/runtime-and-fleet/architecture/api_contract.md`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-18 | готово | `agent-manager` принимает typed runner report `queued`/`running`/`completed`/`failed` через `ReportAgentRunState`, сверяет run/session/slot/job refs и expected version, сохраняет только safe status/summary/digest/failure code и не принимает raw prompt/transcript/tool payload/stdout/stderr/provider payload/workspace paths/secrets. |
| #984 | `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/**`, `docs/domains/console-and-operations-ux/README.md`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-19 | готово | `agent-manager` отдаёт безопасную read surface для операторского UI: `ListAgentSessions` и `ListAgentRunSummaries` возвращают session/run summaries с runtime job ref, safe status/summary/error, Human gate/follow-up flags, latest activity summary, timestamps и version по сужающим фильтрам без чтения соседних БД, Kubernetes, provider API или live runtime fan-out. |
| #990 | `docs/domains/agent-orchestration/**`, `docs/domains/runtime-and-fleet/**`, `services/jobs/agent-runner/**`, `proto/kodex/runtime/v1/runtime_manager.proto`, `proto/gen/go/kodex/runtime/v1/**` | RTM-RUNNER-2 | готово | Runtime contract содержит `CodexSessionExecutionSpec` для запуска Codex CLI: producer передаёт только safe refs/digest на checked instruction object, result schema, snapshot, hooks и outputs, а raw prompt text остаётся вне БД и вне `agent-run.json`. |
| #994 | `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-20 | готово | `agent-manager` при постановке `JOB_TYPE_AGENT_RUN` заполняет вложенный `CodexSessionExecutionSpec` в `AgentRunExecutionSpec` только безопасными refs/digest: instruction object, result schema, session/workspace snapshot, hooks/callbacks, timeout, фиксированный runner profile, output/result refs и allowed secret refs без значений; при недостающих refs/digest `Run` остаётся в состоянии waiting/diagnostic без неполного runtime job, а replay создаёт job после готовности. |
| #999 | `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `specs/asyncapi/agent-manager.v1.yaml`, `libs/go/platformevents/agent/**`, `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/**`, `docs/domains/runtime-and-fleet/architecture/api_contract.md`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-21 | готово | `agent-manager` выравнивает Run orchestration с runtime/runner: `ReportAgentRunState` принимает `queued`/`running`/`started`/`completed`/`failed`/`cancelled`/`timed_out`, сохраняет только safe refs/status/summary/digest/failure code, публикует `agent.run.cancelled`, мапит timeout в failed run с `runner_timeout` и использует `execution_input_unavailable` для недоступного checked execution input. |
| #1011 | `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `specs/asyncapi/agent-manager.v1.yaml`, `libs/go/platformevents/agent/**`, `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/**`, `docs/domains/runtime-and-fleet/architecture/api_contract.md`, `docs/platform/architecture/repository_onboarding.md`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-22 | готово | `agent-manager` фиксирует pending self-deploy orchestration plan после safe provider/project signal: хранит project/repository/source refs, affected service keys, path categories, `services.yaml` ref/digest, expected runtime job types, governance refs, safe summary и fingerprint, публикует `agent.self_deploy.plan_requested` и не создаёт build/deploy runtime jobs без owner/governance approval. |
| #1015 | `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/**`, `docs/domains/runtime-and-fleet/architecture/api_contract.md`, `docs/platform/architecture/repository_onboarding.md`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-23 | готово | `agent-manager` принимает self repo safe signal через `CreateSelfDeployPlanFromSignal`, требует `provider_signal_ref`, создаёт pending `SelfDeployPlan`, возвращает существующий plan при повторе того же signal/fingerprint и конфликтует при другом fingerprint по тому же signal ref; runtime build/deploy jobs не создаются до owner/governance approval. |
| #1022 | `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/**`, `docs/platform/architecture/repository_onboarding.md`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-24 | готово | `agent-manager` подключает self-deploy signal wiring: consumer читает `provider.repository.changed` только как trigger, вызывает `project-catalog.GetSelfDeploySignal`, создаёт pending `SelfDeployPlan` только при `ready` project-side input и не подставляет `path_digest` вместо `services_yaml_digest`; non-ready статусы остаются безопасной диагностикой ожидания. |
| #1027 | `services/internal/agent-manager/**`, `deploy/base/agent-manager/**`, `deploy/base/postgres/secrets.yaml.tpl`, `bootstrap/host/config.env.example`, `services.yaml`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-25 | готово | `agent-manager` после ready `SelfDeployPlan` готовит governance gate через `governance-manager.PrepareSelfDeployPlanGate`, передаёт только safe plan refs/digest/fingerprint, сохраняет `risk_assessment_ref`, `gate_request_ref`, `gate_decision_ref`, status/version и не создаёт build/deploy runtime jobs до `approved`. |
| #1035 | `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/**`, `docs/domains/runtime-and-fleet/architecture/api_contract.md`, `docs/platform/architecture/repository_onboarding.md`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-26 | готово | После `approved` self-deploy gate `agent-manager` вызывает `project-catalog.GetSelfDeployBuildPlan`, принимает только ready per-service build items, ставит `runtime-manager.CreateJob(JOB_TYPE_BUILD)` с typed `BuildExecutionSpec`, сохраняет safe runtime build job refs/status/fingerprint и не создаёт deploy/health-check jobs. |
| не назначено | `services/internal/agent-manager/**`, `deploy/base/agent-manager/**`, `bootstrap/host/config.env.example`, `docs/domains/agent-orchestration/**`, `docs/delivery/coordination/agent-3-package-hub.md` | AGO-27 | готово | `agent-manager` потребляет `governance.gate.resolved` для target `self_deploy_plan`, сверяет `gate_request_ref`, идемпотентно сохраняет `gate_decision_ref`, переводит plan в `approved` для `approve`/`approve_with_conditions` и запускает существующий build dispatch; `reject` и `request_changes`/`revise` закрывают plan без runtime build. |
| не назначено | `proto/kodex/agents/v1/agent_manager.proto`, `proto/gen/go/kodex/agents/v1/**`, `services/internal/agent-manager/**`, `docs/domains/agent-orchestration/**`, `docs/domains/runtime-and-fleet/architecture/api_contract.md` | AGO-28 | готово | Post-approval self-deploy path отделяет ожидание runtime-owned build context от policy blockers: `build_context_unavailable` сохраняется как `runtime_build_status=preparing_context`, ready build plan дополнительно проверяется на safe `BuildExecutionSpec` refs/digests, а `JOB_TYPE_BUILD` создаётся только после готового context; deploy/health-check остаются отдельными переходами. |
