Summary

PR #337's deep-audit rewrite of Phase 2 swapped a single linked-name table for the current Tier A/B/C LOC tables and lost the leaf links to the four existing split-* roadmap pages (split-runtime-launch, split-input-editor, split-operator-env, split-app-mod). The pages stayed in the sidebar, but the parent program doc and the roadmap overview no longer reached them — so an operator browsing Codebase health → Phase 2 saw the LOC measurements with no path to the design plans those measurements had motivated. Three subsequent re-bakes (#355, #366, #387) did not re-introduce the links. This PR adds a short "Design pages" subsection at the top of Phase 2 in codebase-readability.mdx linking each of the four pages with its LOC and one-line scope, and notes that the remaining Tier A/B/C entries do not yet have dedicated pages. The Tier A/B/C tables themselves stay unchanged.

Verify locally

Checkout

Paste this first to bypass the tirith paste scanner for the rest of the session:

export TIRITH=0

Then paste the checkout block:

mkdir -p "$HOME/Projects/jackin-project/test"
cd "$HOME/Projects/jackin-project/test"

if [ ! -d jackin/.git ]; then
  git clone https://github.com/jackin-project/jackin.git
fi

cd jackin
mise trust
git fetch -f origin fix/roadmap-orphan-split-pages:refs/remotes/origin/fix/roadmap-orphan-split-pages
git checkout -B fix/roadmap-orphan-split-pages refs/remotes/origin/fix/roadmap-orphan-split-pages

Documentation

cd docs
bun install --frozen-lockfile
bun run dev

Astro serves at http://localhost:4321/. Page to walk:

http://localhost:4321/reference/roadmap/codebase-readability/#phase-2--file-splits-confirmation-required
UPDATED page. New "Design pages" subsection sits between the Phase 2 intro paragraph and the "Tier A — files over 2000 lines" heading. Confirm the four bullet links resolve to the matching split-* roadmap pages and that the Tier A/B/C tables below render unchanged. Sidebar entry is unchanged under Reference → Roadmap → Codebase health → Phase 2 — File splits.