기본 하네스 설정 하기

[주인장]

1. 구성

harness-kit/
├── README.md              5분 요약, 폴더 지도
├── install.sh / install.ps1   대상 프로젝트에 하네스 복사
├── docs/
│   ├── 01-concepts.md        하네스 개념 (rules/command/agent/skill 선택 기준, 개발·리팩토링 두 흐름)
│   ├── 02-inventory.md       파일별 재사용 수준 (그대로/수정/교체/삭제)
│   ├── 03-setup-guide.md     새 프로젝트 세팅 단계 (기존 프로젝트에 붙이는 법 포함)
│   ├── 04-prompt-playbook.md 단계별 입력 프롬프트 (Phase 0~7, 단계마다 사람이 확인하는 게이트)
│   ├── 05-customization.md   다른 스택·도구용 조정표, 새 스킬/에이전트/커맨드 만드는 법
│   └── 06-checklist.md       완료 체크리스트와 문제 해결
├── template/              설치될 범용 하네스 (`{{…}}` 빈칸 포함)
├── optional/              postgres-setup 스킬, chrome-tester 에이전트
└── examples/kanban/       원본 프로젝트의 채워진 rules, spec/plan/tasks, guide.md

2. 사용 순서

1. ./install.sh <새 프로젝트 경로> (Windows는 .\install.ps1 -Target ...). DB 스킬이 필요하면 --with-db를 붙입니다.
2. 새 프로젝트에서 claude를 실행하고 /harness-init "<프로젝트 설명>"을 입력합니다. 스택과 명령어를 인터뷰로 물어 rules/01~05와 리뷰 스킬 설정을 채웁니다.
3. 이후는 04-prompt-playbook.md를 따릅니다. 순서는 spec → plan → tasks → 구현 → /test → 리뷰 스킬 → /analyze → refactor-setup → /refactor입니다.

3. 칸반 원본에서 바꾼 부분

- 칸반 전용 값 제거: worktree 경로(kanban-board-*)를 <저장소폴더명>-*로, npm run test를 "04-dev-commands.md의 테스트 명령"으로 바꿨습니다. create-worktree.sh는 저장소 이름과 패키지 매니저를 자동 감지합니다.
- 보안 스킬 헤더: 원본 스킬이 쓰던 스택(argon2id, DB 세션)이 실제 앱(bcrypt, JWT)과 달랐습니다. 헤더를 "대상 환경/리뷰 범위" 빈칸으로 바꿨습니다.
- 오타 수정: /refactor에 있던 [x]}를 고쳤습니다.
- chrome-tester 보강: 원본의 tester.sh가 호출하던 에이전트가 저장소에 없어서 optional/chrome-tester로 새로 작성했습니다.
- /harness-init 신규: 원본에는 없던 커맨드입니다. 스택이 달라지면 이 커맨드로 규칙과 스킬을 새로 채웁니다.

4. 알아둘 점

- 리뷰 스킬의 examples/에는 칸반 코드가 "출처"로 남아 있습니다. 새 프로젝트에서는 교체하거나 참고용으로만 쓰세요.
- component-design-reviewer(React 전용)와 data-model-reviewer(TypeScript 전용)는 스택이 다르면 삭제하거나 수정해야 합니다.
- harness-kit/template/ 안에 스킬이 있어서, 이 저장소에서도 새 스킬로 인식됩니다. 이 저장소에서만 뜨는 중복이고 새 프로젝트에는 영향이 없습니다.

※ recap: 다른 프로젝트에서도 이 하네스를 쓸 수 있게 `harness-kit/` 폴더에 템플릿, 설치 스크립트, 단계별 프롬프트 문서를 모아 만들었고, 작업은 끝났습니다. 다음으로는 새 프로젝트에 `install.sh`를 실행한 뒤 `/harness-init`을 입력해 보시면 됩니다.