Architectural Patterns

Architectural Patterns

概要

アーキテクチャパターンの選定・比較・適用・検証を一連で整理する。 必要な詳細は references/ に外部化し、必要なときだけ参照する。

• 比較レポートは assets/pattern-comparison.md を使用
• 実装準拠の評価は scripts/evaluate-pattern-compliance.mjs を使用

ワークフロー

Phase 1: コンテキスト整理

目的: 対象システムの目的・制約・現状を把握する

アクション:

1. references/Level1_basics.md で基礎概念を確認
2. references/requirements-index.md で適用ルールを確認
3. 現状構造と制約を整理する

Task: agents/analyze-context.md

Phase 2: パターン選定と境界設計

目的: パターン比較と境界設計を行い、採用方針を固める

アクション:

1. assets/pattern-comparison.md に比較結果を整理
2. 必要に応じて references/hexagonal-architecture.md などを参照
3. 境界設計と依存方向のルールを決める

Task:

• agents/pattern-selection.md
• agents/boundary-design.md

Phase 3: 準拠評価と記録

目的: 実装が設計意図に沿っているか検証し、改善点を記録する

アクション:

1. scripts/evaluate-pattern-compliance.mjs で依存違反を確認
2. scripts/validate-skill.mjs でスキル構造を検証
3. scripts/log_usage.mjs でフィードバックを記録

Task: agents/compliance-review.md

Task仕様ナビ

ベストプラクティス

すべきこと

• 目的と制約を先に整理してからパターンを選定する
• 境界設計は依存方向と責務の範囲で定義する
• 既存コードの依存違反を定量的に確認する
• パターン選定の理由を記録し、後続判断の根拠にする
• 移行計画とリスクを比較レポートに含める

避けるべきこと

• 目的や制約を無視してパターンを先に決める
• 依存方向のルールを曖昧にする
• パターンの用語を混在させて境界が曖昧になる
• 準拠評価なしで移行を進める

リソース参照

参照資料

• references/Level1_basics.md: 基本概念と最小チェック
• references/Level2_intermediate.md: パターン選定と比較の実務
• references/Level3_advanced.md: 移行・検証と段階適用
• references/Level4_expert.md: 複合パターンと運用最適化
• references/hexagonal-architecture.md: Ports and Adaptersの詳細
• references/onion-architecture.md: Onion Architectureの詳細
• references/vertical-slice.md: Vertical Sliceの詳細
• references/requirements-index.md: 適用ルール索引
• references/legacy-skill.md: 旧版の要約（移行時のみ参照）

スクリプト

• scripts/evaluate-pattern-compliance.mjs: 依存関係の準拠評価
• scripts/validate-skill.mjs: スキル構造検証
• scripts/log_usage.mjs: 実行ログ記録

テンプレート

• assets/pattern-comparison.md: パターン比較レポート

変更履歴