크라우니코드 스킬 전량 감사 — 도구/규칙·프롬프트/코드화 비율 실측 (2026-07-25)

개요

~/.claude/commands/크라우니코드.md(스킬 본문) 전량 감사. 페블 오케스트레이션: 하이쿠=참조 실존 전수(73개), 소넷=중복·프롬프트/코드화 분류, 페블=교차검증·종합. 즉시 수리 2건 반영 완료.

실측 총량

• 문서: 480줄 / 26.4KB ≈ 6,600토큰 / 22섹션 — 스킬 호출마다 전량 컨텍스트 주입
• 구성: 코드블록 166줄(35%) · 산문 268줄(56%) · 빈줄 9%
• 참조 자산: 73개 중 72개 실존(99%) — 도구 생태 자체는 건실 (agent.sh 78KB, 학습DB 합 ~215k줄/106MB, keywords 14k줄)

강제 방식 분류 (핵심 발견)

분류	개수	줄수	비율
코드화 (훅이 결정론 강제)	~3건	~5줄	~1%
반코드화 (도구 실존, 호출은 프롬프트 의존)	~14블록	~278줄	~58%
순수 프롬프트 (도구 없음)	~8블록	~123줄	~26%
참조/구조	—	~74줄	~15%

역전 현상: 문서가 "전 세션 강제·자동·토큰0"이라 주장하는 것 대부분(규칙집행 CLI·학습흐름·자동성장)이 훅 미등록 = 말로 때우는 층. 반대로 실제 도는 훅(autolearn·한선씨동반알림·디자인이식가드/게이트·throttle·갑옷)은 문서에 거의 미기재. 갑옷훅은 일부 유형만 토큰0 조회를 직접 실행, 코드 유형은 지시 주입까지(반코드화).

중복·모순·불필요 (삭제 가능 150~180줄 = 31~38%)

1. 학습 플로우(lookup→MISS→LLM→learn) 6곳 반복 ~90줄 + learn.sh 명령 4~5회 재타이핑 ~25줄
2. 자기모순 2건: §뇌라우터 "brain.sh run이 1~3단계 대행, 수동은 디버깅용" 선언 ↔ §기본라우팅·§에이전트우선·§학습명령이 여전히 수동 필수 지시 / "agent.sh를 반드시 먼저 호출" ↔ "agent.sh 생성폴백 신뢰금지"
3. 글로벌 CLAUDE.md 1:1 중복: §규칙집행 46줄, §학습명령 ~10줄, §한선씨 문법 ~25줄 (SSOT 위반)
4. Stop 훅이 이미 자동 실행하는 종료 지시 5줄 (harvest sync 등)
5. 유지해야 할 중복: §분별 연결 블록(설계상), §4계층 경로표(유일 출처), §디자인이식(실훅 정합)

즉시 수리 완료 (이번 세션)

• 죽은 참조 1건: crownycode-working/ 디렉토리 복구(mkdir)
• 낡은 수치 7건 갱신: "964/1249"·"739건"·"268개"·"3700+"·"9000+"·"15000+" → 실측치/stats 참조로 치환 (전부 7~52배 과소 — DB가 자란 뒤 문서 미갱신)

선언 (정리 방향 — 구조 변경은 사용자 승인 후 적용)

1. 원칙: 강제는 훅으로, 문서는 계약+참조만. 코드화 1%가 문제의 뿌리 — "말로 하면 피해간다"는 스킬 자신에게도 적용됨.
2. 훅 승격 우선순위(반코드화→코드화): ①세션시작 enforce/harvest 상태 → 세션인사·갑옷훅에 이관 ②비중표 출력 → Stop 훅 자동 리포트 ③코드 유형 brain 게이트 → :9977 상주서버 직조회로 갑옷훅에서 결정형 실행 ④수치는 수동 기입 금지(CROWNY_VERSIONS.md 원칙 확장)
3. 슬림화 목표: 480줄 → ~300줄 — 학습 플로우는 §뇌라우터 1곳만 남기고 §기본라우팅은 "디버깅 부록" 강등, §규칙집행·§한선씨 문법은 글로벌/가드레일 링크로 대체, §에이전트우선은 §뇌라우터에 병합.
4. 도구 자산(99% 실존·106MB DB)은 문제없음 — 문제는 문서층의 프롬프트 의존이다.

관련 파일

• 대상: ~/.claude/commands/크라우니코드.md · 훅 SSOT: ~/.claude/settings.json
• 이전 작업: 2026-07-24-디자인이식-가드도구.md (코드화 모범 사례)

---

적용 완료 (2026-07-26 — 사용자 승인 후 슬림화+고도화 실행)

1. 스킬 슬림화: 480줄/6,600토큰 → 125줄/2,500토큰(–62%). 독트린 전부 보존, 학습플로우 1곳화, 규칙집행·문법=SSOT 링크, "실제 자동층(훅)" 명세 신설, 수동 명령=디버깅 부록. 백업=크라우니코드.md.bak-슬림화전
2. 갑옷훅 고도화(소넷 구현+페블 검증): ①코드/생성 유형 brainq(:9977) 직조회 — HIT면 학습코드 주입("재생성 금지"), MISS/서버다운=기존 지시 폴백(+0.02~0.4s) ②디자인 핸드오프 감지 유형 신설 — 오탐 실측 후 정규식 조임(디자인·시안 문맥 결합 필수: "npm 패키징" 미발동 확인) ③세션인사에 비중 1줄. 백업=크라우니갑옷.sh.bak-20260726152212
3. 비중 자동화: 크라우니코드비중기록.sh 신규 + Stop 훅 배선 — ~/.crownycode/비중로그.psv 자동 append 실측(57%). 수동 비중표 지시 폐지.

→ 코드화 비율: 강제층 1% → 갑옷 토큰0 주입·디자인 감지·비중 기록이 결정형으로 승격. 잔여: 세션시작 enforce 상태의 훅 이관(선택), 디자인이식 정규식 실사용 오탐 모니터링.