================================================================================
REPOSITORY_STRUCTURE_PLAN_5_12_26.txt
CollabORhythm / Collabtunes — Final Stabilization Consolidation Pass
Generated: 5.12.26
STATUS: RECOMMENDED structure — Tom approves before implementing
================================================================================

PURPOSE:
Define how all project files should be organized going forward.
Baseball Rule: this is the ballpark blueprint — data (files) go in the right sections.
Keeps AI oriented, prevents duplicate work, prevents overwriting canon.

================================================================================
SECTION 1 — RECOMMENDED FOLDER STRUCTURE
================================================================================

COLLABTUNES_PROJECT_ROOT/
│
├── 00_OPERATIONAL_RULES/
│   ├── COLLABTUNES_OUTPUT_NAMING_RULES_PERMANENT_5_12_26.txt
│   └── README_READ_THIS_FIRST_NEW_CLAUDE_SESSION.txt  ← build this next session
│
├── 01_LIVE_CAPTURE/
│   ├── COLLABTUNES_LIVE_CAPTURE_FINAL_2026-05-12.zip
│   └── FAST_SCROLL_MANUAL_BROWSER_CAPTURE.txt  ← pending Tom action
│
├── 02_CANON/
│   ├── FINAL_CANON_AUTHORITY_REGISTRY_5_12_26.txt          ← THIS SESSION
│   ├── MASTER_CANON_SOURCE_NOTES_VOL1_5_11_26.txt
│   ├── MASTER_CANON_SOURCE_NOTES_VOL2_5_11_26.txt
│   └── MASTER_CANON_SOURCE_NOTES_VOL3_LIVE_SITE_5_12_26.txt
│
├── 03_RATINGS/
│   ├── MASTER_CONTENT_RATINGS_INDEX_VOL1_5_11_26.txt
│   ├── MASTER_CONTENT_RATINGS_INDEX_VOL2_5_11_26.txt
│   └── MASTER_CONTENT_RATINGS_INDEX_VOL3_LIVE_SITE_5_12_26.txt
│   └── [VOL4 when mood_settings_explicit file is processed]
│
├── 04_BLOCKERS/
│   ├── DEPLOY_BLOCKERS_VOL2_5_11_26.txt
│   ├── DEPLOY_BLOCKERS_VOL3_LIVE_SITE_5_12_26.txt
│   └── UNRESOLVED_BLOCKERS_REQUIRING_TOM_DECISIONS_5_12_26.txt  ← THIS SESSION
│
├── 05_URL_MAPS/
│   ├── MASTER_URL_REGISTRY_VOL1_5_12_26.txt
│   ├── MASTER_URL_AUTHORITY_REGISTRY_5_12_26.txt              ← THIS SESSION
│   └── MASTER_NAVIGATION_STABILIZATION_REPORT_VOL1_5_12_26.txt
│
├── 06_NAV_STABILIZATION/
│   ├── FINAL_NAVIGATION_AUTHORITY_MAP_5_12_26.txt             ← THIS SESSION
│   ├── TOM_DECISION_QUEUE_VOL1_5_12_26.txt
│   └── MASTER_NAVIGATION_CLEANUP_CHECKLIST_5_12_26.txt  ← referenced but not built yet
│
├── 07_DEPLOYMENT/
│   ├── MASTER_DEPLOYMENT_READY_CHECKLIST_5_12_26.txt          ← THIS SESSION
│   ├── SAFE_TO_PROPAGATE_SYSTEMS_5_12_26.txt                  ← THIS SESSION
│   └── SYSTEMS_NOT_YET_SAFE_TO_PROPAGATE_5_12_26.txt          ← THIS SESSION
│
├── 08_PLACEHOLDERS/
│   └── FINAL_PLACEHOLDER_AND_FUTURE_SYSTEMS_MAP_5_12_26.txt   ← THIS SESSION
│
├── 09_HTML_PROTOTYPES/
│   ├── FIXED_COLOR_CODING_HTMLS_5_11_26.zip                   (3 FIXED HTML + README)
│   └── MAY_CODING_HTMLS_FOUR_OF_THEM_5_11_26.zip              (4 ORIGINALS — archive)
│
├── 10_QA/
│   ├── SHORT_SUMMARY_OF_FINDINGS_VOL1_5_11_26.txt
│   ├── SHORT_SUMMARY_OF_FINDINGS_VOL2_5_11_26.txt
│   ├── SHORT_SUMMARY_OF_FINDINGS_VOL3_LIVE_SITE_5_12_26.txt
│   └── [Session QA reports from Black/White Claude — add when available]
│
├── 11_REGISTRY/
│   ├── REPOSITORY_STRUCTURE_PLAN_5_12_26.txt                  ← THIS FILE
│   └── FINAL_CANON_AUTHORITY_REGISTRY_5_12_26.txt             (also in 02_CANON)
│
├── 12_MANIFESTS/
│   ├── MANIFEST_4_TXT_FILES_COLLABTUNES_NAV_STABILIZATION_5_12_26.txt
│   └── [All future manifests go here]
│
└── 13_SOURCE_ZIPS/
    ├── 39_ALL_IN_ONES.zip
    ├── thirt_or_forty_htmls.zip
    ├── SECTIONS_FROM_WEBSITE_on_ZIP.zip
    ├── WEBSITE_LINK_MAP.zip
    ├── 121_TABS_ORGANIZED_INTO_13_SECTIONS.zip
    ├── BIG_LIST_OF_RECENT_INDEX_FILES.zip
    ├── BUILDING_BLOCKS_FOR_NEW_CODE_MAKING.zip
    ├── OA_REPORTS_AND_HTML_CODING.zip
    ├── MASTER_DUMPS.zip
    └── [all other source ZIPs]

================================================================================
SECTION 2 — FILE VERSIONING RULES
================================================================================

RULE 1: Never delete VOL1. Create VOL2, VOL3, etc.
RULE 2: Date every file. No undated files in this project.
RULE 3: If two files have the same purpose but different dates, keep both.
         The newer date is current. The older date is ARCHIVE.
RULE 4: If a file is superseded, rename it with _SUPERSEDED_[date] suffix.
         Do not delete — ever.
RULE 5: This session = 5_12_26. Prior session = 5_11_26. Track by date.

================================================================================
SECTION 3 — HANDOFF PACKAGE SPEC (For next Claude session)
================================================================================

When handing off to a new Claude, include:
  □ COLLABTUNES_OUTPUT_NAMING_RULES_PERMANENT_5_12_26.txt
  □ FINAL_CANON_AUTHORITY_REGISTRY_5_12_26.txt
  □ MASTER_URL_AUTHORITY_REGISTRY_5_12_26.txt
  □ FINAL_NAVIGATION_AUTHORITY_MAP_5_12_26.txt
  □ MASTER_DEPLOYMENT_READY_CHECKLIST_5_12_26.txt
  □ UNRESOLVED_BLOCKERS_REQUIRING_TOM_DECISIONS_5_12_26.txt
  □ TOM_DECISION_QUEUE_VOL1_5_12_26.txt  (with Tom's answers filled in)
  □ The most recent RATINGS INDEX (VOL3 or higher)
  □ COLLABTUNES_LIVE_CAPTURE_FINAL_2026-05-12.zip

The new Claude reads NAMING RULES first, then CANON AUTHORITY, then DEPLOYMENT CHECKLIST.
It does not start building until it understands the current state.

================================================================================
SECTION 4 — WHAT STILL NEEDS TO BE BUILT (NEXT SESSION PRIORITIES)
================================================================================

PRIORITY 1 — PENDING Tom answers from TOM_DECISION_QUEUE:
  All 20 decisions answered → Execute fixes listed in each decision

PRIORITY 2 — MISSING SOURCE FILE:
  Upload mood_settings_ratings_explicit_for_all_34_albums
  This file unlocks the full per-album rating picture

PRIORITY 3 — FAST SCROLL CAPTURE:
  Tom manually captures Fast Scroll body content

PRIORITY 4 — GENERATOR PREP:
  White Claude 2 source pull: SL1 tracks 2–7, 9–13
  Confirm first 5 deployment collections (SL1, SL6, SL7, SL8, SL9)

PRIORITY 5 — MASTER CLEANUP CHECKLIST:
  MASTER_NAVIGATION_CLEANUP_CHECKLIST (referenced but not yet built)
  Exact edit-by-edit list of every nav fix needed

================================================================================
END REPOSITORY_STRUCTURE_PLAN_5_12_26.txt
================================================================================
