菜单
Jira 개발 가이드(dev-guide)를 읽고 Sprint Contract를 보충 생성합니다. /jira-plan 이후에 실행하여 DoD, Verify Targets, Out of Scope를 명시화합니다. '/harness-plan', 'harness plan', 'Sprint Contract 만들어줘', '계획 보충' 요청 시 사용.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | harness-plan |
| description | Jira 개발 가이드(dev-guide)를 읽고 Sprint Contract를 보충 생성합니다. /jira-plan 이후에 실행하여 DoD, Verify Targets, Out of Scope를 명시화합니다. '/harness-plan', 'harness plan', 'Sprint Contract 만들어줘', '계획 보충' 요청 시 사용. |
직교 원칙: /jira-plan의 dev-guide.md를 수정하지 않는다. 별도의 Sprint Contract를 생성하여 보충한다. 참조: ~/.claude/docs/HARNESS-JIRA-ORTHOGONAL-ARCHITECTURE.md
이 스킬의 모든 단계보다 먼저 실행. SSoT:
~/.claude/skills/_harness-guard.md—HARNESS_MODE가 미설정/빈값/off면 즉시 중단(안내 출력 후 이후 단계 실행 금지),suggest/auto면 정상 진행.
현재 작업 디렉토리(cwd)를 기반으로 프로젝트를 식별한다. 알려진 프로젝트가 매칭되면 그 컨텍스트를 우선 사용하고, 매칭되지 않으면 스택 감지로 폴백하여 임의의 프로젝트(Flutter 앱, 다른 백엔드 등)에서도 동작하게 한다.
알려진 프로젝트 (우선 매칭)
| cwd 패턴 | 프로젝트 | 스택 | 비고 |
|---|---|---|---|
app-ha-back | app-ha-back | Spring Boot | IdeaProjects 하위 |
cs-back | cs-back | Spring Boot | newIdeaWorkSpace 하위 |
cs-front | cs-front | Vue 3 | newIdeaWorkSpace 하위 |
Fallback (cwd가 위에 매칭되지 않을 때) — 스택 감지
| 감지 파일 | 스택 | 비고 |
|---|---|---|
pubspec.yaml | Flutter/Dart | StudioProjects 하위 등 |
build.gradle 또는 pom.xml | Spring Boot (일반) | |
package.json + vue 의존성 | Vue.js (일반) | |
package.json + react/next 의존성 | React/Next.js | |
go.mod | Go | |
Cargo.toml | Rust | |
pyproject.toml 또는 requirements.txt | Python | |
| 기타 | unknown | 사용자에게 스택 확인 요청 |
이슈 키를 다음 순서로 탐색:
/harness-plan PROJ-200).claude/runtime/workflow-state.json의 issue_key[A-Z]+-[0-9]+ 패턴 추출 (예: feature/PROJ-200-* → PROJ-200). Jira project key는 프로젝트마다 다르므로(SURINP/SCRUM/PROJ 등) prefix를 고정하지 않는다.dev-guide 파일은 프로젝트마다 위치 컨벤션이 다를 수 있어 다음 후보 경로를 순차 확인한다(첫 번째 존재하는 파일을 사용):
docs/<ISSUE-KEY>-dev-guide.md (cs-back 컨벤션 — 가장 흔함).claude/docs/<ISSUE-KEY>-dev-guide.md (cs-front 컨벤션).claude/docs/reference/<ISSUE-KEY>-*.md (app-ha-back 컨벤션).claude/docs/<ISSUE-KEY>/dev-guide.md (디렉토리 형식 컨벤션)<ISSUE-KEY>는 Step 1에서 확정된 키 — prefix 무관하게 동작한다.
dev-guide가 없으면 경고 출력 후 Jira MCP에서 이슈 본문을 직접 읽어 Contract를 생성한다.
플래너/탐색 에이전트가 존재하면 Agent tool로 위임하여 코드베이스 탐색을 격리한다. 에이전트 이름은 프로젝트 접두사 컨벤션을 따른다:
haback-explorer (haiku)cs-explorer 또는 cs-plannercs-front-planner.claude/agents/ 안에서 *-explorer 또는 *-planner 패턴으로 탐색하여 발견되면 사용에이전트가 없으면 메인 세션에서 직접 탐색한다.
dev-guide를 읽고 다음 고정 스키마의 Sprint Contract를 생성한다:
# SURINP-XXX Sprint Contract
> 보충 문서 — 원본: [dev-guide 경로]
> 생성: /harness-plan
> 일시: YYYY-MM-DD
## Definition of Done
- [ ] 검증 가능한 행동 1 (테스트 또는 수동 검증으로 매핑)
- [ ] 검증 가능한 행동 2
- ...
## Files to Change (산출물 계약)
| Path | 변경 종류 | Risk |
|------|----------|------|
| src/.../XxxService.java | 수정 (+N/-M) | Medium |
## Verify Targets (Evaluator 지정)
> 프로젝트의 verify-* 스킬 중 해당되는 것 나열
- verify-cqrs-service-split (서비스 분리 대상 시)
- verify-n1-optimization (Repository 변경 시)
- ...
## Phase 분할 (dev-guide 기반)
> dev-guide의 구현 단계를 Phase로 매핑
- Phase 1: ...
- Phase 2: ...
## Out of Scope (스코프 드리프트 방지)
- 이 이슈에서 하지 않는 것을 명시
## Context Handoff
- Reference: [관련 레퍼런스 문서 경로]
- Memory: [관련 메모리 파일]
5.1 Sprint Contract 파일 저장
저장 경로: .claude/runtime/sprint-contract/SURINP-XXX.md
5.2 workflow-state.json 갱신 (누락 금지)
반드시 다음 3단계를 순서대로 실행:
.claude/runtime/workflow-state.json 파일이 존재하면 Read로 읽는다.{
"issue_key": "SURINP-XXX",
"stage": "plan-supplement",
"dev_guide_path": "<감지된 dev-guide 경로>",
"sprint_contract_path": ".claude/runtime/sprint-contract/SURINP-XXX.md",
"updated_at": "YYYY-MM-DDTHH:MM:SS"
}
파일이 존재하지 않으면: .claude/runtime/workflow-state.template.json을 읽어 템플릿 기반으로 새로 생성한 후 위 필드를 채운다.
절대 원칙: 이 스킬은 workflow-state.json 갱신을 건너뛰지 않는다. 갱신 없이 종료하면 /harness-gate와 /harness-resume이 stale 데이터를 읽게 되어 전체 Harness 무결성이 깨진다.
Sprint Contract의 핵심 3가지만 요약:
사용자가 /harness-plan <KEY> --subtasks 로 호출 시:
<runtime>/sprint-contract/<KEY>.md) 작성 — 단일 contract 에 slice 별 DoD 인라인 구조 (### 통합 DoD + ### Slice 별 DoD)workflow-state.json 에 subtasks_mode: true + subtasks: [...] + slice_status: {...} 기록자세한 정책: ~/.claude/skills/_subtasks-convention.md § 3
커밋 전 최종 품질 게이트. aggregate-verdict 확인 + 프로젝트별 빌드/타입체크/린트를 종합 검증합니다. '/harness-gate', 'harness gate', '품질 게이트', '커밋 전 검증' 요청 시 사용 — 커밋 직전 최종 게이트(jira-commit 의 DoD 검증과 독립).
이전 세션의 체크포인트를 복원하여 작업을 이어갑니다. 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 비교' 요청 시 사용.