Skip to content

chore: update model references for Claude Opus 5.5 - #351

Merged
evansenter merged 2 commits into
mainfrom
chore/opus-5-5-model-refs
Oct 17, 2026
Merged

evansenter merged 2 commits into
mainfrom
chore/opus-5-5-model-refs

Conversation

@evansenter

@evansenter evansenter commented Oct 17, 2026 •

Copy link
Copy Markdown
Owner

This is the first of a series of PRs that update the Claude Code setup for the Opus 5.5 generation. It changes model references and the global CLAUDE.md only. The two workflow-file edits moved to #352, because the bot reviewer skips PRs that touch its own workflow.

Global CLAUDE.md (loaded every session, and by Antigravity through GEMINI.md):

  • Model Policy now names the opus alias instead of pinning "Claude Opus 5", so the text doesn't go stale at the next release.
  • "Working with Opus 5" is renamed Working Style. The Opus 5 behavioral rules (scope, delegation, corrections) stay as the starting point; the Opus 5.5 migration guide says to keep them and re-test.
  • Removed the claim that "lowering effort does not reliably shorten visible output". It was true for Opus 5; on 5.5 the guidance is the reverse (lower effort before prompting for brevity).
  • The verification rule now also covers "verify with a subagent" phases written into commands and agents. A later PR removes several of those.

Model IDs:

File Old New
home/.hermes/config.yaml claude-opus-4-8 claude-opus-5-5
summarize skill (recommended model) claude-sonnet-5 claude-sonnet-5-5
mcp-builder eval script (default) claude-sonnet-5 claude-sonnet-5-5
statusline-command.sh (example in a comment) "Opus 4.8" "Opus 5.5"

Left on purpose: docs/case-study.md quotes Opus 4.5 pricing from Nov 2025 as a dated historical record.

make check passes, and evaluation.py compiles.

🤖 Generated with Claude Code

https://claude.ai/code/session_01LBftoc1JCMLow9LDFZMADs

evansenter and others added 2 commits October 17, 2026 18:39
- Global CLAUDE.md: describe the default as the `opus` alias rather than
  pinning "Claude Opus 5"; rename "Working with Opus 5" to "Working
  Style" and drop the Opus 5-specific claim that lowering effort doesn't
  shorten output (the Opus 5.5 guidance is the reverse: lower effort
  before prompting for brevity). Widen the verification rule to cover
  verify-with-a-subagent phases in commands and agents.
- CI review workflow: the fallback prompt said "REQUEST_CHANGES for any
  issues found", contradicting the central prompt's convergence policy;
  align it. Drop pinned model versions from workflow comments.
- Model IDs: hermes default claude-opus-4-8 -> claude-opus-5-5;
  summarize and mcp-builder eval defaults claude-sonnet-5 ->
  claude-sonnet-5-5; statusline example comment.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LBftoc1JCMLow9LDFZMADs
claude-code-action skips review on PRs that modify its workflow file, and
main requires an approving review.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LBftoc1JCMLow9LDFZMADs
LINK_RESET=$'\e]8;;\e\\'

# Model name — prefer the friendly display_name (e.g. "Opus 4.8") over the raw id
# Model name — prefer the friendly display_name (e.g. "Opus 5.5") over the raw id

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[Suggestion] This file still has an old model ID: the usage example in the header comment on line 8 uses claude-opus-4-6 as the model id. Since you are updating this file's examples anyway, consider changing it to claude-opus-5-5 so it matches. It is a comment only and does not change behavior.

@claude claude Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Prompt: evansenter/dotfiles/.../claude-review.md

Code Review — Round 1

Summary
This PR changes docs and model IDs only. The new IDs (claude-opus-5-5, claude-sonnet-5-5) are valid. Pointing the global CLAUDE.md at the opus alias instead of a named version means it will not go stale at the next release. Dropping the "lowering effort does not shorten output" line fits the 5.5 guidance. The changes in evaluation.py only touch string defaults and help text, so they do not change behavior beyond which model is called.

The workflow files still say Claude Opus 5 / Sonnet 5 (claude-code-review.yml:68, claude.yml:49). That is expected, because the PR body moves those edits to PR 352.

One small gap: the PR body table does not list the evaluation.md:599 change, where the "more capable model" example moves from Sonnet to claude-opus-5-5. The change is reasonable, since Opus is the more capable tier.

Verdict
APPROVE - No blocking findings. One non-blocking suggestion is inline.


Automated review by Claude Code

@evansenter
evansenter merged commit 8c1a1be into main Oct 17, 2026
8 checks passed
@evansenter
evansenter deleted the chore/opus-5-5-model-refs branch October 17, 2026 17:43
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