Add data directory structure with .gitkeep files and usage instructions

README.md

@@ -146,9 +146,29 @@ SongLift_LyrGen2/
 │   └── utils/            # Utility functions
 ├── scripts/              # Data processing & testing
 ├── data/
-│   ├── raw/lyrics/       # Original lyrics files
-│   └── processed/        # Embeddings & processed data
-└── docs/                 # Documentation
+│   ├── raw/lyrics/       # Place your lyrics files here (organized by artist folders)
+│   └── processed/        # Generated embeddings & ChromaDB files
+└── .env.example          # Environment variables template
+```
+
+### 📂 Data Directory Setup
+
+The `data/` directory structure is preserved for you to add your own lyrics:
+
+```
+data/raw/lyrics/
+├── artist1/
+│   ├── song1.txt
+│   └── song2.txt
+├── artist2/
+│   ├── song1.txt
+│   └── song2.txt
+└── ...
+```
+
+After adding lyrics, run the processing pipeline:
+```bash
+python scripts/process_lyrics.py
 ```
 
 ## 🔍 Browser Compatibility

data/processed/embeddings/.gitkeep

@@ -0,0 +1,3 @@
+# This file ensures the embeddings directory structure is preserved in git
+# Processed embeddings and ChromaDB files will be stored here
+# This directory is populated by running: python scripts/process_lyrics.py

data/raw/lyrics/.gitkeep

@@ -0,0 +1,10 @@
+# This file ensures the lyrics directory structure is preserved in git
+# Place your lyrics files (.txt) in this directory organized by artist folders
+# Example structure:
+# data/raw/lyrics/
+#   ├── artist1/
+#   │   ├── song1.txt
+#   │   └── song2.txt
+#   └── artist2/
+#       ├── song1.txt
+#       └── song2.txt