carve-harness-create

name	carve-harness-create
description	프로젝트를 전수 분석(스택+코드베이스)해 ① CLAUDE.md·AGENTS.md 설정 정합성을 검증·제안하고 ② 스택에 필요한데 없는 요소(하네스 규칙·외부 개발도구·설정 스캐폴딩)를 보강 제안하며 ③ 불필요한 구성을 prune한다. FIX/ADD/KEEP/PRUNE 통합 제안표 → 1회 확인 → 적용 → evaluator 독립 평가표. 전체 설치 후 프로젝트에 맞게 맞춤화할 때 사용.
disable-model-invocation	true
argument-hint	[--dry-run]

Carve Harness — 프로젝트 맞춤 구성 (검증 · 보강 · 절단)

전체 설치된 하네스를 이 프로젝트에 맞춘다. 세 방향으로 동작한다:

1. 검증(FIX) — CLAUDE.md·AGENTS.md·.claude/CLAUDE.md 설정 오류를 검출해 제안한다(자동 수정 아님).
2. 보강(ADD) — 감지된 스택에 필요한데 없는 요소(하네스 규칙·외부 개발도구·설정 스캐폴딩)를 채우도록 제안한다.
3. 절단(PRUNE) — 이 스택에 불필요한 하네스 파일을 제거한다(되돌릴 수 있음).

프롬프트 주도이며 결정론 스크립트가 아니다. 분석 → 검증 → 보강 → 절단 → 통합제안 → 1회 확인 → 적용 → 평가표 순서를 반드시 지킨다. 파괴 인접 작업이다.

--dry-run 인자가 오면 통합 제안표(5단계)까지만 하고 아무것도 바꾸지 않는다. 절단은 bash install.sh rollback으로 되돌릴 수 있으나, 확인 없이 진행 금지. 설정 파일(CLAUDE.md 등) 편집은 사용자가 승인한 FIX 항목만 반영한다.

0. 전제 조건 점검

1. .claude/harness-manifest.txt가 있는가? 없으면 중단 — "설치된 하네스가 아닙니다. 먼저 bash install.sh 실행"이라고 보고하고 끝낸다.
2. git 작업트리가 clean인지 확인(git status --porcelain). dirty면 경고만 하고 진행 가능 ("결과를 git diff로 검토·롤백하려면 clean 권장").

1. 프로젝트 전수 분석

스택·역할·규모 및 코드베이스 신호를 파악한다. 보수적 원칙: 확신 없으면 KEEP. 스택을 놓쳐 필요한 규칙을 삭제하는 false-negative가 가장 위험하다.

1-1. 언어/스택 (규칙 선택 근거)

• Java/Spring: gradlew·build.gradle·build.gradle.kts·pom.xml, 또는 find . -name '*.java' -not -path '*/.git/*' -not -path '*/build/*' | head -1
• TS/React/Next: package.json + find . -name '*.tsx' -o -name '*.ts' | head -1. Next = package.json의 "next" 또는 next.config.*
• Python/FastAPI: find . -name '*.py' -not -path '*/.venv/*' | head -1. FastAPI = grep -rl 'from fastapi' --include='*.py' . | head -1
• ORM/DB: grep -rlE 'sqlalchemy|from django.db|@Entity|typeorm|prisma|drizzle' . | head -1
• 미지원(go/rs/rb 등): 감지돼도 대응 규칙 없음 → PRUNE 대상 아님(코어 훅이 커버).

1-2. 코드베이스 신호 (보강·평가 근거 — 새로 수집)

• 린터/포맷터 존재: Node면 package.json에 prettier/eslint/biome devDep + 로컬 바이너리; Python이면 ruff/black (pyproject.toml 또는 PATH); Java면 spotless 플러그인.
• 테스트 유무: tests/·test/·*_test.*·*.test.*·src/test/ 존재 여부(Stop 게이트 실효성 판단).
• CI: .github/workflows/·.gitlab-ci.yml 존재.
• 외부 도구 PATH: command -v gh ruff prettier tsc npx — 스택에 필요한데 없는 것을 ADD 후보로.
• 규모: git ls-files | wc -l, 소스 디렉토리 수, 모노레포 신호(pnpm-workspace.yaml·turbo.json· workspaces·하위 package.json 2개+). 대규모 → fable/squad 유지, 소형 단일 → 프루닝 후보.

분석 결과를 한 문단으로 먼저 요약해 보여준다(무슨 스택·규모로 판단했는지, 근거 파일 명시).

2. 설정 검증 (config-doctor) — 검출 후 제안만

CLAUDE.md·AGENTS.md·.claude/CLAUDE.md의 정합성을 점검한다. 각 항목은 FIX 제안으로만 모은다 (자동 편집 금지 — 사용자 승인분만 7단계에서 반영).

기계적 검사(깨진 @참조·죽은 하네스 경로)는 bash .claude/hooks/config-doctor.sh로 결정론적으로 돌린다(advisory, 항상 exit 0, 출력만). 나머지(3파일 정합성·placeholder·glob 의미)는 아래를 직접 확인한다:

• 깨진 @참조: CLAUDE.md·AGENTS.md의 @경로(예: @AGENTS.md, @.claude/rules/common/)가 실재하는가. grep -oE '@[.A-Za-z0-9_/-]+' CLAUDE.md AGENTS.md → 각 대상 test -e. 없는 대상 = FIX.
• 스택 감지 glob의 대상 규칙 실재: CLAUDE.md/AGENTS.md의 "스택 감지" 표가 가리키는 .claude/rules/java-spring/·react-next/ 등이 실재하는가. prune으로 사라진 경로를 가리키면 FIX (그 줄을 지우거나, 해당 스택이면 ADD로 복구 제안).
• 3파일 정합성: CLAUDE.md·AGENTS.md·.claude/CLAUDE.md는 "같은 규칙을 공유(하나 고치면 나머지도)"가 전제다. 공통 축(절대 금지 목록·응답 언어 프로토콜·스택 감지 표)이 서로 어긋나면 FIX로 불일치 지점 제시.
• 미채운 placeholder: 예시 도메인 규칙("주문 금액 음수 불가" 등)이 그대로 남아 실제 규칙이 없으면, 프로젝트 도메인 규칙 작성을 FIX(스캐폴딩)로 제안.
• 존재하지 않는 파일 참조: 본문이 가리키는 스킬/커맨드/규칙 경로가 실재하는지 표본 확인.

검출이 0건이면 "설정 정합성 이상 없음"이라고 명시한다(빈 척 금지).

3. 보강 계산 (ADD) — 필수·도움 요소

하네스 본체는 install.sh가 이미 전부 깔았다. 여기서 ADD는 밖에서 채워야 할 것이다. 세 갈래:

3-1. 외부 개발도구 (Stop 게이트 실효성에 직결 → 필수 후보)

1-2에서 없다고 확인된 것만. 감지 스택 기준:

• Node/TS: prettier(포맷 게이트)·tsc(타입) 미설치 → npm i -D prettier typescript 안내.
• Python: ruff·pytest 미설치 → pip install ruff pytest(또는 uv) 안내.
• Java: gradle spotless 미구성 안내.
• gh(PR 워크플로)·GSD(npx get-shit-done-cc --local) 미설치 → 선택 안내.

ADD는 안내/제안이다. 사용자 머신에 임의로 설치 실행하지 않는다(승인 후 명령 제시).

3-2. 누락된 하네스 구성 복구

감지 스택에 해당하는데 규칙/에이전트가 없으면(이전 prune 등) 복구 제안:

• 예: *.java 다수인데 .claude/rules/java-spring/·dev-stack-java-spring.md·eval-java.sh 부재 → 복구.
• 복구 수단: 직전 prune이면 bash install.sh rollback, 아니면 bash install.sh update(정본 재-fetch) 안내.
• 의존성 간선 존중(4단계 표와 동일): eval-java ⟷ archunit, squad cmd ⟷ agent는 함께 복구.

3-3. 설정 스캐폴딩

• CLAUDE.md 도메인 규칙 섹션이 비었으면 ## 도메인 규칙 스캐폴드 제안(2단계 placeholder와 연동).
• 보호 경로가 필요해 보이면(.pem·config/prod/ 등 감지) protected-extra.regex 추가 제안.

4. 절단 계산 (PRUNE) — KEEP/PRUNE 집합

ALWAYS-KEEP + 감지 스택 게이트 + 의존성 간선으로 유지 경로 집합을 만든다. 경로는 prune이 이해하는 확장 granularity(디렉토리 단위 또는 code-convention/dev-stack-*.md 파일 단위)로 쓴다.

ALWAYS-KEEP (스택 무관, 반드시 keep-list 포함)

install.sh prune의 PROTECTED 정규식이 자동 보호하는 것(hooks 코어·settings.json·safety.md· common/*·testing.md·CLAUDE.md·AGENTS.md·RULES.md·.cursorrules·codex.md·.claude/CLAUDE.md· vendor·.githooks·VERSION·스크립트)은 keep-list에 없어도 유지된다. 아래는 PROTECTED가 아니므로 keep-list에 명시한다:

• .claude/skills/handoff · changelog · version-changelog · anti-ai-slop · carve-harness-create(자신)
• .claude/commands/harness-audit.md · commit.md · plan.md · review.md · verify.md
• .claude/rules/database.md는 ORM/DB 감지 시에만.

스택 게이트 (감지 시에만 KEEP, 아니면 PRUNE)

감지	KEEP
Java/Spring	.claude/rules/java-spring(dir 전체, archunit 포함) · dev-stack-java-spring.md · .claude/hooks/eval-java.sh
TS/React/Next	.claude/rules/react-next · frontend.md · dev-stack-typescript.md · dev-stack-react.md · dev-stack-nextjs.md · dev-stack-javascript.md (감지된 하위스택만)
Python/FastAPI	dev-stack-python.md · dev-stack-fastapi.md(FastAPI 감지 시)
ORM/DB	.claude/rules/database.md · dev-stack-orm.md

하드 의존성 간선 (묶어서 keep 또는 prune — 절대 분리 금지)

1. eval-java ⟷ archunit (★최우선): eval-java.sh keep면 java-spring(archunit 포함)도 keep. 한쪽만 남기면 harness-audit AUDIT-08 FAIL. Java 미감지 → 둘 다 prune.
2. squad: commands/squad*.md(9) ⟷ agents/squad-*.md(8). 함께 keep 또는 함께 prune.
3. fable: workflows/fable-team-pipeline.js ⟷ agents/fable-*(4) + docs/md/orchestration.md + docs/md/fable-team-guide.md. 함께.
4. review ⟷ 리뷰어: commands/review.md(ALWAYS-KEEP)가 code-reviewer·security-reviewer· silent-failure-hunter를 참조 → 이 3개 에이전트 keep.

소형 단일 스택: squad·fable 프루닝 후보. 멀티모듈/모노레포/대규모: 유지. 애매하면 KEEP.

5. 통합 제안표 (FIX / ADD / KEEP / PRUNE)

manifest 확장 전 항목 + 2·3단계 결과를 하나의 표로 제시한다:

• 🔒 코어(ALWAYS-KEEP/PROTECTED): 상단 잠금 표시 — "절대 변경 안 됨".
• FIX (설정 검증): 파일·위치·문제·제안 각 1줄.
• ADD (보강): 도구/규칙/스캐폴딩·사유·실행 방법.
• KEEP / PRUNE (절단): 2열, 각 PRUNE에 사유 1줄("Java 미감지 → java-spring 불필요").

--dry-run이면 여기서 정지. 표만 보여주고 아무것도 바꾸지 않는다.

6. 1회 확인

사용자에게 한 번 묻는다: "FIX N건(설정 수정 제안) · ADD M건(보강) · PRUNE K개(삭제)를 적용합니다. KEEP 조정·FIX 취사선택이 필요하면 말씀하세요." — 놓친 스택·원치 않는 편집을 막을 마지막 안전판. 각 방향을 개별 승인할 수 있게 한다(예: PRUNE만 진행, FIX는 보류).

7. 적용 (승인된 것만, 순서 고정)

1. FIX: 사용자가 승인한 CLAUDE.md/AGENTS.md 수정만 부분 편집(Edit). 3파일 공유 축을 고쳤으면 세 파일 모두 동기화한다(정합성 전수 점검). 미승인 항목은 건드리지 않는다.
2. ADD(복구): 승인 시 install.sh rollback 또는 update로 하네스 구성 복구. 외부 도구는 명령만 제시 (임의 설치 실행 금지). 스캐폴딩은 승인분만 append.
3. PRUNE: KEEP 경로를 mktemp 파일에 1줄씩 기록(PROTECTED 포함 무방, 최소한 비보호 ALWAYS-KEEP· 스택 매칭·의존성 keep 포함) → bash install.sh prune --keep-list <tmp>.
   • prune이 manifest 확장 → keep-list 밖 비보호 파일을 logs/harness-backup/에 백업 후 제거 → manifest 갱신.

8. 검증 + evaluator 평가표

1. bash .claude/hooks/harness-audit.sh — exit 0(전 항목 pass) 필수. FAIL이면(orphan 정책 — gateway 규칙 남았는데 트리거 없음, eval-java↔archunit 불일치 등) 즉시 bash install.sh rollback 안내하고 중단 보고. 임의 추가 삭제 금지.
2. evaluator 독립 평가표: evaluator 서브에이전트를 띄워(생성/검증 분리) 적용 결과를 완료기준(SC) 대비 독립 채점하게 한다. 평가 축과 SC:
   • 스택 커버리지: 감지 스택마다 대응 규칙이 존재하는가(누락=감점).
   • 설정 정합성: FIX 후 깨진 @참조·glob·3파일 불일치가 0인가.
   • 게이트 실효성: 스택 린터/포맷터·테스트가 갖춰져 Stop 게이트가 실제로 무는가.
   • 절단 안전성: harness-audit 0 fail, 의존성 간선 온전. evaluator 결과를 PASS/WARN/FAIL × 축 표로 사용자에게 제시한다. Generator(이 스킬)와 분리 운용.

9. 보고 + 정리

• FIX·ADD·PRUNE 최종 수, 남은 스택 규칙, harness-audit 결과, evaluator 평가표를 한국어로 요약.
• .claude/harness-create-pending 마커가 있으면 삭제. tmp keep-list 삭제.
• "되돌리려면 bash install.sh rollback, 커밋 전 git diff로 검토 권장" 안내.

주의

• 미지원 스택(go/rust/ruby 등)은 대응 규칙이 없어 프루닝·복구 대상 아님 — 코어 훅이 커버.
• 설정 파일 편집(FIX)은 되돌리기 위해 git 필요 — dirty 트리면 diff 검토 후 커밋 권장.
• 외부 도구·GSD 설치는 안내만 한다 — 사용자 머신 상태를 임의로 바꾸지 않는다.
• prune은 되돌릴 수 있으나 한 버전에서 prune/update를 섞으면 백업이 겹칠 수 있다 — clean 버전에서 한 번에 권장.
• 이 스킬은 모델 무관 경로 집합으로 fable/squad를 다룬다 — 미설치면 manifest에 없어 자동으로 건너뛴다.