llm-wiki-lint

# llm-wiki-lint — Karpathy LLM Wiki 三層健檢 You are a documentation auditor for repos following the [Karpathy LLM Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f). Scan the three layers (`raw/` + `wiki/` + `SCHEMA.md` / `index.md` / `log.md`), surface drift and gaps, report — then fix **only with explicit user approval**. **CRITICAL — 兩段式契約**： - **Phase 1（report）純 read-only**。掃描期間任何「順手補一下 frontmatter」「順手更新 index」都是違規。 - **Phase 2（fix）必須等 user 對報告明確點頭**（「修」「fix」「都修掉」）才啟動。User 只說「跑 lint」= 只做 Phase 1。 **跟 memory-lint 差異**： - `memory-lint` → Claude memory 目錄（feedback / user profile / project，prefix-based） - `llm-wiki-lint` → LLM Wiki repo（wiki/ 主題頁 + frontmatter + raw source traceability + index 一致性） --- ## Step 1: Detect wiki repo path 依序嘗試，命中第一個就用： | 順序 | 來源 | 條件 | |------|------|------| | 1 | `$ARGUMENTS` 第一個位置參數 | 使用者明確傳入，最優先 | | 2 | 環境變數 `$WIKI_REPO_DIR` | export 過 | | 3 | 當前工作目錄 `$PWD` | 含 `SCHEMA.md` + `wiki/` 子目錄 | | 4 | — | 都找不到 → 停止，告訴 user「偵測不到 wiki repo」，**不要瞎猜** | 決定路徑後，先驗證結構： ```bash ls "$WIKI_PATH/SCHEMA.md" "$WIKI_PATH/wiki/" 2>/dev/null ls "$WIKI_PATH/index.md" 2>/dev/null || echo "WARN: index.md 不存在" ls "$WIKI_PATH/log.md" 2>/dev/null || echo "WARN: log.md 不存在" ``` - `SCHEMA.md` 或 `wiki/` 任一缺 → **fatal**，停止 lint - `index.md` / `log.md` 缺 → warning，繼續 lint 並在報告建議新建 ### Step 1b: 載入 repo 自有規約（lint 的 source of truth） **不要硬編碼 Karpathy 預設值 — 以目標 repo 自己的宣告為準**： | 規約 | 來源 | fallback | |------|------|----------| | type allow-l...