claude-code-harness
SHA-256Claude Code를 위해 설계된 구조화된 개발 프로세스 오케스트레이션 도구로, "계획-실행-검토-배포" 사이클을 통해 AI 에이전트의 통제 불능을 방지하고 코드 품질 및 감사 가능성을 보장합니다.
Claude Code에 고삐를 채워 AI 코딩이 자유로운 대화에서 반복 가능한 전달 파이프라인으로 변신하게 하다.
주요 기능
- Plan→Work→Review→Release 4단계 사이클을 강제하여 AI 에이전트가 임의로 작동하는 것을 방지합니다.
- spec.md와 Plans.md를 사실 출처로 자동 생성하며, 모든 작업은 승인된 계획을 기반으로 합니다.
- 구현 단계에서 TDD(테스트 주도 개발)를 강제하고, 검토와 구현을 분리하여 품질을 보장합니다.
- 릴리스 전에 변경 로그, 태그 경계 및 증거 완전성을 자동으로 확인합니다.
- 네이티브 Go로 구현되어 Node.js가 필요 없으며, 가볍고 크로스 플랫폼입니다.
할 수 없는 것
- •이 프로젝트는 Claude Code v2.1+에서만 적용 가능하며, 다른 호스트(예: Codex CLI, OpenCode)의 지원 수준은 내부 호환 또는 후보 단계이므로 프로덕션 환경에서 완전히 동일한 경험을 기대하지 마십시오.
- •/harness-work all은 계획이 명확하고 리포지토리 베이스라인이 알려진 경우에만 사용해야 하며, 그렇지 않으면 혼란을 초래할 수 있습니다.
- •harness-mem은 선택적 교차 세션 메모리 구성 요소로, 별도로 구성하고 상태를 확인해야 합니다. 구성되지 않은 경우 기능이 손실되지 않습니다.
- •Harness가 제공하는 명령을 대체하기 위해 raw(예: raw codex exec)를 직접 사용하지 마십시오. 그렇지 않으면 구조화된 검토 및 증거 패키징을 얻을 수 없습니다.
사용 사례
- 고품질 코드의 AI 보조 개발 프로젝트가 필요하며, AI가 임의로 코드를 작성하거나 테스트를 누락하는 것을 피하고자 합니다.
- 팀 협업 시 AI가 생성한 코드에 대한 구조화된 승인 및 감사가 필요합니다.
Claude Code Harness는 Go 기반의 경량 개발 프로세스 오케스트레이션 도구로, Claude Code 및 호환 AI 코딩 어시스턴트를 위해 설계되었습니다. 이 도구는 "계획 → 구현 → 검토 → 릴리스"의 반복 가능한 주기를 강제하여, 기존 AI 에이전트에서 흔히 발생하는 "계획 누락, 테스트 선택적, 검토 지연" 등의 문제를 방지합니다. 핵심 메커니즘은 spec.md와 Plans.md를 사실의 근거로 삼아 승인된 작업에 TDD(테스트 주도 개발)를 강제하고, 검토와 구현을 분리하며, 검증된 증거만 PR 또는 릴리스에 패키징하는 것입니다. Claude Code, Codex CLI, OpenCode 등 다양한 호스트를 플러그인이나 스크립트를 통해 지원합니다. Superpowers, Hermes Agent 등 더 무거운 도구와 비교하여 Harness는 더 가볍고(5개의 핵심 동사 명령만 있음), Node.js에 의존하지 않으며, "관찰되지 않았다고 존재하지 않는 것이 아니다"라는 엄격한 원칙을 따라 AI가 데이터를 임의로 생성하는 것을 방지합니다. 예측 가능성과 감사 가능성을 중시하는 개인 또는 팀에 적합합니다.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
Claude Code에서 /plugin marketplace add Chachamaru127/claude-code-harness 실행
/plugin install claude-code-harness@claude-code-harness-marketplace 실행
/harness-setup 실행하여 초기화 완료
- Claude Code에서 /plugin marketplace add Chachamaru127/claude-code-harness 실행
- /plugin install claude-code-harness@claude-code-harness-marketplace 실행
- /harness-setup 실행하여 초기화 완료
SHA-256 체크섬 확인됨
GitHub 공식 Release 페이지에서 추출된 체크섬
SHA256 체크섬
f938a7f58cb7b10ff902d2969b9d8b198811e8e5f87ead178e39d758adef810e이 체크섬은 GitHub Release 페이지에서 추출되었습니다. 다운로드 후 파일 무결성을 확인하세요.
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
Claude Code에서 /plugin remove claude-code-harness를 실행하여 플러그인을 삭제한 다음, 프로젝트 디렉터리에서 harness가 생성한 .harness, spec.md, Plans.md 등 파일을 수동으로 삭제합니다(선택 사항). harness-mem을 사용한 경우 bin/harness doctor --migration-report를 실행하여 잔여 파일을 확인한 후 정리하십시오.
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
5 FAQs