Files
lolympus-agent/CLAUDE.md
T

45 lines
2.9 KiB
Markdown

# 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/<name>/` - 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/<name>/`에 정의하고 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으로 진행합니다.