nomadcode/agent-roadmap/phase/agent-ops-mcp-control-plane/PHASE.md
toki 0109c89eb9 update: agent-ops-mcp-control-plane 로드맵 정리 및 gitoevents 클라이언트 개선
- 마일스톤 문서 archive로 이동 (gito-branch-event-sync-bridge, plane-work-item-webhook-intake)
- PHASE.md 및 ROADMAP.md 갱신
- gitoevents/client.go: 클라이언트 로직 개선
- gitoevents/client_test.go: 테스트 커버리지 추가
2026-06-16 21:05:31 +09:00

4.5 KiB

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, Plane Work Item Webhook Intake, Gito Branch Event Creation Sync Bridge를 완료/archive했고, Gito Proto-Socket Consumer Wire Readiness를 다음 계획 후보로 둔다.

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/archive/phase/agent-ops-mcp-control-plane/milestones/milestone-work-item-creation-sync.md
    • 요약: Plane-origin 방식으로 Milestone을 생성하고 Plane Todo 티켓까지 동기화한 뒤 멈추는 마일스톤이다. 12/13/14번 task group의 Roadmap Completion 근거로 live-cycle gate 보완 Task까지 완료했고, 사용자 승인 후 archive했다.
  • [완료] Plane Work Item Webhook Intake

    • 경로: agent-roadmap/archive/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을 시작하도록 연결했다. 코드 레벨 재검토와 사용자 종료 승인 후 archive했다.
  • [완료] Gito Branch Event Creation Sync Bridge

    • 경로: agent-roadmap/archive/phase/agent-ops-mcp-control-plane/milestones/gito-branch-event-creation-sync-bridge.md
    • 요약: Gito branch.updated wakeup을 NomadCode core가 소비하고 target branch 재검증/스캔 뒤 creation sync job으로 enqueue하는 bridge를 구현했다. 코드 레벨 종료 검토에서 roadmap milestone path가 없는 event drop을 보강하고 archive했다.
  • [계획] 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 기준으로 닫는다.
  • [계획] 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 범위에서 제외한다.