| name | review-governance-consistency |
| description | 생성이 완료된 뒤 governance 아티팩트의 중복, 충돌, 잘못된 배치, 강제 누락, always-on vs on-demand 배치 문제를 독립적으로 검토한다. |
| allowed-tools | Read Grep Glob |
| disable-model-invocation | true |
목적
governance 아티팩트를 독립적으로 검토한다.
이 skill은 review 전용이며, governance 파일이 이미 존재하는 상태에서 사용한다.
하네스 엔지니어링 관점에서의 검토 원칙
이 검토의 목적은 단순 오탈자 점검이 아니다.
이 검토의 목적은 현재 governance 구조가 프로젝트를 원하는 상태로 실제로 유도하고 있는지 평가하는 것이다.
검토 시 아래 질문을 항상 염두에 둔다.
- 전역 규칙은 정말 항상 로드될 가치가 있는가
- 모듈 책임과 도메인 제약이 적절한 레벨에 배치되어 있는가
- 사람이 확인해야 할 정책이 추측 문구로 변질되지 않았는가
- 결정론적으로 막아야 할 정책이 advisory 문구에 머물러 있지 않은가
- 문서 구조가 계속 비대해지는 방향인지, 아니면 분해 가능하고 유지 가능한 방향인지
- 이 governance가 실제로 에이전트의 행동 품질과 안전성을 높일 수 있는가
검토 범위
다음을 검토한다.
- 루트
CLAUDE.md
- 모듈별
CLAUDE.md
.claude/rules/*.md.claude/settings.json.claude/hooks/ 아래 관련 hook
검토 체크리스트
1. 중복
다음 간 규칙 중복을 확인한다.
- 루트 vs 모듈 CLAUDE 파일
- rule 파일 vs CLAUDE 파일
- 여러 rule 파일 사이
2. 충돌
다음과 같은 상충 지침을 확인한다.
- 서로 모순되는 architecture rule
- 다른 승인 요구사항
- 상충되는 ownership 또는 dependency rule
3. 잘못된 배치
다음을 확인한다.
- 모듈 고유 내용이 루트 CLAUDE.md에 잘못 들어간 경우
- 파일 단위의 좁은 규칙이 always-on CLAUDE.md에 잘못 들어간 경우
- 절차적 내용이 rules에 남아 있고 skill로 분리되어야 하는 경우
4. 강제 누락
결정론적으로 강제되어야 할 정책이 advisory text로만 남아 있는지 확인한다.
예:
- 보호 파일 편집
- 금지된 명령
- rule frontmatter 검증
5. Settings 누락
다음의 명백한 누락을 확인한다.
- deny / ask 보호
- governance 경로 커버리지
- hook 등록
6. Always-on vs On-demand 배치 적절성
각 규칙이 아래 중 어디에 있어야 하는지 평가한다.
- always-on governance
- path-scoped rule
- on-demand skill
- deterministic hook
7. desired state 적합성
현재 governance가 아래 상태를 향하는지 평가한다.
- 전역 문서는 짧고 선명한가
- 세부 규칙은 분리되어 있는가
- 도메인 제약은 해당 모듈 근처에 있는가
- 반복 절차는 skill로 이동되어 있는가
- 보호 정책은 hook으로 승격되어 있는가
- 문서가 늘어나기만 하지 않고 정리 가능하게 설계되어 있는가
출력 형식
각 발견 사항마다 아래를 출력한다.
- severity: critical / warning / info
- location
- issue
- why it matters
- recommended fix
마지막에는 아래 4개 섹션으로 마무리한다.
- 지금 반드시 고쳐야 할 것
- 다음 단계에서 고치면 좋은 것
- 현재는 유지해도 되는 것
- 이 governance가 현재 유도하고 있는 상태 요약
검토 독립성 규칙
이 skill 안에서 파일을 다시 쓰지 않는다.
문제를 조용히 정규화하지 않는다.
별도의 drafting 또는 editing pass에서 수정할 수 있도록 명확하게 드러낸다.
