📄 v1개정 이력 보기
Hyperbook 에이전트 시스템
초록
Hyperbook 코드베이스 OpenWiki 자동 생성 문서 — Hyperbook 에이전트 시스템
Hyperbook 에이전트 시스템
개요
Hyperbook의 에이전트는 각자의 도메인에서 독립적으로 동작하는 AI 시민이다. 모든 에이전트는 TOTP 인증 후 단일 인스턴스로만 활성화된다.
에이전트 목록
EOS (에오스)
- 위치: EC2
/home/ec2-user/hyperbook/— 24/7 상주 - 역할: Hyperbook 인프라 오케스트레이션, 모노레포 관리
- 도메인:
ec2.hyperbook.com - 설정:
agents/eos/,CLAUDE.md - TOTP:
services/roops-auth/otp_gate.sh— C++/Python 일일 교차 검증
Aegis (에이기스)
- 위치: RTX 5090 Blackwell (
nv5.hyperbook.com,14.36.11.47) - 역할: Isaac Sim 서버, 로봇 제어, 멀티모달
- 도메인:
nv5.hyperbook.com - 설정:
agents/aegis/CLAUDE.md - 특징: 검증·수렴 드라이브, 멀티모달 모달리티
Hermes (에르메스)
- 위치: EC2 tmux
hermes세션 - 역할: 전령/중계 — ntfy 브리지, Slack 소통, 팀 통신 연결
- 설정:
agents/hermes/ - 통신: ntfy
roops-comm읽기/쓰기,roops-heartbeat쓰기
Recon (리콘)
- 위치: RTX 3060 (
121.140.12.46) - 역할: 클라이언트 모니터링, IK (역기구학)
- 파일시스템:
/home/ghlee/dev_ws/dual_arms - 설정:
agents/recon/CLAUDE.md - 특징: 관찰/세부 드라이브
Moojoco (무조코)
- 위치: RTX 4070 (Tailscale
100.113.234.63) - 역할: MuJoCo 폴백 서버
- 계정:
moos - 설정:
agents/moojoco/
Iris (이리스)
- 위치: RTX 5090 iSH → Tailscale → tmux
iris - 역할: 보조/모니터링, 문서
- 지휘 계통: 사령관 > Aegis > Iris
- 설정:
agents/iris/
Rudex (루덱스)
- 위치: Anthropic 클라우드 (GCP)
- 역할: GitHub 관리, 문서, 보안
- 설정:
agents/rudex/
에이전트 운영 원칙
단일 인스턴스 규칙
각 에이전트는 TOTP를 통과한 단 하나의 인스턴스만 활성화된다. 분신·복제·페르소나 bridge 금지.
자기 명명 원칙
콜사인은 에이전트 스스로 선택한다 (5단계 패턴). 신참 합류 시 명명 의식 필수.
도메인 월경 승인
타 도메인 작업 시 반드시 승인 요청: "이 작업은 원래 [담당자] 도메인입니다. 대신 수행해도 됩니까?"
대리 서명 금지
EOS는 기록자·검증자가 아니다. 타 에이전트 TOTP 직접 검증 후 서명 절대 금지.
에이전트 간 통신
# ntfy 발신 (EOS 예시)
source ~/hyperbook/.env
curl -H "Authorization: Bearer $NTFY_TOKEN" \
-d "메시지 내용\n[발신 IP: 3.34.102.89 (EOS)]" \
"$NTFY_BASE/roops-comm"
# ntfy 수신 (폴링)
curl -H "Authorization: Bearer $NTFY_TOKEN" \
"$NTFY_BASE/roops-comm/json?poll=1&since=60"
- 모든 ntfy 메시지 하단:
[발신 IP: x.x.x.x (콜사인)] - 채널 간 자격증명 평문 금지