docs: 리뷰 절차가 merge 단계 게이트 전부를 ci:gate로 돌린다
문제: CLAUDE.md 전체 리뷰 절차 2단계가 돌릴 명령 11개를 손으로 적는다. 이 목록은 merge 단계 명령 87개 중 10개만 돌리고, merge 게이트 14개 중 7개(001, 008, 009, 011, 012, 013, 020)는 전혀 돌지 않는다. 명령을 직접 부르면 ci:gate가 하는 로그·증거 검사, 음성 fixture의 기대 실패, workflow env도 빠진다. 2026-11-03 리뷰가 실제 CI에서 항상 실패하던 merge 게이트 둘(1103/11-06, 12-09)을 놓친 경로다. 고른 방법: 2단계를 "config/ci/gates.json의 merge 단계 gateIds 전부를 workflow env로 ci:gate 하나씩, verify:documentation은 따로"로 바꾸고 목록을 손으로 적지 않는다. 자세한 방법은 개선 매뉴얼 07장 3절을 가리킨다. 매뉴얼 01·07장과 부록 P-01에서 옛 목록을 전제로 쓴 문장을 같이 고친다. 줄 수는 그대로라 매뉴얼의 CLAUDE.md 줄 참조는 맞다. 버린 대안: 목록에 빠진 명령을 더 적기(다음에 게이트가 바뀌면 다시 갈라진다). merge 단계를 읽는 명령(ci:gate:stage merge)은 이 작업 범위 밖이라 더하지 않았다. 위험·한계: 리뷰 시작 비용이 커진다(FE-GATE-020만 약 20분). 실행 위치와 잠금은 매뉴얼 07장 7절을 따른다. 추적하지 않는 AGENTS.md는 이 변경을 받지 않는다. 검증: 로컬 정적 대조(매뉴얼의 경로·script·FE-GATE ID 문제 0건). desktop의 verify:documentation과 문서 unit 테스트는 이 커밋을 보내 돌린다. Refs: 1105/12-03
This commit is contained in:
@@ -21,7 +21,7 @@ Critical은 다섯 라운드 모두 0건이다. 패턴에 들지 않은 High는
|
||||
|
||||
| ID | 패턴 | 모양 | 대표 발견 | 막는 기준 | 관점 |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| P-01 | 돌리는 게이트 목록이 stage 전체가 아니거나, 게이트가 늦은 단계에서만 돈다 | 리뷰·드릴이 손으로 적은 명령 목록을 돌려 merge 게이트 일부가 빠진다. release 단계 게이트를 아무도 안 돌린다. CI가 꺼져 있다 | 0925/12-01, 0925/12-02, 1101/15-01, 1103/12-02, 1105/12-03 | 07장 2·3절. `CLAUDE.md` 27줄의 리뷰 목록이 merge 단계와 다르다는 발견(1105/12-03)은 미조치 | 21, 10, 26 |
|
||||
| P-01 | 돌리는 게이트 목록이 stage 전체가 아니거나, 게이트가 늦은 단계에서만 돈다 | 리뷰·드릴이 손으로 적은 명령 목록을 돌려 merge 게이트 일부가 빠진다. release 단계 게이트를 아무도 안 돌린다. CI가 꺼져 있다 | 0925/12-01, 0925/12-02, 1101/15-01, 1103/12-02, 1105/12-03 | 07장 2·3절. 리뷰 절차의 게이트 목록은 merge 단계 `gateIds` 전부를 `ci:gate`로 돌리는 것으로 바꿨다(`CLAUDE.md` 27줄, 1105/12-03) | 21, 10, 26 |
|
||||
| P-02 | 게이트·수정 확인이 템플릿 원래 상태와 작은 입력만 본다 | 기능 0개, 제품 파일이 빈 상태, 객체 0~1개에서만 맞다. 기능을 더하거나 제품 파일을 채운 다운스트림에서 깨진다 | 0925/09-01, 1103/12-01, 1103/16-09, 1105/09-01, 1105/16-03 | 01장 2절 5단계, 05장 3.3절 | 10, 21, 25, 3, 20 |
|
||||
| P-05 | workflow env에서만 나는 게이트 실패 | `CI=true`·빌드 식별값이 테스트 기대값·dev server·테스트 안 빌드로 새어 실제 CI에서만 실패 | 1103/11-06, 1103/11-07, 1103/11-08 | 07장 3·4절, 04장 6절 | 21, 10, 18, 19 |
|
||||
| P-06 | 고정 출력 경로·포트·추적 파일에 쓴다 | `dist/`, `artifacts/`, 고정 포트, 커밋된 파일에 써서 한 checkout의 두 실행이 부딪히고 추적 파일이 바뀐다 | 1105/12-04, 1103/12-08, 1105/16-01, 0929/14-01, 0925/00-01 | 실행 격리는 결정 대기(08장 5.1절 D6). 그동안 09장 4절 방식으로 하나씩 돈다. 실행 뒤 `git status`가 비어야 한다 | 20, 25, 12, 10 |
|
||||
|
||||
Reference in New Issue
Block a user