toki/nomadcode
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
nomadcode/agent-task/m-milestone-work-item-creation-sync/03+02_develop_match/CODE_REVIEW-cloud-G07.md
toki f9c6be03ef feat: milestone work-item creation sync 관련 변경사항 커밋 
- projectsync: checkout, config 모듈 개선 및 테스트 추가
- workitempipeline: service 개선 및 테스트 추가
- http handlers 테스트 업데이트
- client: proto_socket_branch_event_service.dart 추가 및 테스트
- contracts notes 업데이트
- agent-task: milestone 하위 subtask PLAN/CODE_REVIEW 문서 추가
2026-06-13 16:45:10 +09:00

3.3 KiB
Raw Blame History

Code Review Reference - API

[IMPLEMENTING AGENT — READ FIRST] Filling in this file is the mandatory final step of implementation. Fill implementation-owned sections, run verification, keep active files in place, and report ready for review. Do not prompt the user directly during implementation.

개요

date=2026-06-13 task=m-milestone-work-item-creation-sync/03+02_develop_match, plan=0, tag=API

Roadmap Targets

  • Milestone: agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/milestone-work-item-creation-sync.md
  • Task ids:
    • cycle-develop-sync: sync layer가 branches/develop 또는 remote develop에서 pushed Milestone을 감지하고 원래 Plane 티켓 identity와 매칭한다.
  • Completion mode: check-on-pass

이 파일을 읽는 리뷰 에이전트에게

[REVIEW AGENT ONLY] 종결 절차는 코드리뷰 에이전트 전용이다.

구현 항목별 완료 여부

항목 완료 여부
[API-1] Roadmap Sync Identity Model [ ]
[API-2] Milestone Identity Parser [ ]
[API-3] Develop Projection Candidate Gate [ ]

구현 체크리스트

  • develop branch workspace 또는 remote revision scan 결과를 표현하는 roadmapsync domain model을 추가한다.
  • Milestone 파일에서 provider, tenant, project, work item id, milestone path/id를 추출하는 parser를 추가한다.
  • pushed/scanned Milestone이 원래 Plane work item identity와 일치할 때만 projection-ready result를 반환한다.
  • slot local dirty path나 push 실패 result는 projection-ready가 아니도록 테스트한다.
  • cd services/core && go test ./...와 git diff --check를 실행한다.
  • CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

코드리뷰 전용 체크리스트

  • 코드리뷰 결과에 PASS, WARN, FAIL 중 하나의 판정을 append한다.
  • active 파일을 .log로 아카이브하고 PASS이면 complete.log 작성 후 task directory를 archive로 이동한다.
  • PASS이고 task group이 m-<milestone-slug>이면 런타임 완료 이벤트 메타데이터를 보고한다.

계획 대비 변경 사항

구현 에이전트가 계획과 다르게 구현한 부분을 이유와 함께 기록한다.

주요 설계 결정

구현 에이전트가 주요 설계 결정 사항을 기록한다.

사용자 리뷰 요청

  • 상태: 없음
  • 사유 유형: 없음
  • 결정 필요: 없음
  • 차단 근거: 없음
  • 실행한 검증/명령: 없음
  • 자동 후속 불가 이유: 없음
  • 재개 조건: 없음

리뷰어를 위한 체크포인트

  • slot local file이나 push 실패만으로 projection-ready가 되지 않는지 확인한다.
  • Milestone parser가 provider identity 누락을 조용히 성공 처리하지 않는지 확인한다.
  • sync identity field가 contract note와 충돌하지 않는지 확인한다.

검증 결과

API-1 중간 검증

$ cd services/core && go test ./internal/roadmapsync
(output)

최종 검증

$ cd services/core && go test ./...
$ git diff --check
(output)