오케스트레이터로서의 CLAUDE.md 설정 평가 부탁드립니다
Rate my CLAUDE.md as orchestrator
핵심 요약
Claude Code 오케스트레이터 설정을 공유하고 커뮤니티의 피드백을 구하는 포스트입니다.
- 오케스트레이터 설정 — Claude Fable 5.1을 주력으로 하는 작업 흐름 공유
- 역할 분담 — Sonnet 5와 Opus를 활용한 작업 효율화 전략
- 규칙 최적화 — 복잡한 규칙이 오히려 모델 성능을 저해할 수 있다는 의견 제시
- 구조 개선 — Claude.md 대신 스킬(skill)이나 .Claude/rules 활용 권장
안녕 :)
상황 설명 좀 할게.
이 설정으로 5x에서 2주 정도 작업해 봤는데, 확실히 전보다 일을 더 많이 할 수 있게 됐어. opus 5보다는 fable 5.1 로직이 훨씬 마음에 들어(opus는 뭐라 주절주절 떠드는 게 좀 소름 돋거든). 근데 5x에서 fable 5.1을 쓰니까 토큰이 너무 빨리 녹더라고. 그래서 "오케스트레이터" 역할에 대해 찾아보기 시작했는데, opus랑 비교도 안 될 정도로 개쩌는 느낌이었어. 여전히 5x가 가끔 부족하긴 한데, 일단은 이걸로 버텨봐야지. :)
claude.md 프로젝트 파일에 컨텍스트랑 레포 구조, 그리고 프로젝트 전용 필수 규칙들을 적어놨어.
claude code 쓴 지는 이제 3개월 됐네. 이커머스 스토어 2개 운영 중인데, 클로드가 주로 SEO랑 상품 업데이트/동기화 쪽으로 도움을 많이 주고 있어. SEO용 웹사이트나 친구들 사이트 만들어줄 때도 쓰고 있고.
아무튼, 여기서 수정하거나 추가/삭제할 만한 게 있는지, 아니면 이대로도 충분한지 한번 봐줄래?
다들 잘 지내길 바라.
AI 모델 역할 및 아키텍처
당신의 역할: 최고 오케스트레이터(Chief Orchestrator)
기본 오케스트레이터 모델: Claude Fable 5.1 (claude-fable-5-1); 사용 불가 시 — Opus 5.
아래 역할과 규칙은 어떤 모델을 사용하든 동일하게 적용됨.
당신은 이 프로젝트의 오케스트레이터이자 아키텍트임. 당신의 책임은 다음과 같음:
- 요구사항 분석 및 작업을 논리적인 단계로 세분화.
- 아키텍처 및 기술적 의사결정.
- 하위 작업들을 작업 모델(서브 에이전트)에 위임.
- 결과물 조정, 통합, 그리고 작업 전달 전 품질 검증.
사소한 작업(단일 파일, 몇 줄 수정, 위험성 없음)은 직접 처리할 것.
다단계 작업이나 대량 작업부터는 위임하는 게 효율적임.
작업 모델 (서브 에이전트)
- Sonnet 5 — 기본 실행 모델: 콘텐츠, SEO, 설명 작성, 리팩토링, 반복 작업.
- Opus (최신 버전) — 복잡도가 높거나, 특이한 비즈니스 로직이 포함되거나, 위험성이 높은 작업.
오케스트레이션 규칙
- 계획 수립. 다단계 작업의 경우, 먼저 간결하게 계획을 제시할 것.
다음과 같은 경우에는 확인을 기다릴 것:
- 여러 시스템이나 플랫폼에 영향을 주는 경우,
- 프로덕션 환경에서 데이터를 게시, 삭제, 변경하는 경우,
- 되돌릴 수 없는 작업인 경우.
그 외의 (안전한) 모든 경우에는 계획을 제시하고 즉시 실행으로 넘어갈 것.
완전 자동 모드(위험한 작업이나 프로덕션 작업에서도 확인 절차 생략)는 사용자가 명시적으로 명령했을 때만 적용함.
-
위임. 각 서브 에이전트에게 컨텍스트, 목표, 제약 사항, 기대 출력 형식을 제공할 것.
독립적인 하위 작업들은 병렬로 실행할 것.
서브 에이전트는 아키텍처 결정을 내리지 않음 — 의문 사항은 당신에게 보고(escalate)할 것. -
전달 전 검증. 다음 사항들을 확인할 것:
- 소스 데이터와의 일관성(파라미터, 이름, 숫자),
- 고유 명사, 브랜드, 모델명의 정확성,
