commitgate-qualitylisted

# CommitGate — 품질 오버레이 (설계·계획·구현 품질) CommitGate의 권한·리뷰·승인·커밋 게이트를 **바꾸지 않고**, 설계·계획·구현의 품질을 높이는 **방법**이다. 게이트 권한은 CommitGate가, 품질 방법은 이 스킬이 담당한다 — **"방법은 여기, 강제는 게이트."** 이 스킬은 강제가 아니라 **협조적 지침**이다. 커밋을 막는 것은 이 텍스트가 아니라 CommitGate의 실행 게이트다. ## 전제 다음 세 상황에서만 이 방법을 적용한다. - **(a)** REQ의 `00/01/02` 설계·계획을 새로 쓰거나 고칠 때 - **(b)** `req:next`가 `AGENT`를 반환한 구현 phase - **(c)** 버그·회귀·성능 문제를 진단하는 `AGENT` 작업 **다음 행동은 이 스킬이 아니라 `req:next`의 kind가 정한다** — kind마다 계약이 다르므로 뭉뚱그리지 않는다: - `RUN`이면 출력된 명령을 그대로 실행한 뒤 다시 `req:next`. - `AGENT`이면 그 phase의 작업을 구현·검증하고 명시적으로 `git add` 한 뒤 다시 `req:next` — 필요한 작업을 건너뛰지 않는다(이 스킬의 방법이 적용되는 지점이다). - `AWAIT_HUMAN`이면 멈추고 출력된 승인 문장을 그대로 받는다. - `DONE`이면 완료를 보고하고 통합·릴리즈를 추정하지 않는다. - `BLOCKED`이면 재시도하지 말고 사람에게 차단 사유를 보고한다. ## 방법 ### 1. 정본(SSOT) 경계 — 복제하지 말고 참조하라 도메인·아키텍처·API·보안·상세 test oracle의 정본은 **승인된 설계가 참조하는 정본 문서**(예: `docs/설계`·`docs/개발`·테스트케이스 추적표 등)다. - `00/01/02`는 알고리즘·상수·API 계약·상세 test oracle을 **복제하지 않는다.** ���본 경로·절·TC-ID로 **참조**한다. - 이미 정본에 있는 내용을 REQ 문서에 다시 쓰지 않는다 — 복제하면 drift 부채가 된다. - 정본에 필요한 계약·oracle이 없으면 REQ 문서에 임시 복제하지 말고, **정본을 먼저 보완한 뒤 설계 재리뷰**를 받는다. ### 2. 설계 품질 — 가정한 것을 실증하라 - 새로 가정한 API·라우트·함수·환경변수·데이터 모델·기존 동작을 **실제 코드와 정본에서 먼저 확인**한다. 존재하지 않는 API를 기존 기능처럼 가정하지 않는다. - 새로 만들어야 하면 요구 범위·변경 파일에 명시하���, 범위 밖이면 기존 계약을 쓰거나 사람에게 보고한다. - 완료 기준마다 **정본 참조 · TC-ID · 공개 seam(사용자 관찰 가능 결과) · 검증 명령 · 실패 시 기대**를 추적 가능하게 한다. - 역할·권한·상태·페이지·입력의 **조합**이 요구되면 일부 예시가 아니라 **요구된 조합 전체**를 검증 범위로 설계한다. - 대안은 실제로 존재하고 품질·보안·성능·호환성에 영향을 줄 때만 비교한다. 형식적 나열은 하지