majiayu000 Modular Architecture
概要
モジュラーアーキテクチャとコンポーネント分割の設計スキル。高凝集・低結合の原則に基づいたシステム設計、依存関係管理、スケーラブルなアーキテクチャパターンの実装を支援する。
ワークフロー
Phase 1: アーキテクチャ分析
目的: システム要件を理解し、適切なモジュール分割を決定する
アクション:
- システム要件とドメイン境界を明確化
- 機能的凝集性と技術的凝集性を分析
- モジュール境界の候補を特定
- 既存コードベースの依存関係を把握
Task: agents/analyze-architecture.md を参照
Phase 2: モジュール設計
目的: モジュールの責務と依存関係を定義する
アクション:
- 各モジュールの責務と境界を定義
- モジュール間インターフェースを設計
- 依存関係の方向性を決定（依存性逆転）
- レイヤー構造を設計
Task: agents/design-modules.md を参照
Phase 3: 実装と検証
目的: 設計に基づいてモジュールを実装し、品質を確認する
アクション:
- モジュール構造を実装
- 循環依存をチェック
scripts/validate-dependencies.mjsで検証- テストを作成
Task: agents/implement-validate.md を参照
Task仕様ナビ
| Task | 起動タイミング | 入力 | 出力 |
|---|---|---|---|
| analyze-architecture | Phase 1開始時 | システム要件 | 分析レポート |
| design-modules | Phase 2開始時 | 分析レポート | モジュール設計書 |
| implement-validate | Phase 3開始時 | モジュール設計書 | 実装コード、検証結果 |
詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照
ベストプラクティス
すべきこと
| 推奨事項 | 理由 |
|---|---|
| ビジネスロジックとインフラを分離 | 変更容易性の確保 |
| 各モジュールに単一責任を持たせる | 凝集性の向上 |
| 依存性逆転の原則を適用 | 疎結合の実現 |
| インターフェースを明示的に定義 | 契約の明確化 |
| 依存関係を一方向に保つ | 循環依存の防止 |
避けるべきこと
| 禁止事項 | 問題点 |
|---|---|
| 神クラス・ゴッドオブジェクトの作成 | 凝集性の低下 |
| 複数関心事を1モジュールに混在 | 責務の曖昧化 |
| 具体実装への直接依存 | 変更時の影響範囲拡大 |
| 循環依存の放置 | ビルド・テストの困難化 |
| レイヤー飛び越えアクセス | アーキテクチャ崩壊 |
リソース参照
scripts/（決定論的処理）
| スクリプト | 機能 |
|---|---|
scripts/validate-dependencies.mjs |
依存関係と循環依存の検証 |
scripts/log_usage.mjs |
使用記録の保存 |
references/（詳細知識）
| リソース | パス | 読込条件 |
|---|---|---|
| 基本概念 | references/basics.md | 初回利用時 |
| 設計パターン | references/patterns.md | 設計時 |
| レイヤー設計 | references/layered-architecture.md | 高度な設計時 |
変更履歴
| Version | Date | Changes |
|---|---|---|
| 2.0.0 | 2026-01-02 | 18-skills.md仕様完全準拠版として再構築 |
| 1.0.0 | 2025-12-31 | 初版作成 |