Skip to content

Commit 195d238

Browse files
Nick Websterclaude
andcommitted
docs(v0.11-release-prep-close): close-docs sweep — status flip + §3/§7 fill + workflow.md R-NEW-82 widening
CLAUDE.md "Status" flipped to v0.11.0 release-prep SHIPPED — ready for publish, EXTERNALLY BLOCKED on user push + npm publish; Live numbers refreshed to the M54-G IMPL baseline (4295 + 5 skip / 119 commands / branch 95.86% / functions 98.98% 1359/1373) + the new "Release-prep held all numbers" sentence; package.json version bumped to 0.11.0; the bulky M54-G narrative block collapsed to a plan-doc pointer per the v0.10 close-docs precedent (the per- milestone narrative belongs in `docs/v0.11-plan.md` §3 + §22 per `feedback_public_docs_clean` propagation forward); "Next session" pointer flipped to publish-coordination → v0.11.x / v0.12 candidate-selection per R-NEW-75 (E profile-scoped argument defaults queued standalone per the 2026-05-22 user binding); §3 v0.11-plan row refreshed to "Release-prep SHIPPED" with R-class outcomes. `docs/v0.11-plan.md`: §1 release-prep row flipped to SHIPPED; new §3 "release-prep — close" subsection at `413d0f8..<close-docs>` (4 commits — README Scope flip + version bump + CHANGELOG + this close-docs; ToC audit + deferral-slip + help-text-hygiene commits all skipped after CLEAN gates per R-NEW-82's widened "if clean, skip" sub-rule); §7 exit checklist filled (mirrors v0.10 §7 format with a publish line pending the user). `.claude/rules/workflow.md`: R-NEW-82 body widened at this 3rd- consecutive 4-commit cluster threshold — folds three OPEN watch-items inline: - R-v0.10-NEW-6 GRADUATED ("if clean, skip" sub-rule named on the three conditional commit slots — deferral-slip, help-text- hygiene, ToC-audit). - R-v0.9-NEW-14 GRADUATED ("clean by construction when no deferred wire leg ships" framing — cites v0.9 M50 deletion + v0.10 M53 pure refactor + v0.11 M54-G pure-additive as the three structurally-distinct classes named in the M54-G IMPL- close-widened "Pre-flights with no deferred wire leg need NO stub literal" rule). - R-v0.10-NEW-7 RESOLVED (bidirectional cross-ref between R-NEW-82 + R-v0.9-NEW-13's "Post-publish flip commit pattern" — placeholder convention origin + post-publish backfill side now point at each other). `docs/v0.11-plan.md` §22 R-class register: R-v0.8-NEW-21 CLOSED- RESOLVED at 4th-consecutive CLEAN hygiene sweep (closed rather than graduated — the v0.10-M53 NOUN_DESCRIPTIONS structural fix + `feedback_public_docs_clean` user-memory + R-NEW-82's widened "if clean, skip" sub-rule cover the discipline already); R-v0.10-NEW-6 + R-v0.9-NEW-14 + R-v0.10-NEW-7 all flipped to GRADUATED/RESOLVED per the workflow.md fold above; R-v0.9-NEW-15 re-ratified (2nd dedicated consumer of the widened README checklist — all three surfaces applied verbatim). Skip Codex review (R-NEW-84) — release-prep is mechanical / process-only, zero production `src/**/*.ts` semantic changes; gates (typecheck + lint + 4295 pass + 5 skipped + npm audit 0) carry verification. `<close-docs>` / `<close-docs-sha>` SHA placeholders (6 in CLAUDE.md + 8 in docs/v0.11-plan.md, 14 total) will be backfilled at the post-publish flip commit per the GRADUATED R-v0.9-NEW-13 rule. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 11a3e24 commit 195d238

3 files changed

Lines changed: 432 additions & 204 deletions

File tree

.claude/rules/workflow.md

Lines changed: 38 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -277,19 +277,50 @@ slot** (feature shipped), or **drop the rejection** (no longer
277277
planned). Matching test pins + doc prose + module docstrings update
278278
in lockstep.
279279

280-
Release-prep is a 6-commit baseline: envelope-snapshot refresh probe
281-
+ ToC audit + deferral slip + README quickstart refresh + version
282-
bump + CHANGELOG + close-docs sweep.
283-
284-
R-NEW-82 (graduated v0.5 release-prep).
280+
**Release-prep is a 6-commit baseline** (envelope-snapshot refresh
281+
probe + ToC audit + deferral slip + README refresh + version bump +
282+
CHANGELOG + close-docs sweep), but **conditional commits skip when
283+
the corresponding gate runs CLEAN**: the deferral-slip commit skips
284+
when the grep returns zero hits; the help-text-hygiene commit skips
285+
when the `.description()` / `.summary()` / `addHelpText()` sweep
286+
across `src/commands/**` surfaces no internal refs; the ToC-audit
287+
commit skips when `output-shapes.md` + `cli-design.md` already
288+
carry the milestone's surfaces. Three consecutive 4-commit clusters
289+
at v0.9 / v0.10 / v0.11 ratified the "if clean, skip" sub-rule
290+
into the baseline.
291+
292+
**When the IMPL ships with no deferred wire leg** (the three
293+
structural classes named in the "Pre-flights with no deferred wire
294+
leg need NO stub literal" rule above — deletion, pure refactor,
295+
pure-additive new verb), the deferral-slip grep runs CLEAN BY
296+
CONSTRUCTION rather than as an empirically-empty result — no
297+
deferred leg ever shipped, so no slot can be stale. v0.9 M50
298+
(deletion) was the 1st instance, v0.10 M53 (pure refactor) the
299+
2nd, v0.11 M54-G (pure-additive new verb) the 3rd.
300+
301+
The **close-docs commit leaves `<close-docs>` / `<close-docs-sha>`
302+
placeholders** that the post-publish flip backfills — the close-
303+
docs commit can't reference its own SHA. The placeholder convention
304+
is the close-docs SIDE of R-v0.9-NEW-13's "Post-publish flip commit
305+
pattern" (below); both rules cover the same placeholder lifecycle
306+
from opposite ends of the cycle.
307+
308+
R-NEW-82 (graduated v0.5 release-prep; widened v0.11 release-prep
309+
close at the 3rd-consecutive 4-commit cluster threshold to fold in
310+
R-v0.10-NEW-6's "if clean, skip" sub-rule, R-v0.9-NEW-14's "clean
311+
by construction when no deferred wire leg ships" framing, and
312+
R-v0.10-NEW-7's cross-reference to R-v0.9-NEW-13 for the post-
313+
publish placeholder backfill).
285314

286315
## Post-publish flip commit pattern
287316

288317
After `npm publish` lands the release, write ONE small commit that
289318
flips status forward + retires the placeholders the close-docs
290319
commit couldn't fill itself. The close-docs commit can't reference
291-
its own SHA, so it leaves `<close-docs>` placeholders that the
292-
post-publish commit backfills once `git rev-parse HEAD` is stable.
320+
its own SHA, so it leaves `<close-docs>` placeholders (the
321+
convention is defined in R-NEW-82's release-prep close-docs shape
322+
above) that the post-publish commit backfills once `git rev-parse
323+
HEAD` is stable.
293324

294325
The shape (4 steps, single commit):
295326

0 commit comments

Comments
 (0)