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:
@@ -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.
|
||||||
@@ -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(無
|
||||||
|
檔案系統,機制上不可能讀到),此層防線不受本次搬移影響。
|
||||||
|
|||||||
@@ -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 便不會看到工作規範;主會話動手前
|
||||||
|
自行閱讀之。
|
||||||
|
|||||||
Reference in New Issue
Block a user