toki/nomadcode
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
nomadcode/agent-roadmap/phase/agent-ops-mcp-control-plane/PHASE.md
toki f23ba78eba feat: plane webhook intake & protosocket consumer wire readiness 
- Add Plane webhook handler for issue events (created, state, assignees)
- Add Plane webhook integration tests with testdata fixtures
- Add Gito Protosocket consumer wire readiness milestone
- Add Plane work item webhook intake milestone
- Add agent-task for plane-work-item-webhook-intake (trigger dispatch, idempotency, live smoke)
- Update service config, router, handlers for Plane webhook endpoints
- Add SOPS env setup script and secrets configuration
- Update agent-ops domain rules and phase roadmap
2026-06-14 20:37:48 +09:00

4.4 KiB
Raw Blame History

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 bridge, Gito proto-socket consumer wire readiness, 실행 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 완료 로그까지 반영되어 모든 기능 Task가 완료 후보가 되었고, 사용자 최종 확인과 archive 승인 대기 상태다.

  • [계획] 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 티켓 선택을 명시한다.

  • [계획] 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하는 bridge를 구현한다.

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

    • 경로: agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/gito-protosocket-consumer-wire-readiness.md
    • 요약: NomadCode Gito consumer가 실제 Gito /proto-socket binary protocol로 subscribe/event를 주고받고, 운용 env와 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 범위에서 제외한다.