Pane 0
Claude Opus
오케스트레이터
아키텍처를 설계하고 작업을 TASK_ID 기반으로 분해한 뒤, 태그 메시지로 하위 워커에 위임합니다. 최종 판단과 검토를 담당합니다.
N-Pane 아키텍처
기본 구성은 4-Pane(Opus·Sonnet·Haiku·Sonnet-UI)이며, 활용 분야에 따라 Pane 수를 자유롭게 확장할 수 있습니다. 번역 프로젝트라면 언어별 Pane을, 대규모 개발이라면 모듈별 Sonnet Pane을 추가하는 방식입니다.
Pane 1
Claude Sonnet
백엔드 엔지니어
PHP, API, 데이터베이스 구현을 전담하며, 완료 시 1회 보고 후 ACK를 대기합니다. 민감 정보 접근은 제한됩니다.
Pane 2
Claude Haiku
런타임 가디언
구문 검사와 응답 확인을 자동으로 수행하며, PASS 또는 FAIL로 회신합니다. 코드를 직접 수정하지 않습니다.
Pane 3
Claude Sonnet
프론트엔드 엔지니어
HTML, CSS, JavaScript를 전담하며, 백엔드 워커와 독립적으로 병렬 진행됩니다. 완료 시 오케스트레이터에 보고합니다.
사용자 지시 → Opus 설계·위임 → Sonnet 구현·보고 → 자동 체인 → Haiku 검증 → Opus 종결 또는 재위임
핵심 기능
ACK + CLOSE 핸드셰이크
모든 메시지는 수신 즉시 확인 응답이 전송되어 중복 실행을 방지하고 Pane 간 안정적인 전달을 보장합니다.
자동 재시도 + Fallback 라우팅
전송 실패 시 자동으로 재시도합니다. 모든 시도가 실패하면 Fallback Pane으로 우회하며, 최종적으로 오케스트레이터에 에스컬레이션합니다.
주기적 헬스체크 + 자동 재시작
데몬이 각 Pane의 프로세스 상태를 주기적으로 점검합니다. 워커가 응답하지 않으면 자동 재시작을 시도하고, 한도 초과 시 오케스트레이터에 에스컬레이션합니다.
선언형 자동 체인
설정 파일의 선언형 규칙에 따라 파이프라인 단계가 자동으로 트리거됩니다. 태그와 키워드 매칭으로 수동 개입 없이 흐름을 제어합니다.
하이브리드 SDK 구조
Python 데몬(표준 라이브러리만 사용), 셸 스크립트, JSON 설정, 역할 규칙이 하나의 SDK로 통합되어 있습니다. Python, tmux, jq 외 외부 의존성이 없습니다.
DEB/RPM 패키지
RSA/SHA256 서명된 패키지로 배포됩니다. 데몬, 설정 템플릿, 셸 스크립트, 역할 규칙, deploy/undeploy 도구가 포함되어 있습니다.
Bird Nesting
새는 아무 곳에나 내려앉지 않습니다. 머물 자리를 찾고, 둥지를 틀고, 주변을 정리합니다. 하이브리드 하네스 엔진도 마찬가지입니다. 패키지가 서버에 도착하면, 사용자가 하나하나 조립하는 것이 아니라 패키지 스스로가 자기 실행 환경을 갖추는 방식으로 설치가 완료됩니다.
-
1
Bird Landing
서버에 내려앉기
DEB 또는 RPM 패키지가 서버에 전달됩니다. RSA/SHA256 서명을 통해 무결성이 검증된 52개 파일이 지정된 경로에 배치됩니다.
-
2
Bird Nesting
실행 공간 만들기
디렉터리 구조, 로그 경로, 상태 파일, 데이터 디렉터리를 자동으로 생성합니다. 패키지가 자기 자리를 찾고 둥지를 트는 단계입니다.
-
3
Bird Feeding
의존성 채우기
install-check.sh 가 bash, tmux, python3, jq, Claude Code CLI 5개 도구의 존재 여부를 검증합니다. 누락된 의존성이 있으면 안내 메시지를 출력합니다.
-
4
Bird Grooming
권한과 설정 정리
setup-env.sh 가 실행 사용자, tmux 세션명, 프로젝트 루트를 입력받아 harness.local.json 설정 파일을 자동 생성합니다. 실행 권한도 함께 설정됩니다.
-
5
Bird Wake-up
실행 준비 완료
harness-start.sh 가 4-Pane tmux 세션을 기동합니다. 각 Pane에 역할이 자동 배정되며, 하네스 데몬이 2초 폴링을 시작합니다. 이 시점부터 엔진이 자율적으로 동작합니다.
한 줄 정의Bird Nesting이란, 패키지가 서버에 내려앉아 자기 둥지를 만들고 실행 가능한 상태로 스스로 정리되는 설치 방식입니다.
