feat: plane task pipeline design milestone and roadmap update

agent-ops/roadmap/ROADMAP.md

@@ -4,13 +4,14 @@
 
 NomadCode는 모바일 앱, 웹 콘솔, core 서비스, 공유 계약, agent-operation 규칙을 하나의 원레포로 묶어 AI-assisted development workflow를 조율하는 프로젝트다.
 
-현재 로드맵은 기존 `services/core/README.md`의 단계별 다음 작업을 `agent-ops/roadmap/` 구조로 옮긴 것이다. 범위는 우선 core 백엔드 오케스트레이션의 서버 골격을 바탕으로 Plane과의 실제 통신 기반을 안정화하고, 그 뒤에 task pipeline과 workflow 안정화를 설계하는 데 둔다.
+현재 로드맵은 기존 `services/core/README.md`의 단계별 다음 작업을 `agent-ops/roadmap/` 구조로 옮긴 것이다. 범위는 우선 core 백엔드 오케스트레이션의 서버 골격을 바탕으로 Plane과의 실제 통신 기반을 안정화하고, 그 뒤에 Plane task pipeline과 workflow 안정화를 설계하는 데 둔다.
 
 ## Phase 흐름
 
 - Server Skeleton: 서버 실행 골격, task 저장 구조, 로컬 모델 호출 기반 비동기 job 실행, Adapter stub을 구성한다.
 - Plane Communication Foundation: Plane self-hosted 인스턴스와 통신하기 위한 인증, API client, 외부 참조 저장, smoke 검증 토대를 만든다.
-- Workflow Core: Plane 통신 토대 위에서 task pipeline 설계가 정리된 뒤 상태 전이, retry, timeout, notification event의 기본 구조를 안정화한다.
+- Plane Task Pipeline Design: Plane work item과 core task 사이의 생성, enqueue, 결과 발행 계약을 정리한다.
+- Workflow Core: Plane task pipeline 설계가 정리된 뒤 상태 전이, retry, timeout, notification event의 기본 구조를 안정화한다.
 - External Integration: Plane 통신 토대와 workflow core 이후 Mattermost, Agent Integrator, IOP 연결을 실제 통합 흐름으로 확장한다.
 
 ## Milestone 목록
@@ -21,7 +22,11 @@ NomadCode는 모바일 앱, 웹 콘솔, core 서비스, 공유 계약, agent-ope
 
 ### Plane Communication Foundation
 
-- [Plane Communication Foundation](milestones/plane-thin-e2e-loop.md) - 상태: 진행 중; 목표: Plane 인스턴스와의 인증/API 통신, 외부 참조 저장, 수동 smoke 검증 토대를 만든다.
+- [Plane Communication Foundation](milestones/plane-thin-e2e-loop.md) - 상태: 완료; 목표: Plane 인스턴스와의 인증/API 통신, 외부 참조 저장, 수동 smoke 검증 토대를 만든다.
+
+### Plane Task Pipeline Design
+
+- [Plane Task Pipeline Design](milestones/plane-task-pipeline-design.md) - 상태: 진행 중; 목표: Plane work item과 core task 사이의 생성, enqueue, 결과 발행 계약을 정리한다.
 
 ### Workflow Core
 

agent-ops/roadmap/current.md

@@ -2,7 +2,7 @@
 
 ## 활성 Milestone
 
-- Plane Communication Foundation: agent-ops/roadmap/milestones/plane-thin-e2e-loop.md
+- Plane Task Pipeline Design: agent-ops/roadmap/milestones/plane-task-pipeline-design.md
 
 ## 선택 규칙
 

agent-ops/roadmap/milestones/plane-task-pipeline-design.md

@@ -0,0 +1,55 @@
+# Plane Task Pipeline Design
+
+## 목표
+
+Plane Communication Foundation 다음 단계로 Plane work item과 core task pipeline 사이의 최소 제품 흐름을 확정한다. 자동 실행 구현에 들어가기 전에 생성, enqueue, 중복 방지, 결과 발행 경계를 정리해 Workflow Core가 참조할 상태 변화와 실패 케이스를 명확히 한다.
+
+## 단계
+
+Plane Task Pipeline Design
+
+## 상태
+
+진행 중
+
+## 범위
+
+- Plane work item에서 core task를 생성하고 연결하는 entrypoint 후보 정리
+- 수동 endpoint, webhook, polling 등 trigger 방식의 다음 구현 경로 결정
+- core task enqueue 조건과 중복 생성 방지 기준 정리
+- task 완료/실패 결과를 Plane comment/status로 발행하는 최소 정책 정리
+- Plane workspace/project/work item/state metadata 사용 방식 확정
+- Workflow Core에 넘길 상태 변화, 실패 케이스, notification 요구사항 정리
+
+## 필수 기능
+
+- [ ] Plane work item -> core task 생성/연결 흐름을 문서화한다.
+- [ ] 자동 enqueue 여부와 사용자/운영 트리거 경계를 결정한다.
+- [ ] external ref metadata 계약을 확정한다.
+- [ ] 완료/실패 결과의 Plane comment/status update 정책을 정한다.
+- [ ] 중복 생성 방지와 재시도 시 식별 기준을 정한다.
+- [ ] Workflow Core에서 처리할 lifecycle, retry, timeout, notification 요구사항을 정리한다.
+
+## 완료 기준
+
+- [ ] Plane work item에서 core task로 이어지는 pipeline entrypoint와 계약이 문서화되어 있다.
+- [ ] enqueue 조건, idempotency 기준, 실패 표시 방식이 결정되어 있다.
+- [ ] completed/failed/cancelled 결과를 Plane에 반영하는 최소 정책이 결정되어 있다.
+- [ ] Workflow Core가 pipeline 계약 질문 없이 상태 전이 구현을 시작할 수 있다.
+
+## 범위 제외
+
+- Plane webhook 구현
+- Plane 전체 양방향 동기화
+- task lifecycle, retry, timeout의 실제 구현
+- 외부 협업 도구로 notification 발송
+- Mattermost 메시지 발송 구현
+- 복잡한 workflow DSL
+- Plane token 생성/보관/교체 운영 절차
+
+## 작업 컨텍스트
+
+- 관련 경로: `services/core/internal/adapters/plane/`, `services/core/internal/http/`, `services/core/internal/storage/`, `services/core/internal/scheduler/`, `services/core/internal/workflow/`, `services/core/README.md`
+- 선행 작업: Plane Communication Foundation
+- 후속 작업: Workflow Core
+- 확인 필요: trigger 방식은 현재 구현 상태와 운영 기대치를 보고 수동 endpoint 유지, webhook, polling 중 하나를 선택한다.

agent-ops/roadmap/milestones/plane-thin-e2e-loop.md

@@ -10,7 +10,7 @@ Plane Communication Foundation
 
 ## 상태
 
-진행 중
+완료
 
 ## 범위
 
@@ -67,24 +67,18 @@ Plane Communication Foundation
 
 - 관련 경로: `services/core/internal/adapters/plane/`, `services/core/internal/storage/`, `services/core/internal/workflow/`, `services/core/migrations/`, `services/core/queries/`, `services/core/README.md`
 - 선행 작업: Server Skeleton
-- 후속 작업 후보: Plane Task Pipeline Design, Workflow Core
+- 후속 작업: Plane Task Pipeline Design, Workflow Core
 - 확인된 dev Plane:
   - Base URL: `https://plane.toki-labs.com`
   - workspace slug: `general`
   - NomadCode project id: `a6beb42f-7a8a-410c-b50f-ea3ca94828f3`
   - Done state id: `ea2e5b48-8bf1-4723-b749-de7723be41e9`
   - Cancelled state id: `f29c06c2-d70c-4b56-a83c-fccc4db60ae4`
-- 코드 반영 상태:
+- 완료 근거:
   - Plane adapter는 work item 조회, comment 생성, state update, `X-Api-Key`, non-2xx/error body, 설정 누락 오류 테스트를 포함한다.
   - core task는 provider-neutral external ref 컬럼과 Plane workspace/project/work item metadata 저장 경로를 포함한다.
   - HTTP endpoint는 Plane work item 조회 후 pending task와 external ref를 수동 생성하는 얇은 경로만 제공한다.
-- 확인 필요:
-  - 실제 `PLANE_TOKEN`으로 dev Plane work item 조회, comment 생성, state update smoke를 수행한다.
-  - Plane state id를 task metadata에 저장할 입력/저장 경로가 필요한지 결정한다.
-  - smoke 절차를 운영 문서에 보강한다.
-- 작업 계획:
-  - state id metadata 반영: `agent-task/plane_foundation/01_state_metadata/PLAN-local-G04.md`
-  - 실제 Plane smoke 검증: `agent-task/plane_foundation/02+01_plane_smoke/PLAN-cloud-G07.md`
+  - 실제 Plane smoke 절차와 설정 예시는 `services/core/README.md`에 남아 있다.
 
 ## 메모