vladikk/modularity

何を解決するか

このプロジェクトは、AIによって生成されたコードベースにおける「大きな泥だらけのボール」型アーキテクチャや技術的負債を防ぐ方法を提供します。単なるコードレベルのフィードバックを越えて、アーキテクチャ上の非効率性、誤った境界の定義、ソフトウェアコンポーネント間の管理されていない結合を解決します。

動作方法

これは、Claude Code用のプラグインであり、バランスド・コッピングモデルを実装しています。このモデルは、ソフトウェアの結合性を3つの次元で評価します：統合強度（共有される知識の量）、距離（進化に伴う社会技術的コスト）、変動性（変更の確率）。

このプラグインは2つの主要なスキルを提供します：

• /modularity:review: 既存のコードと要件を分析し、結合の不均衡を特定し、改善のための実行可能な推奨事項を提供します。
• /modularity:design: 機能要件からモジュールアーキテクチャを構築し、設計書、統合契約、テスト仕様を生成しながら、設計が明確になるまで反復します。

対象ユーザー

Claude Codeを使用し、特に急速に生成されたAIコードを扱う際に、システムのモジュール性と保守性を保ちたいソフトウェアアーキテクトや開発者。

特徴

• アーキテクチャ中心：細部のコードレビューではなく、高レベルのシステム設計に焦点を当てます。
• バランスド・コッピングモデル：すべての推奨事項は直感ではなく、明確な数学的ルールに基づいています。
• 自動設計：機能要件から完全なモジュール設計仕様と統合契約を自動生成できます。
• Claude Code統合：Claude Code環境内で直接プラグインとして動作します。