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

2.2 KiB

CLAUDE.md — Claude Code 호환성 진입점

이 파일은 Claude Code가 자동으로 찾는 이름이라 유지한다.

프로젝트 지침의 원본은 AGENTS.md 하나다. 작업을 시작할 때는 반드시 AGENTS.md를 읽고, 그 내용을 이 파일에 적힌 지침처럼 적용하라.

⚖️ 절대 규칙 — AI 에이전트 오케스트레이션 바이블 (AGENTS.md B절)

AGENTS.mdB절은 이 저장소의 모든 지침보다 우선하는 절대 규칙이다. 요약하면:

  • 이 세션의 모델이 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만 수정한다.