nomadcode/agent-roadmap/phase/agent-ops-work-item-lifecycle/PHASE.md

Phase: Agent-Ops Work Item Lifecycle

상태

[진행중]

목표

로드맵 기반 agent-ops 운영 루프에서 Plane/Jira 같은 work item provider의 Todo 이후 실행 lifecycle을 Core action 경계로 정리한다. Milestone Task, provider 하위 티켓, agent-task/m-<milestone-id> plan/code-review 결과, 사용자 리뷰와 종료 흐름을 연결하되, MCP와 외부 agent 제어 표면은 이 Phase 범위에서 제외한다.

Milestone 흐름

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

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

  • 경로: 워크스페이스 포트/환경 표준화
  • 요약: NomadCode client/core/compose/test runner 포트와 IOP Edge 연동 endpoint를 workspace 공통 대역과 remote runner 문서 기준으로 정리하고, remote code-server preview 정상 노출 확인 후 archive했다.

• [완료] Milestone Work Item Creation Sync

  • 경로: Milestone Work Item Creation Sync
  • 요약: Plane-origin 방식으로 Milestone을 생성하고 Plane Todo 티켓까지 동기화한 뒤 멈추는 마일스톤이다. 12/13/14번 task group의 Roadmap Completion 근거로 live-cycle gate 보완 Task까지 완료했고, 사용자 승인 후 archive했다.

• [완료] Plane Work Item Webhook Intake

  • 경로: Plane Work Item Webhook Intake
  • 요약: Plane work item 생성, 상태 변경, assignee 변경 webhook을 NomadCode Core가 받아 Backlog + AGENT assignee 조건을 재검증하고 기존 Milestone creation sync pipeline을 시작하도록 연결했다. 코드 레벨 재검토와 사용자 종료 승인 후 archive했다.

• [완료] Gito Branch Event Creation Sync Bridge

  • 경로: Gito Branch Event Creation Sync Bridge
  • 요약: 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

  • 경로: Gito Proto-Socket Consumer Wire Readiness
  • 요약: NomadCode/Gito 연동 MVP의 Gito /proto-socket binary transport/decode, bridge e2e, failure/reconnect 운영 기준 검증을 완료했고, 사용자 승인 후 archive했다.

• [완료] Gito HTTP Webhook Consumer Readiness

  • 경로: Gito HTTP Webhook Consumer Readiness
  • 요약: Gito gito.forgejo-branch-events.v1 signed HTTP webhook delivery를 NomadCode Core가 소비하고 branch revision 재검증/creation sync enqueue로 수렴하는 구현을 코드 레벨 종료 감사와 소규모 계약 보강 후 archive했다.

• [완료] Plane-Origin Authoring Roundtrip Sync

  • 경로: Plane-Origin Authoring Roundtrip Sync
  • 요약: 최신 dev IOP Responses, workspace slot, Gito HTTP webhook, filename slug canonical id, active Milestone reconcile, Plane 생성/갱신 기준의 기능 Task와 live 검증을 완료했고 코드 레벨 종료 감사 후 archive했다.

• [완료] Roadmap Driven Agent-Ops Automation

  • 경로: Roadmap Driven Agent-Ops Automation
  • 요약: roadmap/action core와 Plane/Jira 기반 Milestone item 동기화의 상위 방향과 계약 후보를 정리했고, 코드 레벨 종료 검토 후 archive했다.

• [완료] Agent-Origin Milestone Creation Sync

  • 경로: Agent-Origin Milestone Creation Sync
  • 요약: agent 또는 사람이 active Milestone을 직접 수정해 develop에 push한 경우 Gito revision 검증 후 Plane work item 생성/갱신, provider identity ledger 기록, identity backfill commit/push, self-loop guard까지 닫고 코드 레벨 종료 감사 후 archive했다.

• [계획] Milestone Execution Lifecycle Sync

  • 경로: Milestone Execution Lifecycle Sync
  • 요약: Todo 이후 In Progress 실행, 하위 티켓, plan/code-review, 완료/폐기 흐름은 사용자가 명시적으로 해제할 때까지 구현 잠금 상태로 둔다.

Phase 경계

• 이 Phase는 Plane/Jira work item과 agent-roadmap Milestone Task의 실행 lifecycle 동기화만 다룬다.
• Todo -> In Progress 실행 승인, 하위 티켓 identity, agent-task/m-<milestone-id> plan/code-review 결과 반영, 사용자 리뷰와 종료 흐름이 이 Phase의 책임이다.
• 완료된 선행 Milestone의 archive 파일은 Phase 분리 전 historical path인 agent-ops-mcp-control-plane milestones archive에 보존한다.
• MCP, 외부 agent 제어 표면, tool policy, 외부 호출 권한, side effect 승인 경계는 MCP Control Surface Phase에서 별도로 다룬다.
• 프로젝트/워크스페이스 UX와 provider console composition은 Project Workspace Management UX Phase에서 다룬다.
• IOP 내부 모델 라우팅, RAG, context compression, output validation은 NomadCode 범위에서 제외한다.