Files
ISEP/system-dev/docs/2-architecture/decisions/ADR-0001-isep-自建wiki.md
Leo 45bf7b4a52 ISEP #3:裝一套自己的 wiki,接手 session 不必回頭翻 InkStoneCo
骨架照 inkstone/system-dev-template 的 wiki template 裝(三層+標籤橫切:
INDEX/TAXONOMY/status/mistakes/principles + cards/<bucket>/),不自創格式。

內容只記 ISEP 自己的事:
- 真身薄殼合一(為什麼環境設定收斂成一個 plugin)
- hook 路徑規約(${CLAUDE_PLUGIN_ROOT} vs $CLAUDE_PROJECT_DIR)
- repo 邊界與紅線(wiki 是這條紅線目前唯一開的例外,且例外本身也劃了邊界)

不複製 InkStoneCo 頂層 wiki 的任何內容——複製即 fork,fork 即漂移。

實測:hooks/session-start-recall.sh 以 ISEP 為 cwd 執行,exit 0,principles/mistakes
兩段真的印出剛寫的內容;wiki-secret-scan.sh 對全部新檔案掃過,exit 0;
wiki-recall/update/capture 三支 command 描述的路徑全部存在。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-20 13:00:36 +08:00

35 lines
1.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ADR-0001ISEP 自建 wiki,不繼承 InkStoneCo 的內容
- **狀態**:已採納
- **日期**2026-08-20
- **票**`inkstone/ISEP#3`
## 背景
ISEP 是獨立 repo,裝的是「環境」(hookscommandsskillsscripts),本來刻意不放
「知識」(wikidocs`_archive`)——見 `README.md`「裝什麼」段。但接手 ISEP 的 session
(含雲端)若要查「這裡的決定、踩過的坑、現在什麼狀態」,過去只能回頭 clone InkStoneCo
頂層知識庫,多一層跳轉、且 ISEP 自己的事並不天然屬於 InkStoneCo 頂層(那裡管的是跨專案決策)。
## 決策
ISEP 建立自己的 `system-dev/wiki/`,骨架取自 `inkstone/system-dev-template` 的 wiki
template(三層 + 標籤橫切:`INDEX.md``TAXONOMY.md``status.md``mistakes.md`
`principles.md``cards/<bucket>/`),照它的規約裝,不自創格式。
**紅線**:這份 wiki 只記 ISEP 自己的事。不把 InkStoneCo 頂層 wiki 的內容複製過來——
複製即 fork,fork 即漂移,跟「真身薄殼合一」(見 `cards/isep/真身薄殼合一.md`)要解的病
是同一種結構性錯誤,只是對象從 hook 換成知識庫。
## 後果
- 好處:接手 session 在 ISEP 內就能查到 ISEP 自己的歷史,不必先 clone 別的 repo。
- 代價:多一份骨架要維護(跟 InkStoneCo 頂層、以及其他裝了 template 的子 repo 一樣)。
- 邊界:跨專案的決策、鐵律、部署架構全局,仍然只在 InkStoneCo 頂層記錄,ISEP 不重複。
## 相關
- `cards/isep/真身薄殼合一.md`
- `cards/isep/repo邊界與紅線.md`
- `cards/isep/hook路徑規約.md`