Skip to content

docs(tiers): make Opus 5 the default top tier, Fable the peak reserve - #32

Merged
cristim merged 1 commit into
mainfrom
docs/opus-5-tier-ladder
Jul 27, 2026
Merged

docs(tiers): make Opus 5 the default top tier, Fable the peak reserve#32
cristim merged 1 commit into
mainfrom
docs/opus-5-tier-ladder

Conversation

@cristim

@cristim cristim commented Jul 27, 2026

Copy link
Copy Markdown
Member

Routes everyday top-tier work to Opus 5 (planning, all review loops, iteration, gnarly debugging, non-trivial implementation) and keeps Fable as a peak reserve used only when the last ~0.5% of max-effort intelligence decides the outcome. Per the Claude Opus 5 announcement: Opus 5 lands within ~0.5% of Fable 5's peak at roughly half the cost.

Files: CLAUDE.md (§2 split + tier table + §1c review loop + §1 pre-commit review + cross-model mapping), subagent-strategy.md (PR-shipping split + model rubric), git-workflow.md (review + watcher fix-push tiers), issue-pr-autopilot.md (manual Fable-escalation note + RemoteTrigger server-pinned-minute caveat).

User-directed change; not a self-noticed guidance gap.

Summary by CodeRabbit

  • Documentation
    • Clarified repository initialization requirements and exceptions for temporary or scratch work.
    • Expanded guidance for pre-commit reviews, escalation, delegation, and post-merge cleanup.
    • Updated model-selection and tiering guidance for planning, implementation, review, and debugging workflows.
    • Documented server-pinned scheduling behavior and label-based workflow coordination.
    • Added guidance for handling exceptional issues through manual replanning rather than automated escalation.

Claude Opus 5 reaches within ~0.5% of Fable 5's peak intelligence at
roughly half the cost, so route the everyday top-tier work to Opus and
keep Fable only for the last-0.5% max-effort cases.

- CLAUDE.md: §2 tier split + 4-row tier table + when-in-doubt rule now
  put planning, all review loops, iteration, gnarly debugging, and
  non-trivial implementation on Opus (default); Sonnet keeps simpler
  decided-shape implementation; Fable is a peak reserve (~2x Opus cost).
  §1c local review loop reviews on Opus (Fable only for peak calls);
  §1 pre-commit review runs on Opus. Cross-model mapping updated.
- subagent-strategy.md: PR-shipping split + model rubric mirror the same
  ladder; Fable bullet reframed as the deliberate peak escalation.
- git-workflow.md: pre-commit review and ci/cr/merge-watch fix-push and
  exploratory-debug escalations run on Opus; Fable reserved for the
  hardest money-path diffs.
- issue-pr-autopilot.md: added a note that frontier-judgement escalation
  to Fable is a manual, human-driven re-plan (single-model cloud routines
  cannot escalate mid-run), plus an operational caveat that the
  RemoteTrigger API pins the cron minute server-side.
@coderabbitai

coderabbitai Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5a6c6844-509e-4118-9dcd-119d1329669c

📥 Commits

Reviewing files that changed from the base of the PR and between 6d200e6 and 5f249f4.

📒 Files selected for processing (4)
  • CLAUDE.md
  • git-workflow.md
  • issue-pr-autopilot.md
  • subagent-strategy.md

📝 Walkthrough

Walkthrough

The documentation updates add Fable to model-tier guidance, make Opus the standard review tier, require explicit model selection for Agent calls, define repository initialization and cleanup procedures, and clarify autopilot scheduling and manual escalation.

Changes

Agent tier and review guidance

Layer / File(s) Summary
Tier selection and review responsibilities
CLAUDE.md, subagent-strategy.md, git-workflow.md
Model mappings, explicit Agent model selection, Opus review responsibilities, implementation-tier splits, and Fable escalation rules are updated.
Repository and merge workflow
CLAUDE.md, git-workflow.md
Repository initialization exceptions, pre-commit review guidance, and post-merge worktree, branch, and plan-file cleanup procedures are documented.
Autopilot scheduling and escalation
issue-pr-autopilot.md
RemoteTrigger minute pinning, label-driven state, and manual-only Fable frontier escalation are clarified.

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

Possibly related PRs

Suggested labels: type/docs, enhancement, effort/xs, impact/internal, severity/low

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/opus-5-tier-ladder

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

@cristim
cristim merged commit 3bf4d5f into main Jul 27, 2026
1 check was pending
@cristim
cristim deleted the docs/opus-5-tier-ladder branch July 27, 2026 12:36
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