Bible-Grade Procedural Standard + Grok Gap Audit Implementation

Context

You asked for a two-part initiative:

Part 1 — A new site-wide content standard that adds a layered structural progression (overview → decision framework → step-by-step + improvised) to every procedural page, so a beginner with no prior experience can use the printed page as their only resource during a real emergency. This is critical and impacts agents, root governance files, and the entire ecosystem. Codex collaboration was deep multi-turn (3 turns, thread 019e5641…→019e5642…→019e5644…).

Part 2 — Review Grok's gap audit (~50 items across Medical, Food, Shelter, Energy, Security, Skills, Cross-cutting + Prepping/Survival/Homesteading splits) and ship the highest-value gaps using the new Part 1 standard — 4–6 waves, top 20–30 pages.

Both parts build on (and EXTEND, not replace) the two recent governance changes that already shipped 2026-05-23:

  • Wave A1 — Procedural-Detail Tier (risk_to_perform front-matter axis + !!! danger "Field/Austere Technique" admonition for very-high risk)
  • Wave C0 — Actionable Detail Standard (13-point "Only Resource" test + Tools-and-substitutes table + Failure-modes canonical 3-part structure)

Codex confirmed the new layered structure is a third orthogonal axis that codifies order and adds visible scaffolding only where stakes warrant it, without duplicating the existing Action Block (§13) or A1/C0 work.

Part 1 — Bible-Grade Procedural Standard (governance)

Tier model (Codex-locked)

Tier Scope What's required
Tier 1 criticality: life-safety + depth: procedural (~30 pages) Visible canonical-H2 layering required
Tier 2 All other procedural pages (criticality: high + depth: procedural and criticality: standard + depth: procedural) (~150 pages) Compact pre-step decision block required
Discretionary escalation criticality: high + depth: procedural where the procedure has multiple phases, multiple methods, or irreversible safety consequences May use visible H2 layering; editor gate does NOT require it

Tier 1 top-of-page structure (in this exact order, before the first H2)

  1. Page Action Block admonition (existing, STANDARDS §13)
  2. NEW — !!! info "Quick reference" admonition with a 4-row table: 
    !!! info "Quick reference"
    | Field | What to know |
    |---|---|
    | Outcome target | (measurable success state) |
    | First-line action | (primary recommended action) |
    | Escalate if | (trigger to switch methods or call for help) |
    | Stop if | (terminate or wait — irreversible / dangerous state) |
  3. Educational disclaimer admonition (existing)
  4. Field/Austere admonition (existing, A1) — only when risk_to_perform: very-high, placed near the relevant risky section (not always at top)

Tier 1 canonical H2 sequence (after the top matter)

  1. ## When to use this — discrete bullet block: Use this when / Do not use this when / Stop and escalate if
  2. ## Choosing a method — REQUIRED when 2+ valid methods exist; comparison table
  3. ## Steps — numbered procedure with concrete cues (body position, hand/tool position, measurements, timing, temperature, force) — OR ## Last-resort principles when risk_to_perform: very-high (principles + improvised path, no step-by-step per the existing A1 rule)
  4. ## Tools and substitutes (existing Wave C0)
  5. ## Failure modes (existing Wave C0)

H2 names are canonical and locked. Synonyms (## Overview, ## At a glance, ## Decision matrix, ## How to use this, etc.) are NOT permitted on Tier 1 pages.

Tier 2 minimum requirement

  • Existing opening + Page Action Block stay
  • Before the first numbered procedure, require a discrete pre-step decision block: 
    Before you start:

- Use this when: …
- Do not use this when: …
- Stop and escalate if: …
  • Numbered steps with concrete cues
  • ## Choosing a method required only when 2+ methods exist
  • ## Tools and substitutes + ## Failure modes already required by Wave C0

Tier 2 pages do NOT need ## Quick reference, ## When to use this, or visible H2 layering. The pre-step bullet block carries the decision-framework content compactly.

Only Resource checklist additions (extends Wave C0)

Two new criteria added to the 13-point "Only Resource" audit (now 15-point):

  • #14 — Method-selection clarity: If the topic has 2+ plausible methods, a ## Choosing a method H2 with a comparison table appears BEFORE any recommended method is presented. The beginner is not forced to choose blind.
  • #15 — Decision-framework discreteness: "When to use" and "Do not use" content appears in a discrete bullet block (Tier 1: under ## When to use this; Tier 2: pre-step bullet block) — NOT embedded in narrative prose.

Editor FAIL on 3+ criteria out of 15 blocks publish (threshold unchanged).

Enforcement model (Codex-locked: Option B — author + editor)

  • Author owns producing the structure correctly on first draft.
  • Editor owns hard-gate enforcement and returns missing structure to author.
  • Defer a scripts/layered_structure_audit.py lint until 20–30 retrofits prove the structure is stable (then add as mkdocs build --strict pre-step or publisher pre-flight).

Migration (Codex-locked: Path 3 — mechanical sweep first)

Phased rollout:

Phase What ships Effort Duration
0a Governance: STANDARDS + STYLEGUIDE + MEMORY + CLAUDE + 6 agent prompts 1 commit, no content change 1 day
0b Mechanical H2-synonym retrofit on ~30 Tier 1 pages + ~80 Tier 2 pages with legacy ## Overview / ## Decision matrix / ## How to use this etc. Diff narrow: headings only, no content rewrites. 1 commit, 1 helper script 1 day
1 Editor gates flip from WARN to hard-FAIL on all in-scope pages. All new content emerges under the new standard. — immediate after 0b
2–7 Wave-by-wave content gap closures (Part 2) — each new/expanded page ships under the new standard, plus retrofits surface organically when pages are touched. 6 commits, ~25 pages 6–10 weeks

Agent updates required (Codex-confirmed file list)

Must update: - STANDARDS.md §5 — new sub-section: "Layered procedural structure" with tier model, canonical H2 names, Quick reference content spec, order requirement, and the new criteria #14 + #15 - STYLEGUIDE.md — exact !!! info "Quick reference" admonition pattern + Tier 2 pre-step decision block pattern + ## Choosing a method comparison-table template - MEMORY-STANDARDS.md — pattern entry citing the rule + the 3 most likely author drift modes (synonym H2 names, prose decision content not in discrete bullets, missing Choosing-a-method when 2+ methods exist) - CLAUDE.md — one-sentence pointer under Content Quality Rule to the new STANDARDS §5 subsection - .claude/agents/author.md — required-structure checklist by tier - .claude/agents/editor.md — hard-gate enforcement details + new criteria #14/15 - .claude/agents/reader.md — usability judgment: does the layered structure help or bury the procedure? - .claude/agents/webmaster.md — routing note: name the layered-structure requirement on new/rewrite procedural task dispatch - .claude/agents/guide-author.md — chapter-level adaptation: standalone life-safety procedural chapters in 25–35k guides include the inline quick-reference / decision-block / steps logic; guides do NOT mimic Foundation-page top matter - .claude/agents/guide-publisher.md — same chapter-level adaptation in the gate

NOT updated (Codex-confirmed): - fact-checker, medical-sme, food-safety-sme, electrical-sme — structural check is out of their scope (they may notice missing structure but should not fail on it unless it causes accuracy/safety issue) - publisher — no prompt change for Option B; revisit when Option C lint script lands

Block-responsibility map (avoid duplication — Codex-locked)

Each block has ONE job. Editor enforces this:

Block Sole responsibility
Page Action Block (§13) First action, time, skill, tools, warnings, routing — operational triage metadata
!!! info "Quick reference" Outcome target / first-line action / escalation threshold / stop condition — fast reorientation during execution
Educational disclaimer General legal + safety disclaimer (boilerplate)
Field/Austere admonition (A1) Very-high risk gate: reasonable to attempt / do not attempt / last-resort framing
## When to use this block Method selection + contraindications + stop/escalate triggers
## Choosing a method Multi-method comparison table — only when 2+ methods exist
## Steps / ## Last-resort principles Procedure body or principle-only guidance
## Tools and substitutes (C0) Equipment list + field-expedient improvisation
## Failure modes (C0) Recognition + recovery after things go wrong

If ## Quick reference ever restates Action Block metadata, it has drifted from spec.

Part 2 — Grok Gap Audit Implementation

Filter results (against shipped work as of 2026-05-23)

I cross-referenced Grok's 50+ gaps against current site state. About half are already covered by the recent Bible-Standard campaign + Phase 3 close-out:

Grok gap Status
Improvised wound closure ✅ Wave A2 medical/wounds.md austere section (~1,560w shipped 2026-05-23)
Game butchering (deer) ✅ Wave C2 food/deer-processing.md (~3,500w shipped 2026-05-23)
Rabbit & small-game processing ✅ Wave C1 food/rabbit-processing.md (~3,200w shipped 2026-05-23)
Game-bird processing ✅ food/game-bird-processing.md (~3,200w shipped 2026-05-23)
Fish processing ✅ food/fish-processing.md (~3,000w shipped 2026-05-23)
Home hardening against intrusion ✅ shelter expansion 2026-05-23 + security/safe-room.md
Long-term underground / hidden shelter ✅ shelter/improvised-shelter-engineering.md (Codex-override page shipped 2026-05-23)
Vehicle as long-term shelter ✅ shelter/vehicle-living.md (~2,800w shipped 2026-05-23)
Confined-shelter occupancy ✅ shelter/confined-shelter-occupancy.md (~2,400w shipped 2026-05-23)
EMP & surge protection ✅ energy/emp-surge-protection.md exists; Wave B4 Faraday audit verified
Active conflict / civilian protection ✅ Wave B1 energy/active-conflict-energy.md + Threats active-conflict.md
Chronic condition management (grid-down) ✅ Phase 3 medical/chronic-conditions.md (~3,500w)
Elderly + mobility-impaired care ✅ Phase 3 medical/elder-care.md
Infant + toddler emergency care ✅ Phase 3 medical/infant-care.md
Cold-chain medication continuity ✅ Phase 3 medical/cold-chain.md
Financial preparedness + cash ✅ Phase 3 community/financial-resilience.md
Water rationing / hauling ✅ Phase 3 water/rationing.md + water/hauling.md
Family playbook + documentation ✅ guides/family-emergency-playbook.md (~13,100w)
Long-term off-grid energy maintenance ✅ Wave B2/B3 energy/multi-year-offgrid.md + battery-lifespan + solar-lifespan
Owner-built permitting ✅ Loop 103-O skills/owner-builder-plumbing-electrical.md
Foraging ✅ food/foraging.md (print-ready Loop 88)
Smoking + dehydrating ✅ existing
Seed saving ✅ food/seed-saving.md
Mutual-aid networks ✅ community/mutual-aid.md
Group dynamics + leadership ✅ community/leadership.md
Soil building ✅ food/soil.md
Food forest / permaculture ✅ food/food-forest.md + food/permaculture.md
Year-round food planning ✅ food/year-round.md
Off-grid livestock systems ✅ food/livestock-systems.md
Psychological first aid ✅ medical/mental-health-kit.md + mindset/stress.md
Bug-out on foot ✅ mobility/bug-out.md + mobility/urban-bug-out-no-vehicle.md

That leaves ~25 genuine gaps that are not yet covered. Below are the top 25 grouped by wave, scored by life-safety × reach × current-coverage.

Wave plan (6 waves, ~25 pages, sequenced after Part 1 ships)

Every page in every wave is dogfooded against Part 1's new standard — Tier 1 (life-safety) pages get the full visible H2 layering + Quick reference admonition; Tier 2 pages get the pre-step decision block.

Wave I — Medical austere core (Tier 1; 5 pages; ~16,000w net new)

Highest life-safety impact. Three are expansions, two are net-new pages.

# Page Mode Spec
1.1 docs/medical/dental.md EXPAND (~+3,000w to existing 31KB) Add austere protocols beyond the existing 4-row decision table (Wave A3): temporary fillings (ZOE / OTC dental cement), abscess drainage (gate + last-resort principles), tooth extraction principles with strong warnings, prolonged-isolation infection management. Tier 1 layered structure. medical-sme gate required.
1.2 docs/medical/women-health.md NEW (~3,500w) Menstruation without supplies (cloth + cup + improvised); pregnancy complication recognition (pre-eclampsia, gestational diabetes recognition in austere settings); postpartum care (hemorrhage recognition + breastfeeding troubleshooting + perineal care + mental-health flags). Tier 1 layered. medical-sme gate.
1.3 docs/medical/burns.md EXPAND (~+2,500w to existing 32KB) Beyond initial cooling: long-term wound management (dressing changes, infection prevention with iodine/silver sulfadiazine alternatives), Parkland-formula fluid resuscitation estimates with weight-based calculations, when-to-escalate-after-day-3 protocols. Tier 1 layered. medical-sme gate.
1.4 docs/medical/eyes.md NEW (~3,000w) Eye injuries + infections in field conditions: irrigation procedures, foreign-body removal limits, patching (when yes / when never), corneal abrasion recognition + management, conjunctivitis differentiation (bacterial vs viral vs allergic), chemical-splash protocol, when-to-evacuate. Tier 1 layered. medical-sme gate.
1.5 docs/medical/fractures.md EXPAND (~+3,000w to existing 29KB) Advanced improvised splinting (long-bone vs joint vs spine), traction protocols (femur traction with improvised materials), open-fracture austere management with infection prevention, multi-day immobilization care. Tier 1 layered. medical-sme gate.

Wave II — Cross-cutting integration playbooks (Tier 1 + Tier 2; 4 items; ~15,000w net new)

Grok's #1 cross-cutting recommendation: integration playbooks + cascading-failure decision trees + climate adaptations.

# Page Mode Spec
2.1 docs/guides/cascading-failures.md NEW Guide (~8,000w) Integration playbook for the most common cascade chains: grid-down → cold-chain failure → medication degradation → chronic-condition crisis; water-main failure → sanitation collapse → disease vector; multi-day power outage → fuel rotation failure → heating loss → hypothermia. Decision-tree diagrams + cross-Foundation routing. This is a Guide, not a Foundation page — uses guide-author + guide-publisher.
2.2 docs/community/information-warfare.md NEW (~2,500w) Propaganda resilience + misinformation triage during high-stress events: source-tier verification under emotional load, social-engineering recognition, family-level disinformation protocols, what to ignore vs what to amplify. Tier 2 (criticality:high, depth:procedural). fact-checker gate.
2.3 docs/threats/climate-specific-adaptations.md NEW (~3,000w) Climate-zone-specific shelter/water/food/medical adaptations: hot-arid (heat-stroke + water scarcity); cold-arctic (hypothermia + fuel + insulation); humid-tropical (mold + vector-borne disease + preservation challenges); maritime (storms + corrosion + isolation). Tier 2 routing hub with comparison tables + per-zone playbooks.
2.4 docs/medical/dehydration.md EXPAND (~+1,500w to existing 34KB) Add refeeding syndrome + malnutrition recovery section (Grok-flagged). Recognition criteria (NICE 2017 thresholds), safe-reintroduction protocol (thiamine prep + slow calorie ramp + electrolyte monitoring), when austere care fails and evacuation is required. medical-sme gate.

Wave III — Sanitation, hygiene & austere field skills (Tier 1 + Tier 2; 5 pages; ~14,000w net new)

# Page Mode Spec
3.1 docs/community/austere-sanitation.md NEW (~3,000w) Group + long-term hygiene protocols: handwashing without running water, food prep sanitation, waste segregation, disease-vector control, hygiene rotation in 10+ person groups. Tier 2 procedural.
3.2 docs/community/composting-toilets.md NEW (~3,000w) Humanure systems + composting toilet design + maintenance: Joseph Jenkins method, separation systems, pathogen-kill timelines, regulatory landscape, urban vs rural deployment. food-safety-sme gate for pathogen-kill claims. Tier 2 procedural.
3.3 docs/community/pest-vector-control.md NEW (~2,500w) Austere pest + vector control: mosquito source reduction + screening + repellents, rodent exclusion + trapping, flies + sanitation linkage, ticks + lyme prevention, scabies/lice protocols. medical-sme gate for vector-borne disease claims. Tier 2 procedural.
3.4 docs/water/greywater.md EXPAND (~+2,500w to existing 13KB) Full design + safety: branched-drain systems, mulch basins, indoor-vs-outdoor reuse, soap selection, pathogen pathways, EPA + state regulatory landscape, multi-year maintenance schedule. Tier 2 procedural.
3.5 docs/skills/fire-starting.md EXPAND (~+3,000w to existing 30KB) Advanced primitive methods (bow drill + hand drill detail with troubleshooting), wet-weather improvisation (inner-bark tinder, pitch wood, char cloth from scratch), extreme-cold protocols (hand-warming + spark-shower sustained on snow), no-matches fallbacks (battery + steel wool + flint + striker hierarchy). Tier 1 (life-safety + procedural).

Wave IV — Skills depth (Tier 2; 5 pages; ~13,000w net new)

# Page Mode Spec
4.1 docs/skills/tracking.md EXPAND (~+3,000w to existing 18KB) Advanced sign-reading: age estimation of tracks (precipitation + ambient + freshness cues), behavior reading (gait change = injury/alert), following wounded game (blood-trail color taxonomy already on hunting.md — cross-reference; expand into snow + leaf litter + creek crossings). Tier 2 procedural.
4.2 docs/skills/improvised-tools.md NEW (~3,000w) Stone tools (flake + biface knapping basics with safety + tool selection), cordage repairs (splice + lash), field fixes (knife handles, pot repairs, awl handles, broken-spear repair, screw-thread replacements). Tier 2 procedural.
4.3 docs/skills/cordage.md EXPAND (~+2,000w to existing 19KB) Natural materials (yucca + nettle + bark + animal sinew + cattail), reverse-wrap technique with tension testing, break-strength rules of thumb, multi-strand braiding, archaeological evidence (oldest cordage 50,000 years). Tier 2 procedural.
4.4 docs/mobility/vehicle-breakdown.md NEW (~2,500w) Remote-area vehicle breakdown: diagnostic triage (won't-start vs limp vs stranded), recovery (jump-start + winch + tow strap + traction boards), self-recovery (gravel + sand + mud + snow), call-out protocols, multi-day-stranded survival rotation (stay-with-vehicle vs walk-out decision). Tier 2 procedural.
4.5 docs/energy/manual-power.md EXPAND (~+2,500w to existing 18KB) Bicycle-generator detail (realistic 50-150W sustained output), hand-crank systems (radio + flashlight + small-device charging), pedal-powered grain mill + water pump + sewing-machine, calorie cost of human power generation, when manual power makes sense vs PV. electrical-sme gate. Tier 2 procedural.

Wave V — Security + conflict (Tier 1 + Tier 2; 3 pages; ~8,000w net new)

Codex-discipline: civilian-protective scope only; same scope lines as Threats active-conflict.md and improvised-shelter-engineering.md. No operational concealment recipes.

# Page Mode Spec
5.1 docs/security/opsec-prolonged.md NEW (~3,000w) Daily habits + information control under prolonged unrest / occupation: social-media discipline, family-routine variability, conversation hygiene with neighbors, what-not-to-say, observable-pattern reduction, child OPSEC coaching. Tier 2 procedural. Codex consultation required before author dispatch to confirm civilian-protective scope.
5.2 docs/security/resource-denial.md NEW (~2,500w) DEFENSIVE strategies when others target your supplies: caching + decoy + distribution across locations, neighborhood mutual-watch, low-signature storage, when to share vs when to refuse, de-escalation scripts. Tier 2 procedural. Codex consultation required for scope lines.
5.3 docs/security/safe-room.md EXPAND (~+2,500w to existing 19KB) Add real-time forced-entry resistance section (distinct from pre-event hardening which is already covered): immediate-action protocols when someone is breaching, communication during breach, layered fallback, when to comply vs barricade vs evade. Tier 1 (life-safety + procedural).

Wave VI — Long-term prepping & homesteading depth (Tier 2; 3 pages; ~8,000w net new)

# Page Mode Spec
6.1 docs/community/long-term-medication-rotation.md NEW (~2,500w) FIFO medication systems beyond cold-chain.md: temperature + humidity monitoring, multi-year prescription stockpile strategy (legal landscape — most states cap 90-day fills), insulin extended shelf-life evidence vs printed expiration (cite ADA Standards 2025 + DoD SLEP findings via medical-sme during draft), beyond-use-date research, rotation by household member. medical-sme gate REQUIRED to pin Tier 1 citations. Tier 2 procedural.
6.2 docs/food/livestock-veterinary.md NEW (~3,000w) Austere veterinary care for homestead livestock: chicken/rabbit/goat/sheep/cattle common conditions (mastitis, parasites, dystocia, hoof rot, respiratory), when to treat at home vs cull vs vet, withdrawal periods for milk + eggs + meat after treatment, antibiotic stewardship in austere setting. food-safety-sme gate for withdrawal claims. Tier 2 procedural.
6.3 docs/water/long-term-maintenance.md NEW (~2,500w) Multi-year maintenance schedules for wells + springs + cisterns: inspection cadence, water-quality testing (annual coliform + 3-year heavy-metals + post-event), shock-chlorination procedure, sanitary-seal maintenance, backup-system planning, drought response. Tier 2 procedural.

Wave summary

Wave Pages Total words Effort estimate Focus
I 5 (3 expand + 2 new) ~16,000w 1 loop @ 48pt Medical austere
II 4 (3 new + 1 expand, 1 is a Guide) ~15,000w 1 loop @ 48pt + 1 guide-loop Cross-cutting playbooks
III 5 (4 new + 1 expand) ~14,000w 1 loop @ 48pt Sanitation, hygiene, fire
IV 5 (3 expand + 2 new) ~13,000w 1 loop @ 48pt Skills depth
V 3 (2 new + 1 expand) ~8,000w 1 light loop + Codex consults Security (scope-disciplined)
VI 3 (3 new) ~8,000w 1 light loop Long-term systems depth
Total 25 pages (18 new + 7 expansions) + 1 Guide ~74,000w ~6 loops + 1 guide-loop 6–10 weeks

Out-of-scope (intentionally deferred per filter)

  • Items already covered (32 of Grok's ~50 — listed above)
  • Items with low life-safety value (e.g., Trapping advanced systems, Knots & lashings comprehensive set — existing pages sufficient)
  • Items where Codex previously pushed back (operational concealment recipes, thermal-evasion engineering for personnel)
  • Items requiring infrastructure (book-compiler agent, Practical Calculators JS widgets — already declined)

Critical files modified/created

Part 1 (Wave 0a — governance)

  • STANDARDS.md — new §5 subsection "Layered procedural structure"
  • STYLEGUIDE.md — Quick reference admonition + Tier 2 pre-step block + Choosing-a-method table patterns
  • MEMORY-STANDARDS.md — drift modes catalog entry
  • CLAUDE.md — Content Quality Rule pointer
  • .claude/agents/author.md — required-structure checklist
  • .claude/agents/editor.md — hard-gate logic + criteria #14/#15
  • .claude/agents/reader.md — usability judgment
  • .claude/agents/webmaster.md — routing note
  • .claude/agents/guide-author.md — chapter-level adaptation
  • .claude/agents/guide-publisher.md — chapter-level adaptation

Part 1 (Wave 0b — mechanical H2 retrofit)

  • scripts/h2_synonym_audit.py — NEW helper (one-shot): scan all depth: procedural pages, flag any non-canonical H2 names, emit a JSONL report. Used to drive the mechanical retrofit.
  • ~30 Tier 1 + ~80 Tier 2 procedural pages — H2 renames only (no content changes)

Part 2 (Waves I–VI — content)

  • 18 NEW pages (see wave tables above)
  • 7 EXPANSIONS of existing pages
  • 1 NEW Guide (docs/guides/cascading-failures.md)
  • mkdocs.yml — nav entries for 18 new pages + 1 new guide
  • CATEGORY-CANON.md — additive required-topic entries on the relevant Foundation cells
  • SITE-INDEX.md + CONTENT-MAP.md — refreshed (script + manual)
  • SOURCES.md — new Tier 1 anchors per page as needed
  • MEMORY-CONTENT.md — new clinical facts per wave

Execution sequence

  1. Today (in this session, if approved): Land Part 1 Wave 0a (governance) as one commit. Land Part 1 Wave 0b (mechanical H2 retrofit + helper script) as a second commit. Both commits ship under the existing git push once credentials clear.
  2. Loop 1 (next session): Wave I — Medical austere core. 5 medical-sme gates, editor + reader passes, publisher commit.
  3. Loop 2: Wave II — Cross-cutting playbooks (Guide via guide-loop, 3 foundation pages via run-loop).
  4. Loop 3: Wave III — Sanitation + hygiene + fire.
  5. Loop 4: Wave IV — Skills depth.
  6. Loop 5: Wave V — Security + conflict (Codex consultation thread BEFORE author dispatch on 5.1 and 5.2 for scope discipline).
  7. Loop 6: Wave VI — Long-term systems.

Verification

Part 1 verification

  • grep -c "## Quick reference\|## When to use this\|## Steps\|## Last-resort principles\|## Choosing a method" across docs/medical/* and other life-safety pages → counts match expected Tier 1 page count after Wave 0b.
  • mkdocs build --strict PASS clean after Wave 0a + 0b.
  • Editor agent dry-run on 3 randomly-selected Tier 1 pages: produces PASS (after retrofit) or a clear deficiency report.
  • Author dry-run: dispatch author on a synthetic Tier 1 topic and verify the emitted page contains all 4+ canonical H2s in correct order without prompting.

Part 2 verification (per wave)

  • All new pages PASS mkdocs build --strict.
  • SME accuracy gates PASS or PASS-WITH-FIXES on every life-safety / high-criticality page; food-safety-sme on composting-toilets + livestock-veterinary; medical-sme on every Wave I + I.2 page.
  • Editor verdict PASS on every page (including 15-point Only Resource).
  • Reader verdict Grade B+ or higher; usability-of-layered-structure feedback noted.
  • CATEGORY-CANON.md reflects the new required topics.
  • python3 scripts/category-coverage.py shows incremented coverage on the relevant cells.

Cross-check verification

  • git log origin/main..main --oneline after Wave 0 returns the 2 governance commits.
  • Wave V security pages confirmed by Codex consultation thread (linked in commit message) before author dispatch.
  • python3 scripts/h2_synonym_audit.py --strict returns 0 violations after Wave 0b.

What is NOT in this plan

  • JS calculator widgets (already closed per BACKLOG triage 2026-05-23)
  • Wide-table reformat (already accepted as-is)
  • KDP book-compiler agent (still deferred per HUMAN.md 2026-04-26)
  • GA4 / PSI / CrUX analytics integration (deferred per user 2026-05-13)
  • Visual asset generation for the 18 new pages — handled opportunistically by @diagrammer and @image-gen in follow-up loops (each wave can dispatch visuals as needed but the wave plan does not block on visuals)
  • Operational concealment / thermal-evasion / drone-evasion content (Codex-rejected in prior threads)

Effort summary

Block Effort
Part 1 Wave 0a (governance) ~6pt (S+S+S = STANDARDS edit + STYLEGUIDE edit + agent prompts)
Part 1 Wave 0b (mechanical H2 retrofit + helper script) ~8pt (L = 1 script + ~110 page edits)
Part 2 Wave I (Medical austere) ~32pt (5×L for 3 expansions + 2 new pages with medical-sme + editor + reader)
Part 2 Wave II (Cross-cutting) ~40pt (1 XL guide + 3 L foundation pages)
Part 2 Wave III (Sanitation + fire) ~24pt (4 M new + 1 L expand)
Part 2 Wave IV (Skills) ~24pt (3 M expand + 2 M new)
Part 2 Wave V (Security) ~16pt (3 M with Codex consults)
Part 2 Wave VI (Long-term) ~16pt (3 M new)
Grand total ~166pt across 8 loops

At the current /run-loop budget=48 cadence with 24pt hard floor + 8pt content-work floor, this plan ships in 6–10 weeks.