nomadcode/agent-roadmap/phase/agent-ops-mcp-control-plane/PHASE.md

Phase: Agent-Ops MCP Control Plane

상태

[진행중]

목표

로드맵 기반 agent-ops 운영 루프, Plane/Jira 같은 work item provider와 Milestone item의 양방향 동기화 도메인, 외부 agent 제어 표면을 Core action과 MCP tool 계층으로 분리한다. 현재는 Milestone Work Item Creation Sync를 live/runtime 보완이 필요한 진행중 대상으로 두고, Gito proto-socket consumer wire readiness, Gito branch event bridge, Plane work item webhook intake, 실행 lifecycle은 계획 후보로 둔다.

Milestone 흐름

완료된 Milestone은 archive 경로를 가리키고, 검토중, 진행중, 계획, 스케치 또는 보류 Milestone은 이 Phase 하위 milestones/ 경로를 가리킨다. 완료, 검토중, 진행중, 계획, 스케치 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다. 스케치 Milestone은 아직 구현 가능한 계획이 아니므로 계획 Milestone보다 아래에 둔다.

• [완료] 워크스페이스 포트/환경 표준화

  • 경로: agent-roadmap/archive/phase/agent-ops-mcp-control-plane/milestones/workspace-port-env-standardization.md
  • 요약: NomadCode client/core/compose/test runner 포트와 IOP Edge 연동 endpoint를 workspace 공통 대역과 remote runner 문서 기준으로 정리하고, remote code-server preview 정상 노출 확인 후 archive했다.

• [진행중] Milestone Work Item Creation Sync

  • 경로: agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/milestone-work-item-creation-sync.md
  • 요약: Plane-origin 방식으로 Milestone을 생성하고 Plane Todo 티켓까지 동기화한 뒤 멈추는 마일스톤이다. creation-sync-orchestrator 단위/fake 기반 근거는 있으나 원격 live 흐름은 webhook task 생성까지만 즉시 검증되어, 자동 enqueue, develop push gate, Todo projection, slot terminal state 보완 후 다시 검토한다.

• [계획] Gito Proto-Socket Consumer Wire Readiness

  • 경로: agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/gito-protosocket-consumer-wire-readiness.md
  • 요약: NomadCode/Gito 연동 MVP의 다음 구현 slice로, 기존 Gito event semantic bridge를 실제 Gito /proto-socket binary protocol과 cross-project smoke 기준으로 닫는다.

• [계획] Gito Branch Event Creation Sync Bridge

  • 경로: agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/gito-branch-event-creation-sync-bridge.md
  • 요약: Gito가 proto-socket branch.updated wakeup을 제공하면 NomadCode core가 이를 구독하고 target branch를 재검증/스캔한 뒤 creation sync job으로 enqueue하는 semantic bridge 범위를 정리한다.

• [계획] Plane Work Item Webhook Intake

  • 경로: agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/plane-work-item-webhook-intake.md
  • 요약: Plane work item 생성, 상태 변경, assignee 변경 webhook을 NomadCode Core가 받아 Backlog + AGENT assignee 조건을 재검증하고 기존 Milestone creation sync pipeline을 시작하도록 연결한다. 사용자에게 필요한 webhook URL, 인증 방식, AGENT assignee id, live smoke 티켓 선택을 명시한다.

• [계획] Roadmap Driven Agent-Ops Automation

  • 경로: agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/roadmap-driven-agent-ops-automation.md
  • 요약: roadmap/action core와 Plane/Jira 기반 Milestone item 동기화의 상위 방향과 계약을 정리하는 설계 마일스톤이며, 실제 구현은 slice 마일스톤으로 진행한다.

• [계획] Milestone Execution Lifecycle Sync

  • 경로: agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/milestone-execution-lifecycle-sync.md
  • 요약: Todo 이후 In Progress 실행, 하위 티켓, plan/code-review, 완료/폐기 흐름은 사용자가 명시적으로 해제할 때까지 구현 잠금 상태로 둔다.

Phase 경계

• 이 Phase는 현재 Workflow Core 구현의 선행 조건이 아니다.
• Core task lifecycle, proto-socket client-core 통신, provider adapter 기본 통합, Flutter workbench UX가 먼저 닫힌 뒤 진행한다.
• Plane/Jira work item과 agent-roadmap Milestone item의 양방향 동기화는 별도 Core sync domain이 소유하며, provider adapter 세부 구현과 분리한다.
• Sync는 Plane/Jira provider project 단위 project sync 설정을 통해 provider project target, git remote, 실제 작업 workspace를 확정한 뒤 진행한다.
• MCP 서버, 외부 agent tool policy, roadmap/action side effect 제어는 이 Phase에서 다룬다.
• IOP 내부 모델 라우팅, RAG, context compression, output validation은 NomadCode 범위에서 제외한다.