carve-harness: Skill for Claude Code

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 유지, 소형 단일 → 프루닝 후보.