diff --git a/docs/decision-log.md b/docs/decision-log.md index fce55b6..0102d63 100644 --- a/docs/decision-log.md +++ b/docs/decision-log.md @@ -495,3 +495,9 @@ 代價是少數組名不副實，依前條據實報告。實驗歸檔不入 repo，費用 $0.09（sonnet）與 $0.43（fable）記入 `run-costs.md`。 +- **仲裁定義檔改名為 `03-02-arbitration.md`**，2026-08-04 + 訂下的「仲裁檔同 prefix 加 `-arb`」規則隨之作廢。理由： + `code` 與編號重複——`03-02` 已表明是步驟 3（編碼）之下 + 的第二道工序；`arb` 又是全部 task 名中唯一的縮寫。趁 + 步驟 3-2 尚未執行改名，此名進歸檔目錄與論文引用後即 + 不再變動。 diff --git a/docs/methodology.md b/docs/methodology.md index 2f7b2c8..9333841 100644 --- a/docs/methodology.md +++ b/docs/methodology.md @@ -99,7 +99,7 @@ Run、Song，一列一筆出現，依三欄排序），供收斂軌跡分析； - **步驟 3-1 code**：逐首比對兩次執行的標籤集合（引述不 參與比對）。兩次皆有的標籤為共識保留、兩次皆無為 共識不標；單邊標籤送仲裁。 -- **步驟 3-2 code-arb**：仲裁者看歌詞全文與該標籤的引述 +- **步驟 3-2 arbitration**：仲裁者看歌詞全文與該標籤的引述 （不含執行別），裁決保留者附仲裁者自己的引述，剔除 者不列。剔除集合＝送裁鍵減輸出鍵，由程式推得。 - 仲裁者的引述可能與原引述不同：仲裁是對歌詞的重新 diff --git a/docs/project-structure.md b/docs/project-structure.md index 4f1f814..f280c6f 100644 --- a/docs/project-structure.md +++ b/docs/project-structure.md @@ -25,7 +25,7 @@ pop-fem-audit/ │ └── artists.csv # 歌手報表（人讀；進 git） ├── prompts/ # LLM 定義檔（逐字作為 system prompt） │ └── <步>-<次步>-.md # 01-tag.md、03-01-code.md、 -│ # 03-02-code-arb.md +│ # 03-02-arbitration.md │ # 不帶版本號，版本即 git 歷史 │ # （編號的所指是工序：確定性 │ # 的步驟 2 無定義檔仍佔一號； @@ -62,7 +62,7 @@ pop-fem-audit/ │ └── tests/ # 單元測試（unittest） ├── runs/ # 現行執行的完整稽核紀錄（進 git； │ │ # 重跑同一 run 須明示 --replace） -│ ├── <步驟名>/ # 仲裁步驟居自己的 -arb/ +│ ├── <步驟名>/ # 仲裁自成一步，居自己的目錄 │ │ └── run/ # LLM 步驟：每個 run 一份自我 │ │ ├── prompt.md # 完備歸檔（定義檔快照） │ │ ├── output.jsonl # 該次執行原始輸出 diff --git a/docs/research-plan.md b/docs/research-plan.md index 4c62f57..596dad5 100644 --- a/docs/research-plan.md +++ b/docs/research-plan.md @@ -122,8 +122,8 @@ 定義檔命名 `prompts/<步>-<次步>-.md`——步為研究 程序的工序序，次步為步內執行順序（僅一個執行時省略）， 讀者依編號先後依循：01-tag.md、03-01-code.md、 -03-02-code-arb.md；仲裁定義檔同 prefix 加 `-arb`。檔名 -與目錄名補零只為排序，正文一律寫「步驟 1」「步驟 3-2」。 +03-02-arbitration.md。檔名與目錄名補零只為排序，正文 +一律寫「步驟 1」「步驟 3-2」。 編號的所指是工序而非定義檔，因此確定性的第 2 步雖無 定義檔仍佔一個編號，其歸檔為 `runs/02-cluster/`。檔名不帶 版本號——版本即 git 歷史，失敗的版本不保留，需要回看的 diff --git a/prompts/03-02-code-arb.md b/prompts/03-02-arbitration.md similarity index 100% rename from prompts/03-02-code-arb.md rename to prompts/03-02-arbitration.md