01 / ARCHITECTURE AS CODE

@kekkai/blueprint

把架構決策從文件中的共識，轉換成工程師、Lint、CI 與 AI Agent 共同遵守的可執行系統。

當 AI 開始大量產生程式碼，最先被悄悄侵蝕的往往不是功能，而是架構。Blueprint 把「系統應該如何成長」寫成一份能被編譯、執行與驗證的來源。

THE PROBLEM

文件會失真，口頭共識會遺失，而每一次 Agent Session 都可能重新猜測架構。檔案放置、依賴方向、模組責任與 package ownership，不能只期待下一個人記得。

THE ABSTRACTION

用一份 blueprint.config 宣告 layers、dependency flow、module shape、ownership、naming 與品質規則，再同步產生 ESLint 規則、Architecture Handbook 與 Agent Contract。規則與說明來自同一份真相，因此不會各自漂移。

BROWNFIELD ADOPTION

Survey 先輸出確定性的專案事實，再由人或 Agent 做架構判斷；Baseline 鎖住既有債務，只阻止新的違規。導入不等於假裝舊系統沒有問題，也不強迫一次完成全面重構。

VERIFICATION

不同驗證層各自處理單元測試看不到的風險：真實 ESLint 合併、Vite／Next.js／Vue／React／Monorepo fixture、Windows 路徑、發佈後 CLI、weekly terrain run 與 mutation testing。重點不是測試數字，而是每一層都有清楚的失敗責任。

FROM STRUCTURE-LINT

@kekkai/structure-lint 最初聚焦 one-way dependency flow；相關能力現在已被 Blueprint 納入更完整的 Architecture as Code 模型。舊 repository 已封存，它是演進來源，不是另一個平行產品。

SKY-1945 / BLUEPRINT IN PRACTICE

Sky-1945 是 Blueprint 的非典型壓力測試。下方直接讀取 GitHub API，呈現目前 repository 的 src/ 結構，讓架構規則落進真實 Codebase 後的形狀可以被直接檢視。