claude-ai-native-harness은(는) 무엇을 하나요?
전역 ~/.claude/ 하네스 — RPI(연구→계획→구현→종료) 사이클, 결정론적 프로젝트 부트스트랩, 5개의 훅 + 4개의 오케스트레이터 스킬 + 3개의 래퍼 서브 에이전트를 통한 AI 실패 추적을 강제합니다. 크로스 플랫폼(Windows/WSL/Linux).
개요
이 하네스는 AI 에이전트(예: Claude Code)가 일관되고 체계적인 워크플로우를 따르도록 보장합니다. 이는 RPI 사이클을 통해 연구, 계획, 구현, 종료 단계로 구성됩니다. 각 단계는 작업의 완전성과 품질을 보장하는 특정 훅에 의해 추진됩니다.
주요 기능
- RPI 사이클 강제: 모든 작업은 Research → Plan → Implement → Closeout 단계를 거칩니다.
- 결정론적 부트스트랩: 새 프로젝트를 예측 가능한 초기 상태로 시작합니다.
- AI 실패 추적: 실패 지점과 원인을 기록하여 악순환을 방지합니다.
- 확장 가능한 훅: 5개의 내장 훅으로 워크플로우를 사용자 정의할 수 있습니다.
- 오케스트레이터 스킬: 4개의 오케스트레이터 스킬이 RPI 사이클을 조정합니다.
- 래퍼 서브 에이전트: 3개의 특수 서브 에이전트가 특정 작업을 처리합니다.
- 크로스 플랫폼: Windows, WSL2, Linux에서 동일하게 작동합니다.
설치
# 저장소 복제
gh repo clone Easy-T/claude-ai-native-harness ~/.claude
# 또는 직접 복사
cp -r claude-ai-native-harness/* ~/.claude/
사용법
기본 명령
# 새 프로젝트 부트스트랩
claude bootstrap <프로젝트명>
# RPI 사이클 시작
claude rpi start
# 현재 상태 확인
claude status
훅 참조
| 훅 이름 | 트리거 | 설명 |
|---|---|---|
pre-research | Research 단계 전 | 컨텍스트 로드 |
post-plan | Plan 단계 후 | 계획 검증 |
pre-implement | Implement 전 | 환경 설정 |
post-implement | Implement 후 | 변경 사항 검증 |
pre-closeout | Closeout 전 | 최종 점검 |
오케스트레이터 스킬
- Research Orchestrator (
orchestrator-research): 정보 수집 및 분석 - Plan Orchestrator (
orchestrator-plan): 작업 분할 및 일정 수립 - Implement Orchestrator (
orchestrator-implement): 코드 생성 및 수정 지시 - Closeout Orchestrator (
orchestrator-closeout): 완료 검증 및 문서화
래퍼 서브 에이전트
- Failure Tracker (
wrapper-failure-tracker): 실패 로그 수집 및 분석 - Context Manager (
wrapper-context-manager): 세션 간 컨텍스트 유지 - Bootstrap Helper (
wrapper-bootstrap-helper): 프로젝트 초기 설정 지원
환경 변수
| 변수 | 기본값 | 설명 |
|---|---|---|
CLAUDE_HARNESS_DIR | ~/.claude/ | 하네스 루트 디렉토리 |
CLAUDE_RPI_ENABLED | true | RPI 사이클 활성화 |
CLAUDE_FAILURE_TRACKING | true | 실패 추적 활성화 |
CLAUDE_DEBUG | false | 디버그 모드 |
지원 플랫폼
- Windows: PowerShell 5.1+ 또는 PowerShell Core 7+
- WSL: Ubuntu 20.04+ 기반 WSL2
- Linux: 모든 주요 배포판 (Ubuntu, Debian, Fedora, Arch)
문제 해결
로그 확인
cat ~/.claude/harness.log
실패 기록 보기
claude failures list
특정 프로젝트 재부트스트랩
claude bootstrap --force <프로젝트명>
기여
기여를 환영합니다! 다음을 확인하세요:
- 이슈 트래커에서 기존 이슈 검색
- RPI 사이클 문서 읽기
- 훅을 수정하거나 새 훅 추가
- Pull Request 제출
라이선스
MIT