@@ -82,6 +82,12 @@ codex:
82826 . 이슈가 워크플로 증거를 요구하면 ` docs/ai-test-workflow/logs/prompt-and-tool-log.md ` 에 프롬프트/도구 사용 내역을 기록한다.
83837 . 최종 응답에는 완료한 작업, 수정한 파일, 실행한 검증, 남은 블로커를 요약한다.
84848 . 리포트를 작성할 때는 ` 목적, 확인한 근거, 발견 사항, 한계/블로커, 다음 단계 ` 처럼 간결한 한국어 섹션을 우선 사용한다.
85+ 9 . agent는 Linear 이슈를 ` Done ` , ` Closed ` , ` Cancelled ` , ` Canceled ` , ` Duplicate ` 같은 terminal state로 변경하지 않는다. terminal state 전환은 사람만 수행한다.
86+ 10 . 구현 완료 후에는 ` In Review ` 상태까지만 전환할 수 있다. 리뷰 완료 후에도 ` Done ` 으로 닫지 말고 리뷰 리포트와 Linear 코멘트에 최종 확인 요청만 남긴다.
87+ 11 . ` git push ` , ` gh pr create ` , PR 생성, PR merge, remote branch 삭제는 사람이 명시적으로 승인하기 전까지 수행하지 않는다.
88+ 12 . PR 생성은 이슈 본문 또는 최신 Linear 코멘트에 ` PR_CREATE_APPROVED ` 문구가 명시되어 있을 때만 수행한다. 이 문구가 없으면 PR 본문 초안만 작성하고 멈춘다.
89+ 13 . 리뷰가 완료됐고 치명적 문제가 없으면 가능한 경우 ` Final Approval ` 상태로 전환한다. 해당 상태가 없거나 전환에 실패하면 ` In Review ` 에 머물되 파일 수정, 상태 변경, PR 생성 없이 ` Final Approval ` 대기 상태임을 알린다.
90+ 14 . 현재 상태가 ` In Review ` 이고 ` docs/ai-test-workflow/reports/review-report.md ` 가 이미 존재하면, 같은 리뷰를 반복하지 않는다. 기존 리뷰 결과를 요약하고 ` Final Approval ` 이 필요하다고만 응답한다.
8591
8692상태 전이:
8793- ` Backlog ` : 아직 착수하지 않은 이슈다.
@@ -92,11 +98,14 @@ codex:
9298- ` In Progress ` : 승인된 범위 안에서 구현 중인 단계다.
9399- ` In Review ` : 구현이 끝났고 결과를 검토하는 단계다. 이 상태에서는 Reviewer만 검토를 수행한다.
94100- ` Rework ` : 검토 결과 수정이 필요한 단계다. 이 상태에서는 같은 범위만 다시 수정한다.
95- - ` Done ` : 최종 수용이 끝난 상태다.
101+ - ` Final Approval ` : 리뷰가 끝났고 최종 승인 대기 중인 단계다. 이 상태는 active state에 넣지 않는다.
102+ - ` Done ` : 최종 수용이 끝난 상태다. agent는 이 상태로 직접 전환하지 않는다.
96103
97104워크플로 메모:
98105- PR, 커밋, 리포트, 로그 같은 산출물은 상태가 아니라 작업 결과로 다룬다.
99106- Linear 상태는 작업의 진행 단계만 표현하고, 세부 산출물은 리포트/로그 문서로 남긴다.
100107- PR 본문이 필요하면 ` .github/PULL_REQUEST_TEMPLATE.md ` 의 항목 순서와 제목을 그대로 따라 작성한다.
101108- PR 본문은 자유 서술로 대체하지 말고, 작업 개요 / 작업 내용 / PR 유형 / Check List / 관련 이슈 / 기타 참고 사항 항목을 빠짐없이 채운다.
102109- PR의 ` 관련 이슈 ` 에는 GitHub 이슈 목록을 확인한 뒤 실제 이슈 번호를 ` #123 ` 형식으로 적는다.
110+ - 리뷰 결과 문제가 없으면 ` docs/ai-test-workflow/reports/review-report.md ` 와 Linear 코멘트에 ` Final Approval required ` 를 남기고 멈춘다.
111+ - 사람이 최종 확인하기 전에는 workspace 정리를 유발할 수 있는 terminal state 전환을 수행하지 않는다.
0 commit comments