Files
ISEP/system-dev/docs/2-architecture/decisions/ADR-0001-isep-自建wiki.md
T
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

1.6 KiB
Raw Blame History

ADR-0001ISEP 自建 wiki,不繼承 InkStoneCo 的內容

  • 狀態:已採納
  • 日期2026-08-20
  • inkstone/ISEP#3

背景

ISEP 是獨立 repo,裝的是「環境」(hookscommandsskillsscripts),本來刻意不放 「知識」(wiki/docs/_archive)——見 README.md「裝什麼」段。但接手 ISEP 的 session (含雲端)若要查「這裡的決定、踩過的坑、現在什麼狀態」,過去只能回頭 clone InkStoneCo 頂層知識庫,多一層跳轉、且 ISEP 自己的事並不天然屬於 InkStoneCo 頂層(那裡管的是跨專案決策)。

決策

ISEP 建立自己的 system-dev/wiki/,骨架取自 inkstone/system-dev-template 的 wiki template(三層 + 標籤橫切:INDEX.mdTAXONOMY.mdstatus.mdmistakes.md principles.mdcards/<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