[kriszyp]

⊙ Problem

main's Lint Source Code workflow is red since Give agents a resources/ concept map … (#3856) merged on top of Design-docs check resolves every relative link and anchor … (#3838). Each was green on its own base. Together, npm run check:design-docs fails:

• resources/MAP.md section "Files" is not indexed in DESIGN.md (and "Where is it"): Design-docs check resolves every relative link and anchor in the notes, not only the root index #3838 treats every file a DESIGN.md list entry links to as a note, and Give agents a resources/ concept map on first read, and cut resources/DESIGN.md from 339 KB to 44 KB of invariant notes #3856 added a list entry for resources/MAP.md.
• DESIGN.md is 68,319 bytes, over its ceiling of 68,166: Give agents a resources/ concept map on first read, and cut resources/DESIGN.md from 339 KB to 44 KB of invariant notes #3856 set the ceiling before Design-docs check resolves every relative link and anchor in the notes, not only the root index #3838 added 153 bytes to the index.

🤔 Is the requirement right?

Yes. A map is not a note: the index's rules say AGENTS.md lists every map, and it already lists resources/MAP.md.

💡 Solution

DESIGN.md only, 3 lines:

• Remove the resources/MAP.md list entry.
• Shorten two .github/ entry labels by dropping their file-list parentheticals, as Give agents a resources/ concept map on first read, and cut resources/DESIGN.md from 339 KB to 44 KB of invariant notes #3856 did for resources/. Anchors are unchanged.

DESIGN.md is now 68,115 bytes, 51 under its ceiling.

🤔 Ceiling left at 68,166

I did not run --update-ceilings. Lowering it by 51 bytes leaves no room, and four open PRs edit DESIGN.md; any of them adding an index line would turn main red again on merge.

⚖️ Alternatives

• Make the check skip MAP.md files when collecting notes: a code exception for what one doc line causes. The written rule already sends maps to AGENTS.md.
• Revert Give agents a resources/ concept map on first read, and cut resources/DESIGN.md from 339 KB to 44 KB of invariant notes #3856: drops a large, wanted docs cut to fix three lines.

✅ Verification

• node build-tools/check-design-docs.mjs --base 9ed308ccc (what CI runs on this push) and with no base: index complete, links resolve, budgets and ceilings met, maps resolve, exit 0. On main both fail with the errors above.
• npm run lint:required, npm run check:unit-partition, prettier --check DESIGN.md: pass.
• unitTests/build-tools/checkDesignDocs.test.mjs (type-strip): 51 passing.
• PR QA: not substantive (index-only docs change, nothing observable end to end).
• Docs: none needed (internal design-doc index).

First red Lint run on main: 664185c35; last green: 9ed308ccc.

— Claude Opus 5.5

Release target: main — fixes a docs-index break that exists only on main
Related PRs: #3856 overlaps, #2752 overlaps, #3233 overlaps, #3839 overlaps, 3 others independent
Complexity: trivial

🤖 Generated with Claude Code

Origin — the dispatch brief this PR was written from

harper main is red: Lint Source Code at 664185c

main on HarperFast/harper went from green to red. Failing workflows: Lint Source Code at 664185c.

Find the merge that broke it and get main green. Walk that workflow's recent push runs on main oldest-to-newest to find the FIRST red head SHA and the PR it came from, then pull the failing test names from that run and from the current head. A failure on every matrix leg (Node version, Bun, uWS, Windows) is a regression; one leg is usually a flake.

Then either fix it or, when the culprit is a single merge and the fix is not obvious, open a revert and say so — main being green is worth more than the change being preserved. Record the fingerprint on the initiatives/ci-health board doc either way (prose row beginning with the test path, never a bare ref), and add your PR to initiatives/testing-and-deploy > "CI & build infrastructure" as a bare-ref line so it renders as a card.

_{Dispatch: task main-red-kriszyp_harper_664185c35_5684deb1 · queued by automation · ran by claude/opus/high · worker kzyp-xps-1}

_{Ready-For-Promotion: c7158a1 urgency=fast late=none}

_{Review-Coverage: authored=claude; ran=gemini,cursor-composer,codex; adjudicated=domain; declined=cursor-grok,muse; urgency=fast; rounds=1; full=1 @ c7158a1}

_{Review-Attention: skim ~2m (decisions: map-exclusion-layer) @ c7158a1}

[gemini-code-assist]

Code Review

This pull request updates the DESIGN.md file by simplifying several link descriptions in the CI workflows section and removing the reference to resources/MAP.md. There are no review comments, and I have no feedback to provide.