[DOCS] 규약 8 을 사용자 레벨 하네스와 일치 — 서브 에이전트 모델 상한 Opus · 역할 파일 위치 정정 #674

무엇을

사용자 레벨 공통 하네스 (~/.claude/CLAUDE.md · ~/.claude/rules/02-orchestration.md · ~/.claude/agents/) 가 2026-10-11 에
생겼다. Claude Code 공식 문서는 사용자 룰과 프로젝트 룰이 충돌하면 어느 쪽을 따를지 임의 라고 명시하므로, 두 층은
일치해야 한다. 프로젝트 규약 8 에서 하네스와 어긋나는 두 문장을 고친다.

어긋나는 곳

1. 모델 상속 허용 — 규약 8 "티어 → 모델 매핑" 절: "model 을 생략하면 세션 모델을 상속한다 — T1 로 부족하다고 판단한 일에만".
   하네스는 "서브 에이전트 모델 상한은 Opus. model 생략 금지, 항상 명시" 다. 프로젝트가 우선하면 느슨한 쪽이 이긴다.
2. 역할 파일 부재 서술 — "역할 정의 파일 (.claude/agents/<역할>.md) 은 아직 없다 — 호출 시점에 model 인자로 티어를 지정한다".
   이제 ~/.claude/agents/ 에 9개 역할 파일이 있다. 프로젝트 .claude/agents/ 는 같은 이름을 덮어쓰는 용도다.

무엇을 하나

• 규약 8 의 두 문장을 하네스와 같은 의미로 교체 (Opus 상한 · model 항상 명시 · 역할 파일은 사용자 레벨, 프로젝트는 override)
• 역할 군 표의 "역할명은 향후 .claude/agents/ 파일명" 문장도 현재형으로
• Notion 설계 결정 기록 (규약 7) — 규약 8 행을 참조하는 보완 행
• make harness-check 통과

범위 밖

• 규약 8 · CLAUDE.md 8번이 하네스 02 와 중복되는 부분을 줄이는 것 — 하네스 설계 결정이라 별도 지시 후

관련

• 이슈 [DOCS] 규약 8 — 메인 세션 오케스트레이션 · 서브 에이전트 모델 차등 배분 #667 · [DOCS] 규약 8 — 서브 에이전트 역할 군 명시 (오케스트레이터 · 코더 · 기획 · 디자인 · 자료조사 · QA · 테스터 · 아키텍트 · 기타) #669 (규약 8), 사용자 하네스 저장소 ~/.claude 커밋 609b962 ~ 8bafce5