Skip to content

docs(agents): refresh 'Current State' section to v0.16.0 + v1.0 milestone#563

Merged
MartinP7r merged 4 commits into
mainfrom
docs/refresh-claude-md-current-state
Jun 15, 2026
Merged

docs(agents): refresh 'Current State' section to v0.16.0 + v1.0 milestone#563
MartinP7r merged 4 commits into
mainfrom
docs/refresh-claude-md-current-state

Conversation

@MartinP7r

Copy link
Copy Markdown
Owner

Summary

Refreshes the 'Current State' section in AGENTS.md (CLAUDE.md → AGENTS.md is a symlink, both agents share). Previous text claimed v0.9.0 (shipped 2026-04-29) — 7 releases stale.

Ground truth verified:

  • Latest git tag: v0.16.0 (2026-05-20)
  • Cargo.toml workspace version: 0.16.0
  • CHANGELOG.md most recent shipped: [0.16.0] - 2026-05-20

Changes

Aspect Before After
Header version v0.9.0 (shipped 2026-04-29) v0.16.0 (shipped 2026-05-20)
Milestone framing 'between milestones; awaiting /gsd:new-milestone' 'v1.0 Desktop (Tauri GUI) active, ratified 2026-05-23'
Release detail 4 per-version bullets (v0.6–v0.9) 1 prose chain line (v0.6–v0.16); CHANGELOG.md is source of truth
Phase tracking (none) Compact 7-row table for Phases 25–31 with cuts + status
'why no v1.0 yet' (implicit) Explicit note: crates/tome-desktop is cargo-dist-excluded
Open carry-overs unchanged unchanged (still accurate)

Why

  • Flagged twice in deferred items: Phase 26 (26-deferred-items.md) and Phase 27 CONTEXT.md <deferred> section
  • AGENTS.md is the agent's first read; stale 'current state' actively misleads about which milestone we're in

Test plan

MartinP7r added 4 commits June 4, 2026 19:33
…tone

Previous state was 7 releases stale (claimed v0.9.0, 2026-04-29). Real
ground truth (verified via git tags + Cargo.toml + CHANGELOG.md):

- v0.16.0 shipped 2026-05-20 — last released CLI cut
- v1.0 Desktop (Tauri GUI) milestone ratified 2026-05-23, in progress
- Phase 25 (Rust core + Tauri spike) complete 2026-05-27
- Phase 26 (Read-only views, alpha cut) complete 2026-05-29
- Phase 27 (Sync + triage UI) in progress — context gathered 2026-06-02

Changes:
- Replace v0.9.0 header line with v0.16.0 + v1.0 milestone framing
- Replace 4 per-version detail bullets (v0.6–v0.9) with a single prose
  release-chain line covering v0.6–v0.16 (CHANGELOG.md holds the detail)
- Add v1.0 phase progression table (matches STATE.md shape, compact)
- Add note explaining why interim v0.10–v0.16 CLI releases shipped
  without v1.0 appearing (`crates/tome-desktop` is `cargo-dist`-excluded)
- Preserve open-carry-overs paragraph unchanged (still accurate:
  2 Linux UAT items + backup roundtrip flake)

CLAUDE.md is a symlink to AGENTS.md — both agents see the update.

Flagged in Phase 26 and Phase 27 deferred-items as a stale-doc carry-over.
Phase 26 shipped via PR #560 (merged); drop the stale '(PR #560 draft)'.
Phase 27 is now planned (7 plans) + fully executed + UAT underway, not
just 'context gathered'.
@MartinP7r MartinP7r marked this pull request as ready for review June 15, 2026 14:06
@MartinP7r MartinP7r merged commit 45a585f into main Jun 15, 2026
14 checks passed
@MartinP7r MartinP7r deleted the docs/refresh-claude-md-current-state branch June 15, 2026 14:11
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