Skip to content

docs(playbooks): extend the orchestration snapshot note to pricing figures - #1942

Merged
kyle-sexton merged 2 commits into
mainfrom
docs/row229-pricing
Aug 6, 2026
Merged

docs(playbooks): extend the orchestration snapshot note to pricing figures#1942
kyle-sexton merged 2 commits into
mainfrom
docs/row229-pricing

Conversation

@kyle-sexton

Copy link
Copy Markdown
Contributor

No linked issue

Summary

The boris orchestration reference (plugins/playbooks/skills/boris/reference/orchestration.md) carries a header note classifying its benchmark figures (Sections 78 and 94) as launch-day snapshots with a re-resolve trigger. Section 94/95's Fable 5 price literals ($10/M input, $50/M output, cache write $12.50, cache read $1, full 1M context at standard rate) and Sections 78/95's relative price claims ("same price as 4.7", "exactly 2x Opus 4.8") sat outside that classification, readable as current rates.

This extends the note to classify pricing figures (Sections 78, 94-95) the same way — launch-day rates, verified still current against the live pricing page on 2026-08-04 — and routes current-rate resolution upstream. No figures added or removed; the vendored upstream mirror is untouched.

Playbooks 0.6.18: serialized one patch above unmerged #1931's 0.6.17 claim per the one-in-flight-claim-per-plugin rule; whichever lands second rebases.

Related

🤖 Generated with Claude Code

…gures

The boris orchestration reference's header note scoped its dated-snapshot
classification to benchmark figures only, leaving Section 94's Fable 5 price
literals and Sections 78/95's relative price claims readable as current rates.
Classify pricing figures (Sections 78, 94-95) the same way — launch-day rates,
verified still current against the live pricing page 2026-08-04 — and route
current-rate resolution to the upstream pricing page. Playbooks 0.6.18
(serialized above unmerged #1931's 0.6.17 claim).

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
@cursor

cursor Bot commented Aug 4, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@claude

claude Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Claude finished @kyle-sexton's task in 1m 52s —— View job


Code review — docs(playbooks): extend the orchestration snapshot note to pricing figures

  • Gather context (diff, CLAUDE.md, REVIEW.md)
  • Understand the request (code review of this PR)
  • Review changed files for correctness & alignment
  • Post findings

Scope note: per REVIEW.md, this lane owns correctness/design/docs and defers security findings to the dedicated security lane. This PR is a pure-docs change with no security surface, so that split doesn't come into play here.

Files reviewed: plugins/playbooks/.claude-plugin/plugin.json, plugins/playbooks/CHANGELOG.md, plugins/playbooks/skills/boris/reference/orchestration.md.

Findings

None. The change is small and internally consistent:

  • The extended note (orchestration.md#L16-L19) correctly cites Sections 78, 94–95 as the pricing-bearing sections — I checked each: 78 has "Same price as 4.7," 94 has the Fable 5 price literals plus "exactly 2× Opus 4.8," and 95 restates "Cost — 2× Opus 4.8." No pricing content exists outside those three sections, so the classification is complete and not over- or under-scoped.
  • No figures were added, removed, or altered — confirmed via the diff; only the header note grew. This matches the PR description.
  • Per CLAUDE.md's fresh-docs mandate, a skill reference file's prose body is explicitly out of that mandate's scope (only frontmatter/manifest/contract surfaces are in), so this change wasn't required to WebFetch-verify against the live pricing page — but the PR did so anyway (2026-08-04) and the CHANGELOG records that basis, which is good practice for a note whose whole point is flagging staleness risk.
  • CHANGELOG.md entry follows the existing format (bold lead sentence, ### Changed, similar line-wrap width) and accurately mirrors the code change — the "Section 94's Fable 5 price literals" / "Sections 78/95's relative price claims" split in the changelog is actually more precise than the PR body's own summary (which said "94/95" for literals), since the literals only live in Section 94.
  • plugin.json version bump (0.6.16 → 0.6.18) matches the CHANGELOG's new [0.6.18] entry; the skipped 0.6.17 is explained in the PR body as intentional sequencing against an unmerged sibling PR, and doesn't create any inconsistency in this repo's current state.

Nothing else stood out — no error-handling, atomicity, or test-coverage concerns apply to this doc-only change.

@claude

claude Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Claude finished @kyle-sexton's task in 30s —— View job


Security review complete

  • Gather context (diff, CLAUDE.md, custom instructions)
  • Review changed files for security issues
  • Post findings

Scope: git diff origin/main...HEAD for this PR touches exactly the 3 files listed — plugins/playbooks/.claude-plugin/plugin.json (version bump 0.6.160.6.18), plugins/playbooks/CHANGELOG.md (changelog entry), and plugins/playbooks/skills/boris/reference/orchestration.md (4 lines added to an existing header note, extending its "launch-day snapshot" classification to pricing figures).

Findings: none. This is a pure prose/documentation edit:

  • No code execution paths, no scripts, no hooks, no .mcp.json, no GitHub Actions workflow changes.
  • No secrets, tokens, or credentials touched.
  • No injection surfaces (command, SQL, path, template) — the diff only adds a markdown note and a link to the existing, already-referenced pricing page.
  • No permission or trust-boundary changes — nothing here affects hook contracts, marketplace schema, or manifest fields beyond the semver bump.
  • No supply-chain surface — no dependency or action pins are added or altered.

No security concerns to report on this PR.

@github-actions

github-actions Bot commented Aug 4, 2026

Copy link
Copy Markdown

Claude has reviewed this PR 2 times. The lane skips further automatic reviews after 5; deleting this comment resets the count.

Resolves the 0.6.17/0.6.18 version collision (0.6.18 stands above the
preserved 0.6.17 entry) and adds the version-transition parenthetical
matching the recent entries' convention.

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
@claude

claude Bot commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Claude finished @kyle-sexton's task in 2m 24s —— View job


Code review — docs(playbooks): extend the orchestration snapshot note to pricing figures

  • Gather context (diff, CLAUDE.md, REVIEW.md)
  • Understand the request
  • Review changed files for correctness & alignment
  • Post findings

Scope note: per REVIEW.md, this lane owns correctness/design/docs and defers security findings to the dedicated security lane. This is a pure-docs change with no security surface, so that split doesn't come into play.

Files reviewed: plugins/playbooks/.claude-plugin/plugin.json, plugins/playbooks/CHANGELOG.md, plugins/playbooks/skills/boris/reference/orchestration.md (diff at 25afa2b).

Findings

Substance is correct; one cosmetic nit in the CHANGELOG.

  • Versioning is clean. plugin.json now bumps 0.6.17 → 0.6.18, matching the new [0.6.18] entry. After the merge of origin/main (which already carries docs(playbooks): re-resolve fable-5 model adaptation on Opus fallback #1931's 0.6.17), there's no duplicate ## [0.6.17] header and no version gap — I checked, only one instance each of 0.6.16/0.6.17/0.6.18 in the changelog.
  • The extended note is accurate and complete. orchestration.md#L16-L19 cites Sections 78, 94–95 as the pricing-bearing sections. I re-checked each: 78 has "Same price as 4.7," 94 has the Fable 5 price literals plus "exactly 2× Opus 4.8," 95 restates "Cost — 2× Opus 4.8." No pricing content lives outside those three sections, so the classification is neither over- nor under-scoped, and no figures were added, removed, or altered.
  • Minor formatting nitCHANGELOG.md#L11-L13: the hard-wrap breaks unusually early — (playbooks ends line 11, then line 12 is just 0.6.17 → 0.6.18). The (~23 chars) before line 13 resumes at full width with header note classified.... Every other entry in this file wraps the sentence continuously near the ~90–100 char width (e.g. the 0.6.17 entry two entries below: 0.6.16 → 0.6.17). The rule resolved the running model once, at arm time, and routed it to its). Purely cosmetic — doesn't affect rendered markdown — but worth a quick rewrap for consistency with the file's established convention. Fix this →
  • Per CLAUDE.md's fresh-docs mandate, a skill reference file's prose body is out of that mandate's scope (only frontmatter/manifest/contract surfaces are in), so this change wasn't required to WebFetch-verify pricing against the live page — but the changelog records that the author did so anyway (2026-08-04), which is good practice for a note whose whole point is flagging staleness risk.

Nothing else stood out — no error-handling, atomicity, or test-coverage concerns apply to this doc-only change.

@claude

claude Bot commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Claude finished @kyle-sexton's task in 37s —— View job


Security review complete

  • Gather context (PR diff, CLAUDE.md)
  • Review changed files for security issues
  • Post findings

Scope: git diff origin/main...HEAD for this PR touches exactly 3 files — plugins/playbooks/.claude-plugin/plugin.json (version bump 0.6.170.6.18), plugins/playbooks/CHANGELOG.md (new changelog entry), and plugins/playbooks/skills/boris/reference/orchestration.md (4 lines added to an existing header note, extending its "launch-day snapshot" classification to cover pricing figures in Sections 78, 94–95).

Findings: none. This is a pure prose/documentation edit with no security-relevant surface:

  • No code execution paths — no scripts, hooks, .mcp.json, or GitHub Actions workflow files are touched.
  • No pull_request_target/workflow_run usage, no run: blocks, no github context interpolation — nothing in scope is a workflow file at all.
  • No secrets, tokens, or credentials referenced or handled.
  • No injection surfaces (command, SQL, path, template) — the diff only adds markdown prose and a link to the pre-existing, already-referenced pricing page.
  • No permission or trust-boundary changes — the plugin.json diff is solely the semver field; no permissions, config, or manifest contract fields beyond version are touched.
  • No supply-chain surface — no dependency or action pins added, removed, or loosened.

Nothing for zizmor's advisory lane to defer either — there's no workflow, action-pin, or trigger content in this diff for it to have covered.

No security concerns to report on this PR.

@kyle-sexton
kyle-sexton merged commit 7e4842d into main Aug 6, 2026
32 checks passed
@kyle-sexton
kyle-sexton deleted the docs/row229-pricing branch August 6, 2026 00:52
kyle-sexton added a commit that referenced this pull request Aug 6, 2026
…aces (#1950)

No linked issue

Row 145 of the doc-alignment campaign (lane P). Four items plus the
changelog entry item (a) owes. Live pages fetched **2026-08-04** via the
campaign's raw-markdown channel (`.md` appended to the `code.claude.com`
URL path); the shipped docs cite the reader-facing non-`.md` URLs.

## (a) `docs/conventions/loop-lane/README.md` — pointer-not-copy

The `PushNotification` paragraph enumerated four of Remote Control's
requirements. The live
[Requirements](https://code.claude.com/docs/en/remote-control) section
carries five bullets — Subscription, Authentication, API endpoint,
Feature-flag evaluation, Workspace trust — and three of the four
enumerated conditions under-covered their live counterparts (evidence in
item (e)).

Extending the list would re-drift: the section carries version-dated
clauses of its own ("As of v2.1.196…"). The paragraph already cited the
page, so the enumeration is replaced by a pointer at the Requirements
section **and** the page's mobile-push setup steps, with exactly one
fact kept inline: `DISABLE_TELEMETRY`, `DO_NOT_TRACK`,
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, and `DISABLE_GROWTHBOOK`
each disable the feature-flag evaluation Remote Control depends on. This
repo ships OTEL and hook-telemetry conventions, so its readers are the
population that sets those variables. The Team/Enterprise Owner toggle
is deliberately left to the pointer — it is a research-preview-era
default. Net 6 lines replacing 7: a conversion, not an extension.

## (b) `plugins/playbooks/skills/boris/reference/advanced.md` §35 —
amended, per precedent

Tweet-sourced (March 2026): "Available on Max, Team, and Enterprise
(v2.1.74+)." Upstream now states the availability two ways in two
places, and the amendment quotes **both** verbatim rather than picking
one: the page note reads "in research preview and available on all
plans", while Requirements reads "available on Pro, Max, Team, and
Enterprise plans". The amendment names Requirements as owning the
current list.

This file is a repo-authored distillation, not the frozen vendor capture
(`SKILL.md`: "The verbatim upstream baseline lives at `vendor/SKILL.md`
for drift detection only"), and `scripts/update.sh` states that
integration into `reference/*.md` is manual — so a hand-edit survives
the next sync.

Precedent followed rather than chosen on taste: `reference/autonomy.md`
§72 lines 205–220 amends a tweet-sourced claim that upstream moved past
with an **"Amended (verified DATE against LINK)"** blockquote — original
preserved, upstream quoted verbatim, recheck trigger.
(`reference/orchestration.md:22` was considered and rejected as the
model: that is a tweet superseded by a later *tweet*, not by upstream
docs.)

## (c) `plugins/playbooks/reference/model-adaptation/opus-4-8.md` —
dating record

The Sources note said the Opus 4.8 guide "has not been re-read at all
since then". It was re-read 2026-08-04 (ROSTER row 221 close-out).
Re-verified independently for this PR: literalism at lower effort,
strict effort adherence with `xhigh` for coding and `high` as the
intelligence-sensitive floor, reasoning favored over tool calls, fewer
subagents by default, native progress updates, response-length
calibration, and the code-review-harness recall effect with
coverage-before-filtering — all present, no material drift. The note now
records the re-read instead of an absence.

## (d) `plugins/playbooks/skills/fable-5/context/verification.md` — link
text

`[Slash commands]` → `[Commands]`; that page's live H1 is `# Commands`.
URL unchanged.

## (e) `docs/conventions/loop-lane/CHANGELOG.md` — **8.0.1**, the entry
item (a) owes

Codex P2 on `README.md:274`, verified real. The convention's own
§Versioning (`README.md:713-725`) states: "A firing that finds drift
lands its outcome as a changelog entry; a no-drift firing refreshes the
claim's verification date in place — no entry, no bump". Item (a) found
drift, so it fires the entry-owing branch, and the original diff left
this file at 7.0.1.

The drift was re-established from raw bytes rather than from any
second-hand description (`curl
https://code.claude.com/docs/en/remote-control.md` → **HTTP 200, 42173
bytes**, 2026-08-04), diffed against `git show
origin/main:docs/conventions/loop-lane/README.md`. Three evidenced
mismatches:

1. **Feature-flag evaluation** had no counterpart in the four-item
enumeration at all — the load-bearing one, and why the PR keeps that
fact inline.
2. **API endpoint** under-covered the `ANTHROPIC_BASE_URL` clause, which
the live bullet self-dates "As of v2.1.196".
3. **Subscription** under-covered the Team/Enterprise Owner-toggle
precondition.

Deliberately **not** written into the entry: any claim that the section
"moved" or "changed". No prior page snapshot exists, so only a state
mismatch is evidenceable, and that is how the entry is phrased. The live
page's two availability statements — "all plans" in the page note, "Pro,
Max, Team, and Enterprise plans" under Requirements — are page-internal
looseness, not drift against this repo: the pre-change README's tier
list already matched Requirements verbatim.

## Version and rebase dependencies

Two separately versioned artifacts, two claims: `plugins/playbooks`
0.6.16 → **0.6.19**, and `docs/conventions/loop-lane/CHANGELOG.md` →
**8.0.1**. `docs/conventions/` is not a plugin, so the loop-lane entry
carries no plugin-version implication and `playbooks` stays at 0.6.19.

**Playbooks chain, in order:**

`#1931` (playbooks 0.6.17) → `#1942` (playbooks 0.6.18) → **this PR
#1950** (playbooks 0.6.19) → a forthcoming consolidation PR (playbooks
0.6.20)

**Plus a newly discovered dependency:** this PR now also claims
`docs/conventions/loop-lane/CHANGELOG.md` **8.0.1**, which sits above
the unmerged **8.0.0** claim in **#1830**
(`feat/1525-trusted-internal-bot-logins`, not draft — the only other
open PR touching that file). **This PR must therefore be rebased after
#1830 lands as well.** `8.0.1` rather than `7.0.2` because the
campaign's serialization rule takes patch+1 above the highest claim
merged *or* unmerged; `7.0.2` would only be correct if this PR landed
first, and merge ordering is not controlled here.

`check-changelog-parity.sh --check-order` compares **version** order,
not dates, so the post-rebase sequence `8.0.1 / 8.0.0 / 7.0.1` is
ordered correctly despite 8.0.0 carrying the earlier date.

## Verification

- `scripts/check-changed-skills.sh origin/main` — PASS, 0 errors (boris,
fable-5)
- `scripts/check-changelog-parity.sh` `--check`, `--check-bump
origin/main`, `--check-order` — all pass, re-run after the 8.0.1 entry
(`All 71 changelog(s) read newest-first with no duplicate versions`)
- `markdownlint-cli2` on all changed markdown files — 0 errors

## Reported, not shipped


`plugins/playbooks/skills/skill-authoring/reference/verification-loops-in-skills.md:73`
carries the same stale `[Slash commands]` link text at the same URL.
Same fix, same plugin — held out of this PR because the row's scope is
fixed at four items.

## Related

- Doc-alignment campaign ROSTER row 145 (Remote Control), lane P
- ROSTER row 221 — the Opus 4.8 guide re-read this PR's item (c) records
- #1931, #1942 — unmerged `playbooks` version claims this PR sequences
behind
- #1830 — unmerged `docs/conventions/loop-lane/CHANGELOG.md` 8.0.0 claim
this PR's 8.0.1 sequences behind
- <https://code.claude.com/docs/en/remote-control>,
<https://code.claude.com/docs/en/tools-reference>,
<https://code.claude.com/docs/en/commands>,
<https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-4-8>

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Fable 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