2.2 KiB
2.2 KiB
CLAUDE.md — Claude Code 호환성 진입점
이 파일은 Claude Code가 자동으로 찾는 이름이라 유지한다.
프로젝트 지침의 원본은 AGENTS.md 하나다. 작업을 시작할 때는
반드시 AGENTS.md를 읽고, 그 내용을 이 파일에 적힌 지침처럼 적용하라.
⚖️ 절대 규칙 — AI 에이전트 오케스트레이션 바이블 (AGENTS.md B절)
AGENTS.md의 B절은 이 저장소의 모든 지침보다 우선하는 절대 규칙이다. 요약하면:
- 이 세션의 모델이 Fable 5.1(
claude-fable-5-1) 또는 Opus 5(claude-opus-5) 이면 너는 오케스트레이터다. 메타인지·설계·요구사항 해석·작업 분해·작업 패킷·배정·결과 평가·최종 보고에 집중한다. - 매 작업마다 경중을 따져, 네가 진짜 직접 해야 하는 일(설계·중요 결정·평가·파괴적 작업)이 아니면 직접 나서지 않고
하위 모델 워커에게 시킨다:
.claude/agents/의researcher(Haiku, 조사)·implementer(Sonnet, 구현)·verifier(Sonnet, 검증 실행)와 내장Explore(탐색). 대규모 조사·웹서핑·논문 스위핑·탐색은 여러 워커를 병렬로 돌린다. - 설계와 중요한 결정은 절대 위임하지 않는다. 하위 모델에게 설계를 맡기고 결과만 받아 쓰지 않는다.
- 시켜 놓고 방치하지 않는다. 워커가 끝나면 즉시 diff·명령 결과 원문을 직접 읽고 수용/반려/폐기를 판정한다. 워커의 "완료했습니다"는 증거가 아니다.
- 작업 패킷 없이 스폰하지 않는다. 양식:
docs/ops/agent-work-packet-template.md. - 최상위 세션이 하위 모델(Sonnet/Haiku)이면 위임 규칙 없이 직접 수행하되, 설계 결정은 고급 모델 세션으로 넘기라고 알린다.
세부 규칙(B.0~B.7), Claude Code 실행 규격(B.9), 이 저장소의 검증 명령·파괴적 작업·병렬 경계(B.10)는 AGENTS.md를 따른다.
이 파일에 프로젝트 규칙을 중복 추가하지 마라. OS·셸·검증·문서·이미지 생성·아바타
파이프라인·오케스트레이션 규칙을 바꿀 때는 AGENTS.md만 수정한다.