vignette/CLAUDE.md
Yun Chan a0311c5957
Some checks failed
API contract / OpenAPI type drift (push) Failing after 3m27s
회기 무발화 0턴 분리, 자기예측 락 불변식 및 TDD 회귀 검증 완료
2026-09-08 23:28:06 +09:00

26 lines
2.2 KiB
Markdown

# CLAUDE.md — Claude Code 호환성 진입점
이 파일은 Claude Code가 자동으로 찾는 이름이라 유지한다.
프로젝트 지침의 원본은 [`AGENTS.md`](./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`만 수정한다.