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

55 lines
2.5 KiB
Markdown

# Plane Thin E2E Loop
## 목표
Plane issue를 core task의 외부 출처로 연결하고, task 실행 결과를 Plane comment/status로 되돌려보내는 최소 e2e cycle을 완성한다. Workflow Core의 retry, timeout, notification event 정책은 이 실제 loop가 관찰된 뒤 안정화한다.
## 단계
Plane Thin E2E
## 상태
진행 중
## 범위
- Plane issue 기반 작업 입력과 core task 생성 경로
- core task와 Plane issue의 외부 참조 연결
- task 완료와 실패 결과의 Plane comment/status 반영
- 최소 e2e 검증 절차와 운영 설정 문서화
## 필수 기능
- [ ] Plane issue를 core task로 연결하는 최소 입력 계약을 정한다.
- [ ] task에 `provider`, `external_id`, `external_url` 등 외부 참조를 저장하는 방식을 정한다.
- [ ] Plane issue title/description/comment 중 어떤 값을 task title/payload로 매핑할지 정한다.
- [ ] Plane adapter에서 issue comment와 status update 실제 호출을 구현한다.
- [ ] `PLANE_BASE_URL`, `PLANE_TOKEN` 설정과 adapter client 동작을 README 또는 운영 문서와 맞춘다.
- [ ] task 완료/실패 시 Plane에 결과를 남기는 발행 지점을 workflow 또는 scheduler에 연결한다.
- [ ] completed 결과는 Plane comment로 남긴다.
- [ ] failed 결과는 Plane comment 또는 status로 관찰 가능하게 남긴다.
- [ ] Plane issue에서 core task 실행 결과가 Plane에 다시 남는 e2e 검증 시나리오를 정리한다.
## 완료 기준
- [ ] Plane issue 하나를 기준으로 core task를 만들고 enqueue할 수 있다.
- [ ] core task의 completed 결과가 Plane issue comment 또는 status에 반영된다.
- [ ] core task의 failed 결과가 Plane issue에서 관찰 가능하게 남는다.
- [ ] e2e loop 검증 명령이나 수동 절차가 문서에 남아 있다.
- [ ] Workflow Core에서 후속으로 정리할 retry, timeout, notification event TODO가 실제 loop 기준으로 드러난다.
## 범위 제외
- Plane 전체 양방향 동기화
- Plane webhook 기반 자동 수집의 완전한 운영화
- Mattermost 메시지 발송 구현
- Agent Integrator와 IOP의 추가 통합
- 복잡한 workflow DSL
## 작업 컨텍스트
- 관련 경로: `services/core/internal/adapters/plane/`, `services/core/internal/workflow/`, `services/core/internal/scheduler/`, `services/core/internal/storage/`
- 선행 작업: Server Skeleton
- 후속 작업: Workflow Core
- 확인 필요: Plane issue 상태 값과 comment API의 실제 계약은 구현 전에 확인이 필요하다.