harness-setup

Files (7)

• SKILL.md
• react.md · references/agent-templates/
• spring-boot.md · references/agent-templates/
• vue.md · references/agent-templates/
• aggregate.py · references/metrics-templates/
• aggregate.sh · references/metrics-templates/
• scorecard.md.tmpl · references/metrics-templates/

SKILL.md (first lines)

# /harness-setup — Harness Engineering 자동 구성

프로젝트에 AI Agent Harness Engineering 인프라를 자동으로 구성한다.
기존 구성이 있으면 감지하여 부족분만 보충한다. 기존 파일은 덮어쓰지 않는다.

> 설계 문서: `~/.claude/docs/HARNESS-SETUP-SKILL-DESIGN.md`

## Scope

사용자의 프롬프트에서 scope를 추출한다:

| Scope | 동작 |
|-------|------|
| **full** (기본) | 감지 → Gap 분석 → 부족분 전체 생성 |
| **check** | 감지 → 상태 보고만 (변경 없음) |
| **upgrade** | 감지 → 최신 표준 대비 diff → 사용자 확인 후 수정 |

scope가 명시되지 않으면 `full`로 간주한다.

## 자연어 파라미터

사용자가 함께 전달할 수 있는 정보. 명시되지 않은 항목은 Step 3 인터뷰에서 질문한다:
- **mode**: HARNESS_MODE 값 (`suggest` / `auto` / `off`)
- **prefix**: 에이전트 이름 접두사 (예: `myapp`, `cs`, `haback`)
- **stack**: 기술 스택 (자동 감지 기본)

### 인터뷰 원칙

이 스킬은 **파일 20개 이상을 생성/수정**하고 **settings.local.json을 변경**한다. 따라서 자동 기본값으로 조용히 넘어가지 않는다.

- 다음 3가지는 **반드시 사용자에게 확인**한다: **mode**, **prefix**, **생성 계획**
- 자동 감지한 값은 **보여주고 확인**을 받는다 (조용히 적용 금지)
- 질문은 **Step 3에서 한 번에 묶어** 물어본다 (drip-drip 금지)
- `scope=check`는 읽기 전용이므로 질문 없음

---

## Step 0. git 확인

```bash
git rev-parse --show-toplevel 2>/dev/null
```

git이 없으면 경고:
```
"⚠️ git 레포가 아닙니다. review-gate 의 worktree 루트 해석과 rollback 기능이 제한됩니다. 계속 진행할까요?"
```
사용자 확인 후 계속.

## Step 1. 스택 감지

아래 순서로 기술 스택을 자동 감지한다:

1. 사용자가 명시한 stack → 그대로 사용
2. 파일 기반 감지:

| 파일 | 스택 | Tier |
|------|------|------|
| `build.gradle` / `build.gradle.kts` | `spring-boot` | 1 (실전 검증) |
| `package.json` + `"vue"` 의존성 | `vue` | 1 (실전 검증) |
| `package.json` + `"react"` 의존성 | `react` | 1 (유사 구조) |
| `pom.xml` | `spring-boot-maven` | 2 |
| `package.json` + `"next"` | `next` | 2 |
| `package.json` + `"angular"` | `angular` | 2 |
| `Cargo.toml` | `rust` | 2 |
| `go.mod` | `go` | 2 |
| `pyproject.toml` / `requirements.txt` | `python` | 2 |
| 기타 | `unknown` | 2 |

3. 감지 불가 → 사용자에게 질문

**Tier 2 스택**은 전문 에이전트 템플릿이 없다. 안내:
```
"이 스택({stack})은 기본 에이전트 3종(explorer + security-reviewer + test-writer)으로 시작합니다.
 프로젝트 운영 후 도메인 에이전트를 추가하는 것을 권장합니다."
```

## Step 2. 기존 Harness 상태 감지

아래 7개 항목을 검사하여 각각의 상태를 기록한다:

| # | 항목 | 확인 방법 |
|---|------|----------|
| D1 | `.claude/settings.local.json` | 파일 존재 + `HARNESS_MODE` + `hooks` 섹션 (**Stop hook 배선이 남아 있으면 legacy — upgrade 제안**) |
| D2 | `.claude/hooks/` (3종) | `harness-context-inject.sh`, `compile-check.sh`, `review-gate.sh` (persist-checkpoint 는 폐기 — 있어도 미배선이 표준) |
| D3 | `.claude/agents/` | 파일 목록 + 접두사 패턴 |
| D4 | `CLAUDE.md` | "Harness" 키워드 포함 섹션 존재 여부 |
| D5 | `.claude/runtime/` | 디렉토리 + 하위 구조 |
| D6 | legacy 잔재 | `harness-metrics/`(사장 — archive 이관 제안) · review-gate 에 `exit 1` 차단 분기(구 결함판 — upgrade 필수) |
| D7 | 글로벌 harness 스킬 | `~/.claude/skills/harness-workflow/SKILL.md` 존재 (유일 진입점 — ADR-106) |

## Step 3. 인터뷰 (분기)

### scope=check

읽기 전용. 보고서 출력 후 종료:

```
Harness Status: {project} ({stack}, {mode})
✅ settings  ✅ hooks(4/4)  ⚠️ agents(4/7)  ❌ rules  ✅ runtime  ✅ metrics
→ 부족: agents 3종, rules
→ /harness-setup full 실행 시 자동 보충됩니다
```

**추가 질문 없이 종료.**

### scope=full / upgrade — 통합 인터뷰

감지 결과와 제안을 한 번에 보여주고 사용자 확인을 받는다:

```
🔍 감지 결과
─────────────────────────────────────
Project:  {project_dir_name}
Stack:    {detected_stack} ({gradle/maven/vite 등})
Git:      ✅ (branch: {current_branch}) / ❌
기존 구성: settings={Y/N}, hooks={N/4}, agents={N}개 ({prefix}-*)

─────────────────────────────────────

From bigbulgogiburger/claude_jira_harness, MIT.

More from bigbulgogiburger/claude_jira_harness