Skip to content

chore(agents): normalize model tiers to reasoning-inherits, find-and-report-cheap - #7

Merged
roadhero merged 1 commit into
mainfrom
chore/agent-model-tiers
Sep 14, 2026
Merged

roadhero merged 1 commit into
mainfrom
chore/agent-model-tiers

Conversation

@roadhero

@roadhero roadhero commented Sep 14, 2026 •

Copy link
Copy Markdown
Owner

Summary

Agent model: pins had drifted into an inconsistent mix (some reasoning agents pinned sonnet, the four-hat chain opus in some packs and inherit in others). Apply one clear rule so thinking stays on the powerful model and only mechanical work runs cheap:

  • Reasoning / review / design / implementation / delivery agents carry no model: line → they inherit your selected main model (and follow it if you change it). Fixes performance-engineer (was sonnet), db-migration-specialist (was sonnet), and normalizes the four-hat chain's opus/inherit drift across packs.
  • docs-reconciler (find-and-report drift scan) stays pinned to sonnet — the one role that doesn't need frontier reasoning.
  • agents-compute/ is unchanged: it already tiers by role at a finer grain (deep specialists opus, routine implementation sonnet), and flattening it would raise cost on routine compute work.

Result: generic / Android / iOS packs are each docs-reconciler = sonnet, everything else inherits. Policy documented in docs/agents.md.

Note: individual Read/Grep tool calls can't be routed to a cheaper model — that's not a Claude Code capability. Cheap reads happen by delegating to a subagent pinned to a cheap model, which this scheme supports.

Test plan

  • Every agent still declares name: (gate invariant); frontmatter intact
  • Full gate green: shellcheck, jq, template parity, guard 597 + format 4 + bootstrap 9
  • CI green on ubuntu-latest

Summary by CodeRabbit

  • Documentation

    • Added guidance explaining agent model selection, inheritance of the user’s selected model, and exceptions for specialized agent packs.
  • Configuration

    • Removed explicit model assignments from multiple agents, allowing default model selection while preserving their existing instructions and capabilities.

…find-and-report is pinned cheap

Agent model pins were inconsistent across packs (e.g. performance-engineer, a
reasoning agent, was pinned sonnet in three packs; db-migration-specialist was
sonnet; the four-hat chain was opus in some packs, inherit in others). Apply one
rule to the generic/android/ios packs: reasoning, review, design, implementation,
and delivery agents carry no model: line so they inherit the selected main model;
only docs-reconciler (a find-and-report drift scan) stays pinned to sonnet. The
compute pack is left as-is — it already tiers by role at a finer grain (deep
specialists opus, routine implementation sonnet). Documents the policy in
docs/agents.md.
@coderabbitai

coderabbitai Bot commented Sep 14, 2026 •

Copy link
Copy Markdown

Review Change StackReview Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: e92a982a-4484-4085-ad75-6c26bba820bc

📥 Commits

Reviewing files that changed from the base of the PR and between 0b6380c and 03f690f.

📒 Files selected for processing (17)
  • agents-android/performance-engineer.md
  • agents-ios/architect.md
  • agents-ios/code-reviewer.md
  • agents-ios/performance-engineer.md
  • agents-ios/qa.md
  • agents-ios/release-engineer.md
  • agents-ios/senior-swe.md
  • agents/db-migration-specialist.md
  • agents/debugger.md
  • agents/devops-sre.md
  • agents/performance-engineer.md
  • agents/product-designer.md
  • agents/scrum-master.md
  • agents/security-reviewer.md
  • agents/tech-writer.md
  • agents/technical-program-manager.md
  • docs/agents.md
💤 Files with no reviewable changes (16)
  • agents-ios/performance-engineer.md
  • agents-android/performance-engineer.md
  • agents/tech-writer.md
  • agents-ios/senior-swe.md
  • agents-ios/architect.md
  • agents/scrum-master.md
  • agents-ios/code-reviewer.md
  • agents/performance-engineer.md
  • agents-ios/qa.md
  • agents/db-migration-specialist.md
  • agents/security-reviewer.md
  • agents/devops-sre.md
  • agents/debugger.md
  • agents/product-designer.md
  • agents-ios/release-engineer.md
  • agents/technical-program-manager.md

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

Changes

Agent model selection

Layer / File(s) Summary
Remove explicit agent model assignments
agents/*.md, agents-android/*.md, agents-ios/*.md
Sixteen agent definitions remove their model frontmatter field. Other metadata and instructions remain unchanged.
Document model tiers
docs/agents.md
The documentation describes inherited models, pinned models, and model tiers for the agent packs.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~5 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to 03f69

The model-selection updates are limited and aligned with the documented policy, so the PR is mergeable pending normal checks.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main change: standardizing agent model tier assignments so reasoning agents inherit the selected model and find-and-report agents use a cheaper model.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/agent-model-tiers

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.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@roadhero
roadhero merged commit 66b0596 into main Sep 14, 2026
1 of 2 checks passed
@roadhero
roadhero deleted the chore/agent-model-tiers branch September 14, 2026 19:30
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