菜单
커밋 전 최종 품질 게이트. aggregate-verdict 확인 + 프로젝트별 빌드/타입체크/린트를 종합 검증합니다. '/harness-gate', 'harness gate', '품질 게이트', '커밋 전 검증' 요청 시 사용 — 커밋 직전 최종 게이트(jira-commit 의 DoD 검증과 독립).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | harness-gate |
| description | 커밋 전 최종 품질 게이트. aggregate-verdict 확인 + 프로젝트별 빌드/타입체크/린트를 종합 검증합니다. '/harness-gate', 'harness gate', '품질 게이트', '커밋 전 검증' 요청 시 사용 — 커밋 직전 최종 게이트(jira-commit 의 DoD 검증과 독립). |
직교 원칙: /jira-commit의 DoD 검증과 독립. 더 엄격한 Harness 품질 기준 적용. 참조: ~/.claude/docs/HARNESS-JIRA-ORTHOGONAL-ARCHITECTURE.md
이 스킬의 모든 단계보다 먼저 실행. SSoT:
~/.claude/skills/_harness-guard.md—HARNESS_MODE가 미설정/빈값/off면 즉시 중단(안내 출력 후 이후 단계 실행 금지),suggest/auto면 정상 진행.
.claude/runtime/aggregate-verdict.md를 읽는다.
| 상태 | 동작 |
|---|---|
| 파일 없음 | "⚠️ /harness-review를 먼저 실행하세요" 경고 후 Step 2로 진행 |
| verdict = PASS | Step 2로 진행 |
| verdict = ITERATE | "🔴 Blocker 미해결. 커밋 불가." 차단 |
| verdict = ESCALATE | "🔴 재계획 필요. /harness-plan 재실행." 차단 |
cwd가 알려진 프로젝트와 매칭되면 그 명령을 우선 사용하고, 매칭되지 않으면 스택을 감지하여 기본 명령을 실행한다. 이 분기는 새 프로젝트(Flutter, 다른 백엔드 등)에서도 게이트가 의미 있게 동작하도록 만들기 위함이다.
알려진 프로젝트 (우선)
| 프로젝트 | 명령어 |
|---|---|
| app-ha-back | ./gradlew compileJava -q |
| cs-back | ./gradlew.bat compileJava -q |
| cs-front | npx vue-tsc --noEmit (타입 체크만, 빌드 아님) |
Stack-based Fallback (cwd가 위에 매칭 안 되거나 알 수 없을 때)
CLAUDE.md에 빌드/타입체크 명령이 명시되어 있으면 그것을 우선 사용한다. 없으면 다음 기본:
| 스택 | 기본 명령 | 비고 |
|---|---|---|
| Spring Boot (Gradle) | ./gradlew.bat compileJava -q (Windows) 또는 ./gradlew compileJava -q | gradlew 존재 우선 |
| Spring Boot (Maven) | mvn -q compile | |
| Vue/React/Angular | npx tsc --noEmit 또는 npm run typecheck | package.json scripts 우선 |
| Flutter | flutter analyze --no-pub | |
| Go | go build ./... | |
| Rust | cargo check | |
| Python | mypy . 또는 python -m py_compile **/*.py | mypy 설정 있을 때 우선 |
| unknown | (스킵 + 경고) | "스택 감지 실패 — 빌드 검증 생략" 표시 |
빌드 실패 시 차단 + 에러 메시지 출력.
Sprint Contract (.claude/runtime/sprint-contract/SURINP-XXX.md)가 있으면:
| 조건 | 결과 |
|---|---|
| Aggregate PASS + 빌드 성공 | ✅ GATE PASS — 커밋 진행 가능 |
| Aggregate PASS + 빌드 실패 | 🔴 빌드 수정 후 재시도 |
| Aggregate 없음 + 빌드 성공 | ⚠️ 리뷰 없이 커밋 가능 (경고만) |
| Aggregate ITERATE/ESCALATE | 🔴 차단 |
판정 완료 직후 반드시 실행:
.claude/runtime/workflow-state.json을 Read.{
"stage": "<gate-passed|gate-blocked>",
"gate_verdict": "<PASS|BLOCKED>",
"gate_reason": "<빌드 성공/실패, verdict 상태 요약>",
"gated_at": "YYYY-MM-DDTHH:MM:SS"
}
══════════════════════════════════
Harness Quality Gate
Aggregate: PASS ✅
Build: PASS ✅
DoD: 3/4 completed ⚠️
→ 커밋 진행 가능합니다.
══════════════════════════════════
haback-build-resolverHARNESS_MODE=off일 때는 이 스킬을 제안하지 않음Jira 개발 가이드(dev-guide)를 읽고 Sprint Contract를 보충 생성합니다. /jira-plan 이후에 실행하여 DoD, Verify Targets, Out of Scope를 명시화합니다. '/harness-plan', 'harness plan', 'Sprint Contract 만들어줘', '계획 보충' 요청 시 사용.
이전 세션의 체크포인트를 복원하여 작업을 이어갑니다. workflow-state.json과 checkpoint.md를 읽어 중단된 단계부터 재개합니다. '/harness-resume', 'harness resume', '이어서 작업', '이전 작업 복원' 요청 시 사용.
코드 변경 사항에 대해 프로젝트별 전문 에이전트를 병렬 fan-out으로 리뷰하고 종합 verdict(PASS/ITERATE/ESCALATE)를 생성합니다. '/harness-review', 'harness review', 'harness 리뷰', '품질 리뷰' 요청 시 사용.
Post-merge VALID/INVALID 채점 — 머지 후 7일 이상 경과한 이슈의 aggregate-verdict.md에 사후 평가를 기록합니다. Harness의 catch rate/false positive rate 측정에 사용. 자기 채점 편향 방지를 위해 별도 세션에서 외부 증거와 함께 수행. '/harness-score', 'harness score', '사후 평가', 'post-merge scoring', 'catch rate 측정' 요청 시 사용.
AI Agent Harness Engineering infrastructure auto-provisioner. Detects project stack (Spring Boot, Vue, React, etc.) and generates project-scoped agents, hooks, settings, CLAUDE.md rules, runtime directories, and metrics infrastructure. Idempotent — safely run on new or partially configured projects; only adds what's missing. Use this skill whenever: the user says 'harness setup', 'set up harness', 'configure harness', 'harness-setup', 'add harness to project', 'init harness', 'harness 설정', 'harness 구성', 'harness 초기화', 'harness 세팅', 'new project harness', 'upgrade harness', 'check harness status', 'harness check'. Also trigger when user asks to add agents, hooks, or quality gates to a project even without explicitly saying 'harness'.
Shadow run 프로토콜 — HARNESS_MODE=off로 baseline Claude만의 리뷰와 Harness full-run을 비교하여 counterfactual lift를 측정합니다. 5개 이슈 중 1개 권장 주기. Harness가 baseline을 능가하는지 경험적 증거 수집. '/harness-shadow', 'harness shadow', 'shadow run', 'counterfactual lift', 'baseline 비교' 요청 시 사용.