Commit Graph
2 Commits
Author SHA1 Message Date
DongHyeonka e9d9c3694f 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
2026-11-05 22:33:03 +09:00
DongHyeonka 23e04f7383 docs(improvement): 다섯 라운드 리뷰의 반복 결함 패턴 49개를 모은다
문제: 같은 모양의 결함이 라운드마다 다른 영역에서 다시 나오지만,
리뷰를 시작할 때 훑어볼 목록이 없다. 지난 리뷰의 "반복되는 원인"
절은 라운드마다 따로 있다.

고른 방법: 0924 src 리뷰와 0925·0929·1101·1103·1105 성숙도 리뷰에서
두 번 이상 나온 모양을 P-01~P-49로 묶는다. 행마다 모양, 대표 발견
ID, 막는 기준(이 매뉴얼의 장), 관점을 적는다. 한 번만 나온 High
(0929/09-01)는 따로 적는다. 번호는 다시 매기지 않는다.

위험·한계: 1103 이전 라운드는 README와 High 영역 문서만 읽어
Medium·Low의 근거는 색인 행에서 왔다. 막는 기준이 "없음"인 행이
남아 있다.

검증: 로컬 정적 대조. desktop 검사는 연결 커밋 뒤.
2026-11-05 22:15:44 +09:00