Move CLAUDE.md to docs/conventions.md so subagents do not inherit it

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-18 23:37:32 +08:00
co-authored by Claude Opus 5
parent 85d776da8b
commit a5fd86deb6
3 changed files with 31 additions and 7 deletions
+12 -2
View File
@@ -1,7 +1,17 @@
# Project Conventions # 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.
## Analysis pipeline ## Analysis pipeline
The pipeline has run to completion; these conventions govern
any rerun or extension.
- LLM analysis runs via Python scripts calling the Anthropic - LLM analysis runs via Python scripts calling the Anthropic
Messages API, Batch API where possible. Steps 1 and 3 run Messages API, Batch API where possible. Steps 1 and 3 run
on `claude-sonnet-4-6` with `temperature=0` and thinking on `claude-sonnet-4-6` with `temperature=0` and thinking
@@ -64,5 +74,5 @@
- `results/` holds the final tallied tables (what the paper - `results/` holds the final tallied tables (what the paper
cites); `runs/` holds raw audit records. The paper cites cites); `runs/` holds raw audit records. The paper cites
`results/` only. `results/` only.
- Any change to a definition file, the codebook, or the plan is - Any change to a definition file or the plan is recorded in
recorded in `docs/decision-log.md` with date and reason. `docs/decision-log.md` with date and reason.
+12
View File
@@ -932,3 +932,15 @@
LLM 合併嘗試 `01-02-01-merge`、步驟 3 的仲裁 LLM 合併嘗試 `01-02-01-merge`、步驟 3 的仲裁
`03-02-arbitration`)其歸檔已不存在,無現行編號可指, `03-02-arbitration`)其歸檔已不存在,無現行編號可指,
不另發新名,步驟欄逕標「已廢棄」,原名存於末欄。 不另發新名,步驟欄逕標「已廢棄」,原名存於末欄。
- **CLAUDE.md 移為 `docs/conventions.md`**:專案 CLAUDE.md 會
全文自動注入每一個 Claude Code subagent 的 context(2026-07-30
實測條),步驟 6 的 883 個盲判 agent 因此都看到了工作規範。
規範本身無研究語意(無 women-power、無假說),污染有限,但
「防脈絡污染」的原則應貫徹到自家工具鏈:docs/ 底下的檔案
不會自動注入,搬移後 subagent 除非主動翻閱否則不會看到,
盲判 agent 的定義檔並明令不得查閱專案材料。代價是主會話
也不再自動載入,須自行先讀 `docs/conventions.md`。內容
順帶微調:註明管線已完成、規範適用於重跑;刪去已不存在
的 codebook 一詞。進論文的數據一律走 Anthropic API(無
檔案系統,機制上不可能讀到),此層防線不受本次搬移影響。
+7 -5
View File
@@ -6,8 +6,6 @@ SQLite 工作儲存架構;2026-08-17 依完成後的現況更新)
``` ```
pop-fem-audit/ pop-fem-audit/
├── README.md # 專案說明、重現步驟 ├── README.md # 專案說明、重現步驟
├── CLAUDE.md # 極簡工作規範(subagent 會讀到,
│ # 絕不放理論、codebook、預期結果)
├── .gitignore # captures/lyrics/、.env、scratch ├── .gitignore # captures/lyrics/、.env、scratch
├── data/ # 依生命週期分層(文字格式) ├── data/ # 依生命週期分層(文字格式)
│ ├── source/ # 源頭:手放後不動 │ ├── source/ # 源頭:手放後不動
@@ -91,6 +89,8 @@ pop-fem-audit/
│ ├── annotations.csv # 步驟 5d 定案歌×樣態 │ ├── annotations.csv # 步驟 5d 定案歌×樣態
│ └── pattern-matrix.csv # 前四者的人讀寬表 │ └── pattern-matrix.csv # 前四者的人讀寬表
├── docs/ ├── docs/
│ ├── conventions.md # 常設工作規範(原 CLAUDE.md
│ │ # 移入 docs/ 使 subagent 不繼承)
│ ├── research-plan.md # 研究步驟規劃(本檔之姊妹篇) │ ├── research-plan.md # 研究步驟規劃(本檔之姊妹篇)
│ ├── project-structure.md # 本檔 │ ├── project-structure.md # 本檔
│ ├── output-validation.md # LLM 輸出的契約查核紀錄 │ ├── output-validation.md # LLM 輸出的契約查核紀錄
@@ -132,6 +132,8 @@ pop-fem-audit/
- **設定**經 pydantic-settings 統一:`.env`gitignored,範本 - **設定**經 pydantic-settings 統一:`.env`gitignored,範本
`tools/.env.example`)供應 `SQLALCHEMY_DATABASE_URL` `tools/.env.example`)供應 `SQLALCHEMY_DATABASE_URL`
`ANTHROPIC_API_KEY`,絕不寫入 repo。 `ANTHROPIC_API_KEY`,絕不寫入 repo。
- **CLAUDE.md 極簡**:實測證實 Claude Code subagent 會繼承專案 - **不設 CLAUDE.md**:實測證實 Claude Code subagent 會繼承專案
CLAUDE.md 全文,故其中只放工作流程規則,領域知識一律放 CLAUDE.md 全文(原本因此只放極簡工作規則),2026-08-18 進一步
`docs/`subagent 不會自動讀到)。 將其移為 `docs/conventions.md`——docs/ 不會自動注入 subagent
的 context,盲判型 agent 便不會看到工作規範;主會話動手前
自行閱讀之。