vladikk/modularity

解決的問題

本專案提供了一種防止 AI 生成程式碼庫中出現「大泥球」架構與技術負債的方法。它超越了單純的程式碼層級回饋，解決架構上的低效率、錯誤的邊界劃分，以及軟體元件間未受控的耦合問題。

工作原理

這是一個為 Claude Code 設計的外掛程式，實作了平衡耦合模型。該模型從三個維度評估軟體耦合：整合強度（共享知識的數量）、距離（演進的社會技術成本），以及波動性（變更的機率）。

此外掛程式提供兩項主要功能：

• /modularity:review：分析現有程式碼與需求，識別耦合失衡，並提供可執行的改善建議。
• /modularity:design：根據功能需求建立模組化架構，產出設計文件、整合契約與測試規格，並持續迭代直到設計清晰為止。

適用對象

使用 Claude Code 並希望確保系統保持模組化與可維護性的軟體架構師與開發者，特別是在處理快速生成的 AI 程式碼時。

特色

• 架構導向：聚焦於高階系統設計，而非逐行程式碼審查。
• 平衡耦合模型：所有建議均基於明確的類數學規則，而非直覺判斷。
• 自動化設計：可從功能需求自動產生完整的模組設計規格與整合契約。
• Claude Code 整合：直接作為外掛程式在 Claude Code 環境中運作。