software-architecture-patterns
ソフトウェアアーキテクチャの包括的なリファレンスです。基礎知識、アーキテクチャスタイル（レイヤード、パイプライン、マイクロカーネル、マイクロサービス、イベント駆動、SOA）、アーキテクチャパターン（ヘキサゴナル/ポーツ&アダプター、CQRS、イベントソーシング、MVC）、エンタープライズアプリケーションパターン、統合パターンをカバーします。 以下の場面では常にこのスキルを活用してください：システムやコンポーネントのアーキテクチャをレビューする、新しいサービスやシステムを設計する、システム設計セッションを実施する、アーキテクチャに関する意思決定を行う、アーキテクチャスタイル間のトレードオフを評価する、新しいバウンデッドコンテキストやマイクロサービスを構築する、モジュール化・スケーラビリティ・拡張性についてシステムレベルで議論する、アーキテクチャを文書化する（ADR、アーキテクチャ俳句）、または可用性、スケーラビリティ、保守性、耐障害性などのアーキテクチャの品質属性が議論されるあらゆる場面。
description の原文を見る
Comprehensive reference for software architecture: fundamentals, architectural styles (layered, pipeline, microkernel, microservices, event-driven, SOA), architectural patterns (hexagonal/ports & adapters, CQRS, event sourcing, MVC), enterprise application patterns, and integration patterns. ALWAYS activate this skill when: reviewing system or component architecture, designing new services or systems, doing system design sessions, making architectural decisions, evaluating trade-offs between architectural styles, creating new bounded contexts or microservices, discussing modularisation, scalability, or extensibility at the system level, documenting architecture (ADR, Architecture Haiku), or any time architectural quality attributes (availability, scalability, maintainability, fault tolerance) are being discussed.
SKILL.md 本文
ソフトウェアアーキテクチャ
アーキテクチャレビュー、システム設計セッション、アーキテクチャ上の判断を下すための参考資料です。 各トピックは独立したリファレンスファイルに記載されています。
リファレンスファイル
| ファイル | 内容 |
|---|---|
references/fundamentals.md | アーキテクチャの定義、アーキテクト役割、アーキテクチャ要件、判断、制約、文書化(ADR、Architecture Haiku) |
references/architectural-styles-monolithic.md | レイヤード、パイプライン、マイクロカーネル — トポロジ、トレードオフ、使用場面 |
references/architectural-styles-distributed.md | マイクロサービス、イベント駆動アーキテクチャ(EDA)、SOA — トポロジ、原則、トレードオフ |
references/architectural-patterns.md | ヘキサゴナル(ポーツ&アダプタ)、CQRS、イベントソーシング、MVC |
references/enterprise-patterns.md | ドメインロジックパターン(トランザクションスクリプト、ドメインモデル)、データソースパターン(アクティブレコード、データマッパー)、統合パターン(ファイル転送、共有DB、RPC、メッセージング) |
references/architecture-review-checklist.md | アーキテクチャレビューとシステム設計セッション用の構造化チェックリスト |
各ファイルをいつ読むか
アーキテクチャレビュー / システム設計：
architecture-review-checklist.md から始め、より詳しい背景情報のため関連するスタイルまたはパターンファイルを読んでください。
アーキテクチャスタイルを選択する場合：
architectural-styles-monolithic.md または architectural-styles-distributed.md(またはその両方)を読み、トレードオフ比較表を参照してください。
新しいサービスまたはコンポーネントを設計する場合：
architectural-patterns.md を読んでください(内部構造はヘキサゴナル、複雑なドメインはCQRS/イベントソーシング)。
システム間の統合：
enterprise-patterns.md の統合セクションを読み、4つの統合アプローチを確認してください。
アーキテクチャ上の判断を文書化する場合：
fundamentals.md を読み、ADRおよびArchitecture Haikiテンプレートを確認してください。
アーキテクチャスタイル クイック比較
Style | Type | Scalability | Complexity | Best For
──────────────────┼─────────────┼─────────────┼────────────┼───────────────────────────
Layered | Monolithic | Low | Low | Small/medium business apps
Pipeline | Monolithic | Low | Low | Data processing, ETL
Microkernel | Monolithic | Low | Medium | Product apps, plugin systems
Event-Driven | Distributed | High | High | Async, decoupled workflows
SOA | Distributed | Medium | High | Enterprise integration
Microservices | Distributed | High | Very High | Independent team/domain scale
品質属性 → スタイル/パターン ルックアップ
| ニーズ | 検討事項 |
|---|---|
| 独立したデプロイ可能性 | マイクロサービス |
| 拡張性 / プラグインモデル | マイクロカーネル |
| 高スループットのデータ処理 | パイプライン |
| 非同期の疎結合 | イベント駆動アーキテクチャ |
| 複雑な読み書きスケーリング | CQRS |
| 完全な監査証跡 | イベントソーシング |
| テスト可能なビジネスロジックをインフラストラクチャから分離 | ヘキサゴナル |
| シンプルなチーム所有サービス | レイヤード |
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- wesleyegberto
- ライセンス
- MIT
- 最終更新
- 2026/3/31
Source: https://github.com/wesleyegberto/software-engineering-skills / ライセンス: MIT
関連スキル
doubt-driven-development
重要な判断はすべて、本番環境への展開前に新しい視点から対抗的レビューを実施します。速度より正確性が重要な場合、不慣れなコードを扱う場合、本番環境・セキュリティに関わるロジック・取り消し不可の操作など影響度が高い場合、または後でバグを修正するよりも今検証する方が効率的な場合に活用してください。
apprun-skills
TypeScriptを使用したAppRunアプリケーションのMVU設計に関する総合的なガイダンスが得られます。コンポーネントパターン、イベントハンドリング、状態管理（非同期ジェネレータを含む）、パラメータと保護機能を備えたルーティング・ナビゲーション、vistestを使用したテストに対応しています。AppRunコンポーネントの設計・レビュー、ルートの配線、状態フローの管理、AppRunテストの作成時に活用してください。
desloppify
コードベースのヘルスチェックと技術負債の追跡ツールです。コード品質、技術負債、デッドコード、大規模ファイル、ゴッドクラス、重複関数、コードスメル、命名規則の問題、インポートサイクル、結合度の問題についてユーザーが質問した場合に使用してください。また、ヘルススコアの確認、次の改善項目の提案、クリーンアップ計画の作成をリクエストされた際にも対応します。29言語に対応しています。
debugging-and-error-recovery
テストが失敗したり、ビルドが壊れたり、動作が期待と異なったり、予期しないエラーが発生したりした場合に、体系的な根本原因デバッグをガイドします。推測ではなく、根本原因を見つけて修正するための体系的なアプローチが必要な場合に使用してください。
test-driven-development
テスト駆動開発により実装を進めます。ロジックの実装、バグの修正、動作の変更など、あらゆる場面で活用できます。コードが正常に動作することを証明する必要がある場合、バグ報告を受けた場合、既存機能を修正する予定がある場合に使用してください。
incremental-implementation
変更を段階的に実施します。複数のファイルに影響する機能や変更を実装する場合に使用してください。大量のコードを一度に書こうとしている場合や、タスクが一度では完結できないほど大きい場合に活用します。