Skip to content

docs(rules): 実装エージェントのモデル選択をリスクベースの明示指定にする - #70

Open
gotomts wants to merge 1 commit into
mainfrom
chore/model-selection-policy
Open

docs(rules): 実装エージェントのモデル選択をリスクベースの明示指定にする#70
gotomts wants to merge 1 commit into
mainfrom
chore/model-selection-policy

Conversation

@gotomts

@gotomts gotomts commented Aug 27, 2026

Copy link
Copy Markdown
Owner

概要

Hermes が起動する Claude Code セッションのモデル選択規範を、リスクベースの明示指定に置き換える。SSOT は claude/rules/orchestrator.mdclaude/hermes/SOUL.mdscripts/build-agent-rules.zsh による生成物。

変更内容

claude/rules/orchestrator.md の「実装エージェントのセッション運用」から Opus 固定の記述を外し、以下の 4 点に置き換えた。

  • 完全なモデル ID を渡す: 起動・再開時は --model に完全なモデル ID を渡し、選んだ ID を指示に書く。曖昧な alias に依存しない。コンテキスト容量などのサフィックスも ID の一部なので落とさず、'claude-opus-5[1m]' のように zsh の glob 展開を避けてシングルクォートで囲む
  • リスクベースの選択と Sonnet の境界: モデルはタスクの判断量とリスクで選ぶ。設計判断・実装・設計成果物との突き合わせ・履歴の再構成(rebase / cherry-pick / commit の再分割)・自明でないレビューは、確認できた中で最も強いモデルを使う。Sonnet は判断が確定済みの機械的な作業(差分比較、生成、CI 待機、対象が確定している単発置換など)に限定し、途中で判断が混ざったらより強いモデルのセッションへ委ね直す
  • 確認手段と fallback: モデルの利用可能性と用途は、適用する起動 skill の用途表で確認し、確認済みのモデルからタスクに応じて選ぶ。用途表が無い場合は、すでに確認済みの完全なモデル ID だけを使い、新しいモデル ID を推測で渡さない。モデル別の用途を規範側に二重定義しない
  • 人の /model 選択に干渉しない: この規範は Hermes が起動する Claude Code セッションに適用する。人が claude をインタラクティブに起動する場合の /model による選択は妨げない

claude/AGENTS.md は orchestrator フラグメントを含まないため変更なし。

検証

コマンド 結果
zsh scripts/build-agent-rules.zsh exit 0(生成物を更新)
zsh scripts/build-agent-rules.zsh --check exit 0(CI の agent-rules-check と同一の検証)

このリポジトリに markdown 用の linter / formatter は設定されていない(.editorconfig のみ)。変更は markdown 2 ファイルのため、nix-check / setup-check は paths filter の対象外。

レビュー

  • Hermes によるセルフレビュー: 最新 diff を受入条件・変更境界(SSOT と生成物のみ)と突き合わせて確認済み
  • 独立した read-only レビュー: 実施済み。指摘はすべて解消し、解消後の diff に対してセルフレビューを再実施した

🤖 Generated with Claude Code

Opus 固定の記述をやめ、判断量とリスクでモデルを選ぶ規範に置き換える。
`--model` には `'claude-opus-5[1m]'` のような完全なモデル ID を渡すことを
求め、曖昧な alias 依存を排す。利用可能性と用途は起動 skill の用途表で
確認させ、規範側にモデル別の用途を二重定義しない。
人がインタラクティブに起動する `claude` の `/model` 選択は対象外とする。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant