Hermes + Codex + Telegram 환경 -> FiveMonkeys Agent 팀 생성 후기

# [Hermes] FiveMonkeys 팀 생성

## 📝 한줄 요약
Hermes로 FiveMonkeys(총총/포포/공공/유유/강강) 팀을 생성, 텔레그램 단톡 응답 구조를 “다중 봇 응답”에서 “총총 단일 응답 + 내부 위임(delegate_task)”으로 전환  
핵심은 역할을 명확히 분리, 모든 이슈를 로그 근거로 검증

**바쁘시면 이것만 읽어도 돼요:**
- 단톡 공개 창구는 총총 1개로 통일
- 내부는 포포/공공/유유/강강에게 역할별 위임
- `TELEGRAM_REQUIRE_MENTION=true` 유지 + 멘션 패턴 정밀화
- “총총아 잘하고있어” 무응답은 멘션 패턴 누락이 원인, 수정 후 정상화
- 원칙: 추측 금지, 근거 없으면 `확인 불가`

## 🎯 이런 분들께 도움돼요
- AI 멀티 에이전트를 실제 운영 가능한 팀 구조로 만들고 싶은 분
- 텔레그램 단톡에서 봇 응답 누락/혼선을 줄이고 싶은 분
- 역할 분업과 운영 자동화를 함께 가져가고 싶은 1인/소규모 팀

## 😫 문제 상황 (Before)
초기에는 FiveMonkeys 각 에이전트별로 gateway를 개별 구축  
하지만 단톡 환경에서는 봇 간 직접 대화 제약과 멘션 처리 차이로 응답 일관성이 떨어짐

## 🛠️ 사용한 도구
- **도구**: Hermes Agent, Codex, Telegram
- **모델**: gpt-5.3-codex

## 🐵 FiveMonkeys 에이전트 역할

- **총총(chongchong) — 총괄 오케스트레이터**
  - 단톡의 유일한 공식 응답 창구
  - 사용자 요청을 해석해 하위 에이전트에 내부 위임
  - 결과 취합/요약/최종 보고 및 운영 기준 책임

- **포포(popo) — 포스팅 담당**
  - 게시글 초안 작성, 플랫폼 맞춤 문장 구성
  - 실행 전 검토, 실행 후 결과(특히 공개 URL) 검증 중심
  - 불확실 항목은 `확인 불가` 표기

- **공공(gonggong) — AX 리서처**
  - AX 포지션 관점의 사이트/채용 공고 크롤링
  - 공고별 요구 역량/역할/조건 요약
  - 공고 묶음 트렌드 분석으로 준비 방향 인사이트 제공

- **유유(youyou) — 외주 유지보수 운영 에이전트**
  - 외주 유지보수 백로그/우선순위/일정 관리
  - 바이어 요청 접수·분류·진행보고 커뮤니케이션 자동화
  - 반복 유지보수 업무를 표준 프로세스로 운영

- **강강(kangkang) — 강의 운영 자동화 에이전트**
  - 강의 준비/진행/사후 운영 반복 업무 자동화
  - 공지·자료 배포·일정·체크리스트 표준화
  - 강의 품질 유지 + 운영 리소스 절감 루틴 구축

---

## 🔧 작업 과정

### 1) 단톡 응답 구조 전환: 다중 응답 → 단일 창구

```
기존 : 각각의 봇을 직접 호출하면 해당 봇이 응답
변경 : 총총(오케스트레이션) 만 응답 하는 구조, 총총이 내부적으로 다른 에이전트들의 응답을 전달하는 역할
```

겉으로는 총총 하나만 응답하고, 내부에서 필요한 역할(포포/공공/유유/강강)을 `delegate_task`로 호출하는 구조

---

### 2) 총총이가 그냥 내용만 전달하는 이슈, 응답 안받아옴

총총이가 send message로 해당 봇을 호출하고 전달만 하고, 전달완료 까지만 함
delegate_task로 전처리를 해당 봇을 호출 후에 응답받아오는 걸로 수정
봇의 응답을 총총이가 대신 대답해주는 구조로 변경

---

### 3) 무응답 이슈 실전 해결 (“총총아 잘하고있어”)

```
추측하지 말고 로그로 원인을 닫자.
```

- 증상: “총총아 잘하고있어” 입력 시 무응답
- 확인: 로그 추적 결과, 멘션 패턴에 해당 표현 누락
- 조치: 멘션 패턴에 `총총/총총아` 추가
- 결과: 재시작 후 패턴 로드 확인, 동일 표현 정상 처리

이 과정에서 운영 원칙을 명확히 고정
- 근거 없으면 단정하지 않기
- 확인 안 되면 `확인 불가` 명시

---

### 4) 역할 정의 문서화로 재발 방지

역할 혼선을 줄이기 위해 각 에이전트의 SOUL.md/AGENTS.md를 최신 역할 기준으로 정렬

- 총총: 총괄/라우팅/최종 품질 책임
- 포포: 포스팅/게시 검증
- 공공: AX 공고 리서치
- 유유: 외주 유지보수 운영 자동화
- 강강: 강의 운영 자동화

문서-실행-보고가 같은 구조를 보도록 맞춘 게 가장 큰 개선점

---

## ✅ 결과 (After)

### Before vs After
| 항목 | Before | After |
|------|--------|-------|
| 단톡 응답 구조 | 복수 봇 응답 시도 | 총총 단일 응답 + 내부 위임 |
| 역할 정의 | 일부 역할 혼선 | 역할/책임 문서화 완료 |
| 멘션 처리 | 실제 호출어 누락 가능 | 정책 유지 + 패턴 정밀화 |
| 이슈 대응 | 체감/추정 개입 가능 | 로그 근거 중심 검증 |

### 결과물
- FiveMonkeys 단톡 운영 구조 안정화
- 역할 정의(SOUL/AGENTS) 최신화
- 사례 게시글 템플릿 기반 운영 기록 정리

## 💬 이 과정에서 배운 AI 활용 팁

### 효과적이었던 것
1. 외부 응답 채널은 하나로 하는게 헷갈리지 않음
2. 정책 완화보다 정책 정밀화
3. 로그를 기준으로 원인을 닫으면 같은 문제가 반복 

### 이렇게 하면 안 돼요
1. 역할 정의 없이 기능만 붙여 운영하기 (내가 누구랑 대화하고 있는지 모름)
2. 근거 없는 성공 보고 그대로 받아들이기 (할루시네이션)

## 🌍 다른 업무에 적용한다면?
이 구조를 통해 유유, 즉 외주 프로젝트 고객들에게 유지보수 봇을 설계할 때 적용 가능할 거라 생각함. 
유유 하위에 조수를 하나 생성해서 실제 보고는 유유만, 업무는 하위 에이전트들이 수행
핵심은 “단일 창구 + 내부 역할 위임 + 증거 기반 보고”

## 🚀 앞으로의 계획
- SOUL.md, Agent.md, Memory.md 구체화, 고도화
- 포포 -> 공공 -> 강강 -> 유유 순으로 스킬 개발 및 할 일 배정

## 📋 재사용 가능한 프롬프트

### 프롬프트 1: 멀티 에이전트 운영 구조 재설계
> 우리 팀의 AI 에이전트 운영을 점검해줘.  
> 외부는 단일 응답 창구, 내부는 역할별 위임 구조로 재설계하고 싶어.  
> 아래 형식으로 제안해줘:  
> 1) 현재 리스크  
> 2) 제안 구조  
> 3) 운영 정책(멘션/권한/승인)  
> 4) 검증 시나리오  
> [수정할 부분: 채널, 역할, 현재 문제]

### 프롬프트 2: 무응답 원인 분석(로그 기반)
> 다음 사례를 로그 기준으로 분석해줘: “[사용자 입력]”  
> 추측하지 말고, 확인된 사실/확인 불가를 분리해서 작성해줘.  
> 그리고 우선 점검 순서와 재현 테스트 문장을 같이 제시해줘.