Claude Code Harness Portable

Claude Code 멀티에이전트 하네스 이식 패키지

이 패키지는 Claude Code 멀티에이전트 하네스를 **어느 연구/개발 도메인에서도** 사용할 수 있도록 이식 가능한 형태로 묶은 것입니다. 세 개의 스크립트(`install.sh` → `setup-claude.sh` → `init-project.sh`)를 순서대로 실행하면 멀티에이전트 파이프라인이 갖춰집니다.

---

개요

이 하네스는 **Research Team**(연구 합의)과 **Dev Team**(구현 검증)을 **Chief Orchestrator**가 순차 기동하는 3계층 하이브리드 멀티에이전트 시스템입니다.

역할	구성	하는 일
Chief Orchestrator	스킬(1인)	요구사항 번역, 팀 간 핸드오프 감독, 통합 보고
Research Team	4인 에이전트 팀	SOTA 탐색, 실험 가능성 검증, 합의, 시각화
Dev Team	3인 에이전트 팀	코드 분석, 구현, 리뷰

주요 특징:

• 도메인 독립적 — 음성 딥페이크, 자연어 처리, CV 등 어느 분야든 적용 가능
• NotebookLM 기반 논문 분석 파이프라인 내장
• Docker 기반 실험 큐(Experiment Runner) 지원
• Google Drive 원격 공유(remote-share) 지원
• 매일 자동 리서치(daily-research-runner) cron 지원
• ntfy 모바일 알림 내장

---

시스템 요구사항

항목	최소 요구사항
OS	Ubuntu/Debian 20.04+ 또는 macOS
Node.js	v22 이상
Python	3.10 이상 (pip 포함)
셸	bash
기타	tmux, rclone (선택), Google Chrome (nlm 인증용)

---

설치 순서

1단계. 시스템 도구 설치

chmod +x install.sh
bash install.sh

설치 항목:

• tmux (터미널 멀티플렉서)
• rclone (Google Drive 동기화, remote-share 사용 시 필요)
• Node.js 22+
• Google Chrome (NotebookLM headless 인증에 사용)
• rtk (선택적 — 토큰 효율 최적화 도구, 없어도 동작함)

2단계. Claude Code 설치

bash setup-claude.sh

수행 작업:

• npm global prefix 설정 (~/.npm-global)
• @anthropic-ai/claude-code 전역 설치
• claude --dangerously-skip-permissions alias(claude-dangerous) 설정
• claude-recap 설치 (대화 요약 도구)
• notebooklm-mcp-cli(nlm) 설치
• nlm login 실행 (브라우저 Google 계정 인증)
• ntfy 알림 채널 자동 생성 (형식: <프로젝트슬러그>-<랜덤8자>)
• ~/.claude/settings.json 초기 생성

3단계. 프로젝트 초기화

bash init-project.sh

대화형 위저드가 다음 정보를 수집합니다:

1. 도메인 — 예: "음성 딥페이크 탐지", "자연어 처리", "의료 이미지 분석"
2. 프로젝트 슬러그 — 영문 소문자+언더스코어 (예: audio_deepfake)
3. 프로젝트 경로 — 절대 경로 (기본값: 현재 디렉토리)
4. Experiment Runner — Docker 이미지, GPU 수, 데이터셋 경로 등 (선택)
5. Google Drive remote-share — rclone remote 이름, 폴더명 (선택)
6. *daily-research-runner