================================================================================
REPOSITORY_FOLDER_STRUCTURE_REFERENCE_5_12_26.txt
CollabORhythm / Collabtunes — Production Implementation Phase
Generated: 5.12.26 | Production Claude
SOURCE: MASTER_FOLDER_STRUCTURE_5_12_26.txt (authority file)
PURPOSE: Implementation-ready directory tree with human-readable descriptions
         and deployment-safe organization notes
STATUS: READY TO IMPLEMENT — no Tom decisions required
================================================================================

IMPLEMENTATION NOTES:
  - Create all folders before filing any documents
  - Folder names use underscores — no spaces, no hyphens
  - ACTIVE and ARCHIVE subfolders are mandatory in folder 09
  - Folder 14 (GENERATED_OUTPUT) is created empty — do not pre-populate
  - DEFAMATION_RISK_REGISTRY_VOL1 goes ONLY in folder 10_QA — not elsewhere
  - Public-facing HTML files go ONLY in folder 09_HTML_PROTOTYPES/ACTIVE/

================================================================================
DIRECTORY TREE
================================================================================

COLLABTUNES_REPOSITORY/
│
├── 00_OPERATIONAL_RULES/
│   │   Canon rules, naming standards, output rules, template specs.
│   │   The law of the project. Read before touching anything else.
│   │
│   ├── MASTER_NAMING_STANDARD_5_12_26.txt
│   ├── COLLABTUNES_OUTPUT_NAMING_RULES_PERMANENT_5_12_26.txt
│   ├── PRODUCTION_SAFE_TEMPLATE_SYSTEM_5_12_26.txt
│   ├── BULK_HTML_GENERATION_STANDARDS_5_12_26.txt
│   ├── SITEWIDE_PROPAGATION_PLAYBOOK_5_12_26.txt
│   └── ROLLBACK_AND_RECOVERY_PROCEDURES_5_12_26.txt
│
├── 01_LIVE_CAPTURE/
│   │   Raw snapshots of collabtunes.com as it exists at capture time.
│   │   Never edit these. They are the ground truth baseline.
│   │
│   └── COLLABTUNES_LIVE_CAPTURE_FINAL_2026-05-12.zip  [AWAITING UPLOAD]
│
├── 02_CANON/
│   │   Confirmed source-of-truth documents.
│   │   All 34 album titles, locked canon rules, creator interview.
│   │   If it contradicts this folder, flag it — don't silently resolve it.
│   │
│   ├── FINAL_CANON_AUTHORITY_REGISTRY_5_12_26.txt
│   ├── FINAL_NAVIGATION_AUTHORITY_MAP_5_12_26.txt
│   └── FINAL_PLACEHOLDER_AND_FUTURE_SYSTEMS_MAP_5_12_26.txt
│
├── 03_RATINGS/
│   │   Content rating indexes for all 34 albums.
│   │   Confirmed ratings only. Pending ratings use SOURCE_PULL badge in output.
│   │   Mood settings file goes here when uploaded.
│   │
│   ├── [RATINGS_INDEX_VOL1 — file reference from prior sessions]
│   ├── [RATINGS_INDEX_VOL2 — file reference from prior sessions]
│   ├── [RATINGS_INDEX_VOL3 — file reference from prior sessions]
│   └── mood_settings_ratings_explicit_for_all_34_albums  [AWAITING UPLOAD]
│
├── 04_BLOCKERS/
│   │   Unresolved issues blocking deployment or generation.
│   │   Includes live blockers, Tom decision queue, GX conflicts.
│   │   Items move OUT of this folder only when resolved.
│   │
│   ├── UNRESOLVED_BLOCKERS_REQUIRING_TOM_DECISIONS_5_12_26.txt
│   ├── TOM_DECISION_QUEUE_CENTRALIZED_5_12_26.txt
│   ├── SYSTEMS_NOT_YET_SAFE_TO_PROPAGATE_5_12_26.txt
│   └── [TOM_DECISION_QUEUE_ANSWERED version goes here when returned]
│
├── 05_URL_MAPS/
│   │   Every live URL with status codes.
│   │   Generator link injection source — use this for ALL internal links.
│   │   Never pull URLs from memory. Always pull from this folder.
│   │
│   ├── MASTER_URL_AUTHORITY_REGISTRY_5_12_26.txt
│   └── CROSS_SYSTEM_DEPENDENCY_MAP_5_12_26.txt
│
├── 06_NAV_STABILIZATION/
│   │   Navigation architecture, chapter drift mapping, URL conflict tracking.
│   │   Working documents for nav cleanup (Phase 2).
│   │   DO NOT file anything here until Tom answers chapter drift decision.
│   │
│   └── FINAL_NAVIGATION_AUTHORITY_MAP_5_12_26.txt  [copy from 02_CANON]
│
├── 07_DEPLOYMENT/
│   │   Deployment readiness checklists and launch manifests.
│   │   Nothing goes live without passing the 5-gate checklist in this folder.
│   │
│   ├── MASTER_DEPLOYMENT_READY_CHECKLIST_5_12_26.txt
│   ├── SAFE_TO_PROPAGATE_SYSTEMS_5_12_26.txt
│   ├── FINAL_DEPLOYMENT_RISK_ASSESSMENT_5_12_26.txt
│   └── REPOSITORY_STRUCTURE_PLAN_5_12_26.txt
│
├── 08_PLACEHOLDERS/
│   │   Coming-soon trackers and future system maps.
│   │   Documents what exists as a placeholder vs. what is complete.
│   │
│   └── FINAL_PLACEHOLDER_AND_FUTURE_SYSTEMS_MAP_5_12_26.txt
│
├── 09_HTML_PROTOTYPES/
│   │   All HTML files — active working versions and archived prior versions.
│   │   ACTIVE = current working versions.
│   │   ARCHIVE = prior versions, superseded files, pre-fix originals.
│   │   Never delete from ARCHIVE. Never edit ARCHIVE files.
│   │
│   ├── ACTIVE/
│   │   │   Current HTML files in use or being worked on.
│   │   │
│   │   ├── FRONT_DOOR_BOUNCER_FIXED_COLOR_V2_5_12_26.html       [built today]
│   │   ├── WEBSITE_MISSION_STATEMENT_5_12_26.html               [built today]
│   │   ├── PDF_LANDING_PAGE_DOWNLOAD_THE_BOOK_5_12_26.html      [built today]
│   │   └── SONG_LIST_1_LAST_MAN_SINGING_AIO_STAGING_5_12_26.html [Phase 4]
│   │
│   └── ARCHIVE/
│       │   Superseded HTML files. Keep forever. Never delete.
│       │
│       └── [original Bouncer file goes here when V2 is deployed]
│
├── 10_QA/
│   │   Quality assurance, audit reports, risk documents.
│   │   DEFAMATION_RISK_REGISTRY lives HERE ONLY — internal access only.
│   │   Do not move defamation registry to any public-facing folder.
│   │
│   ├── IMPLEMENTATION_READINESS_SCORECARD_5_12_26.txt
│   ├── MOST_DANGEROUS_IMPLEMENTATION_FAILURES_5_12_26.txt
│   ├── GENERATOR_INPUT_READINESS_REPORT_5_12_26.txt
│   └── DEFAMATION_RISK_REGISTRY_VOL1  [INTERNAL ONLY — do not expose]
│
├── 11_HANDOFF/
│   │   Production Claude onboarding, operational guides, session handoffs.
│   │   Everything needed to orient a new session from zero.
│   │
│   ├── READ_THIS_FIRST_PRODUCTION_CLAUDE_5_12_26.txt
│   ├── EXECUTION_ORDER_OF_OPERATIONS_5_12_26.txt
│   ├── PRODUCTION_CLAUDE_DAY_ONE_EXECUTION_PLAN_5_12_26.txt
│   ├── IMPLEMENTATION_READINESS_SCORECARD_5_12_26.txt
│   ├── GLOBAL_PROPAGATION_TARGETS_5_12_26.txt
│   ├── SAFE_BULK_EDIT_OPERATIONS_5_12_26.txt
│   ├── DANGEROUS_BULK_EDIT_OPERATIONS_5_12_26.txt
│   └── TOP_PRIORITY_HIGH_IMPACT_FIXES_5_12_26.txt
│
├── 12_MANIFESTS/
│   │   ZIP manifest files. One manifest per ZIP, named to match the ZIP.
│   │   Format: MANIFEST_[ZIP_NAME]_[DATE].txt
│   │
│   └── [manifest files for each session ZIP go here]
│
├── 13_SOURCE_ZIPS/
│   │   Original ZIP packages received from prior Claude sessions.
│   │   Never unzip here — these are archival originals.
│   │   Extract to working directories only.
│   │
│   ├── 11_TXT_COLLABTUNES_FINAL_AUTHORITY_LAYER_..._5_12_26.zip
│   ├── 7_TXT_COLLABTUNES_FINAL_HANDOFF_..._5_12_26.zip
│   ├── 5_TXT_COLLABTUNES_PRODUCTION_FACTORY_RULEBOOK_5_12_26.zip
│   ├── 5_TXT_COLLABTUNES_PREHANDOFF_OPERATIONAL_CONTROL_LAYER_5_12_26.zip
│   └── HANDOFF_TO_PRODUCTION_CLAUDE_FRM_MIXED_CLAUD.zip
│
└── 14_GENERATED_OUTPUT/
    │   Final generated HTML files ready for Yola upload.
    │   EMPTY until Phase 5 (AIO generation) begins.
    │   Nothing goes here until Tom approves the SL1 staging template.
    │   Do not pre-populate with staging files.
    │
    └── [34 AIO HTML files will be filed here during Phase 5]

================================================================================
FOLDER USAGE RULES
================================================================================

RULE 1 — ONE FOLDER PER FILE TYPE
  TXT canon/registry files → 02_CANON or 05_URL_MAPS or 11_HANDOFF
  TXT blocker/decision files → 04_BLOCKERS
  TXT operational rules → 00_OPERATIONAL_RULES
  HTML files → 09_HTML_PROTOTYPES/ACTIVE/ or ARCHIVE/
  ZIP source packages → 13_SOURCE_ZIPS/
  ZIP manifests → 12_MANIFESTS/
  QA + risk files → 10_QA/

RULE 2 — ARCHIVE BEFORE EDITING
  Before editing any active file, move the prior version to ARCHIVE/
  with _ARCHIVE_[DATE] suffix. Never edit a file in place.

RULE 3 — DEFAMATION REGISTRY STAYS IN 10_QA/
  The DEFAMATION_RISK_REGISTRY_VOL1 is internal documentation.
  It must never be placed in a web-accessible folder or referenced in
  any public-facing file. 10_QA/ is the only authorized location.

RULE 4 — FOLDER 14 STAYS EMPTY UNTIL PHASE 5
  Do not pre-populate GENERATED_OUTPUT with staging files.
  Staging files belong in 09_HTML_PROTOTYPES/ACTIVE/.
  Only Tom-approved, deployment-ready pages go in folder 14.

RULE 5 — NO GENERIC FILENAMES ANYWHERE
  Apply MASTER_NAMING_STANDARD to every file in every folder.
  No file named: notes.txt / output.html / final.zip / temp.txt

================================================================================
CHECKPOINT ZIP FOR FOLDER STRUCTURE
================================================================================

After implementing this structure, create:

  ZIP name: 1_TXT_COLLABTUNES_REPOSITORY_FOLDER_STRUCTURE_REFERENCE_5_12_26.zip
  Contents: This file only
  Purpose:  Permanent record of folder structure spec

After populating folders with existing files:

  ZIP name: [N]_MIXED_COLLABTUNES_REPOSITORY_STRUCTURE_IMPLEMENTED_5_12_26.zip
  Contents: Screenshot or listing of populated folder tree
  Purpose:  Proof of structure at implementation point

================================================================================
ITEMS AWAITING FILING (not yet received — flagged)
================================================================================

[FLAG — AWAITING UPLOAD] mood_settings_ratings_explicit → file in 03_RATINGS/
[FLAG — AWAITING UPLOAD] COLLABTUNES_LIVE_CAPTURE_FINAL_2026-05-12.zip → 01_LIVE_CAPTURE/
[FLAG — AWAITING TOM]    TOM_DECISION_QUEUE with answers → 04_BLOCKERS/ when returned
[FLAG — AWAITING TOM]    DEFAMATION_RISK_REGISTRY_VOL1 review → stays in 10_QA/

================================================================================
END REPOSITORY_FOLDER_STRUCTURE_REFERENCE_5_12_26.txt
================================================================================
