2.9 KiB
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에 병합할 때는 별도 요청이 없는 한 제외한다.
운영
- Review queue 처리: docs/service-evaluation-operations.md
- Architecture: docs/multi-agent-architecture.md
- 고도화 시작 조건: docs/optimization-roadmap.md
- Resolution hash sunset: docs/resolution-hash-sunset-procedure.md
상태
운영 가능한 멀티 에이전트 기반은 Iter8 (2026-05-18)에 완료되었습니다. 이후 고도화는 docs/optimization-roadmap.md의 trigger 조건에 따라 별도 track으로 진행합니다.