Codex Phase 2 Response — Water Hub Critique

Date: 2026-05-14 Model: gpt-5.5 (via mcp__codex__codex) Prompt sent: RUBRIC.v2 + current docs/water/index.md + 13-edit plan + Phase 2 template Thread: 019e2744-9228-7202-b026-8582bc3264e4

Reader Clarity

  • Worst flaw in current page: The first screen opens with system-failure framing and disaster examples before giving the reader a concrete action. Lines 15-19 delay the practical answer; the first useful number does not appear until line 23.
  • Worst flaw in edit plan: W1 uses "You can't go 3 days without water," which is fear-forward and violates the calm, empowering voice. It also duplicates the existing dehydration warning instead of making the top answer more practical.
  • Missing suggestion: Replace the opening paragraphs with a calm 40-60 word answer: store 1 gallon per person per day, start with 3 days, add two treatment methods, then map nearby sources.

Authority

  • Worst flaw in current page: Major life-safety claims are unsourced: minimum water quantity on line 23, organ-failure timeline on line 26, contamination/power claims on lines 15-17, and container-leaching claim on line 38.
  • Worst flaw in edit plan: W7 is too narrow for A8. "When to call for help" must include medical dehydration symptoms, suspected chemical contamination, floodwater exposure, infants/elderly/immunocompromised people, and private-well testing after floods. EPA wells alone is not enough.
  • Missing suggestion: Add a compact "Safety thresholds" section with CDC/FEMA/EPA/WHO-style sourcing, separating medical danger signs from water-quality danger signs.

SEO

  • Worst flaw in current page: It does not satisfy the dominant water-storage search intent fast enough. The strongest storage answer is buried in lines 23 and 38-40, while the page spends lines 28-40 as a dense link dump.
  • Worst flaw in edit plan: W8 adds FAQ schema, but the plan does not say the visible page will contain the matching FAQ text. JSON-LD alone is weak and can look like schema stuffing if the questions are not answered in-page.
  • Missing suggestion: Add visible FAQ answers near the bottom for "How much emergency water should I store?", "How long does stored water last?", "What containers are safe?", and "Should I boil, filter, or chemically treat water?"

Conversion

  • Worst flaw in current page: The first explicit action path is not until "Where to start" at line 45, well below the mobile first viewport. Lines 30-40 overwhelm readers with many links but no prioritized route.
  • Worst flaw in edit plan: W10 says "3-tab audience segmentation," but Markdown tabs may hide content, weaken scanning, and bury internal links depending on the renderer. It also risks being a UI trick instead of a clear progression.
  • Missing suggestion: Add three plain "Start here if..." blocks above the three-layer sections: apartment renter, family preparing for two weeks, and off-grid property owner, each with one primary link and one sentence.