Files
lolympus-agent/CLAUDE.md
T

2.9 KiB

CLAUDE.md

lolympus-agent는 NATS 메시지 드리븐 멀티 에이전트 시스템입니다. 자세한 구조는 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에 병합할 때는 별도 요청이 없는 한 제외한다.

운영

상태

운영 가능한 멀티 에이전트 기반은 Iter8 (2026-05-18)에 완료되었습니다. 이후 고도화는 docs/optimization-roadmap.md의 trigger 조건에 따라 별도 track으로 진행합니다.