# Hermes Agent 학습 항목 체계적 도입 (한정승인)

## 배경
- task-851.1에서 Hermes Agent 전수조사 완료: 197개 항목, 가치 '상' 15개, '중' 25개
- 전수조사 리포트: `/home/jay/workspace/memory/research/hermes-agent-full-audit.md`
- 소스 코드: `/tmp/hermes-agent/` (기존 클론)

## 목표
가치 '상' 15개 + '중' 25개 = **총 40개 항목**에 대해:
1. 우리 시스템에 어떻게 도입할지 **체계적 학습 방안** 수립
2. 실행 가능한 것부터 **순차 구현**

## ★ 한정승인 — 자율 체이닝
이 작업은 **한정승인**입니다. Phase를 알아서 나누고, 각 Phase 완료 후 다음 Phase로 자율 진행.
중간보고 3줄 이내, 최종 완료 시 전체 통합 보고.

## Phase 구조 제안 (팀장 재량으로 조정 가능)

### Phase 1: 도입 방안 설계서 작성
- 40개 항목 각각에 대해:
  - **우리 시스템 현재 상태** (이미 있는지, 유사한 게 있는지)
  - **도입 방식** (신규 구축 / 기존 코드 확장 / 설정만 추가)
  - **구현 난이도** (시간 추정, 의존성)
  - **구현 순서** (의존성 기반 토폴로지컬 정렬)
- 산출물: `/home/jay/workspace/memory/specs/hermes-adoption-plan.md`

### Phase 2: 즉시 도입 (난이도 '하' 항목)
난이도 '하'이면서 가치가 높은 항목부터:
- 런타임 비밀 마스킹 (redact.py) — 가치 상, 난이도 하
- 원자적 파일 쓰기 (utils.py) — 가치 중, 난이도 하
- 프롬프트 캐싱 (prompt_caching.py) — 가치 중, 난이도 하
- 비용 계산 200+ 모델 (usage_pricing.py) — 가치 중, 난이도 하
- 모델 메타데이터 resolution — 가치 중, 난이도 하
- robots.txt 정책 — 가치 중, 난이도 하
- 명확화 도구 — 가치 중, 난이도 하
- 퍼지 매칭 — 가치 중, 난이도 하

### Phase 3: 중난이도 항목
- 프롬프트 인젝션 탐지 — 가치 상, 난이도 중
- 보조 LLM 라우터 — 가치 상, 난이도 중
- 세션 인사이트 엔진 — 가치 상, 난이도 중
- Frozen Snapshot 메모리 — 가치 상, 난이도 중
- Progressive Disclosure 스킬 — 가치 상, 난이도 중
- 위험 명령 승인 — 가치 상, 난이도 중
- YAML 설정 중앙화 — 가치 상, 난이도 중
- OpenAI 호환 API 서버 — 가치 상, 난이도 중

### Phase 4: 고난이도 항목 (설계만)
난이도 '상' 항목은 설계서만 작성하고 구현은 별도 판단:
- 5단계 컨텍스트 압축
- FTS5 세션 검색
- SQLite WAL 세션 저장소
- 스킬 보안 스캔 (AST)
- 서브에이전트 격리 위임
- 사전 실행 보안 스캔
- 나머지 중 난이도 상 항목들

## 구현 규칙
1. **우리 코드에 맞게 변형** — Hermes 코드를 그대로 복사하지 말 것. 우리 구조(dispatch, team_prompts, dashboard 등)에 맞게 재설계
2. **모듈화** — 200줄 이하, 독립 실행 가능
3. **기존 코드 깨지지 않게** — 테스트 필수
4. **참조 경로**: Hermes 소스 `/tmp/hermes-agent/` 에서 원본 코드 참조
5. **산출물 저장**: 새 모듈은 `/home/jay/workspace/` 하위 적절한 위치에

## 전수조사 리포트 참조
- 가치 '상' 15개: 리포트 Section 11, 607-623번 줄
- 가치 '중' 25개: 리포트 Section 11, 625-653번 줄
- 각 항목 상세: 리포트 Section 1-10

## 주의사항
- git checkout/stash/reset 전체 사용 금지 — 수정 파일만 대상
- 다른 팀 디렉토리 건드리지 말 것
- 중간 Phase 완료 시 간결 중간보고 (3줄 이내)
- 최종 완료 시 전체 통합 보고