================================================================================
SITEWIDE_PROPAGATION_PLAYBOOK_5_12_26.txt
CollabORhythm / Collabtunes — Production Acceleration Prep Phase
Generated: 5.12.26
PURPOSE: Exact step-by-step procedures for propagating every major site component
================================================================================

RULE: Follow each procedure in order. Do not combine multiple propagation
operations in the same session unless explicitly marked as safe to combine.
One system at a time. Verify after each. ZIP before starting each one.

================================================================================
PROCEDURE 1 — RATING GATE SYSTEM PROPAGATION
Priority: FIRST — everything else depends on this
================================================================================

PRE-FLIGHT:
  [ ] Confirm Bouncer default state fix (ratings[0]) is live and tested
  [ ] Confirm rating key schema: collabtunes_selected_rating = gpg|pg13|r|nc17|x
  [ ] Confirm per-page minimum rating requirements from RATINGS_INDEX VOL3+
  [ ] Create rollback ZIP: ROLLBACK_RATING_GATE_PRE_PROPAGATION_[DATE].zip

STEPS:
  1. Add rating gate JS to Front Door Bouncer (already partially implemented)
     Verify: Page loads at G/PG. Selecting R shows R content. X shows X content.
  2. Add rating gate check to all R-rated pages first (smallest set, highest risk)
     Pages: /set-list-7/, /set-list-8/, /set-list-9/, /set-list-17/
     Gate: Check rating ≥ R. If below: redirect to bouncer.
  3. Add gate to NC-17 pages: Quick Guide NC-17 + any confirmed NC-17 albums
  4. Add gate to X pages: HOW I GOT HERE dirty/Claude AI + Quick Guide X
  5. Add gate to Full Texts of Lyrics (Ch.8): minimum PG-13
  6. Add gate to Rolling Stone Reviews (Ch.9): minimum R
  7. Test end-to-end: G user → cannot reach R/NC-17/X content
  8. Test end-to-end: X user → can reach all content

VERIFY:
  [ ] G/PG visitor: Song Lists visible, HOW I GOT HERE X versions NOT visible
  [ ] PG-13 visitor: Same as above + PG-13 content visible
  [ ] R visitor: All PG-13 + Set Lists 7/8/9/17 + RS Reviews visible
  [ ] X visitor: Everything accessible

DEPENDENCY WARNING: Do NOT propagate to PG-13 pages until R pages are gated.
  If PG-13 pages are gated first and R pages are not, R content is still open.

ROLLBACK: Revert JS gate checks to unconditional show. Deploy rollback ZIP.

================================================================================
PROCEDURE 2 — HEADER / BRAND BLOCK PROPAGATION
================================================================================

PRE-FLIGHT:
  [ ] Confirm palette variables locked (FIXED_COLOR_README)
  [ ] Create rollback ZIP before touching any live page headers

STEPS:
  1. Define standard header HTML block (brand name + social bar for full pages)
  2. Verify on 3 test pages before propagating
  3. Apply to all Song List pages (10)
  4. Apply to all Set List pages (24)
  5. Apply to all Songbook chapter pages (34+)
  6. Apply to nav system pages (Homepage, 128-Nav, Quicklinks)

SAFE TO COMBINE WITH: Footer propagation (same session, both are additive)
DO NOT COMBINE WITH: Rating gate propagation (different risk profile)

================================================================================
PROCEDURE 3 — NAV BAR PROPAGATION (After drift fix)
================================================================================

PRE-FLIGHT:
  [ ] Tom has answered chapter drift decision (Decision 06)
  [ ] Tom has resolved ch.18 duplicate (Decision 07)
  [ ] Lady Weaver canonical URL decided (Decision 09)
  [ ] Revenue Streams URL fixed (Decision 04)
  [ ] Dev test pages confirmed for removal (Decision 20)
  🔒 DO NOT START until all 5 above are resolved
  [ ] Create rollback ZIP: ROLLBACK_NAV_PRE_FULL_CLEANUP_[DATE].zip

STEPS (Yola global nav — changes propagate automatically):
  1. Remove dev test pages (HTML test1/2/3/(HTML 4))
  2. Fix Revenue Streams URL → Tom's confirmed destination
  3. Fix Write Club URL collision
  4. Apply chapter drift fix (Option A: fix labels OR Option B: fix URLs — per Tom)
  5. Resolve ch.18 duplicate — remove or redirect the non-canonical one
  6. Canonicalize Lady Weaver — update both entries to point to canonical URL
  7. Fix X-rated HOW I GOT HERE nav labels — per Tom's Decision 01
  8. Verify nav renders correctly on homepage, 128-nav, and quicklinks

VERIFY:
  [ ] No dev pages in nav
  [ ] All chapter labels match their URL numbers (or Tom's decision applied)
  [ ] No broken URLs in nav (test Revenue Streams, Write Club)
  [ ] X-rated labels handled per Tom's decision

DEPENDENCY WARNING: Do not fix nav labels for drift BEFORE Tom decides.
  Partial drift fix (some chapters fixed, some not) is worse than unfixed.

================================================================================
PROCEDURE 4 — FOOTER SYSTEM PROPAGATION
================================================================================

PRE-FLIGHT:
  [ ] Confirm correct stats: 121+ pages, 24 Set Lists, 10 Song Lists, 34 Albums

STEPS:
  1. Update footer stats line in Yola global footer:
     "COLLABORHYTHM - TOM JENSEN - COLLABTUNES.COM"
     "HOME | SWITCHBOARD | CONTACT | SITEMAP XML"
     "121+ PAGES | 24 SET LISTS | 10 SONG LISTS | 34 ALBUMS | 40-SECTION PDF | 2026"
  2. Verify Yola propagates to all pages automatically
  3. Spot-check 5 random pages to confirm footer update

SAFE TO COMBINE WITH: Header propagation

================================================================================
PROCEDURE 5 — RATING BADGES PROPAGATION (All 34 AIO pages)
================================================================================

PRE-FLIGHT:
  [ ] mood_settings_ratings_explicit file processed
  [ ] GX delta:1 verified (Decision 11)
  [ ] All 34 album ratings confirmed in RATINGS_INDEX VOL4+
  🔒 DO NOT START until mood_settings file is processed

STEPS:
  1. Generate rating badge for each collection using confirmed data
  2. Apply to Song Lists 1–10 first (PG/PG-13 — lowest risk)
  3. Apply to Set Lists 1–22 (PG-13 estimated)
  4. Apply to Set Lists 7, 8, 9, 17 (R confirmed)
  5. Review Set Lists 23–24 before applying (content unconfirmed)

VERIFY:
  [ ] No G page has an R badge
  [ ] No R page has a G badge
  [ ] GX scores match verified data (not calculated values for delta collections)
  [ ] Pending badge rendered for any collection without confirmed rating

================================================================================
PROCEDURE 6 — METADATA / WARNING BADGES PROPAGATION
================================================================================

PRE-FLIGHT:
  [ ] Content flags confirmed from RATINGS_INDEX for each collection
  [ ] Trigger warning block styling confirmed (Block 11 in template)

STEPS:
  1. Apply DRUGS flag to SL1 (confirmed), SL2 (alcohol confirmed)
  2. Apply DARK_THEMES to all Song Lists and most Set Lists
  3. Apply HEAVY_PSYCHOLOGY to SL3, SL8, SL11, SL12, SL15
  4. Apply PROFANITY to SL17 minimum
  5. Apply SOURCE_PULL badges to all unconfirmed collections

VERIFY:
  [ ] No R/NC-17/X flags on G/PG pages
  [ ] Warning badges visible above fold on R+ pages
  [ ] SOURCE_PULL badges render as styled yellow badge, not raw text

================================================================================
PROCEDURE 7 — CATEGORY SYSTEM PROPAGATION (Block 9)
================================================================================

PRE-FLIGHT:
  [ ] revised_category_list_updated.odt accessible
  [ ] CATEGORY_LEGEND file available

STEPS:
  1. Extract canonical category list from revised_category_list_updated.odt
  2. Map categories to each collection using AIO source files
  3. Inject into Block 9 of each AIO page
  4. Verify categories are consistent (same tag = same meaning across all pages)
  5. Connect to /14-of-35-tracks-listed-by-category/ page

================================================================================
PROCEDURE 8 — FAST SCROLL SYSTEM PROPAGATION
================================================================================

STEPS:
  1. Confirm 4-zone anchor structure: #top / #uppermid / #lowermid / #bottom
  2. Apply to all AIO pages (all are long-form — all need this)
  3. Apply to all Songbook chapter pages with multiple sections
  4. Verify scroll buttons work on mobile landscape (critical UX requirement)

SAFE TO COMBINE WITH: Back button propagation (both are additive nav elements)

================================================================================
PROCEDURE 9 — ARCHIVE / CROSSLINKS PROPAGATION
================================================================================

PRE-FLIGHT:
  [ ] All URL conflicts resolved (ch.18, LadyWeaver, YouTube)
  [ ] MASTER_URL_AUTHORITY_REGISTRY confirmed as single source
  🔒 DO NOT START until all URL conflicts resolved

STEPS:
  1. Generate crosslink set for each collection from WEBSITE_LINK_MAP + themes
  2. Inject into Block 13 (Internal Connections) of each AIO page
  3. Verify all crosslinks use URLs from MASTER_URL_AUTHORITY_REGISTRY
  4. Verify LadyWeaver crosslinks use single canonical URL (post-Decision 09)
  5. Test all crosslinks — no 404s allowed in final output

VERIFY:
  [ ] No crosslink points to a conflict URL (ch.18 duplicate, LadyWeaver duplicate)
  [ ] No crosslink points to a placeholder/coming-soon page as if it has content
  [ ] All crosslinks tested in browser (not just code review)

================================================================================
SAFE COMBINATIONS (Can do in same session):
  Header + Footer propagation
  Fast Scroll + Back Buttons
  Rating Badges + Warning Badges (after mood_settings processed)
  Category Tags + Mood Tags

DO NOT COMBINE IN SAME SESSION:
  Rating gate + Nav bar (different risk profiles)
  Nav bar changes + Crosslink injection (nav must be stable before crosslinks)
  Chapter drift fix + URL rename (compounded risk — one session max one operation)
  Any propagation + Bulk generation (stabilize propagation first, then generate)

================================================================================
END SITEWIDE_PROPAGATION_PLAYBOOK_5_12_26.txt
================================================================================
