Repository navigation
Docs: archive superseded docs - #60
Conversation
|
Review status: merged (reached Update 2026-10-15: #53 merged in Original review (2026-10-14)Independent adversarial review of Verdict: merge as written, right after #53. This is a docs-only, release-neutral cleanup: nine pure renames into Optional
Decisions for the maintainer
Merge order: after #53 only; if #53 picks up commits touching the moved or re-pointed docs, rebase #60 and rerun the link check. Posted by the WikiLean PR swarm (lead); updated 2026-10-15. |
Status review (2026-10-14): ✅ Ready after #53Checked mechanically: every relative link resolves, nothing outside Order (important)
Nits
🤖 Automated status pass by Claude Code over all 18 open PRs (#46–#63), posted for the repo owner. An independent verifier re-checked each finding. All 18 heads were also merged and tested together in a scratch tree; the only test failure that comes from combining them is #47 × #55 (three other pairs had mechanical text conflicts). Reviewed head: |
Stacked on #53. The base branch is
claude/docs-status-2026-10, so this diff shows only the archive change. Merge #53 first, then retarget this PR tomain.Release-neutral: every changed path is under
docs/(persite/ops/brain_release_authority.py).Problem
docs/holds six dated Brain SQLite checkpoints, a PR-stack review guide, two session handoffs and a 140 KB reconciliation report, side by side with the current plan and runbooks, and nothing separates them:docs/BRAIN-SQLITE-CONTINUATION-2026-09-08.mdanddocs/BRAIN-SQLITE-HANDOFF-2026-09-09.mdmark themselves "Historical checkpoint only".docs/BRAIN-SQLITE-HANDOFF-2026-09-19.md,-09-23.mdand-09-26.mdpredate the 2026-10-04 promotion. They still say the selector returns 404, and they carry host paths and instructions that no longer apply.docs/BRAIN-SQLITE-PR-REVIEW.mdis the review guide for the PR stack merged on 2026-09-21.docs/SESSION-HANDOFF-2026-07-04.mdand-08-06.mdare one-session handoffs. The first cites a memory file that doesn't exist.docs/BRAIN-STATUS.mdis the 2026-07-04 reconciliation of the pre-build proposal.Change
docs/archive/as git renames, with no content changes except link targets.docs/archive/README.md: one line per file, and a pointer to the current docs (ROADMAP.mdand the 2026-10-04 activation record).../targets), and fromdocs/ROADMAP.md,docs/BRAIN-SQLITE-HANDOFF.md,docs/BRAIN-ACTIVATION-2026-10-04.mdanddocs/BRAIN-SQLITE-CURATION-DECISION.mdto the new paths. Two live references that called the 2026-09-23 handoff "current" now name it by date.docs/BRAIN.md(the 2026-07-03 proposal) gets a "Historical" banner and stays in place because code comments andbrain/SCHEMA.mdcite it.docs/BRAIN-V2.mdgets a "Partly historical" banner: its data model is superseded bydocs/BRAIN-V3.mdand its authority and release design bydocs/BRAIN-ARCHITECTURE.plan.md, but its benchmark (the spec forbench/), ingestion-matrix and "Nightly brain sync" sections are still cited, so it stays in place too.docs/BRAIN-EDITS-ROADMAP.mdalready marks itself historical and is cited by migrations and Worker code, so it is unchanged.How tested
*.mdfiles that points to a moved file or sits inside one: none are broken.git grepfor the olddocs/<name>paths outsidedocs/archive/finds nothing.site/ops/brain_release_authority.pyreports every changed path as release-neutral.Not changed (notes for Jack)
CLAUDE.mdandAGENTS.mdstill calldocs/BRAIN-V2.mdthe Brain "design". Pointing them atdocs/BRAIN-V3.mdwould make this PR release-affecting whileAGENTS.mdis classed that way, so it is left for a follow-up.brain/build_common.py:2156,3190andcatalog/fetch_math_graph.py:12citeBRAIN.md:452by line number. That citation was already off by two lines before this PR, and the banner shifts it by five more. Citing the section ("TheoremGraph / TheoremSearch … deep-dive") instead would be a code change outside this docs-only PR.Risks
docs/...URLs on GitHub stop resolving at those paths. Git history keeps the files, and the archive index lists them.What Jack must do
mainand merge.