docs: baseline doc 重現指令含本機完整路徑，暴露未發表研究專案目錄名 (sibling concern from #131)

[kiki830621]

Problem

docs/format-alignment-baselines.md（public repo）的「重現方式」段落把 MACDOC_TEMPLATE_DIR 的實際本機路徑逐字寫進文件，暴露了未發表研究專案的目錄名。維護者的 env-gate 路徑屬本機配置，不該進 public 文件。

Type

docs

Expected

重現指令用佔位符：MACDOC_TEMPLATE_DIR=<path-to-private-templates> swift test --filter FormatAlignmentAcceptanceTests，路徑細節留在維護者本機（env-gate 的設計本意）。

Actual

文件含完整 ~/Academic/... 展開路徑（含研究專案目錄名）。

Impact

Privacy hygiene 小修（一行 edit）。已在 git history 的部分無法抹除，但 HEAD 修正後停止持續曝光；專案目錄名的敏感度低（非內容洩漏），修 HEAD 即可、不需 history rewrite。

---

Sibling concern surfaced during #131 filing (session 2026-07-08); parent context: #131

---

Current Status

Phase: closed
Last updated: 2026-07-16 by idd-close

Key Decisions

• Complexity = Simple；next: /idd-implement docs: baseline doc 重現指令含本機完整路徑，暴露未發表研究專案目錄名 (sibling concern from #131) #132

Scope Changes

• (none)

Blocking

• (none)

Closing

• docs: baseline doc 重現指令含本機完整路徑，暴露未發表研究專案目錄名 (sibling concern from #131) #132 (comment)

[kiki830621]

Diagnosis

Type

docs

Root Cause / Analysis

docs/format-alignment-baselines.md:164 的「重現方式」段落逐字寫了維護者本機的 MACDOC_TEMPLATE_DIR 展開路徑：

MACDOC_TEMPLATE_DIR=~/Academic/projects/active/sample_size_planning/article2_impossibility_of_rule_of_thumb/docs

這是 env-gate 的本機配置，本不該進 public 文件——env-gate 的設計本意就是把私有路徑留在維護者機器、文件只給佔位符。目錄名 article2_impossibility_of_rule_of_thumb 洩漏未發表研究專案的識別。

Impact

• 影響檔案：docs/format-alignment-baselines.md（單行）
• 洩漏面：僅專案目錄名（非研究內容），敏感度低；git history 已含的部分無法抹除，但修 HEAD 停止持續曝光

Strategy

• docs/format-alignment-baselines.md 路徑改佔位符 <path-to-private-templates>（36bb0fd）
• 掃全 repo 其他同型洩漏——`git ls-files | grep .md | xargs grep -lE '~/Academic|sample_size_planning' → 無殘留

Conflict Class

A_parallel_safe —— 單檔 prose edit，無共享 mutable 資源。

Complexity

Simple

Layer 1 命中「更新既有 prose 但不改 behavior」——一行佔位符替換，deliverable 是文件修正、零 behavior change。跳過 Layer 2/P。

Risks

• git history 的舊路徑仍可考古（低敏感度，不做 history rewrite——issue Impact 已裁定）

Residue

(none)

---

Hard-gate: not triggered — 單檔 doc edit，非散佈概念、無 shared abstraction。

Vagueness Pre-check

• V1: 2 — WHAT 明確：單行路徑改佔位符
• V4: 2 — 驗收明確：grep 無殘留路徑
• Triggered: no — both axes ≤ 3

[kiki830621]

Closing Summary

Problem

docs/format-alignment-baselines.md（public repo）的重現指令逐字寫了維護者本機 MACDOC_TEMPLATE_DIR 展開路徑，洩漏未發表研究專案的目錄名（article2_impossibility_of_rule_of_thumb）。

Root Cause

env-gate 的私有路徑本應留在維護者機器、文件只給佔位符，但 baselines doc 撰寫時直接貼了實際展開路徑。

Solution

docs/format-alignment-baselines.md 的路徑改為佔位符 <path-to-private-templates>。

Verification

全 repo 掃 tracked markdown 確認無其他同型洩漏：git ls-files | grep '\.md$' | xargs grep -lE '~/Academic|sample_size_planning|impossibility_of_rule_of_thumb' → 零命中。git history 的舊路徑不做 rewrite（目錄名敏感度低，issue Impact 已裁定），修 HEAD 停止持續曝光。

Changes

• 36bb0fd docs: use placeholder for MACDOC_TEMPLATE_DIR in baselines reproduce steps

Residue Acknowledgement

Diagnosis residue = (none)。