맥락

사용자가 2026-10-11 에 사용자 레벨 공통 하네스 (~/.claude/CLAUDE.md · rules/01~08 · agents/ 9개) 를 구성했다. 오케스트레이션 규칙 (rules/02-orchestration.md) 은 IssueTracker 규약 8 이 원형이지만 두 가지가 다르다 — 하네스는 서브 에이전트 모델 상한을 Opus 로 고정하고 model 생략을 금하는데 규약 8 은 세션 모델 상속을 허용했고, 규약 8 은 "역할 파일은 아직 없다" 로 적혀 있었다. Claude Code 공식 문서 (memory.md) 는 사용자 룰과 프로젝트 룰이 충돌하면 "어느 쪽을 따를지 임의" 라고 명시한다 — 두 층은 일치해야 한다.

결정

1. 서브 에이전트 모델의 상한은 Opus (T1). 메인 세션 모델이 그보다 높아도 서브에 쓰지 않는다. 역할 파일에 모델이 고정되지 않은 호출은 항상 model 을 명시한다. Opus 로도 부족하면 상한을 올리지 않고 작업을 주거나 메인이 직접 한다.
2. 역할 정의 파일의 기본 위치는 사용자 레벨 ~/.claude/agents/<역할>.md. 프로젝트 .claude/agents/ 는 같은 이름을 덮어쓸 때만 만든다 (공식 문서: 프로젝트 쪽이 우선). 역할명 = 파일명 = subagent_type.
3. 규약 8 과 하네스 02 가 어긋나면 같은 PR 에서 맞춘다 — 승자가 없으므로 불일치 자체가 결함이다.

근거

• 공식 문서: "Neither set overrides the other: if a user rule and a project rule conflict, Claude may follow either one, so keep the two consistent." (code.claude.com/docs/en/memory.md)
• 하네스가 기본값, 프로젝트가 우선이라는 사용자 설계에서 느슨한 프로젝트 문장이 이기면 상한이 무남된다 — 느슨한 쪽을 지우는 것이 유일한 해가 된다.
• model 생략 시 동작은 문서상 "subagent model order" 로, 세션 모델 상속일 수 있다 — 어느 쪽이든 "항상 명시" 가 안전하다.

검토한 대안

• 프로젝트 규약 8 을 그대로 두고 하네스 쪽에 "프로젝트 우선" 만 신고: 문서상 우선 선언은 강제되지 않는다 (임의 선택). 게다가 사용자의 의도는 상한이므로 프로젝트가 이기는 것 자체가 오류다.
• 모델 상한을 프로젝트가 정하게 남김 (상한 없음): 모델 배분은 비용 정책이라 프로젝트별로 다를 이유가 없다 — 공통 기본값이 맞다.
• 규약 8 전체를 지우고 하네스 02 만 남김 (중복 제거): 방향은 맞지만 하네스 설계 결정이믄로 별도 지시 후로 미룸. 이번에는 어긋나는 두 문장만.

결과·영향

• 07-workflow.md 규약 8 의 티어 → 모델 매핑 절 두 문장 교체, 역할명 = subagent_type 명시. CLAUDE.md 은 모델 값을 적지 않으믄로 변경 없음.
• 미결: 규약 8 · CLAUDE.md 8번과 하네스 02 의 중복 정리 (별도 결정). 서브 에이전트 컨텍스트에 ~/.claude/rules/ 가 들어가는지는 문서에 없어 미확인.

되돌리기

두 문장을 #670 시점으로 되돌린다. 단, 그러면 하네스와 다시 어긋나므로 하네스 02 도 같이 바꿔야 한다. 이 행은 지우지 않고 상태를 폐기 로.