name: harness-diet
description: "harness-legacy-scan 리포트의 low-risk 항목만 적용: CLAUDE.md 축소/절차→Skill 이동/긴 SKILL.md 분할/description 좁힘/삭제후보 archive. 트리거: /harness-diet"
model: sonnet
allowed-tools: Read, Write, Edit, Bash, Glob, Grep
argument-hint: [--dry-run] [--queue <path-to-diet-queue.json>]
harness-diet
역할: harness-legacy-scan이 생성한 diet-queue.json을 소비해, diet_auto=true && risk=low 항목만 자동 적용.
컨텍스트: /harness-diet 호출 시. 반드시 scan 리포트를 먼저 검토·납득한 후 실행할 것.
출력: 7보고 섹션 (변경목록/이유/Before-After/diff요약/Claude행동변화/Human승인목록/smoke-test).
쓰지 말아야 할 때
- scan 리포트를 검토하지 않은 상태 → 먼저
harness-legacy-scan 실행 + 리포트 확인.
- medium+ 위험 변경을 자동 적용하려 할 때 → [STOP] 게이트 필수, Human 승인 후만.
- hook/MCP/allowed-tools 변경 → 본 스킬 절대 수정 불가 (gist 금지 7 준수).
- 앱 코드/test/build/deploy 임의 실행 → 금지.
의도 (§2 전문)
harness-legacy-scan 결과를 실제 SSoT(~/forge/.claude/)에 적용하는 actuator.
안전 우선: diet_auto=true && risk=low만 자동. medium/high는 목록 반환 후 Human 승인.
판별 기준 reference: ${FORGE_ROOT:-$HOME/forge}/.claude/rules-on-demand/skill-writing-principles.md
— 무엇을 자를지는 길이가 아니라 진단으로 정한다. no-op 테스트(이 문장이 기본 동작 대비 행동을 바꾸는가? 아니면 문장째 삭제),
퇴적(sediment) vs 비대(sprawl) 구분(전자=가지치기, 후자=progressive disclosure), 중복=단일 진실 원천 위반.
허용 7가지
- CLAUDE.md 축소 — 중복/일반지침 섹션 제거 (Forge 특화 내용은 유지)
- 절차 CLAUDE.md→Skills 이동 — 작업전용 워크플로우를 CLAUDE.md에서 skill로 분리
- 긴 SKILL.md 분리 — SKILL.md + reference.md + examples.md로 분할
- description 좁힘 — 넓은 description에 "언제 쓰지 말아야 하는지" 섹션 추가
- 자동호출 Skill에 negative guard 추가 — "사용하지 말아야 할 때" 섹션 삽입
- 삭제후보 archive 이동 — 영구삭제 X, forge-outputs archive로 이동 (복구가능)
- 변경이유 인라인주석 정리 — 인라인주석 대신 최종요약으로 집약
금지 7가지
- 영구 삭제 금지 (archive 이동만)
- hooks 수정 금지
- MCP 설정 수정 금지
- allowed-tools 확대 금지
- 앱 코드 수정 금지
- test/build/deploy 임의 실행 금지
- 불확실한 변경 → 수동 승인 목록 반환 (자동 적용 X)
편집 SSoT
편집 대상 = ~/forge/.claude/ (SSoT). ~/.claude/ 직접 편집은 block-forge-mirror-edit hook exit2로 차단됨.
archive 경로
삭제후보는 ${FORGE_OUTPUTS:-$HOME/forge-outputs}/11-platform/pipelines/forge-dev/2026-06-08-v1-harness-diet/plans/archive/harness-diet-2026-06-08/로 이동.
주의: gist 원안은 .claude/archive/ 경로를 사용하지만, 이 경로는 forge-sync 미동기 + mirror orphan 이슈로 부적합. forge-outputs archive를 사용하면 git-tracked, 복구 가능, mirror 충돌 없음.
forge-sync 삭제 미전파 FIX (CRITICAL)
스킬 archive(이동) 시 SSoT 폴더(~/forge/.claude/skills/{name}/) 이동 후
~/.claude/skills/{name} mirror copy도 python3 shutil.rmtree로 반드시 제거.
안 하면 호출 가능한 orphan mirror가 잔존해 삭제가 반영되지 않음.
rollback 시: archive에서 복원 후 node ~/.claude/scripts/forge-sync.mjs sync 실행.
SAFETY carve-out
effectiveness=SAFETY-DETERRENT 또는 보안키워드(injection/redact/secret/permission/override/block/deny) 자산 → 자동 archive 절대 금지. Human 승인 필수.
미발동 ≠ 효과 없음.
확장 비전 — Profile-based Skill Surface Budget (P2, WI-17)
현재 harness-diet = 개별 스킬 크기 축소 actuator.
미래 확장: 세션 컨텍스트별 스킬 표면 제어 (78 skills 전체 로드 → 필요 스킬만 로드).
설계 원칙
프로파일 tier (예시):
core: 핵심 forge 커맨드만 (forge-onboard / forge-implement / forge-fix / qa 등 8~10개)standard: core + 자주 쓰는 리서치/리뷰 스킬 (13~15개)full: 전체 (현재 기본값)
requires: 의존성 클로저:
- 각 SKILL.md frontmatter에
requires: [skill-a, skill-b] 선택적 필드 추가
- 프로파일 해소 시 BFS transitive closure로 의존 스킬 자동 포함
- 현재 SKILL.md frontmatter(name/description) additive 추가 — 기존 호환 유지
에이전트 파생 (agent derivation):
- SKILL.md 본문에서
/skill-name 호출 패턴 스캔 → 해당 에이전트 자동 포함
- orphan 에이전트 스텁 방지
마커 파일 (.forge-profile):
~/.claude/ 또는 프로젝트 .claude/에 프로파일 마커 저장- 마커 우선, 없으면
full 기본
install-profile 선택 레이어 (WI-17)
harness-diet 호출 시 --profile 인자로 적용 스킬 표면을 지정한다.
명시 선택:
/harness-diet --profile=핵심 # core: 구현 필수 커맨드만
/harness-diet --profile=확장 # standard: core + 리서치/리뷰
/harness-diet --profile=전체 # full: 모든 스킬 (기본값)
profile별 핵심/확장/전체 설치 구분:
| 프로파일 | alias | 포함 스킬 | 목표 수 | 적합 세션 |
|---|
| 핵심 | core | forge-implement · forge-fix · qa · forge-pr · spec-write · forge-pge · checkpoint · end-sonnet | ~8 | 집중 구현 |
| 확장 | standard | 핵심 + cr-* · investigate · harness-diet · healer · doc-writer | ~16 | 일반 개발 |
| 전체 | full | ~/.claude/skills/ 전체 | 현재 78+ | 기본값 |
환경 감지 auto-profile (프로파일 명시 없을 때):
- 프로젝트
.claude/.forge-profile 존재 → 파일 값 사용 (로컬 우선)
~/.claude/.forge-profile 존재 → 파일 값 사용 (전역)- 마커 없고 스킬 수 ≥ 60 →
standard 권장 안내 출력 (자동 변경 X)
- 마커 없고 스킬 수 < 60 →
full 유지
마커 설정:
echo "standard" > ~/.claude/.forge-profile
echo "core" > .claude/.forge-profile
현재 actuator는 diet-queue.json 단위 항목 적용. 프로파일 기반 bulk 설치/제거 = 하네스 GC(2026-08-01) 이후 구현. WI-17 = 명세 + 인터페이스 정의.
구현 트리거
- Claude Max extra usage 실측 증가 추세 지속 시
~/.claude/skills/ 스킬 수 100+ 초과 시context-engineering.md §컨텍스트 토큰 관리 임계치 반복 도달 시
작업 경로
구현 준비 시: forge-outputs/11-platform/skills/skill-surface-budget/ 작업 폴더 생성 + plan.md 작성 후 사용자 승인.
주의: 현재 delta는 설계 문서화만. 78개 스킬 전체 requires: 필드 소급 적용은 별도 L effort 작업.
하네스 GC 2026-08-01 전까지 plan.md 작성 → 사용자 승인 → 마이그레이션 순서 권장.
호출
Workflow({
script: Bash("cat ${FORGE_ROOT:-$HOME/forge}/.claude/skills/harness-diet/workflow.js"),
args: {
queuePath: "/path/to/diet-queue.json",
outBase: Bash("echo ${FORGE_OUTPUTS:-$HOME/forge-outputs}")
}
})
outBase를 반드시 주입하라. Workflow 스크립트는 process 전역에 접근할 수 없어 $HOME을
스스로 알 수 없다. 미주입 시 workflow.js의 하드코딩 폴백(작성자 로컬 경로)으로 떨어져
다른 PC에서는 archive·리포트 저장이 실패한다.
기본 queuePath: ${FORGE_OUTPUTS}/11-platform/pipelines/forge-dev/2026-06-08-v1-harness-diet/diet-queue.json
