Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
2 changes: 1 addition & 1 deletion plugins/playbooks/reference/model-adaptation/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,4 +15,4 @@ a system-card finding: link the section rather than restate it, so no qualifier

A blog post appears only as a `correlate with <blog link>` note beside a main-docs pointer. A
conflict between two pages is recorded only as "pages X and Y disagree on topic T", with both
links, the as-of date and a trigger.
links.
20 changes: 3 additions & 17 deletions plugins/playbooks/reference/model-adaptation/fable-5-2.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,9 +46,7 @@ Claude Code's page, never from the API guide; in an integration you author, read
(correlate with <https://x.com/alexalbert__/status/2119869724247077229>); for Claude Code's
levels and its default for this model, see
[Adjust effort level](https://code.claude.com/docs/en/model-config#adjust-effort-level).
- **As of**: 2026-11-09
- **Recheck trigger**: a re-read of either section no longer supporting the decisions above, or
the two surfaces' defaults for this model becoming the same.
- **Recheck trigger**: the two surfaces' defaults for this model becoming the same.

## The consent gate's reach

Expand All @@ -74,9 +72,7 @@ standing grant, as the gate's total rule states. `[CC: direct]`
and
[Keep caution from piling up](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#keep-caution-from-piling-up)
(correlate with <https://x.com/alexalbert__/status/2119869724247077229>).
- **As of**: 2026-11-09
- **Recheck trigger**: a re-read of either section no longer supporting the decision above, or the
gate's trigger list or total rule changing.
- **Recheck trigger**: the gate's trigger list or total rule changing.

## Code ownership

Expand All @@ -92,9 +88,7 @@ Under a grant, your closing message lists every change you made, small ones incl

- **Pointer**: see the guide's
[Say who owns the code](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#say-who-owns-the-code).
- **As of**: 2026-11-09
- **Recheck trigger**: a re-read of that section no longer supporting the decision above, or a
lane prompt or convention file in this repository adding an ownership grant.
- **Recheck trigger**: a lane prompt or convention file in this repository adding an ownership grant.

## Delegation and self-review

Expand All @@ -109,8 +103,6 @@ changing anything else. `[CC: direct]`

- **Pointer**: see the guide's
[Set expectations for subagents](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#set-expectations-for-subagents).
- **As of**: 2026-11-09
- **Recheck trigger**: a re-read of that section no longer supporting the decision above.

## Cautions in durable notes

Expand All @@ -125,8 +117,6 @@ file keeps its force under meta-rule 1. `[CC: direct]`
[Keep caution from piling up](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#keep-caution-from-piling-up)
and
[Review instructions written for earlier models](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#review-instructions-written-for-earlier-models).
- **As of**: 2026-11-09
- **Recheck trigger**: a re-read of either section no longer supporting the decision above.

## Earlier answers stay open

Expand All @@ -139,8 +129,6 @@ guide's settled-answers lines into a prompt you run under or author for this mod

- **Pointer**: see the guide's
[Review instructions written for earlier models](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#review-instructions-written-for-earlier-models).
- **As of**: 2026-11-09
- **Recheck trigger**: a re-read of that section no longer supporting the decision above.

## Writing form

Expand All @@ -153,8 +141,6 @@ guidance, and add no sentence or word cap of your own. `[CC: prompt-authoring]`
[Review instructions written for earlier models](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#review-instructions-written-for-earlier-models);
for report guidance, see
[Make reports easy to follow](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#make-reports-easy-to-follow).
- **As of**: 2026-11-09
- **Recheck trigger**: a re-read of either section no longer supporting the decision above.

## Sources

Expand Down
38 changes: 8 additions & 30 deletions plugins/playbooks/reference/model-adaptation/haiku-5-5.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,6 @@ included, lives in the Haiku 5.5 launch record; read it there and copy none of i
[Alias binding](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/loop-lane/README.md#alias-binding);
for what the alias resolves to on each provider, see
[Model aliases](https://code.claude.com/docs/en/model-config#model-aliases).
- **As of**: 2026-10-10
- **Recheck trigger**: a role passing the routing eval, the rubric or the launch record changing,
or the alias changing what it resolves to.

Expand Down Expand Up @@ -71,9 +70,7 @@ read the Claude Code pointers. `[CC: direct]` `[CC: API-side]`
for Claude Code, see
[Adjust effort level](https://code.claude.com/docs/en/model-config#adjust-effort-level) and
[Choose an effort level](https://code.claude.com/docs/en/model-config#choose-an-effort-level).
- **As of**: 2026-10-10
- **Recheck trigger**: the rubric, the effort floor, or the `low` carve-out changing, or any pointed
section moving.
- **Recheck trigger**: the rubric, the effort floor, or the `low` carve-out changing.

## Where a run stops and what it covers

Expand All @@ -90,9 +87,7 @@ pointer before changing that surface. `[CC: direct]` `[CC: prompt-authoring]`

- **Pointer**: see
[Prevent early stopping in long agent prompts](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#prevent-early-stopping-in-long-agent-prompts).
- **As of**: 2026-10-10
- **Recheck trigger**: that section moving, or an agent's "When you are done" section being
renamed or removed.
- **Recheck trigger**: an agent's "When you are done" section being renamed or removed.

## Verification

Expand All @@ -106,9 +101,7 @@ behind it, read the guide's section at the pointer before changing that surface.

- **Pointer**: see
[Tell coding agents to verify their changes](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#tell-coding-agents-to-verify-their-changes).
- **As of**: 2026-10-10
- **Recheck trigger**: that section moving, or a transcript from a surface we own showing the
symptom.
- **Recheck trigger**: a transcript from a surface we own showing the symptom.

## Current specifics and search

Expand All @@ -121,8 +114,6 @@ knowledge where a current source was needed, read the guide's section at the poi

- **Pointer**: see
[Accurate search results](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#accurate-search-results).
- **As of**: 2026-10-10
- **Recheck trigger**: that section moving.

## Thinking and reasoning in replies

Expand All @@ -139,9 +130,6 @@ reasoning-like text shows up in a reply users see, read the guide's section on i
[Use effort to control thinking](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#use-effort-to-control-thinking)
and
[Keep reasoning out of user-facing text](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#keep-reasoning-out-of-user-facing-text).
- **As of**: 2026-10-10
- **Recheck trigger**: any pointed section moving, or a Claude Code release note adding a thinking
setting for this model.

## Mid-turn messages and hook text

Expand All @@ -159,8 +147,7 @@ add a hook that writes into context after tool results, read the pointers.
[Add context for Claude](https://code.claude.com/docs/en/hooks#add-context-for-claude); for our
convention, see the
[hook-observability convention](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/hook-observability/README.md).
- **As of**: 2026-10-10
- **Recheck trigger**: either upstream section moving, or the convention changing.
- **Recheck trigger**: the hook-observability convention changing.

## JSON output, tools, and chatbots

Expand All @@ -176,9 +163,8 @@ a tool, or deploy it as a chatbot or support assistant, read the guide's section
[Use adaptive thinking with JSON output and your own tools](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#json-output-with-your-own-tools)
and
[Keep chatbots to their system prompt](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#keep-chatbots-to-their-system-prompt).
- **As of**: 2026-10-10
- **Recheck trigger**: either section moving, or this repository gaining code that parses model
output, dispatches tool calls, or serves a chatbot.
- **Recheck trigger**: this repository gaining code that parses model output, dispatches tool
calls, or serves a chatbot.

## API requests carried over from Haiku 4.5

Expand All @@ -193,8 +179,7 @@ what's-new page at the pointers. `[CC: API-side]`
[Haiku 5.5 migration guide](https://platform.claude.com/docs/en/models/haiku-5-5/migration-guide)
and
[What's new in Claude Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/whats-new-haiku-5-5).
- **As of**: 2026-10-10
- **Recheck trigger**: either page moving, or this repository gaining code that sends API requests.
- **Recheck trigger**: this repository gaining code that sends API requests.

## Which surfaces we author as system prompt

Expand All @@ -212,9 +197,7 @@ of those two, and read the guide's note on changing a system prompt mid-conversa
[Write subagent files](https://code.claude.com/docs/en/sub-agents#write-subagent-files); for the
flags, see
[System prompt flags](https://code.claude.com/docs/en/cli-reference#system-prompt-flags).
- **As of**: 2026-10-10
- **Recheck trigger**: any pointed section moving, or Claude Code documenting how skill bodies are
delivered.
- **Recheck trigger**: Claude Code documenting how skill bodies are delivered.

## Safeguards and fallback

Expand All @@ -230,9 +213,6 @@ skill that asks a model for its reasoning in the reply, read the guide's refusal
[Safeguard refusals](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#safeguard-refusals)
and, for Claude Code,
[Automatic model fallback](https://code.claude.com/docs/en/model-config#automatic-model-fallback).
- **As of**: 2026-10-10
- **Recheck trigger**: the fallback section naming this model as a source, or a refusal category
added or removed for it.

## Caching and cost

Expand All @@ -252,8 +232,6 @@ before sending it a long prompt where cost matters, read the pointers. `[CC: API
[Haiku 5.5 context window and pricing](https://code.claude.com/docs/en/model-config#haiku-5-5-context-window-and-pricing);
for the figures, see
[Haiku 5.5 launch record: launch page figures](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/upstream/haiku-5-5-launch.md#launch-page-figures).
- **As of**: 2026-10-10
- **Recheck trigger**: any pointed section moving.

## Sources

Expand Down
26 changes: 1 addition & 25 deletions plugins/playbooks/reference/model-adaptation/opus-4-8.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@ as a target; retire it when it stops.

- **Pointer**: for which flagged requests move to Opus 4.8, see
[Automatic model fallback](https://code.claude.com/docs/en/model-config#automatic-model-fallback).
- **As of**: 2026-10-11
- **Recheck trigger**: that section no longer names Opus 4.8 as a fallback target.

> **If you are not Claude Opus 4.8:** the specific deltas below are calibrated for Opus 4.8, so don't
Expand Down Expand Up @@ -47,8 +46,6 @@ do not. `[CC: direct]`

- **Pointer**: for instruction following, see
[More literal instruction following](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-4-8#more-literal-instruction-following).
- **As of**: 2026-08-08
- **Recheck trigger**: a re-read of that section no longer supporting the decision above.

## Verify with tools, not recall

Expand All @@ -58,8 +55,6 @@ for facts about the environment. `[CC: direct]`

- **Pointer**: for tool use, see
[Tool use triggering](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-4-8#tool-use-triggering).
- **As of**: 2026-08-08
- **Recheck trigger**: a re-read of that section no longer supporting the decision above.

## Delegation

Expand All @@ -71,8 +66,6 @@ correct is under-delegation. `[CC: direct]`

- **Pointer**: for subagent spawning, see
[Controlling subagent spawning](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-4-8#controlling-subagent-spawning).
- **As of**: 2026-08-08
- **Recheck trigger**: a re-read of that section no longer supporting the decision above.

## Effort

Expand All @@ -88,9 +81,6 @@ The levels and their recommended uses resolve at the pointers, never from this f
[Calibrating effort and thinking depth](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-4-8#calibrating-effort-and-thinking-depth)
and the Claude Opus 4.8 entry of
[Recommended effort levels](https://platform.claude.com/docs/en/build-with-claude/effort#recommended-effort-levels).
- **As of**: 2026-11-01
- **Recheck trigger**: the effort page dropping its Claude Opus 4.8 entry, or a re-read of either
section no longer supporting the decision above.

## Thinking controls

Expand All @@ -102,8 +92,6 @@ thinking there through its own controls. `[CC: API-side]`
[Calibrating effort and thinking depth](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-4-8#calibrating-effort-and-thinking-depth);
for Claude Code's controls, see
[Extended thinking](https://code.claude.com/docs/en/model-config#extended-thinking).
- **As of**: 2026-08-08 for the guide; 2026-10-01 for model-config.
- **Recheck trigger**: a re-read of either section no longer supporting the decision above.

## Review findings

Expand All @@ -114,8 +102,6 @@ against, never an adjective; the guide's tested wording is at the pointer. `[CC:

- **Pointer**: for review harnesses, see
[Code review harnesses](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-4-8#code-review-harnesses).
- **As of**: 2026-08-08
- **Recheck trigger**: a re-read of that section no longer supporting the decision above.

## Behaviors to emulate deliberately

Expand All @@ -129,7 +115,6 @@ one as a default is checked at the first pointer.
opening paragraph of
[Prompting Claude Fable 5.2](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5-2)
(above its first heading, which the page gives no anchor of its own) and its section index live.
- **As of**: 2026-11-09
- **Recheck trigger**: that guide documenting turn length, early stopping, progress claims,
boundaries, memory, or readability as the model's default, at which point the matching pointer
below moves there.
Expand All @@ -150,9 +135,6 @@ one as a default is checked at the first pointer.
[Construct a memory system](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5#construct-a-memory-system),
and
[Readability when communicating with the user](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5#readability-when-communicating-with-the-user).
- **As of**: 2026-10-01
- **Recheck trigger**: a re-read of any pointed section no longer supporting the bullet that
cites it.

## What NOT to import from Fable-era practice

Expand All @@ -162,16 +144,13 @@ one as a default is checked at the first pointer.
`[CC: prompt-authoring]` Pointer: when weighing how much to spell out for this model, fetch
[More literal instruction following](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-4-8#more-literal-instruction-following)
live; for Fable, fetch
[Work with Fable](https://code.claude.com/docs/en/model-config#work-with-fable) live. As of:
2026-11-01. Recheck trigger: either section no longer separating this model's need for stated
scope from Fable's preference for outcomes over steps.
[Work with Fable](https://code.claude.com/docs/en/model-config#work-with-fable) live.
- **Size plan granularity to the executor, not to yourself.** A stronger model takes fewer, larger
phases each carrying a checkable exit condition; a weaker delegated worker needs enumerated steps
and tight scope fences. Ask who runs a plan before choosing step size. `[CC: prompt-authoring]`
- **Do not scaffold your own progress updates.** Forced interim-status rituals add noise.
`[CC: prompt-authoring]` Pointer: for progress updates, see
[User-facing progress updates](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-4-8#user-facing-progress-updates).
As of: 2026-08-08. Recheck trigger: a re-read of that section no longer supporting this bullet.
- **Do not treat this playbook as license to overthink.** Allocate effort where decisions are hard
to reverse. The calibration chapter's stop-conditions apply unchanged. `[CC: direct]`

Expand All @@ -186,6 +165,3 @@ section is the one delta stated against a Fable guide and keeps its Fable 5 guid
the record above; every other delta is stated against this model's own guide and is kept unchanged.
The communication chapter's prompt-authoring note removes narration-suppressing
lines rather than scaffolding updates, so "Do not scaffold your own progress updates" stands.

Recheck trigger for the whole chapter: a re-read of any pointed section no longer supporting the
decision beside it, or model-config no longer naming Opus 4.8 as a fallback target.
Loading
Loading