Conversation
A pre-release check that found something, rather than a change anyone asked for. ## Problem `HISTORY.md`'s Version 2.0 entry enumerates what this repository became: *"the shared fleet rules, a machine-readable `spec/`, the fleet `registry/`, per-repo audit `reports/`, branch rulesets, and the `AUDIT.md` convergence procedure."* Three things shipped since are **peers of the items in that list** and appear nowhere in it: - **`RESYNC.md`**, now the third procedure an agent routes between, not a detail of the second - **The host tool contract** and its version floors, `spec/host-tools.json` plus a carried `host-tools.json` per repository - **The derived detector** for files the hub hosts rather than carries, so a retired file is found rather than remembered ## Why it was worth catching first A patch release cut against this entry would have published a changelog whose summary omits the session's main deliverable. A reader asking how a repository resyncs would find an enumeration naming only the procedure that *measures*. `HISTORY.md` is per minor version rather than per patch, so nothing is owed for a routine `2.0.x`. What is owed is that the 2.0 summary stay true about what 2.0 contains, and it had stopped being true. ## The pattern, third time today This is the same shape as the `spec/` enumerations corrected in [#653](#653) and the `Repository Layout` bullet corrected downstream in Blog: **a list that was accurate when written, going stale under a change that never mentioned it, with no gate that reads it.** The recurrence is worth noting on its own. Three instances in one session suggests enumerations are a standing hazard rather than three accidents, and the deletion sweep's new "read the files whose job is to say what the repo holds" ([#660](#660)) covers deletions only. Additions have no equivalent instruction. Not fixing that here. ## Verification The `README.md` and `HISTORY.md` openings must mirror per `spec/readme-structure.md`, so that was checked rather than assumed: titles match, taglines match, using the audit's own extraction. `cspell` on both gated files clean, `prose_lint --diff HEAD` clean, `markdownlint-cli2` clean, `editorconfig-checker` clean, CRLF preserved byte-wise. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the Version 2.0 release-history entry to accurately reflect the repository's current governance/audit scope before the next release cut from main.
Changes:
- Expands the Version 2.0 bullet to include the three agent procedures (
STANDUP.md,AUDIT.md,RESYNC.md). - Notes the host tool contract files (
spec/host-tools.json,host-tools.json) and the derived “hub-hosted vs carried” detector.
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Uh oh!
There was an error while loading. Please reload this page.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
One squash: #662 at
31880f0.Merge with a merge commit, never a squash, and never with
--delete-branch— this PR's head isdevelop.Why it wants promoting before the release, not after
HISTORY.md's Version 2.0 entry enumerates what this repository contains and had stopped at theAUDIT.mdconvergence procedure, omitting three peers of the things it lists:RESYNC.md, the host tool contract and its version floors, and the derived detector for files the hub hosts rather than carries.A release cut against the previous text publishes a changelog whose summary omits the work. The release reads
main, so this promotion is the last step before a dispatch is worth making.Verification
README.mdandHISTORY.mdmust open as twins perspec/readme-structure.md, checked with the audit's own extraction rather than by eye: titles match, taglines match.cspellclean on both gated files,prose_lint,markdownlint-cli2andeditorconfig-checkerclean, CRLF preserved byte-wise.🤖 Generated with Claude Code