Reorganize data/ into source, captures, and manual layers

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

.gitignore

@@ -1,5 +1,5 @@
 # Copyrighted lyrics cache — never commit full lyrics
-data/lyrics/
+data/captures/lyrics/
 
 # Secrets
 .env

CLAUDE.md

@@ -21,9 +21,11 @@
 
 ## Data rules
 
-- `data/yearend_hot100_2016_2025.csv` is the only hand-placed
+- `data/source/` holds the immutable hand-placed raw files;
-  raw file; everything else in `data/` is script-derived.
+  `data/captures/` is written only by the fetch commands and the
-- Full lyrics are copyrighted: they stay in `data/lyrics/`
+  private import script; `data/manual/` is written only by the
+  user's own hand.
+- Full lyrics are copyrighted: they stay in `data/captures/lyrics/`
   (gitignored) and must never be committed or reproduced in
   full anywhere in the repo.
 

README.md

@@ -21,17 +21,17 @@ Hot 100（2016–2025）為例的內容分析。
 3. 依 `docs/research_plan.md` 的階段順序，於 `tools/` 目錄下
    執行子命令，必要輸入以位置引數、選擇性輸入以選項給定（如
    `pop-fem-audit-tools build-db
-   ../data/yearend_hot100_2016_2025.csv
+   ../data/source/yearend_hot100_2016_2025.csv
-   --lyrics-dir ../data/lyrics
+   --lyrics-dir ../data/captures/lyrics
-   --wikidata-csv ../data/artists_wikidata.csv
+   --wikidata-csv ../data/captures/artists_wikidata.csv
-   --overrides-csv ../data/artists_overrides.csv`）。
+   --overrides-csv ../data/manual/artists_overrides.csv`）。
    LLM 步驟使用 `claude-sonnet-4-6`、temperature=0、
    thinking 關閉；每步驟獨立執行兩次後由仲裁步驟合併
    （「2+1」協定）。
 4. 每次執行的完整紀錄（定義檔快照、原始輸出、參數）存於
    `runs/`，可逐筆稽核。論文引用的最終資料表在 `results/`。
 
-注意：歌詞受版權保護，`data/lyrics/` 不隨 repo 發布，須自行
+注意：歌詞受版權保護，`data/captures/lyrics/` 不隨 repo 發布，須自行
 以 `tools/` 中的抓取程式重建。
 
 ## 授權