Skip to content

docs: refresh CLAUDE.md methodology track-record line to v1.0 (#336) #338

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dep0we merged 1 commit into from
Jun 5, 2026
Merged

docs: refresh CLAUDE.md methodology track-record line to v1.0 (#336) #338

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@ CHANGELOG entry.

- Post-v1.0 staleness sweep: `ROADMAP.md`, `docs/deployment/programmatic.md`, and `docs/spec/31-llm-backend.md` updated to reflect the v1.0 release (twelfth backend protocol shipped, MCPServerRegistryBackend added to lists, status copy flipped from future-tense to PyPI-install present-tense, spec/31 status line refreshed from "v0.13 era" to "v1.0"). Closes the three stragglers an audit found after the PR #334 v1.0 release sweep.
- Slimmed `CLAUDE.md` from 88k → 30k chars to clear the Claude Code 40k-char prompt budget. Extracted the per-protocol detail (the wall-of-text "What this is" paragraph and the bullet-per-backend Status block) into a new `docs/protocols-shipped.md` that owns the full reference impls / capabilities / operator overrides / doctor checks / Implementer Contracts / cliff-closed narrative for all twelve shipped backends. `CLAUDE.md` keeps the design ethos + a compact 12-row Status table that points to the detail file. Matches the framework's own "progressive disclosure" principle (rule 6 — load metadata in-prompt; lazy-load content).
- Refreshed `CLAUDE.md` §"Working methods" methodology track-record line from "4 published tags through v0.13.0, ~55 merged PRs, ~2.4k tests" to "7 published tags through v1.0.0, ~160 merged PRs, ~3.3k tests" (closes #336). Counts verified empirically: `git tag --list` → 7 tags, `gh pr list --state merged` → 159 PRs, `uv run pytest --collect-only -q` → 3,326 tests. The "no production rollback events" claim is preserved verbatim.

## [1.0.0] - 2026-06-04

Expand Down
2 changes: 1 addition & 1 deletion CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -219,7 +219,7 @@ Every release: `vX.Y.Z` git tag + GitHub Release with CHANGELOG entry verbatim.

## Working methods

These are the methods that have produced this codebase's quality (4 published tags through v0.13.0, ~55 merged PRs, ~2.4k tests, no production rollback events). Captured here to survive the session that produced them. Full retrospective in `docs/methodology.md`.
These are the methods that have produced this codebase's quality (7 published tags through v1.0.0, ~160 merged PRs, ~3.3k tests, no production rollback events). Captured here to survive the session that produced them. Full retrospective in `docs/methodology.md`.

### Always run `/ship` end-to-end — never bypass

Expand Down