# Hermes Agent 전수조사 — 학습 가능 항목 전체 리스트업

## 목표
https://github.com/NousResearch/hermes-agent 레포를 **전수조사**하여, 우리 시스템에 학습/도입 가능한 항목을 **빠짐없이** 리스트업한다.

**주의: Top 5, Top 10 같은 임의 제한 금지. 발견되는 모든 항목을 리스트업할 것.**

## 1차 분석 결과 (아누)
아누의 1차 분석은 `/home/jay/workspace/memory/research/hermes-agent-analysis.md`에 있다.
5건만 추출했으나, 이는 속도 분석 결과이므로 **누락이 많을 가능성 높음**.

## 우리 시스템 현황 (비교 기준)
- 조직 구조: `/home/jay/workspace/memory/organization-structure.json`
- 스킬 시스템: `/home/jay/workspace/skills/` (SKILL.md 기반, 50+ 스킬)
- 메모리: MEMORY.md + task-timer.py + daily/ 로그
- 위임: dispatch.py (팀별 자동 위임)
- QC: `/home/jay/workspace/teams/shared/QC-RULES.md`
- 대시보드: `/home/jay/workspace/dashboard/`
- 봇 시스템: `/home/jay/workspace/services/multimodel-bot/`
- 최근 도입: gstack 벤치마킹 (task-847.1) — worktree, 2-pass audit, health score, /retro, /ship 등

## 조사 범위 (전수조사)

### A. 소스코드 전체 분석
레포를 클론하여 모든 디렉토리/파일을 분석:

1. **agent/** (18개 파일) — 에이전트 코어 로직 전체
2. **tools/** (45개 파일) — 모든 도구 구현 분석
3. **skills/** (25개 카테고리) — 내장 스킬 전체 분석
4. **optional-skills/** — 확장 스킬 분석
5. **gateway/** — 멀티 플랫폼 메시징 아키텍처
6. **cron/** — 스케줄링 시스템
7. **honcho_integration/** — 사용자 모델링
8. **acp_adapter/ & acp_registry/** — 에이전트 역량 프로토콜
9. **environments/** — 터미널 백엔드 (Docker, SSH, Daytona, Modal)
10. **docs/** — 문서화 체계
11. **pyproject.toml** — 의존성, 설정 구조
12. **cli-config.yaml.example** — 설정 아키텍처

### B. 각 항목에 대해 평가할 것
- **기능 설명**: 무엇을 하는가 (1~2줄)
- **구현 방식**: 어떻게 구현되어 있는가 (핵심 기술/패턴)
- **우리 시스템 대비 차이**: 우리에게 있는가? 있다면 어떻게 다른가?
- **도입 가치**: 상/중/하 + 이유
- **도입 난이도**: 상/중/하
- **도입 시 영향 범위**: 어떤 파일/시스템에 영향

### C. 분류 체계
아래 카테고리로 분류:
- **Core Agent**: 에이전트 루프, 라우팅, 프롬프트 빌딩
- **Memory & Learning**: 메모리, 검색, 학습, 궤적
- **Skills & Tools**: 스킬 관리, 도구 시스템
- **Security**: 보안, 가드, 인젝션 방지
- **Infrastructure**: 인프라, 배포, 환경
- **UX & Interface**: TUI, 게이트웨이, 멀티플랫폼
- **Analytics & Observability**: 분석, 인사이트, 모니터링

## 산출물
- 리서치 문서: `/home/jay/workspace/memory/research/hermes-agent-full-audit.md`
- 형식: 카테고리별로 모든 항목 정리, 도입 가치 상/중/하 태깅
- 마지막에 "도입 권장 항목 요약" 섹션 (가치 '상' 항목 모아서)

## 작업 방법
1. `git clone https://github.com/NousResearch/hermes-agent.git /tmp/hermes-agent`
2. 디렉토리별 순차 분석 (agent → tools → skills → gateway → 나머지)
3. 각 파일의 핵심 로직 파악 후 평가
4. 결과를 산출물 경로에 작성
5. 클론 정리: `rm -rf /tmp/hermes-agent`

## 주의사항
- ★ 반드시 전수조사. "중요한 것만" 골라내지 말 것. 전체를 보고 빠짐없이 기록
- ★ 우리 시스템과의 차이를 구체적으로 비교 (단순 "유사함" 말고 어떻게 다른지)
- ★ 도입 가치가 '하'인 항목도 리스트에 포함 (전수조사이므로)
- 클론 후 반드시 정리 (디스크 공간)