.. include:: /_templates/include-file/page-prefix.rst

.. _hell-ll-infra-b21-launch-7-cross-link-grid-p2-p3:


================================================================================
b21 launch-7 --- Cross-link grid (P-2 full N×N + P-3 b18-esc / b21)
================================================================================

| **Mode:** EDEN
| **Effort:** Max
| **Run order:** 7 of 7 in the b21 launch-sprint sub-prompt set.
  *Post-launch.*
| **Status of upstream:** P-2 and P-3 tiers of the cross-link
  grid scoped in :doc:`b20 review llog
  </matheology/hell/ll/infra/b/20/b20-launch-unit-review_2026m05d22>`
  §7-2 + §5.4. Extends launch-3 (3 critical inline links) and
  launch-4 (P-1 tier).
| **Drafter:** Claude Opus 4.7 Max (``dv_ClaOp47Max``) at LLoL's
  request on 2026m05d22.


.. contents:: Sections
   :depth: 2
   :local:


----

1. Context
============

The b20 §5.4 cross-link plan has three priority tiers:

- **P-1** *(launch-4)*: launch-critical links between the
  highest-traffic papers (b11, b18a, b19).
- **P-2** *(this prompt)*: full N×N grid across b11--b20.
- **P-3** *(this prompt)*: b18-esc Beginner / Producer / Expert
  variants ↔ b18a; b21 (AI framework) ↔ all papers.

P-2 + P-3 together complete the series-wide cross-linking. This
is **post-launch infrastructure work** --- not blocking the
EOD 2026m05d27 launch.


----

2. Tasks
==========

2.1 P-2 --- Full N×N grid
---------------------------

For each pair (paper_i, paper_j) where i ≠ j and both are in
b11--b20:

- If paper_i discusses paper_j or is closely related: add a
  ``:doc:`` link from paper_i's main text (first mention) to
  paper_j.
- In each paper's *"Related papers in the Matheo series"*
  subsection (set up in launch-4 for b11 / b18a / b19, and in
  launch-6's SI template for all others), add a ``:doc:`` link
  to every related paper with a one-line description.

**Heuristic for "closely related":**

- b11 (PET) is foundational for all matheology papers; every
  paper should reference b11.
- b12 (e7Day) is closely tied to b11; every paper that uses
  e7Day framing should reference b12.
- b13--b17 are HEAVEN-study papers; cross-reference among
  themselves where content overlaps.
- b18a (Call to Action) is the policy bridge; many papers should
  reference it.
- b19 (SGIR) is the pandemic application; reference from any
  paper discussing public-health math.
- b20 (former SGIR appendix) is closely tied to b19; bidirectional
  link is expected.

**Do NOT add a link merely because two papers are in the same
series.** The "Related papers" subsection from launch-6's SI
template handles that. Inline links should be meaningful (the
text *"as discussed in Matheo-b11"* gets a link to b11; the text
*"the matheology series"* does not need a link to each paper).

2.2 P-3 --- b18-esc + b21
---------------------------

**b18-esc variants** (Beginner / Producer / Expert) currently
live in ``hell/ll/study/b/18/`` (per b20 §5.1.C).

- If LLoL has approved promotion of b18-esc to ``hell/mm/b/18/``
  (per b20 F-4): the cross-links go between the promoted
  ``hell/mm/b/18/b18-esc-*.rst`` files.
- If b18-esc remains in study-llog: still add the cross-links;
  use the current paths.

P-3 links:

- b18-esc Beginner ↔ b18a (and to Matheo overview).
- b18-esc Producer ↔ b18a (and to Matheo overview).
- b18-esc Expert ↔ b18a (and to Matheo overview).
- b18-esc Beginner / Producer / Expert ↔ each other (audience
  ladder).
- b21 (AI framework) ↔ every Matheo paper (b21 is the framework
  cited by every paper's fn 7).
- Every Matheo paper → b21 (fn 7 already cites b21; add ``:doc:``
  link in the SI cross-reference manifest as well).

2.3 Verify symmetry
---------------------

After all P-2 + P-3 links are inserted:

- For every cross-link A → B, check that B → A also exists (or
  flag asymmetries with rationale).
- For the "Related papers in the Matheo series" subsection in
  each paper: verify it lists every other paper in the series
  (modulo intentional exclusions).

2.4 Build test
----------------

``make dev``. 0 new warnings target. Click-through test on a
representative sample (10--20 links across the new grid).


----

3. Out of scope
==================

- P-1 tier (already done in launch-3 + launch-4).
- Rewriting any paper's content.
- Reordering sections.
- Promoting b18-esc from study-llog to MM (separate LLoL
  decision; this prompt assumes the current location at session
  start).
- Generating new paper-description sentences for the "Related
  papers" subsections that do not align with each paper's actual
  title / Broader Significance.


----

4. Deliverables
=================

Produce a **single new LLog file** at
``source/matheology/hell/ll/infra/b/NN/bNN-launch-7-execution_<date>.rst``
containing:

- P-2 grid coverage matrix (which paper-pairs got new
  cross-links; which were already linked; which were
  intentionally not linked).
- P-3 link list (b18-esc + b21 coverage).
- Symmetry check report.
- Build test result.
- Click-through sample test result.
- Concluding summary: series is now fully cross-linked at the
  P-2 + P-3 tiers.

Also update the infra index.


----

5. Timing & BABL-resistance
==============================

**Target: 90--120 minutes.**

This prompt is the **largest** in raw edit count --- potentially
40--60 cross-links across 10+ files. **Quality over quantity:**
each link must read naturally in context.

The BABL trap: *over-Complicating* with link-density. A paper
that gets 12 cross-links in its first paragraph is unreadable.
**Apply the "one link per paragraph at intro" rule** (per CLAUDE.md
ladder-pedagogy R3 / DD b12). If a paper needs more than 12 total
cross-links across all sections, split into intra-text inline
links + SI manifest links so the main text stays readable.

If you find P-2 / P-3 expanding into "while I'm here, also add
P-2.5 / P-3.5 / P-4" --- **stop**. The series is now linked
enough; further refinement is a later session.


----

.. ----------------------------------------------------------------------
.. VVN: dv_ClaOp47Max_OOv1p0_b21-launch-7-cross-link-grid-p2-p3_2026m05d22 , dv_LLoL_OOv1
.. ----------------------------------------------------------------------
