docs: describe the settled v0.8.0 surface, not the release that made it - #37
Merged
Conversation
The docs were accurate but still written as release notes: the README opened on a "Status: proof of concept" banner listing what v0.8.0 removed, and CLAUDE.md opened on the same archaeology. That is the first thing a reader meets and the last thing they need, now that 0.8.0 is the version everyone starts on. README: drop the top banner, open on the pitch, and collect everything it carried — the removed commands and flags, the init skill change, the v0.6.0 pin, the never-tagged 0.7.0 — into one "What changed in v0.8.0" section at the end, linked from a single line above the command list. CLAUDE.md: retitle the opener to "The shape of this repo" and keep only what is durable instruction — the subtractive bias, registry.ts as the authority on what exists, a don't-reintroduce list that records where each removal's replacement lives, and the v0.7.0 trap. Two drift fixes along the way: src/bridge.ts was described in the architecture prose but missing from the project-layout tree, and docs/commands.html was credited to v0.7.0 when the page itself is titled v0.8.0. package.json's description (like the GitHub one, updated separately) still described a docs-push tool and predated the tabs bridge entirely. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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 free
to 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.
The docs were accurate —
bun run src/index.ts helpmatches the README's command block verbatim, and CLAUDE.md's protocol/ring/timeout numbers all check out against the source. What was stale is the framing: both files opened as v0.8.0 release notes ("Status: proof of concept", "v0.8.0 is the subtraction", the never-tagged-0.7.0 archaeology). That's the first thing a reader meets and the last thing they need, now that 0.8.0 is where everyone starts.README
tabscommands, the three removed flags and why each was a flag that could only ever be wrong,init's one-skill change (with the "re-runtabbrew init" note for anyone set up before 0.8.0), thev0.6.0pin, and the never-tagged 0.7.0.--out/--port, "it does not wait for an answer", the two-skills note); only thetabs-history.jsonlline was reworded, since it leaned on the banner for context.CLAUDE.md
## Status: past the POC→## The shape of this repo, keeping only durable instruction: the subtractive bias,registry.ts+git logas the authority on what exists, a don't reintroduce list that records where each removal's replacement lives (tabs watch→/loop,tabs push/check→tabs suggest), and the v0.7.0 trap.Two drift fixes
src/bridge.ts(added in e25def8) was described in the architecture prose but missing from the project-layout tree.docs/commands.htmlwas credited to v0.7.0; the page itself is titledtabbrew CLI v0.8.0.Also, outside this diff
package.json'sdescriptionstill described a docs-push tool and predated the tabs bridge — updated here. The GitHub repo description and topics were changed directly (not versionable): the description now leads with the tab loop, andtab-management+device-flowwere added to the existing eight topics.Verification
bun run typecheckandbun testpass (20/20).bun run src/index.ts helpoutput is unchanged and still matches the README's command block.src/*.tsnow appears in CLAUDE.md's layout tree; the#what-changed-in-v080anchor resolves.initdeletestabbrew-auto.🤖 Generated with Claude Code