RUBRIC.v1 — Hub Page Excellence

Date: 2026-05-14 Status: Draft for Codex Phase 1 review (completeness check only — no wording refinement) Applies to: docs/index.md (homepage) and every Foundation hub docs/{foundation}/index.md

Four lenses, 22 items. Each item is a falsifiable pass/fail criterion.

Lens 1 — Reader clarity (R1–R6)

• R1 First 80 words establish topic + stakes, no jargon
• R2 "What to do next" entry point reachable in mobile first viewport
• R3 H2 sections answer reader questions, not topic taxonomies
• R4 ≥1 Field Note admonition with topic-specific practical wisdom
• R5 Concrete numbers (gallons, $, days, lb/kg) appear before abstract framing
• R6 No insider term without immediate gloss

Lens 2 — Authority / completeness (A1–A5)

• A1 All foundation child pages linked (no orphans in the directory)
• A2 ≥1 citation, source reference, or named institution per major claim cluster
• A3 Multi-setting breadth (urban / suburban / rural OR emergency / short-term / permanent)
• A4 Tier-1 / life-safety claims weighted and warned per SOURCES.md
• A5 Depth signal — measurements, decision criteria, named methods — not just descriptions

Lens 3 — SEO (S1–S5)

• S1 H1 matches title; description ≤160 chars and answers query intent
• S2 H2/H3 hierarchy reflects real subtopic clusters (passage-ranking lens)
• S3 ≥8 outgoing internal links to child pages
• S4 ≥1 schema-eligible element (FAQ / HowTo / ItemList) embedded
• S5 Featured-snippet candidate — complete <50-word answer to the obvious query, near top

Lens 4 — Conversion (C1–C6)

• C1 ≥2 explicit "start here" CTAs above the fold or in first 2 sections
• C2 Audience-segmented entry paths (new / intermediate / advanced OR scenario tabs)
• C3 Every child-page link carries a one-line "why click" — no bare links in lists
• C4 Closing section ends with a single next action, not a summary
• C5 Cross-links to ≥3 other Foundations (system-connection signal)
• C6 At least one "you can do this today" action with a time estimate