NEXT_IMPLEMENTATION_PRIORITY_ORDER_5_13_26.txt
COLLABTUNES — Next Implementation Priority Order
Date: 2026-05-13
Purpose: Practical sequenced order for next major build sessions.
         Each phase depends on the previous. Do not skip phases.
================================================================================

PRIORITY LOGIC:
  Typography and visual stability must come first — everything renders on top of it.
  Bouncer must exist before any adult content is "live" in any meaningful sense.
  AIO prototype must be proven before generator is built at scale.
  First real collection deployment validates the whole pipeline end to end.
  Ratings canon must be locked before access matrix is wired.
  Nav cleanup must happen before crawl.
  ZIP Vault must exist before crawl produces downloadable output.
  Final crawl is the last step — everything else feeds into it.

================================================================================
PHASE 1 — TYPOGRAPHY RETOUCH
================================================================================
GOAL    : Lock the visual foundation before anything else is deployed.
WHY NOW : Everything renders on top of typography. Fix it once before it
          propagates to 34+ pages at scale.

TASKS:
  1.1  Review current typography across Set List, Song List, and AIO pages
  1.2  Identify inconsistencies: font sizes, weights, line heights, spacing
  1.3  Apply fixes to master HTML template / CSS
  1.4  Test on minimum 3 page types (Set List, Song List, Book Section)
  1.5  Save final typography spec to TYPOGRAPHY_SPEC_FINAL.txt
  1.6  Lock spec — no further typography changes after this phase

INPUT   : updated html with fixed colors third version (Tom's Desktop)
          Current AIO renders (15files_FIRST_5_REAL_AIO_RENDER_OUTPUTS)
OUTPUT  : TYPOGRAPHY_SPEC_FINAL.txt + updated master template
BLOCKER : None — can start immediately

================================================================================
PHASE 2 — BOUNCER STABILIZATION
================================================================================
GOAL    : Get a stable, deployable bouncer live on the site.
WHY NOW : Adult content (X-rated How I Got Here, X-rated Quick Guide) is
          currently ungated. Bouncer must exist before full deployment.

TASKS:
  2.1  Review both bouncer ZIPs — identify canonical version
       4files_BOUNCER_FRONT_DOOR_AND_HALLWAY_VIEW_5_13_26 (v1 and v2)
  2.2  Apply Phase 1 typography to bouncer HTML
  2.3  Wire bouncer routing to Quick Guide ratings (G / PG / PG13 / NC17 / X)
       NOTE: Use current Quick Guide pages as routing source.
             Do NOT finalize canon ratings yet — use working approximation.
  2.4  Test bouncer in YOLA test environment
  2.5  Deploy bouncer to live site
  2.6  Verify X-rated pages are behind the gate
  2.7  Add bouncer link to homepage nav and Switchboard

INPUT   : Bouncer ZIPs (v1, v2), Quick Guide pages (4 live)
OUTPUT  : Live bouncer at /bouncer/ or /enter/
BLOCKER : Typography must be locked (Phase 1)

================================================================================
PHASE 3 — AIO PROTOTYPE TO GENERATOR CONVERSION
================================================================================
GOAL    : Take the proven first-5-AIO renders and convert the process
          into a repeatable generator for all 34 albums.
WHY NOW : First 5 renders are prototype-validated. Now systematize.

TASKS:
  3.1  QA the 5 existing AIO renders against source Set List pages
       Use: 11files_COLLABTUNES_BATCH_VALIDATE_RENDER_5_13_26
  3.2  Document what worked and what failed in the first 5
  3.3  Confirm COLLABTUNES_FACTORY_MASTER_V3_15FILES is the canonical generator
  3.4  Apply Phase 1 typography to generator template
  3.5  Run generator on Set Lists 6–10 as second batch test
  3.6  QA second batch
  3.7  If second batch passes: generator is confirmed stable
  3.8  Document generator input/output spec

INPUT   : First 5 AIO renders, Factory Master V3, Batch Validate pipeline
OUTPUT  : Stable generator confirmed for all Set Lists
BLOCKER : Typography lock (Phase 1). Phase 2 not required but recommended.

================================================================================
PHASE 4 — FIRST REAL COLLECTION DEPLOYMENT
================================================================================
GOAL    : Deploy the first complete album collection live to YOLA.
          This is the pipeline end-to-end proof of concept.
WHY NOW : Generator is now stable. YOLA template exists. Time to go live.

TASKS:
  4.1  Select first deployment collection (Set List 1 — Glass Half Something
       already has YOLA template: 5files_YOLA_TEMPLATE_V3_SETLIST01)
  4.2  Run full deployment checklist:
       5_TXT_COLLABTUNES_STABILIZATION_CONTROL_LAYER_5_13_26
       1_TXT_COLLABTUNES_LIVE_DEPLOYMENT_PRECHECK_CARD_5_13_26
  4.3  Deploy Set List 1 AIO page to live site
  4.4  Verify rendering at live URL
  4.5  Cross-check against source Set List page content
  4.6  Take screenshots (required for ZIP Vault QA record)
  4.7  If passes: scale to Set Lists 2–5
  4.8  If fails: run incident response protocol
       2_TXT_COLLABTUNES_INCIDENT_RESPONSE_AND_GENERATOR_CH

INPUT   : YOLA template V3, AIO render for Set List 01, Deployment ops system
OUTPUT  : Set List 1 (minimum) live on site as AIO page
BLOCKER : Generator must be confirmed stable (Phase 3)

================================================================================
PHASE 5 — RATINGS ACCESS MATRIX
================================================================================
GOAL    : Lock canon ratings for all 34 albums. Wire to bouncer routing.
WHY NOW : Bouncer is live but running on approximate ratings. Canonize now.

TASKS:
  5.1  Pull all 4 Quick Guide pages (live content)
  5.2  Cross-reference with Book Section 11 (Albums Ranked by Rating G to X)
  5.3  Cross-reference with Book Section 12 (Themes, Moods, Profanity)
  5.4  Build RATINGS_CANON_FINAL.txt — one row per album, confirmed rating
  5.5  Identify all pages requiring bouncer gate (NC-17 and X albums)
  5.6  Update bouncer routing with canon ratings
  5.7  Test that all X-rated album pages are properly gated
  5.8  Test that all PG/G album pages are freely accessible
  5.9  Save to COLLABTUNES_QA_CANON_DECISIONS ZIP (see ZIP Vault plan)

INPUT   : Quick Guide live pages, Book sections 11 and 12
OUTPUT  : RATINGS_CANON_FINAL.txt + updated bouncer routing
BLOCKER : Bouncer must be live (Phase 2)

================================================================================
PHASE 6 — NAVIGATION CLEANUP
================================================================================
GOAL    : Fix all 10 blockers in the nav before crawl.
WHY NOW : These must be resolved before crawl captures the final state.

TASKS (from SITE_CRAWL_PREP_CHECKLIST):
  6.1  Fix "potential revenue streams" URL (currently /practice-head/)
       Create /potential-revenue-streams/ page
  6.2  Fix Write Club URL collision
       Create /write-club/ page
  6.3  Resolve YouTube lyric video URL conflict (two URLs, one may 404)
  6.4  Resolve Chapter 15 fragile slug (uppercase + ellipsis in URL)
  6.5  Add "of 35" to "16 Nailed It Teaching Tool" nav label
  6.6  Complete Switchboard Quicklinks table (add ~35 missing pages)
  6.7  Remove dev/test pages from public nav (HTML test1/2/3/4 + blank page)
  6.8  Confirm canonical Lady Weaver entry — Tom decision required
  6.9  Confirm canonical Chapter 18 — Tom decision required
  6.10 Document chapter numbering drift resolution

INPUT   : MASTER_NAVIGATION_CLEANUP_CHECKLIST_5_12_26.txt
          SITE_CRAWL_PREP_CHECKLIST_5_13_26.txt
OUTPUT  : All 10 nav blockers resolved. Switchboard table complete.
BLOCKER : Tom must make Lady Weaver and Chapter 18 canon decisions.

================================================================================
PHASE 7 — ZIP VAULT BUILD
================================================================================
GOAL    : Build the /zip-vault/ landing page and PDF landing page.
          Package completed AIO outputs into downloadable ZIPs.
WHY NOW : Crawl will reference download pages. Must exist before crawl.

TASKS:
  7.1  Build /download-the-book/ or /40-section-pdf/ PDF landing page
  7.2  Build /zip-vault/ hub page
  7.3  Package AIO outputs into named ZIPs per ZIP_VAULT_PACKAGE_LIST
  7.4  Upload ZIPs to hosting
  7.5  Link ZIP Vault from homepage nav, Switchboard, 128 Navigator
  7.6  Verify PDF landing page links to correct file
  7.7  Test all downloads

INPUT   : ZIP_VAULT_PACKAGE_LIST_DRAFT_5_13_26.txt
          Completed AIO renders (all albums, from Phase 3-4)
OUTPUT  : Live /zip-vault/ and /download-the-book/ pages
BLOCKER : AIO renders must be complete (Phase 3-4)

================================================================================
PHASE 8 — FINAL CRAWL PREP
================================================================================
GOAL    : Authorize and run the final site crawl.
WHY NOW : Everything is stable, clean, and gated. Time to capture the canon state.

TASKS:
  8.1  Complete all items in SITE_CRAWL_PREP_CHECKLIST_5_13_26.txt
  8.2  Tom sign-off on checklist
  8.3  Black Claude confirm all systems operational
  8.4  Manual browser capture of Fast Scroll body (still required)
  8.5  Verify /sitemap.xml is current
  8.6  Run crawl on all active pages (HTML capture)
  8.7  Run TXT extract from crawl
  8.8  Package crawl outputs into ZIP Vault (see Category 5 and 6)
  8.9  Build COLLABORHYTHM_MASTER_SNAPSHOT_POST_CRAWL ZIP
  8.10 Final QA pass — no dead links, no broken routes
  8.11 Crawl authorized. Done.

INPUT   : All previous phases complete. Sign-off from Tom and Black Claude.
OUTPUT  : COLLABORHYTHM_MASTER_SNAPSHOT_POST_CRAWL_[DATE].zip
BLOCKER : ALL PREVIOUS PHASES. All 10 nav blockers resolved. Crawl checklist signed.

================================================================================
DEPENDENCY CHAIN SUMMARY
================================================================================

  Phase 1 (Typography)
       |
  Phase 2 (Bouncer) ─────────────────────────────────┐
       |                                              |
  Phase 3 (AIO Generator)                            |
       |                                              |
  Phase 4 (First Deployment)                         |
       |                                              |
  Phase 5 (Ratings Canon) ◄──── depends on Phase 2 ──┘
       |
  Phase 6 (Nav Cleanup) ◄──── Tom decisions required (Lady Weaver, Ch.18)
       |
  Phase 7 (ZIP Vault) ◄──── depends on Phase 3-4 (AIO outputs needed)
       |
  Phase 8 (Final Crawl) ◄──── ALL PHASES COMPLETE

================================================================================
WHAT CAN RUN IN PARALLEL
================================================================================
  Phase 1 + Phase 6 nav decisions (typography + Tom canon decisions)
  Phase 3 QA + Phase 5 ratings research (both pull from same source pages)
  Phase 7 page builds + Phase 6 nav fixes (both are page-level work)

================================================================================
END OF NEXT_IMPLEMENTATION_PRIORITY_ORDER_5_13_26.txt
