Skip to content

docs: fix stale pre-mode claims and review nits from #737 - #747

Merged
johnleider merged 1 commit into
masterfrom
docs/claude-md-followup
Jul 28, 2026
Merged

docs: fix stale pre-mode claims and review nits from #737#747
johnleider merged 1 commit into
masterfrom
docs/claude-md-followup

Conversation

@johnleider

@johnleider johnleider commented Jul 28, 2026

Copy link
Copy Markdown
Member

Summary

Follow-up to #737. That PR correctly trimmed always-loaded context and scoped the checklist, but it migrated present-tense pre-mode instructions into the new releasing skill after the repo had already exited pre mode (#687) and shipped stable 1.0.x.

Critical

  • Drop “the repo is in changesets pre mode” from CLAUDE.md and .claude/skills/releasing/SKILL.md
  • Reframe as optional pre-channel workflow (pre enter → ship → pre exit), gated on .changeset/pre.json existing

Important

  • Explicit path on the skill pointer: .claude/skills/releasing/SKILL.md
  • pnpm metrics comment: CI metrics-regen only; local iteration is pnpm test:bench (do not commit artifacts from feature branches)
  • Checklist paths: frontmatter matches sibling single-line style

Suggestions

  • Keep isThenable named in the utilities pointer
  • release:prepare listed under skill Commands
  • Checklist marked path-scoped in Detailed Rules index
  • apps/docs/CLAUDE.md: ::: gn-example is canonical for feature pages; DocsExample recipe scoped to .vue pages

Test plan

  • No .changeset/pre.json on master; skill no longer claims pre mode as current
  • Skill file resolves at the path CLAUDE.md cites
  • Checklist paths: globs unchanged, style aligned with other rules
  • Skim CLAUDE / skill / docs CLAUDE in a fresh agent turn for residual pre/beta present-tense

#737 lazy-loaded release guidance but kept present-tense "repo is in
pre mode" after the 1.0.0 cut (#687). Correct that, and land the rest
of the review follow-ups:

- CLAUDE.md / releasing skill: drop false pre/beta state; reframe as
  optional pre-channel re-entry; point at skill path explicitly
- CLAUDE.md: metrics is CI-only (local: test:bench); keep isThenable
  in the utilities pointer; note checklist is path-scoped
- releasing skill: add changeset / release:prepare commands
- new-feature-checklist: match sibling single-line paths frontmatter
- apps/docs/CLAUDE.md: gn-example is canonical for feature pages
@johnleider
johnleider merged commit 6591474 into master Jul 28, 2026
21 checks passed
@johnleider
johnleider deleted the docs/claude-md-followup branch July 28, 2026 18:31
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