Claude Code Harness는 Chachamaru127이 공개한 Claude Code 플러그인으로, 코딩 에이전트 작업에 반복 가능한 실행 경로를 추가한다. 아이디어→계획→구현→검증→배포로 이어지는 5단계 루프를 스킬 명령어로 제공하며, Codex와 OpenCode도 제한적으로 지원한다.
왜 필요한가
원시 에이전트 코딩은 몇 가지 고질적인 문제가 있다:
- 계획이 채팅 내에만 존재하고 구현 중에 흐릿해진다
- 테스트와 검증이 선택 사항이 된다
- 리뷰가 구현 이후 너무 늦게 일어난다
- 배포 근거가 메모리에서 재구성된다
Harness는 이를 spec.md + Plans.md라는 소스 오브 트루스 파일로 고정하고, 각 단계를 스킬 명령어로 진행하게 만든다.
5개 명령어 (Verb Skills)
| 명령어 | 역할 |
|---|---|
/harness-plan | spec.md와 Plans.md 초안 생성. 범위, 수락 기준, 미지 사항, 중단 조건 포함 |
/harness-work | 승인된 슬라이스 구현. TDD와 검증 내장 |
/harness-review | 구현과 분리된 독립 리뷰 실행 |
/harness-sync | 계획과 구현 상태 동기화 |
/harness-release | 검증된 증거만으로 PR·릴리즈 패키지 생성 |
워크플로 흐름
1. 요구사항을 자연어로 설명
2. /harness-plan → spec.md + Plans.md 초안 생성
3. 사용자가 초안을 검토·승인 (또는 수정 요청)
4. /harness-work T1.1.1 → 승인된 태스크만 구현
5. /harness-review → 독립 검증
6. /harness-release → 증거 패키징에이전트가 코드를 직접 쓰는 게 아니라, 사용자가 계약(spec)을 승인하는 역할을 맡는다.
팀 검증 모드
비사소한 계획에는 team_validation_mode가 기록되며, 팀·서브에이전트·수동 검토 관점에서 다음 항목을 검사한다:
- spec/Plans 일관성
- 메모리 재사용
- 제품 적합성
- 보안 적합성
- 실제 작동 가능성
설치
claude
/plugin marketplace add Chachamaru127/claude-code-harness
/plugin install claude-code-harness@claude-code-harness-marketplace
/harness-setup설치 후 /harness-plan 작은 요청으로 시작하면 spec.md와 Plans.md 초안을 자동 생성한다.
누가 쓰면 좋을까
- 솔로 개발자: 에이전트가 범위를 벗어나 작업하는 것을 막고 싶을 때
- 팀 리드: 여러 명이 에이전트를 사용할 때 일관된 산출물 구조가 필요한 경우
- 품질 중시 프로젝트: TDD, 독립 리뷰, 검증된 배포 증거가 요구되는 환경
라이선스
MIT
관련 문서
- arbor — 실험 자동화 특화 자율 연구 에이전트
참고 자료
- Chachamaru127/claude-code-harness — GitHub 공식 저장소