carve-harness-create
Skill16 starsChanged 2 months agoMITView on GitHub
프로젝트를 전수 분석(스택+코드베이스)해 ① CLAUDE.md·AGENTS.md 설정 정합성을 검증·제안하고 ② 스택에 필요한데 없는 요소(하네스 규칙·외부 개발도구·설정 스캐폴딩)를 보강 제안하며 ③ 불필요한 구성을 prune한다. FIX/ADD/KEEP/PRUNE 통합 제안표 → 1회 확인 → 적용 → evaluator 독립 평가표. 전체 설치 후 프로젝트에 맞게 맞춤화할 때 사용.
- Installs packages
In this repository12 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .claude/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- anti-ai-slopSkill
- carve-guideSkill
- changelogSkill
- checklist-loopSkill
- eval-goldensetSkill
- eval-initSkill
- handoffSkill
- theme-factorySkill
- version-changelogSkill
The file
Files
Carve Harness — 프로젝트 맞춤 구성 (검증 · 보강 · 절단)
전체 설치된 하네스를 이 프로젝트에 맞춘다. 세 방향으로 동작한다:
- 검증(FIX) — CLAUDE.md·AGENTS.md·
.claude/CLAUDE.md설정 오류를 검출해 제안한다(자동 수정 아님). - 보강(ADD) — 감지된 스택에 필요한데 없는 요소(하네스 규칙·외부 개발도구·설정 스캐폴딩)를 채우도록 제안한다.
- 절단(PRUNE) — 이 스택에 불필요한 하네스 파일을 제거한다(되돌릴 수 있음).
프롬프트 주도이며 결정론 스크립트가 아니다. 분석 → 검증 → 보강 → 절단 → 통합제안 → 1회 확인 → 적용 → 평가표 순서를 반드시 지킨다. 파괴 인접 작업이다.
--dry-run인자가 오면 통합 제안표(5단계)까지만 하고 아무것도 바꾸지 않는다. 절단은bash install.sh rollback으로 되돌릴 수 있으나, 확인 없이 진행 금지. 설정 파일(CLAUDE.md 등) 편집은 사용자가 승인한 FIX 항목만 반영한다.
0. 전제 조건 점검
.claude/harness-manifest.txt가 있는가? 없으면 중단 — "설치된 하네스가 아닙니다. 먼저bash install.sh실행"이라고 보고하고 끝낸다.- 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/biomedevDep + 로컬 바이너리; 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.json2개+). 대규모 → fable 유지, 소형 단일 → 프루닝 후보.
분석 결과를 한 문단으로 먼저 요약해 보여준다(무슨 스택·규모로 판단했는지, 근거 파일 명시).
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/·docs/rules/code-convention/dev-stack-java-spring.md·eval-java.sh부재 → 복구. - 복구 수단: 직전 prune이면
bash install.sh rollback, 아니면bash install.sh update(정본 재-fetch) 안내. - 의존성 간선 존중(4단계 표와 동일): eval-java ⟷ archunit, fable workflow ⟷ agent는 함께 복구.
3-3. 설정 스캐폴딩
- CLAUDE.md 도메인 규칙 섹션이 비었으면
## 도메인 규칙스캐폴드 제안(2단계 placeholder와 연동). - 보호 경로가 필요해 보이면(
.pem·config/prod/등 감지)protected-extra.regex추가 제안. specs/goldenset/이 비었으면 골든셋 day-0 부트스트랩 제안 — 감지된 핵심 경로 기반 3~5케이스 초안 (절차·검수 규칙은eval-goldenset스킬 "day-0 부트스트랩" 절, 인간 검수 전 확정 금지).
4. 절단 계산 (PRUNE) — KEEP/PRUNE 집합
ALWAYS-KEEP + 감지 스택 게이트 + 의존성 간선으로 유지 경로 집합을 만든다. 경로는 prune이
이해하는 확장 granularity(디렉토리 단위 또는 docs/rules/code-convention/dev-stack-*.md 파일 단위)로 쓴다.
ALWAYS-KEEP (스택 무관, 반드시 keep-list 포함)
install.sh prune의 PROTECTED 정규식이 자동 보호하는 것(hooks 코어·settings.json·safety.md·
common/*·CLAUDE.md·AGENTS.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 감지 시에만.
언어팩 (스택 자산은 팩 단위로만 넣고 뺀다 — 경로를 손으로 고르지 않는다)
스택별 규칙·스택 정의(.claude/stacks/<pack>.sh)·채점 어댑터·골든셋 스타터·judge 예시·LSP 토글은
packs/<name>.pack이 한 세트로 묶는다. 감지 결과와 설치 기록을 대조해 add/remove 제안만 만든다:
bash install.sh pack list # 팩 | 설치 | 감지 | 요약 (누락 경로 표시)- 감지 ✓ · 설치 ✗ →
ADD: install.sh pack add <name>(규칙+게이트+스타터가 함께 온다) - 감지 ✗ · 설치 ✓ →
PRUNE: install.sh pack remove <name>(백업 →rollback복원) database팩은 ORM 의존성(prisma·drizzle·typeorm·sqlalchemy·JPA·gorm·diesel·sqlx…)으로 감지된다.- 팩 경로는 keep-list/prune 대상에서 제외한다 —
pack remove가 manifest·harness-packs·LSP까지 정리한다. 경로 단위로 자르면 반쪽 팩(규칙만 남고 스택 파일 없음)이 되고harness-auditAUDIT-09가 FAIL한다.
하드 의존성 간선 (묶어서 keep 또는 prune — 절대 분리 금지)
- eval-java ⟷ archunit: 둘 다
java-spring팩 안에 있다 — 팩 단위 add/remove면 자동으로 함께 움직인다. 경로 단위로 한쪽만 남기면harness-auditAUDIT-08/09 FAIL. - fable:
workflows/fable-team-pipeline.js⟷agents/fable-*(4) +docs/md/orchestration.md+docs/md/fable-team-guide.md. 함께. - review ⟷ 리뷰어:
commands/review.md(ALWAYS-KEEP)가security-reviewer를 참조 → 이 에이전트 keep.
소형 단일 스택: 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. 적용 (승인된 것만, 순서 고정)
- FIX: 사용자가 승인한 CLAUDE.md/AGENTS.md 수정만 부분 편집(Edit). 3파일 공유 축을 고쳤으면 세 파일 모두 동기화한다(정합성 전수 점검). 미승인 항목은 건드리지 않는다.
- ADD(복구): 승인 시
install.sh rollback또는update로 하네스 구성 복구. 외부 도구는 명령만 제시 (임의 설치 실행 금지). 스캐폴딩은 승인분만 append. - 언어팩: 승인된 제안대로
bash install.sh pack add <name>/pack remove <name>. 팩이 아닌 구성(fable 오케스트레이터·에이전트·스킬)만 다음 단계의 prune으로 다룬다. - PRUNE(팩 외): KEEP 경로를
mktemp파일에 1줄씩 기록(PROTECTED 포함 무방, 최소한 비보호 ALWAYS-KEEP· 의존성 keep 포함, 팩 경로도 keep에 넣어 손대지 않는다) →bash install.sh prune --keep-list <tmp>.- prune이 manifest 확장 → keep-list 밖 비보호 파일을
logs/harness-backup/에 백업 후 제거 → manifest 갱신.
- prune이 manifest 확장 → keep-list 밖 비보호 파일을
8. 검증 + evaluator 평가표
bash .claude/hooks/harness-audit.sh— exit 0(전 항목 pass) 필수. FAIL이면(orphan 정책 — gateway 규칙 남았는데 트리거 없음, eval-java↔archunit 불일치 등) 즉시bash install.sh rollback안내하고 중단 보고. 임의 추가 삭제 금지.- evaluator 독립 평가표:
evaluator서브에이전트를 띄워(생성/검증 분리) 적용 결과를 완료기준(SC) 대비 독립 채점하게 한다. 평가 축과 SC:- 스택 커버리지: 감지 스택마다 대응 규칙이 존재하는가(누락=감점).
- 설정 정합성: FIX 후 깨진 @참조·glob·3파일 불일치가 0인가.
- 게이트 실효성: 스택 린터/포맷터·테스트가 갖춰져 Stop 게이트가 실제로 무는가.
- 절단 안전성:
harness-audit0 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을 다룬다 — 미설치면 manifest에 없어 자동으로 건너뛴다.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

