| name | harness-gate |
| description | 커밋 전 최종 품질 게이트. aggregate-verdict 확인 + 프로젝트별 빌드/타입체크/린트를 종합 검증합니다. '/harness-gate', 'harness gate', '품질 게이트', '커밋 전 검증' 요청 시 사용 — harness-workflow gate 단계(references/gate.md — 구 jira-test·jira-commit 흡수) 내부의 최종 게이트. |
/harness-gate — Pre-commit 품질 게이트
위치: harness-workflow ⑧ gate 단계의 2번째 관문 (테스트 → 본 게이트 → DoD → commit, harness-workflow/references/gate.md 참조 — 구 /jira-commit 의 DoD 검증은 gate 단계로 흡수됨). 더 엄격한 Harness 품질 기준 적용.
참조: ~/.claude/docs/HARNESS-JIRA-ORTHOGONAL-ARCHITECTURE.md
⛔ Guard — HARNESS_MODE 확인 (최우선)
이 스킬의 모든 단계보다 먼저 실행. SSoT: ~/.claude/skills/_harness-guard.md — HARNESS_MODE 가 미설정/빈값/off 면 즉시 중단(안내 출력 후 이후 단계 실행 금지), suggest/auto 면 정상 진행.
절차
Step 1. Aggregate Verdict 확인
.claude/runtime/aggregate-verdict.md를 읽는다.
| 상태 | 동작 |
|---|
| 파일 없음 | "⚠️ /harness-review를 먼저 실행하세요" 경고 후 Step 2로 진행 |
| verdict = PASS | Step 2로 진행 |
| verdict = ITERATE | "🔴 Blocker 미해결. 커밋 불가." 차단 |
| verdict = ESCALATE | "🔴 재계획 필요. /harness-plan 재실행." 차단 |
Step 2. 빌드 검증 (cwd 우선 + 스택 fallback)
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 | (스킵 + 경고) | "스택 감지 실패 — 빌드 검증 생략" 표시 |
빌드 실패 시 차단 + 에러 메시지 출력.
Step 3. Sprint Contract DoD 체크
Sprint Contract (.claude/runtime/sprint-contract/PROJ-XXX.md)가 있으면:
- "Definition of Done" 섹션의 체크박스 상태 확인
- 미완료 항목이 있으면 경고 (차단은 아님)
Step 4. 최종 판정
| 조건 | 결과 |
|---|
| Aggregate PASS + 빌드 성공 | ✅ GATE PASS — 커밋 진행 가능 |
| Aggregate PASS + 빌드 실패 | 🔴 빌드 수정 후 재시도 |
| Aggregate 없음 + 빌드 성공 | ⚠️ 리뷰 없이 커밋 가능 (경고만) |
| Aggregate ITERATE/ESCALATE | 🔴 차단 |
Step 5. Shared State 갱신 (Read-Merge-Write 필수)
판정 완료 직후 반드시 실행:
- Read:
.claude/runtime/workflow-state.json을 Read.
- Merge: 기존 필드 보존하며 다음 갱신:
{
"stage": "<gate-passed|gate-blocked>",
"gate_verdict": "<PASS|BLOCKED>",
"gate_reason": "<빌드 성공/실패, verdict 상태 요약>",
"gated_at": "YYYY-MM-DDTHH:MM:SS"
}
- Write: 병합한 JSON을 Write로 저장.
Step 6. 출력
══════════════════════════════════
Harness Quality Gate
Aggregate: PASS ✅
Build: PASS ✅
DoD: 3/4 completed ⚠️
→ 커밋 진행 가능합니다.
══════════════════════════════════
주의사항
- /jira-commit의 기존 DoD 검증과 독립 — 이중 체크가 되어도 충돌 없음
- 빌드 실패 시 프로젝트 에이전트 제안 (있는 경우):
- app-ha-back:
haback-build-resolver
- cs-back: (build-resolver 에이전트 없음 — 수동 해결)
- cs-front: (build-resolver 에이전트 없음 — 수동 해결)
HARNESS_MODE=off일 때는 이 스킬을 제안하지 않음
