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

6.4 KiB

Phase: Agent-Ops MCP Control Plane

상태

[진행중]

목표

로드맵 기반 agent-ops 운영 루프, Plane/Jira 같은 work item provider와 Milestone item의 양방향 동기화 도메인, 외부 agent 제어 표면을 Core action과 MCP tool 계층으로 분리한다. 현재는 Gito HTTP Webhook Consumer Readiness까지 완료/archive했고, Roadmap Driven Agent-Ops Automation을 활성 Milestone으로 두어 roadmap/action core와 provider sync domain의 상위 방향을 정리한다.

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/archive/phase/agent-ops-mcp-control-plane/milestones/gito-protosocket-consumer-wire-readiness.md
    • 요약: NomadCode/Gito 연동 MVP의 Gito /proto-socket binary transport/decode, bridge e2e, failure/reconnect 운영 기준 검증을 완료했고, 사용자 승인 후 archive했다.
  • [완료] Gito HTTP Webhook Consumer Readiness

    • 경로: agent-roadmap/archive/phase/agent-ops-mcp-control-plane/milestones/gito-http-webhook-consumer-readiness.md
    • 요약: Gito gito.forgejo-branch-events.v1 signed HTTP webhook delivery를 NomadCode Core가 소비하고 branch revision 재검증/creation sync enqueue로 수렴하는 구현을 코드 레벨 종료 감사와 소규모 계약 보강 후 archive했다.
  • [진행중] 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 마일스톤으로 진행한다.
  • [진행중] Plane-origin Milestone Creation Smoke Test

    • 경로: agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/plane-origin-milestone-creation-smoke-test.md
    • 요약: Plane provider identity를 입력으로 Milestone Creation Sync와 active reconcile smoke가 같은 Milestone 문서 및 provider work item identity로 수렴하는지 확인하는 연동 검증용 마일스톤이다.
  • [진행중] Plane-origin Milestone Creation Smoke Test 9

    • 경로: agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/plane-origin-milestone-creation-smoke-test-9.md
    • 요약: Plane-origin Milestone Creation Sync 기능 검증 9와 active reconcile smoke가 같은 대상 흐름으로 수렴하는지 확인하는 연동 검증용 마일스톤이다.
  • [진행중] Plane-origin Milestone Creation Smoke Test 10

    • 경로: agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/plane-origin-milestone-creation-smoke-test-10.md
    • 요약: Plane-origin Milestone Creation Sync 기능 검증 10과 active reconcile smoke가 같은 대상 흐름으로 수렴하는지 확인하는 연동 검증용 마일스톤이다.
  • [진행중] Test Trace - Plane Dev Full-Cycle Retest 20260702-012014

    • 경로: agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/plane-dev-full-cycle-retest-20260702-012014.md
    • 요약: 테스트 흔적으로 남기는 dev live-cycle 재테스트 마일스톤이며, Plane webhook에서 시작한 요청이 NomadCore, IOP authoring, Gito develop, Plane Todo 반영까지 이어지는지 확인한다.
  • [계획] 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 범위에서 제외한다.