| name | draft-governance-files |
| description | 사용자가 미해결 governance 질문에 답한 뒤, 루트 CLAUDE.md, 모듈 CLAUDE.md, rules, settings 초안을 생성한다. |
| allowed-tools | Read Grep Glob Bash Edit Write |
목적
이 저장소의 governance 아티팩트를 초안 작성한다.
아래 입력만 사용한다.
- 저장소 근거
- 기존 governance 아티팩트
- 사용자가 확인한 답변
도메인 규칙이나 기획 규칙을 추측으로 만들지 않는다.
범위
이 skill은 다음 파일을 생성하거나 수정할 수 있다.
- 루트
CLAUDE.md
- 모듈별
CLAUDE.md
.claude/rules/*.md
.claude/settings.json
사전 조건
파일을 쓰기 전에 아래가 모두 충족되었는지 확인한다.
- discovery 결과가 있다
- 미해결 governance 질문이 식별되었다
- 사용자가 사용할 답변을 확인해주었다
- 생성 대상 파일에 대한 짧은 write plan을 제시했다
하나라도 빠져 있으면 멈추고 해당 항목을 요청한다.
상태 보존 및 승인 동작
파일 편집 전에는 다음을 수행한다.
- 대상 파일 목록을 간결히 보여준다
- 의미가 있으면
git diff --stat 같은 가벼운 변경 미리보기를 제시한다
- 쓰기 진행 승인을 요청한다
자동 commit 하지 않는다.
git stash를 강제하지 않는다.
사용자가 추가 snapshot을 원하면 git stash push -k -m "pre-governance-draft" 를 제안할 수 있다.
초안 작성 규칙
루트 CLAUDE.md
- 집중된 첫 버전을 만든다.
- 초안은 100줄 이하를 목표로 한다.
- Claude가 매번 다시 발견할 수 있는 정보는 최대한 넣지 않는다.
- 디렉터리 나열이나 장황한 저장소 개요처럼 Claude가 파일에서 스스로 알 수 있는 내용으로 공간을 낭비하지 않는다.
권장 섹션:
- 프로젝트 목적 / 제약
- 핵심 build / test workflow
- architecture invariant
- non-negotiable rule
- governance 배치 원칙
- review expectation
모듈 CLAUDE.md
- 짧고 구체적으로 유지한다.
- 대체로 40~80줄 범위를 권장한다.
- 책임, 비책임, 도메인 제약, 경계, 테스트 기대치를 담는다.
Rules
- YAML frontmatter는 반드시 아래 두 필드만 사용한다.
- rule은 좁고 날카로운 범위로 작성한다.
- 해당 파일을 다룰 때 조건부 로딩되어야 하는 내용만 rule로 둔다.
- 내용이 절차적이고 항상 필요하지 않다면 skill을 우선 고려한다.
Settings
- 팀 공용
.claude/settings.json 만 작성한다.
- 최소 구성으로 유지한다.
- 개인 환경이나 머신 전용 선호는 넣지 않는다.
미확인 정보 처리
어떤 rule이나 governance 문구가 미확인 도메인 지식에 의존한다면:
- 추측하지 않는다
[미확인 — 질문 필요] 로 표기한다
- 후속 질문 목록에 추가한다
메타데이터 정책
CLAUDE.md 파일
유지보수 메모가 필요하면 HTML comment만 사용한다.
해당 아티팩트 유형에서 플랫폼 요구가 없는 한 CLAUDE.md 에 YAML frontmatter를 추가하지 않는다.
Rule 파일
기능적으로 필요한 frontmatter만 사용한다.
기본적으로 created, source 같은 감사용 메타데이터는 넣지 않는다.
참고 파일
아래 supporting file을 사용한다.
출력 규약
draft 후에는 항상 아래를 보고한다.
- 생성되거나 수정된 파일
- 남아 있는
[미확인 — 질문 필요] 항목
- rule / skill / hook 배치 과정에서 내린 결정