Skip to content

Commit f0dc41f

Browse files
authored
docs: Symphony 워크플로 승인 게이트 보강 (#241)
* docs: Symphony 워크플로 승인 게이트 보강
1 parent d9a1f02 commit f0dc41f

1 file changed

Lines changed: 10 additions & 1 deletion

File tree

WORKFLOW.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,12 @@ codex:
8282
6. 이슈가 워크플로 증거를 요구하면 `docs/ai-test-workflow/logs/prompt-and-tool-log.md`에 프롬프트/도구 사용 내역을 기록한다.
8383
7. 최종 응답에는 완료한 작업, 수정한 파일, 실행한 검증, 남은 블로커를 요약한다.
8484
8. 리포트를 작성할 때는 `목적, 확인한 근거, 발견 사항, 한계/블로커, 다음 단계`처럼 간결한 한국어 섹션을 우선 사용한다.
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

Comments
 (0)