create-claude-harness

Claude Code 자율 개발 하네스를 한 번에 셋업합니다.

사용법

npx create-claude-harness my-project

기본값으로 즉시 생성:

npx create-claude-harness my-project --yes

기존 프로젝트에 추가:

cd my-project
npx create-claude-harness .

생성되는 파일

my-project/
├── CLAUDE.md              # 에이전트 헌법 (프로젝트 규칙)
├── ARCHITECTURE.md        # 시스템 구조도
├── LESSONS.md             # 실수 학습 노트
├── tests.json             # 기능 체크리스트 (작업 큐)
├── prd.md                 # PRD 태스크 목록
├── progress.md            # 진행 기록
├── ralf.sh                # RALF 자율 개발 루프
├── .claude/
│   ├── settings.json      # 권한 + hooks 설정
│   ├── hooks/             # 안전장치 스크립트 5개
│   ├── rules/             # 조건부 코딩 규칙
│   └── skills/            # implement-next, review-code, cleanup
└── .gitignore             # claude-logs 등

하네스란?

AI 에이전트가 자율적으로 개발하기 위한 구조화된 환경입니다.

• tests.json: "다음에 뭘 해야 하는지" 알려주는 작업 큐
• LESSONS.md: 실수를 반복하지 않는 학습 시스템
• hooks: 위험한 행동을 자동 차단하는 안전장치
• ralf.sh: Claude를 반복 실행하는 자율 루프

RALF 루프 사용법

# tests.json에 기능 추가 → prd.md에 체크리스트 추가 → 실행
tmux new -s ralf "bash ralf.sh 30"

# 빠져나오기 (루프는 백그라운드 계속)
# Ctrl+B → D

# 나중에 확인
tmux attach -t ralf
cat tests.json | jq '.summary'
git log --oneline -20

셋업 후 할 일

1. CLAUDE.md를 프로젝트에 맞게 수정
2. ARCHITECTURE.md에 시스템 구조 작성
3. tests.json에 만들 기능 추가
4. prd.md에 태스크 체크리스트 추가
5. tmux new -s ralf "bash ralf.sh 30" 실행

Author

WJ — LinkedIn

License

MIT