Barbelic 세션 제목 규칙
2026-09-10 #1416 사용자 정정. 구현이 끝난 뒤 상태를 Merge Check → vX.Y.Z 반영완료로 표시한다. 완료한 작업을 [진행중 m/m]에 남긴 일을 계기로 추가했다. 이 규칙은 2026-09-09 및 이전 제목 규칙과 이번 정정 전의 [vX.Y.Z 릴리스 반영완료] 초안을 대체한다. Codex 작업에도 동일하게 적용한다.
2026-09-15 개정(오너 지시, #1661) — release 병합 전 precheck 를 하지 않으므로
[Precheck]단계는 폐기한다. 구현 후 단계는[진행중 n/m]→[Merge Check]→[vX.Y.Z 반영완료]셋뿐이다. 아래 본문의[Precheck]서술은 이 개정으로 지웠다.
형식: #이슈번호 [상태] 이슈 제목
- 이슈 제목은 오너 문구 그대로 앞 핵심 한 절만 쓴다.
—나:뒤 부제를 붙이지 않고[리팩터링 2-3]같은 기존 스텝을 유지한다. - 새로 만들거나 이어받은 이슈를 맡는 그 턴에 바로 세션 제목을 설정한다.
| 상태 토큰 | 사용 시점 |
|---|---|
[선행대기] | 직접 선행 또는 앞 실행 스텝의 완료·필수 검증·목적 release 반영을 기다려 자기 작업을 시작/재개하지 못하는 동안 |
[조사중] | 분석·계획 중, 오너 go 전 |
[진행중 n/m] | 승인 뒤 구현 중. n은 현재 Phase, m은 전체 Phase 수 |
[Merge Check] | 구현을 끝내고 PR 을 연 뒤 자기 PR의 Merge Check 요청·대기·실행 및 실제 release 병합 확인 단계 |
[vX.Y.Z 반영완료] | 자기 PR의 실제 release/vX.Y.Z 병합을 확인한 즉시 |
[취소됨] | 트랙 중단 |
[인수인계중] → [인수인계완료] | 인계 지시를 받은 턴에 설정하고 인계 완료 시 전환 |
- Phase 1은
[진행중 1/m]이다. Phase 완료 보고 때 다음 현재 Phase로 갱신한다. 구현을 마쳐 Merge Check 를 요청하면 마지막 Phase 상태를 유지하지 않는다. - Merge Check·병합은 Phase 수 m에 포함하지 않는다.
[CI대기중],[CI진행중],[vX.Y.Z 릴리스 반영완료]대신 위 표의 정확한 상태를 사용한다. - Merge Check 실패로 구현을 수정하는 동안에는 실제 작업 Phase의
[진행중 n/m]으로 돌아간다. 수정 후 Merge Check 재요청 단계에서[Merge Check]로 바꾼다. - 실제 release 병합을 확인한 같은 턴에
[vX.Y.Z 반영완료]로 바꾼다. 문서 기록이나 운영 배포가 남았다는 이유로 완료한 구현 작업을 진행/검사 상태에 남기지 않는다. - 세션 제목의 반영완료는 release 반영 완료다. staging/Production 배포 여부는 본문에서 따로 보고한다. 이 제목 변경은 승격·배포의 추가 승인이 아니다.
- 이슈 제목·종결 조건은 별도 유지한다. Production 성공 전에는 이슈 제목을 오너 문구 그대로 두고 열림 상태를 유지한다. 릴리스 PR 병합과 Production 배포 성공을 확인한 뒤 이슈 제목에
[vX.Y.Z 반영완료]를 붙여 닫는다. 취소는[취소됨]으로 닫는다. - Codex에서는 단계가 바뀔 때
set_thread_title을 호출한다. 완료 응답 전에 병합 대상·merge SHA와 제목 변경 도구 성공을 확인한다. 말로만 완료했다고 하고 실제 제목을 남기지 않는다.
예: #1416 [진행중 3/3] [리팩터링 3-3] D06 → #1416 [Merge Check] [리팩터링 3-3] D06 → #1416 [v0.18.0 반영완료] [리팩터링 3-3] D06.
선행 완료 대기 (2026-09-10)
계기: 오너가 리팩토링 HQ 세션에 리팩터링 조율을 맡기고, 선행작업을 기다리는 세션 제목의 상태를 [선행대기]로 통일하도록 요청했다.
- 직접 선행 또는 앞 실행 스텝의 완료·필수 검증·목적 release 반영을 기다릴 때 사용한다. 제목의
#이슈번호,[리팩터링 N-M]과 핵심 제목은 유지한다. 예:#1534 [선행대기] [리팩터링 4-2] A16. - 기다리는 선행 이슈·PR/SHA·검증·계약 인계 조건은 본문에 기록한다. 조건이 충족되면 실제 분석 단계의
[조사중]또는 승인된 구현 단계의[진행중 n/m]으로 전환한다. 기존 go를 다시 받거나 HQ 승인을 새 조건으로 추가하지 않는다. - 자기 PR의 Merge Check 요청·대기·실행·release 병합 확인은
[Merge Check]다. 이를[선행대기]로 바꾸지 않는다. - 이 규칙은 세션 제목에만 적용한다. GitHub 이슈 제목·열림 상태는 위 Production 반영·종결 규칙을 그대로 유지한다.