Repository navigation
Conversation
…/agents (이슈 #674) - "model 생략 시 세션 모델 상속 허용" 을 "상한 Opus, model 항상 명시" 로 교체 — 공식 문서상 사용자 룰과 프로젝트 룰 충돌 시 승자가 없어 두 층을 같게 유지 - "역할 파일은 아직 없다" 를 "사용자 레벨 ~/.claude/agents 에 있고 프로젝트 .claude/agents 는 override 용" 으로 정정 - 역할명 = subagent_type 값임을 명시, 참고 자료에 이슈 #674 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
|
Warning Review limit reachedYou've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository. Next included review available in 16 minutes. View limit details
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
There was a problem hiding this comment.
🟡 Changes recommended
모델 명시 조건과 역할 파일 범위가 이슈 요구사항 및 실제 저장소 구조와 일치하지 않습니다.
3 open findings
What changed in this PR
사용자 공통 하네스와 프로젝트의 서브 에이전트 운용 규약을 동기화하는 문서 변경입니다.
Changes:
- 서브 에이전트 모델 상한을 Opus로 명시
- 사용자 레벨 역할 파일 위치와
subagent_type관계 설명 - 관련 이슈 #674 추가
| File | Description |
|---|---|
.claude/rules/07-workflow.md |
모델 및 역할 파일 운용 규약 정정 |
🧠 Review effort: Balanced
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
| 같은 역할이 반복되어 정착하면 그때 파일로 고정하고, 그 파일의 `model` 은 이 표와 일치해야 한다. | ||
| 파일명은 아래 역할 군 표의 영문 역할명이다 | ||
| - **서브 에이전트 모델의 상한은 Opus (T1) 다.** 메인 세션의 모델이 그보다 높아도 서브 에이전트에 쓰지 않는다. | ||
| `model` 을 생략하면 상한을 넘을 수 있으므로, 역할 파일에 모델이 고정돼 있지 않은 호출은 **항상 `model` 을 명시** 한다. |
| 코더 브리프로 분리한다 — 그래야 수정의 범위가 검수 가능하다 | ||
| - 브리프 첫 줄에 역할 이름을 적고, PR "작업 분배" 표에 **역할 열** 로 남긴다 | ||
| - 역할명은 영문 소문자 하나다 — 나중에 만들 `.claude/agents/<역할>.md` 의 파일명이 된다 (`coder.md` · `qa.md` …) | ||
| - 역할명은 영문 소문자 하나다 — `~/.claude/agents/<역할>.md` 의 파일명이자 Agent 도구의 `subagent_type` 값이다 (`coder` · `qa` …) |
Comment on lines
+448
to
+449
| 그 파일의 `model` 은 이 표와 일치해야 한다. 공통 하네스 (`~/.claude/rules/02-orchestration.md`) 와 이 절이 어긋나면 | ||
| Claude Code 는 어느 쪽을 따를지 정하지 않으므로 **둘을 같은 PR 에서 맞춘다** |
Member
Author
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
연관 이슈
구현 내용
사용자 레벨 공통 하네스 (
~/.claude/CLAUDE.md·~/.claude/rules/02-orchestration.md·~/.claude/agents/) 가 생겼다.Claude Code 공식 문서는 사용자 룰과 프로젝트 룰이 충돌하면 어느 쪽을 따를지 임의 라고 명시한다 — 두 층은 같아야 한다.
규약 8 에서 하네스와 어긋나던 두 문장을 고친다.
.claude/rules/07-workflow.md규약 8 "티어 → 모델 매핑" 절model생략 시 세션 모델 상속 허용" → 서브 에이전트 모델 상한은 Opus (T1),model은 항상 명시. Opus 로도 부족하면 상한을 올리지 않고 작업을 쪼개거나 메인이 직접~/.claude/agents/<역할>.md, 프로젝트.claude/agents/는 같은 이름을 덮어쓸 때만 (공식 문서: 프로젝트 쪽 우선). 하네스와 어긋나면 같은 PR 에서 맞춘다subagent_type값CLAUDE.md 8번 요약은 모델 값을 적지 않으므로 변경 없음. 규약 8 과 하네스 02 의 중복 축소 는 하네스 설계 결정이라 범위 밖 (이슈 본문).
작업 분배 (서브 에이전트 사용 시 — 규약 8)
sonnet) — 외부 문서 조사라 T3 → T2 상향make harness-check통과 (경고 0건)CI / 머지 게이트 점검
변경 영향 범위
.claude/rules/07-workflow.md) 만. Go 코드 · 스키마 변경 없음LowRequired Status Checks
Commit LintPR Title LintLinked Issue CheckFormat CheckBuildTestLintHarness Check— 로컬 통과 (경고 0건)롤백 계획
폐기로TODO
논의 사항
~/.claude/rules/가 들어가는지는 공식 문서에 없다. 역할 파일들이 핵심 규칙 (커밋 금지 · 고치지 않기) 을 자체 포함하고 있어 당장 문제는 아니다🤖 Generated with Claude Code