# CLAUDE.md `lolympus-agent`는 NATS 메시지 드리븐 멀티 에이전트 시스템입니다. 자세한 구조는 [docs/multi-agent-architecture.md](docs/multi-agent-architecture.md)를 먼저 읽으세요. ## 작업 시 자주 쓰는 명령 | 명령 | 용도 | | ------------------------------------------------- | ------------------------------------------ | | `npm run typecheck` | TypeScript 타입 검증 | | `npm run lint` | ESLint와 SKILL.md 일관성 검증 | | `npm run lint:skills` | SKILL.md와 코드 manifest 검증 | | `npm test` | 전체 테스트 | | `npm run eval -- --set=onboarding/cases` | onboarding golden 평가 | | `npm run eval:moderation -- --skip-llm-judge` | moderation golden smoke | | `npm run eval:handoff -- --skip-llm-judge` | handoff 경로 회귀 | | `npm run eval:router-shadow-report -- --since=7d` | static router와 learned router shadow 비교 | | `npm run review:list -- --limit=5` | supervisor review queue 확인 | ## 핵심 디렉토리 - `src/skills//` - skill별 단일 정의 위치. `SKILL.md`, intent, prompt data, tools, runtime을 함께 둔다. - `src/agent/dispatch.ts` - production과 eval이 공유하는 handoff dispatch loop. - `src/eval/` - golden, shadow archive, proposal, tournament, router training/reporting. - `src/operations/` - supervisor review queue 운영 CLI. - `src/observability/` - logger, tracing, metrics, alert, Slack notifier. - `docs/service-evaluation-operations.md` - 운영 runbook. ## 변경 시 주의 - SKILL.md를 바꾸면 `npm run lint:skills`를 실행한다. - prompt, routing, handoff를 바꾸면 onboarding, moderation, handoff eval smoke를 함께 확인한다. - 새 skill은 `src/skills//`에 정의하고 factory/registry에 등록한 뒤 golden case를 추가한다. - plan 문서(`docs/refactor-skill-ssot*.md`)는 작업 지시와 기록이다. 공개 main에 병합할 때는 별도 요청이 없는 한 제외한다. ## 운영 - Review queue 처리: [docs/service-evaluation-operations.md](docs/service-evaluation-operations.md) - Architecture: [docs/multi-agent-architecture.md](docs/multi-agent-architecture.md) - 고도화 시작 조건: [docs/optimization-roadmap.md](docs/optimization-roadmap.md) - Resolution hash sunset: [docs/resolution-hash-sunset-procedure.md](docs/resolution-hash-sunset-procedure.md) ## 상태 운영 가능한 멀티 에이전트 기반은 Iter8 (2026-05-18)에 완료되었습니다. 이후 고도화는 [docs/optimization-roadmap.md](docs/optimization-roadmap.md)의 trigger 조건에 따라 별도 track으로 진행합니다.