Trim the docs to their own jobs

The methodology keeps only the method that reaches the paper's
conclusions; the research plan becomes the proposal minus its
externalized method chapter; the standing rules move to a
Chinese conventions.md; the project-structure inventory, a
hand-kept mirror of the tree itself, is deleted.

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

docs/conventions.md

@@ -1,78 +1,66 @@
-# Project Conventions
+# 常設工作規範
 
-The standing working rules of this project.  Formerly the
-project `CLAUDE.md`; moved here so that Claude Code subagents
-do not inherit it into their context (blind-reading agents
-must not see it).  A main session working on this project
-reads this file before touching the pipeline, the data, or
-the documents.
+本專案的常設工作規範。原專案 `CLAUDE.md`；移置於此，
+使 Claude Code subagent 不將其繼承入 context（盲判型
+agent 不得見之）。凡於本專案工作的主會話，動手管線、
+資料或文件之前，先讀本檔。
 
-## Analysis pipeline
+## 分析管線
 
-The pipeline has run to completion; these conventions govern
-any rerun or extension.
+管線已跑畢；本規範適用於任何重跑或擴充。
 
-- LLM analysis runs via Python scripts calling the Anthropic
-  Messages API, Batch API where possible.  Steps 1 and 3 run
-  on `claude-sonnet-4-6` with `temperature=0` and thinking
-  disabled; steps 4 and 5 run on `claude-fable-5`, which
-  accepts neither parameter -- step 4 absorbs its sampling
-  variance by the majority vote, step 5 by consolidating the
-  three readings.
-- Prompt definition files live in
-  `prompts/<step><substep>-<task>.md` (e.g. 1-tag.md,
-  5a-read.md; substeps are lettered, matching the step
-  numbering of the paper; no version suffix -- versions live
-  in git history) and are passed verbatim as the system
-  prompt.  The number names a step of the research
-  procedure, not the file: the deterministic vocabulary step
-  (step 2) has no definition file yet holds its own number.
-- Itemwise LLM judgments (per-song coding in step 3,
-  per-keyword group selection in step 4) run the same
-  definition file three times, independently, over the same
-  input; a deterministic tally then assigns an item (a
-  (song, keyword) or (group, keyword) pair) when at least
-  two of the three runs assign it ("3 runs + majority
-  vote").  Free-generation steps run
-  twice and both outputs are pooled.  The step-5 qualitative
-  readings are neither: three independent readings per song,
-  consolidated per song and synthesized across songs by
-  their own definition files -- a qualitative protocol, not
-  a vote (see docs/methodology.md).  The vocabulary is
-  built by a deterministic subcommand (embedding +
-  clustering), not by an LLM.  If a validation outcome is
-  unexpected, revise the definition file and repeat that
-  cycle; never patch results by hand.
-- Each run of a step is archived self-contained under the
-  destination directory given explicitly on the `run-llm`
-  command line (by convention `runs/<step>/run<N>/`):
-  prompt snapshot, raw output, and `meta.json` (model ID,
-  parameters, timestamps, batch ID).  The runs of a step are
-  that many separate invocations of `run-llm`.  Replacing
-  an existing run archive requires an explicit flag;
-  superseded runs live in git history.  Deterministic steps
-  archive under `runs/<step>/` with no `run<N>` level.
-- Token usage and cost of every `run-llm` execution are
-  recorded in `docs/run-costs.md` in the same commit as the
-  run archive.
-- Scripts read the API key from the `ANTHROPIC_API_KEY`
-  environment variable (`.env`, gitignored).
+- LLM 分析以 Python 腳本呼叫 Anthropic Messages API
+  執行，能用 Batch API 處即用之。步驟 1 與步驟 3 以
+  `claude-sonnet-4-6` 執行，`temperature=0`、thinking
+  停用；步驟 4 與步驟 5 以 `claude-fable-5` 執行，該
+  模型兩個參數皆不受理——步驟 4 的取樣變異由多數決
+  吸收，步驟 5 由整合三份閱讀吸收。
+- 定義檔置於 `prompts/<步><次步>-<task>.md`（如
+  1-tag.md、5a-read.md；次步以字母標示，與論文正文的
+  步驟編號一致；不帶版本號——版本即 git 歷史），逐字
+  作為 system prompt。
+- 逐項的 LLM 判斷（步驟 3 的逐首編碼、步驟 4 的逐碼
+  入群判斷）以同一份定義檔、同一份輸入獨立執行三次；
+  再由確定性計票將三次執行中至少兩次指派的項目（一個
+  （歌，關鍵字）或（群，關鍵字）配對）收入定案
+  （「三次執行＋多數決」）。自由生成步驟執行兩次，
+  兩份輸出進池。步驟 5 的質性閱讀兩者皆非：逐首三次
+  獨立閱讀，由各自的定義檔逐首整合、跨首統整——質性
+  協定，不是投票（見 docs/methodology.md）。詞彙表由
+  確定性子命令建構（嵌入＋分群），不經 LLM。驗證結果
+  不符預期時，修訂定義檔並重複該循環；絕不手改結果。
+- 一步的每次執行皆自我完備歸檔於 `run-llm` 命令列上
+  明示指定的目的目錄下（慣例為
+  `runs/<步驟>/run<N>/`）：定義檔快照、原始輸出與
+  `meta.json`（model ID、參數、時間戳、batch ID）。
+  一步的 N 次執行即 N 次各自的 `run-llm` 呼叫。覆蓋
+  既有執行歸檔須明示旗標；被取代的執行留在 git 歷史。
+  確定性步驟歸檔於 `runs/<步驟>/`，不分 `run<N>` 層。
+- 每次 `run-llm` 執行的 token 用量與費用記入
+  `docs/run-costs.md`，與執行歸檔同一 commit。
+- 腳本自環境變數 `ANTHROPIC_API_KEY` 讀取 API key
+  （`.env`，gitignored）。
 
-## Data rules
+## 資料規則
 
-- `data/source/` holds the immutable hand-placed raw files;
-  `data/captures/` is written only by the fetch commands and the
-  private import script; `data/manual/` is written only by the
-  user's own hand; `data/derived/` is written only by the
-  `build-db` subcommand.
-- Full lyrics are copyrighted: they stay in `data/captures/lyrics/`
-  (gitignored) and must never be committed or reproduced in
-  full anywhere in the repo.
+- `data/source/` 存手放後不動的原始檔；
+  `data/captures/` 只由 fetch 命令與私人匯入腳本
+  寫入；`data/manual/` 只由研究者親手寫入；
+  `data/derived/` 只由 `build-db` 子命令寫入。
+- 歌詞全文有版權：一律置於 `data/captures/lyrics/`
+  （gitignored），絕不 commit，亦絕不於 repo 任何處
+  全文重現。
 
-## Documents
+## 文件
 
-- `results/` holds the final tallied tables (what the paper
-  cites); `runs/` holds raw audit records.  The paper cites
-  `results/` only.
-- Any change to a definition file or the plan is recorded in
-  `docs/decision-log.md` with date and reason.
+- `results/` 存計票後的定案表（論文所引）；`runs/` 存
+  原始稽核紀錄。論文只引 `results/`。
+- **Commit 判準**：凡能由「committed 的輸入＋committed
+  的程式」決定性再生者不 commit；凡不能者一律以文字
+  格式 commit，格式跟著上文「資料規則」一節所定的
+  層次走。例外：`results/` 定案表與
+  `data/derived/` 人讀報表雖可再生仍 commit——理由是
+  引用穩定性、審稿人零門檻、撰稿期數字變動可 diff；
+  兩者皆與工作儲存同一動作產出，稽核鏈無中間空缺。
+- 凡定義檔或研究規劃之更動，皆記入
+  `docs/decision-log.md`，註明日期與原因。