Skip to content

docs: round-3 polish + LEARNINGS; bump to 1.4.1 (migration-ready) - #28

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

budhash merged 1 commit into
mainfrom
docs/migration-final

Conversation

@budhash

@budhash budhash commented Jul 16, 2026

Copy link
Copy Markdown
Owner

Round 3 blind reader (fresh agent, blind to rounds 1–2) rated every finding MATERIAL vs MINOR: zero material repo-fixable gaps — the loop has converged. The one MATERIAL item it kept is inherent and correctly mitigated: the roadmap's source of truth is the GitHub tracker, and the reader's own first action was to re-verify #14 there before coding, which is exactly what MEMORY.md tells it to do.

This PR closes the remaining MINOR findings and wraps the exercise:

Finding Fix
CLAUDE.md numbering note said issues/PRs are "different sequences" — reader disproved from our own disjoint numbers Corrected: one shared sequence, #N resolves to exactly one of the two
Milestone non-inheritance never stated (reader observed rollup vs --table divergence and had to guess) One sentence each in the docstring (spec), schema.md, README
CONTRIBUTING.md lossy vs actual process Squash-merge/never-main rule + gh release create step added
— LEARNINGS.md entry for the blind-dogfood loop; MEMORY.md self-healing tag note

Bumps __version__ to 1.4.1 with a CHANGELOG entry so the proposed migration-marker tag keeps the version↔tag consistency invariant. No tag is pushed — that's the owner's call.

make check green (298/298); examples/TASKS.md still validates.

https://claude.ai/code/session_01UquRBmRrh52iyPFuFQna5q

Round 3 of the blind cold-clone audit found no material repo-fixable
gaps (converged). This closes its minor findings and wraps the exercise:

- CLAUDE.md: the issue-vs-PR numbering note claimed 'different
  sequences' — GitHub issues and PRs share one sequence (the reader
  proved it from our own disjoint numbers); corrected.
- Docstring + schema.md + README: state explicitly that tasks do not
  inherit their parent feature's @milestone= (rollup counts task tags
  only; --table attributes features directly or via tagged tasks).
- CONTRIBUTING.md: add the squash-merge/never-main rule and the
  gh-release step so the public doc matches actual process.
- LEARNINGS.md: entry for the blind-dogfood migration exercise.
- MEMORY.md: self-healing tag note (v1.4.1 committed; tag pending owner
  confirmation) + audit trail in 'what just happened'.
- __version__ 1.4.1 + CHANGELOG entry (docs-only release, keeps the
  version/tag-consistency invariant when the migration tag is pushed).

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