Skip to content

docs(pm-dispatch): subagent default for S+M with per-dispatch model tiering; seat-post read boundary - #7946

Merged
os-zhuang merged 1 commit into
mainfrom
claude/issue-7944-pm-skill-backend-and-reads
Aug 12, 2026
Merged

docs(pm-dispatch): subagent default for S+M with per-dispatch model tiering; seat-post read boundary#7946
os-zhuang merged 1 commit into
mainfrom
claude/issue-7944-pm-skill-backend-and-reads

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Fixes#7944
Fixes#7942

ADR-class (skills root): draft PR, human merge — no auto-merge, no queue entry.

Per-member checklist

  • pm-dispatch SKILL: M-grade cards default to the subagent backend with per-dispatch model tiering — cloud reserved for L/XL, long-lived, browser-verify (maintainer ruling 2026-08-12) #7944 (backend/sizing revision) — landed in .claude/skills/pm-dispatch/SKILL.md: the mode: row of the argument table and the 「资源与后端」 paragraph of the dispatch section now carry the 2026-08-12 ruling (S-mechanical + M ⇒ mode:subagent with per-dispatch model tiering; mode:cloud reserved for L/XL, work that must outlive the PM session, browser/dogfood verification, and build-heavy M by explicit judgment; archive duty narrows to cloud cards). The cloud-vs-subagent trade-off rationale (three fixed taxes vs the one real cost and its mitigations) is recorded on demand in references/dispatch-runbook.md under the cloud-lessons section. The mandatory claude-fable-5 clause for cards editing the pm-dispatch skill is unchanged; the model-resolution facts (env var → per-call param → frontmatter → inherit) were already present in the Model tiering paragraph and stay.
  • pm-dispatch SKILL: seat-post reads cover only comments newer than the last body edit (token-waste fix, maintainer-approved) #7942 (seat-post read boundary) — one principle line added to the seat-post section of SKILL.md (takeover and patrol read the post body plus only comments newer than the body's last edit — older comments were absorbed by that edit and are archive, not state), with the fuller rule (rationale + how to compare the timestamps) in references/seat-post-protocol.md, which loads on demand at takeover time.

Ratchet accounting (ceiling 686, headroom 0)

The file stays at exactly 686 lines. Additions were offset inside the touched sections:

  • Backend paragraph: rewritten 5 → 6 lines; dropped the sentence restating os-dev's parallel-memory discipline (it is normative in .claude/agents/os-dev.md, not here) and the redundant "size is not a sufficient criterion" clause (implied by "S-but-not-mechanical gets M treatment", which stays).
  • Cloud-lessons paragraph: 11 → 9 lines; the self-drive clause's expansion ("never end a turn for questions / mid-task status") and the roster mechanism prose were compressed — both remain spelled out in references/dispatch-runbook.md.
  • Model tiering paragraph: reflowed 11 → 10 lines; dropped 「多面语义」 from the opus examples (subsumed by 「任何带设计判断的卡」).
  • Seat-post paragraph: read-boundary principle folded in at +2 lines; the token-tax rationale lives in the reference file only.

No semantic loss beyond the rationalized drops listed above; no issue-ID citations added (id-lint green).

Gates (local, honest readings)

  • check:pm-skill-ratchet — green (686 lines, ceiling 686, headroom 0; self-test 5/5)
  • check:pm-skill-id-lint — green (8 files clean; self-test 9/9)
  • check:skill-frame-sync — green (4 copies isomorphic; self-test 12/12)
  • check:doc-authoring — green (375 files clean; self-test green)
  • check:nul-bytes — green (7279 text files scanned; self-test 75 assertions)

Generated by Claude Code

…; seat-post read boundary
Backend revision (maintainer ruling 2026-08-12): S-mechanical + M cards
dispatch as mode:subagent with per-dispatch model tiering; mode:cloud is
reserved for L/XL, work outliving the PM session, browser/dogfood
verification, and build-heavy M by judgment. The archive duty narrows to
cloud cards. Rationale recorded in references/dispatch-runbook.md.
Seat-post read boundary: at takeover and on patrol, read the post body
plus only comments newer than the body's last edit — older comments were
absorbed by that edit and are archive, not state. Detail in
references/seat-post-protocol.md.
Ratchet ceiling 686 held (headroom 0): additions offset in the touched
sections (backend paragraph, cloud-lessons paragraph, tiering reflow).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012Gg6rMAti8ZaueWb6BRsDn
@vercel

vercelBot commented Aug 12, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectstackIgnoredIgnoredAug 12, 2026 8:07am

Request Review

@os-zhuang

Copy link
Copy Markdown
ContributorAuthor

人类同意合并

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/sskip-changesetPR has no user-facing published change; bypasses the changeset gate

Projects

None yet

2 participants

@os-zhuang@claude