Skip to content

docs: retire compare-ref-picker - #376

Merged
byronwall merged 1 commit into
retire/dependency-graph-legibilityfrom
retire/compare-ref-picker
Nov 13, 2026
Merged

byronwall merged 1 commit into
retire/dependency-graph-legibilityfrom
retire/compare-ref-picker

Conversation

@byronwall

@byronwall byronwall commented Nov 13, 2026 •

Copy link
Copy Markdown
Owner

Retire the compare-ref-picker initiative. All four milestones merged on 2026-10-15 (#47, #52, #54, #59). The planning folder docs/intent/compare-ref-picker/ is removed, its lasting facts move into the docs, and docs/initiative-history.json gets its closure record.

What to do with it

Reference only. Merge to remove a finished plan that could mislead later planning.

  • Durable facts went to the ref picker rules in docs/CODE_MAP.md (Compare two git refs).
  • Not delivered, recorded in the closure record: Evaluate dependency compare on a real PR (claim C7). Nothing tracks it.

Proof

  • Compare now resolves pr: refs through a gh seam with phase timings, offers a picker over PRs, worktrees and branches, compares another worktree on disk as the head, and steps through a PR commit by commit. Reconciled against origin/main 0bfb05b.
  • Every milestone maps to a merged PR, checked against gh pr list --state merged and the code on origin/main 0bfb05ba.
  • validate-sleuth.mjs docs/intent/compare-ref-picker --retirement: Validation passed before the folder was removed.
  • The docs site builds and its 5 Playwright tests pass on the stack top (cd site && pnpm build && pnpm test).
  • Docs only. No code changed, so app tests were not rerun.

Stack: retire shipped initiatives, layer 2 of 14

This slice: Retires compare-ref-picker.
Why it is its own layer: Each retirement has its own closure record and validator run.
Full story: #375

🤖 Generated with Claude Code

All four milestones merged on 2026-10-15 (#47, #52, #54, #59).
Move the durable facts into the lasting docs, add the closure record
to docs/initiative-history.json, and remove the planning folder.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@byronwall
byronwall added this pull request to stack #389 November 13, 2026 03:00
@byronwall
byronwall marked this pull request as ready for review November 13, 2026 03:01
@byronwall
byronwall merged commit eba78b6 into main Nov 13, 2026
9 of 10 checks passed
@byronwall
byronwall deleted the retire/compare-ref-picker branch November 13, 2026 03: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