nomadcode/agent-task/m-external-integration/04+01,02,03_adapter_boundary/CODE_REVIEW-local-G06.md

Code Review Reference - BOUNDARY

[IMPLEMENTING AGENT - READ FIRST] This dependent task must not start until predecessor complete logs are present.

개요

date=2026-06-03 task=m-external-integration/04+01,02,03_adapter_boundary, plan=0, tag=BOUNDARY

Roadmap Targets

• Milestone: agent-roadmap/phase/external-integration/milestones/external-integration.md
• Task ids:
  • adapter-boundary: 외부 provider별 구현 경계 점검
• Completion mode: check-on-pass

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

[REVIEW AGENT ONLY] Verify predecessor completion and boundary search output before PASS.

---

구현 항목별 완료 여부

항목	완료 여부
[BOUNDARY-1] Predecessor completion	[ ]
[BOUNDARY-2] Provider leakage audit	[ ]
[BOUNDARY-3] Docs and final verification	[ ]

구현 체크리스트

• [BOUNDARY-1] 선행 complete.log 3개를 확인한다.
• [BOUNDARY-2] provider-specific leakage를 검색하고 필요한 작은 경계 수정을 적용한다.
• [BOUNDARY-3] README/domain consistency를 확인하고 필요한 문서 보정을 한다.
• cd services/core && go test ./...를 실행한다.
• CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

코드리뷰 전용 체크리스트

• 코드리뷰 결과에 PASS, WARN, FAIL 중 하나의 판정을 append한다.
• active files를 .log로 아카이브한다.
• PASS이면 complete.log 작성 후 agent-task/archive/YYYY/MM/m-external-integration/04+01,02,03_adapter_boundary/로 이동한다.
• PASS이면 runtime roadmap completion metadata를 보고하고 직접 roadmap을 수정하지 않는다.

계획 대비 변경 사항

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

주요 설계 결정

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

사용자 리뷰 요청

기본값은 없음이다. 구현 중 사용자 결정, 사용자 소유 외부 환경/secret/서비스 준비, 또는 계획 범위 변경 없이는 안전하게 진행할 수 없으면 아래 항목을 실제 내용으로 교체하고, 구현을 중단한 뒤 active 파일을 그대로 둔 채 리뷰를 요청한다. 후속 에이전트가 명령 재실행이나 산출물 수집으로 해소할 수 있는 검증 증거 공백만으로는 사용자 리뷰 요청을 작성하지 않는다.

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

리뷰어를 위한 체크포인트

• Predecessor complete logs are present and unambiguous.
• Provider DTOs and REST paths do not leak outside adapters except intentional wiring/docs.
• Search output is pasted and exceptions are justified.
• No roadmap completion is manually applied by implementation.

검증 결과

BOUNDARY-1 중간 검증

$ test -f agent-task/m-external-integration/01_plane_adapter/complete.log
(output)
$ test -f agent-task/m-external-integration/02_jira_adapter/complete.log
(output)
$ test -f agent-task/m-external-integration/03_mattermost_adapter/complete.log
(output)

BOUNDARY-2 중간 검증

$ rg --sort path -n "plane\\.|jira\\.|mattermost\\.|WorkItemRef|IssueRef|comment_html|/api/v4/posts|/rest/api/3" services/core/internal --glob '!adapters/**'
(output)

최종 검증

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

$ cd services/core && go vet ./...
(output)

$ rg --sort path -n "plane\\.|jira\\.|mattermost\\.|WorkItemRef|IssueRef|comment_html|/api/v4/posts|/rest/api/3" services/core/internal --glob '!adapters/**'
(output)

Section Ownership

Section	Owner	Note
구현 항목별 완료 여부, 구현 체크리스트, 계획 대비 변경 사항, 주요 설계 결정, 사용자 리뷰 요청, 검증 결과	Implementing agent	Fill before review
코드리뷰 전용 체크리스트	Review agent only	Do not modify during implementation