skills(pm-dispatch): optimization flight — monorepo-only lore cut, the report JSON printed once, upstream reporting pointed at objectstack-platform, five drifts synced to the dev contract (net −2,982 tokens) (#14444)

* skills(pm-dispatch): PMD-C-01/E-05/E-02/E-03 — cut monorepo-only lore, point upstream reporting at objectstack-platform

PMD-C-01: the 882-token upstream-reporting job becomes a residue that points at
objectstack-platform's "The App / Platform Boundary" section by heading and keeps
only what this loop adds (derive the upstream repo, actionable report, file as a
guest, park honestly).
PMD-E-05: "Multiple PMs — shard by repository" collapses to one Guardrails bullet.
PMD-E-02: "One semantics, N independent implementations" retired from the
published surface (a platform compiler concern, not an app project's).
PMD-E-03: the two platform-governance non-escalation bullets deleted; the frame
block below them is untouched (check:skill-frame-sync green).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LraLgQVGq8egUwfYZpbYt1

* skills(pm-dispatch): PMD-B-03/B-02/G-01 — one sanitizer rule, one report JSON, no PM-authored PRs

PMD-B-03: the sanitizer specimens are gone; the rule and its measured one-line
evidence stay.
PMD-B-02: the report JSON is printed once (in the template); the "Report
contract" section keeps only the two rules the second copy added.
PMD-G-01: "the PM's own tooling PRs" clause deleted — it contradicted
"The PM writes no files".

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LraLgQVGq8egUwfYZpbYt1

* skills(pm-dispatch): PMD-F-01..F-05 — sync five drifts to the dev contract; "enforces" reads "requires"

F-01: the report is delivered twice in both modes, GitHub first, first line the
literal plaintext marker (never an HTML comment), read back; the "lossless
channel" claim is gone (it was contradicted by the collect step).
F-02: the template re-checks the issue's premises; the report carries
premise_still_valid, and a no-PR report with premise_still_valid: false plus
evidence is a first-class delivery.
F-03: never git stash — the stack lives in the common .git and is shared by
every worktree; park work as a wip commit or a patch file.
F-04: the claim comment carries a Session: line; the race check reads session
ID or branch.
F-05: the empty branch is pushed before any edit (also the write-access probe),
so the stale-claim reclaim can never fire against a live agent.
IF-2: the PM-side resource paragraph says the template "requires" the lock, not
"enforces" it — the mechanism is the host project's.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LraLgQVGq8egUwfYZpbYt1

* skills(pm-dispatch): PMD-D-01/D-02/D-03/E-04 — rewrite anecdotes and the lock design spec as constructs

PMD-D-01 (+E-01): the sweep rationale keeps the three-disjunct predicate, the
scoping caution and the updated_at floor; the cross-seat producers, the
"steward automation" / "lane" / "protocol posts" vocabulary and the anecdote go.
PMD-D-02: the eight-card baseline sample is gone; the rule that the baseline is
measured in your own project stays.
PMD-D-03: the cancelled-timer anecdote is gone; the two check-in rules stay.
PMD-E-04: the four correctness properties of a lock wrapper the customer does
not have collapse to one line; the mechanism stays the host project's.
Also trims the PMD-C-01 residue to <= 250 tokens (the card's ceiling).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LraLgQVGq8egUwfYZpbYt1

* skills(pm-dispatch): PMD-A-01 — drop the "report a platform bug" trigger; regenerate the catalog

The description no longer advertises the upstream-reporting job (the doctrine
lives in objectstack-platform; this file keeps a pointer). skills/README.md and
content/docs/ai/skills-reference.mdx are generator output
(pnpm --filter @objectstack/spec gen:skill-docs), not hand edits.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LraLgQVGq8egUwfYZpbYt1

---------

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

Author: os-litant

content/docs/ai/skills-reference.mdx

@@ -52,7 +52,7 @@ ObjectStack ships **11 skills** — one per authoring domain, plus process skill
 | 7 | [API](#api) | `api` | `skills/objectstack-api/` | Design the server-side API surface that an ObjectStack runtime exposes — REST endpoints, auth providers, realtime channels, error envelopes, batch/versioning contracts. |
 | 8 | [i18n](#i18n) | `i18n` | `skills/objectstack-i18n/` | Author ObjectStack translation bundles — object/field labels, view text, app navigation strings, automation messages — and configure locale fallback, coverage reporting, and the per-locale source layout. |
 | 9 | [Formula](#formula) | `expression` | `skills/objectstack-formula/` | Author CEL expressions used across ObjectStack — formula fields, field conditional rules (`visibleWhen`, `readonlyWhen`, `requiredWhen`), validation / sharing / visibility predicates, flow conditions, and dynamic seed values. |
-| 10 | [PM Dispatch](#pm-dispatch) | `process` | `skills/objectstack-pm-dispatch/` | Run a project-manager dispatch loop over a GitHub backlog: triage and queue ready issues, claim each one, dispatch it to a parallel developer agent that returns a structured JSON report, review the results against GitHub, and drive accepted pull requests to landing — escalating to the maintainer only what genuinely needs a human decision. Ships the developer-agent operating template the loop injects into every dispatch (no custom agent types required) and the upstream-reporting procedure for platform defects an app project finds. |
+| 10 | [PM Dispatch](#pm-dispatch) | `process` | `skills/objectstack-pm-dispatch/` | Run a project-manager dispatch loop over a GitHub backlog: triage and queue ready issues, claim each one, dispatch it to a parallel developer agent that returns a structured JSON report, review the results against GitHub, and drive accepted pull requests to landing — escalating to the maintainer only what genuinely needs a human decision. Ships the developer-agent operating template the loop injects into every dispatch (no custom agent types required). |
 | 11 | [Upgrade](#upgrade) | `process` | `skills/objectstack-upgrade/` | Upgrade an ObjectStack metadata project across a protocol major — run the deterministic conversion chain, then work the semantic residue the chain cannot express (intent choices, custom code on retired APIs, stale prose) to a decision with the project's owner, and finish with a green `validate` plus a human-readable upgrade report. |
 
 ---
@@ -187,9 +187,9 @@ Do not use for SQL fragments (driver-native), cron schedules (cron dialect), or
 
 **Domain** `process` · **Path** `skills/objectstack-pm-dispatch/`
 
-Run a project-manager dispatch loop over a GitHub backlog: triage and queue ready issues, claim each one, dispatch it to a parallel developer agent that returns a structured JSON report, review the results against GitHub, and drive accepted pull requests to landing — escalating to the maintainer only what genuinely needs a human decision. Ships the developer-agent operating template the loop injects into every dispatch (no custom agent types required) and the upstream-reporting procedure for platform defects an app project finds.
+Run a project-manager dispatch loop over a GitHub backlog: triage and queue ready issues, claim each one, dispatch it to a parallel developer agent that returns a structured JSON report, review the results against GitHub, and drive accepted pull requests to landing — escalating to the maintainer only what genuinely needs a human decision. Ships the developer-agent operating template the loop injects into every dispatch (no custom agent types required).
 
-Use when asked to "work through the backlog", "batch-dispatch issues", "派发 issue 给开发 agent", to stand up a multi-agent delivery loop in an ObjectStack app project, or to report a platform bug found while building an app.
+Use when asked to "work through the backlog", "batch-dispatch issues", "派发 issue 给开发 agent", or to stand up a multi-agent delivery loop in an ObjectStack app project.
 
 Do not use for authoring ObjectStack metadata (the domain skills cover that), for a single already-scoped change you can just make, or as a replacement for the project's own conventions file — that file always wins.
 

skills/README.md

@@ -38,7 +38,7 @@ apps too).
 | [API](./objectstack-api/SKILL.md) | `api` | Design the server-side API surface that an ObjectStack runtime exposes — REST endpoints, auth providers, realtime channels, error envelopes, batch/versioning contracts. |
 | [i18n](./objectstack-i18n/SKILL.md) | `i18n` | Author ObjectStack translation bundles — object/field labels, view text, app navigation strings, automation messages — and configure locale fallback, coverage reporting, and the per-locale source layout. |
 | [Formula](./objectstack-formula/SKILL.md) | `expression` | Author CEL expressions used across ObjectStack — formula fields, field conditional rules (`visibleWhen`, `readonlyWhen`, `requiredWhen`), validation / sharing / visibility predicates, flow conditions, and dynamic seed values. |
-| [PM Dispatch](./objectstack-pm-dispatch/SKILL.md) | `process` | Run a project-manager dispatch loop over a GitHub backlog: triage and queue ready issues, claim each one, dispatch it to a parallel developer agent that returns a structured JSON report, review the results against GitHub, and drive accepted pull requests to landing — escalating to the maintainer only what genuinely needs a human decision. Ships the developer-agent operating template the loop injects into every dispatch (no custom agent types required) and the upstream-reporting procedure for platform defects an app project finds. |
+| [PM Dispatch](./objectstack-pm-dispatch/SKILL.md) | `process` | Run a project-manager dispatch loop over a GitHub backlog: triage and queue ready issues, claim each one, dispatch it to a parallel developer agent that returns a structured JSON report, review the results against GitHub, and drive accepted pull requests to landing — escalating to the maintainer only what genuinely needs a human decision. Ships the developer-agent operating template the loop injects into every dispatch (no custom agent types required). |
 | [Upgrade](./objectstack-upgrade/SKILL.md) | `process` | Upgrade an ObjectStack metadata project across a protocol major — run the deterministic conversion chain, then work the semantic residue the chain cannot express (intent choices, custom code on retired APIs, stale prose) to a decision with the project's owner, and finish with a green `validate` plus a human-readable upgrade report. |
 
 <!-- END GENERATED: skills -->