Skip to content

docs: close round-2 blind-reader findings (migration readiness) - #27

Merged
budhash merged 1 commit into
mainfrom
docs/migration-round2
Jul 16, 2026
Merged

budhash merged 1 commit into
mainfrom
docs/migration-round2

Conversation

@budhash

@budhash budhash commented Jul 16, 2026

Copy link
Copy Markdown
Owner

Round 2 of the blind cold-clone audit (fresh agent, no access to round 1's report) ran against main after #26. The resume-point probe now lands (#14 with acceptance shape, #25 folded in, owner-reserved decisions identified). Four residual findings, all closed here:

Finding Treatment
examples/TASKS.md billed as fully populated but predates milestones (no @milestone=, no registry, Meta tag list stops at @done=) Registry added (M1/alpha active, M2/beta planned); assignments made via the CLI; Meta tag list updated. validate passes; milestone rollup renders.
CHANGELOG v1.0.0 "155-scenario" mislabel misleads (reader proved 155 = assertions, 30 = scenarios by running the old suite) Additive editor's note under the entry — history not rewritten, per convention
MEMORY.md overclaim: "every design decision … in specs/" (milestone spec lived off-repo in taxjot) Reworded to state exactly which rounds have in-repo specs and where the milestone feature's surviving spec/rationale live
"make test prints the live count" ambiguous; CLAUDE.md said gh release create is optional while practice is every-release Both clarified

make check green (298/298). One more blind round runs after this merges to confirm convergence.

https://claude.ai/code/session_01UquRBmRrh52iyPFuFQna5q

Second blind cold-clone audit (after #26) found four residuals:

- examples/TASKS.md predated milestones despite being billed as fully
  populated: add a # Milestones registry (M1/alpha, M2/beta), assign
  @milestone via the CLI (F-0001 -> m1, T-0004 -> beta), and add
  @milestone= to the Meta tag list. Still validates; rollup works.
- CHANGELOG v1.0.0 '155-scenario' mislabel: additive editor's note
  (155 counted assertions; suite was 30 scenarios / 155 assertions) —
  entries stay unrewritten per convention.
- MEMORY.md overclaimed that every design decision has an in-repo spec;
  now states the milestone spec lived off-repo (taxjot) and where its
  surviving spec/rationale actually are.
- Wording: 'make test prints the live assertion count' (it does not
  print scenario counts); CLAUDE.md releasing now lists gh release
  create as standard practice (matches every release since v1.1.0).

Claude-Session: https://claude.ai/code/session_01UquRBmRrh52iyPFuFQna5q
@budhash
budhash merged commit abe2631 into main Jul 16, 2026
5 checks passed
@budhash
budhash deleted the docs/migration-round2 branch July 16, 2026 06:55
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