Repository navigation
Commit abe980c
docs(pm-skill): rules-only rewrite of the readings ledger, the REST table and the eight lane job descriptions (#15641)
* docs(pm-skill): rewrite the readings ledger as rules only
One fact per line: the platform behaviour plus what a seat does because of
it. Numbers a seat acts on stay; how they were measured does not.
Four folded readings land here: the MCP list_issues labels array is a union
and its totalCount is the disjunction; the container GitHub egress is
proxy-credentialed; the job-log endpoint is refused by that proxy while the
check-run annotations endpoint carries the exit code; enable_pr_auto_merge
stores merge whatever was requested and the branch rule governs the landing
method. The clause-2 checker reading that no longer reproduces is restated
as its current reading rather than kept with a since-then tail.
397 -> 359 lines; 0 dates, 0 corner quotes, 0 non-table lines over 120 bytes.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox
* docs(pm-skill): rewrite the REST channel table as rules only
Per-operation channel ownership stays; the per-row provenance dates and the
measurement narrative go. The check mark keeps its operative meaning — this
shape was actually executed from a gate-open seat — because two rows are
documented-but-never-called and a reader has to be able to tell them apart.
Adds the update-branch route folded in from its own card: PUT on
pulls/{n}/update-branch is the zero-file-write way to merge origin/main into
a PR head, expected_head_sha must be the full 40-character SHA, and a base
that has not moved answers 422 with nothing to do rather than a failure.
88 -> 82 lines; 0 dates, 0 corner quotes, 0 lines over 120 bytes.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox
* docs(pm-skill): rewrite the eight lane job descriptions as rules only
Each lane keeps scope, duties per round, hand-offs and its never-list, in
plain lines a reviewer can read. What goes: the ruling citations and their
dates, the supersession ledgers recording which ruling moved a duty when,
the charter quotations, and the incident stories behind a rule. Where a
story IS a rule's condition it survives as one clause.
No scope moves in either direction; no current-state values (the cli lane's
dispatch-to-draft-PR baseline number goes, since the main file already says
the baseline is read from the lane's own record and is never a constant).
The skills lane's tier line now names tiers instead of model identifiers.
cli 31->29, devx 39->38, director 72->72, engine 36->32, hotcrm 57->53,
services 28->27, skills 35->33, spec 46->43; every file 0 dates, 0 corner
quotes, 0 lines over 120 bytes, no decision-frame fingerprint.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox
* docs(pm-skill): rewrite the three small references as rules only
release-aftercare keeps every duty and every number a seat acts on — the
latency-to-server-time shape, the 200ms gate boundary, the waker-follows
physics and the fixed protocol order — and drops the two-day operations
log that produced them. Where a failure mode IS the rule's condition it
survives as one clause with no date.
true-green keeps the per-repo invocation, the gates a CI-log grep cannot
see and the local preflight, one fact per line.
compile-surfaces keeps its lookup table. The surface rows are unchanged
byte for byte, so the widest-table-row pin stays where it is; only the
thawed row loses its two dates and the retired in-scope wording, and the
prose around the table loses its measurement provenance.
release-aftercare 58->50, true-green 33->32, compile-surfaces 26->24.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox
* chore(pm): re-pin the thirteen rewritten ceilings at their landed counts
All thirteen fall, none rises: platform-readings 397->359, rest-channel
88->82, release-aftercare 58->50, true-green 34->32, compile-surfaces
26->24, lanes engine 40->32, services 28->27, cli 31->29, devx 39->38,
skills 35->33, spec 46->43, hotcrm 57->53, director 77->72. Every widest
table-row pin is untouched, compile-surfaces included, because its widest
row is unchanged byte for byte.
The cross-file move declared on platform-readings needed one maintenance
edit the header itself prescribes. Its destination no longer stands 73
lines above the 314 it moved from — the rewrite handed 38 of those ruled
lines back — so the two ruledRaises records together read as an over-claim
and the gate refused them. The third-increment record is retired, which is
the header's own remedy for a ruled raise since given back; the intake
record stays, so the declaration reads +11 against a net source decrease
of 20 for a move that took +10. Under-pricing the move is the failure the
header warns about, and this errs the other way. The move's `was`, its
sources and their pre-move ceilings are untouched.
Ratchet green including its 155-case self-test; check-published-list-mirrors,
check-ratchet-remedy-authority, check-skills-token-ratchet and dispatch-gates
(1445 cases) all green on the edited script.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox
* docs(pm-skill): restore six literal spellings the identifier sweep found missing
Every backticked token in the thirteen old files was checked against the
thirteen new ones, the rewritten SKILL.md and the rewritten seven
references. Six of the misses were load-bearing spellings rather than
narrative, and each is restored inside an existing line so no ceiling moves:
the unexpanded matrix placeholder, the dev scratch directory name, the full
large-datasets pagination message, the merge-main command that is the only
fix for a stale rerun, the repository setting behind the auto-merge method
read-back, and the fully qualified spec zod path.
Eighteen misses stand and are listed in the PR body by reason: deliberate
tombstones, provenance the rules-only rewrite removes, spellings the
rewritten sibling files already carry, and equivalent short forms.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox
---------
Co-authored-by: Claude <noreply@anthropic.com>1 parent 0467941 commit abe980c
14 files changed
Lines changed: 780 additions & 800 deletions
File tree
- .claude/skills/pm-dispatch/references
- lanes
- scripts/pm
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | | - | |
| 1 | + | |
2 | 2 | | |
3 | | - | |
4 | | - | |
5 | | - | |
6 | | - | |
| 3 | + | |
| 4 | + | |
7 | 5 | | |
8 | | - | |
| 6 | + | |
9 | 7 | | |
10 | 8 | | |
11 | 9 | | |
| |||
15 | 13 | | |
16 | 14 | | |
17 | 15 | | |
18 | | - | |
| 16 | + | |
19 | 17 | | |
20 | | - | |
21 | | - | |
22 | | - | |
23 | | - | |
24 | | - | |
25 | | - | |
26 | | - | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | | - | |
| 1 | + | |
2 | 2 | | |
3 | | - | |
| 3 | + | |
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
9 | 9 | | |
10 | 10 | | |
11 | | - | |
12 | | - | |
13 | | - | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
14 | 14 | | |
15 | 15 | | |
16 | 16 | | |
17 | | - | |
18 | | - | |
19 | | - | |
20 | | - | |
21 | | - | |
22 | | - | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
23 | 22 | | |
24 | 23 | | |
25 | 24 | | |
26 | | - | |
27 | | - | |
28 | | - | |
29 | | - | |
30 | | - | |
31 | | - | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | | - | |
| 1 | + | |
2 | 2 | | |
3 | | - | |
| 3 | + | |
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
9 | 9 | | |
10 | | - | |
11 | | - | |
12 | | - | |
13 | | - | |
14 | | - | |
15 | | - | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
16 | 15 | | |
17 | 16 | | |
18 | 17 | | |
19 | | - | |
20 | | - | |
21 | | - | |
22 | | - | |
23 | | - | |
24 | | - | |
25 | | - | |
26 | | - | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
27 | 26 | | |
28 | 27 | | |
29 | 28 | | |
30 | | - | |
31 | | - | |
32 | | - | |
33 | | - | |
34 | | - | |
35 | | - | |
36 | | - | |
37 | | - | |
38 | | - | |
39 | | - | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
0 commit comments