Architecture Review(設計・アーキテクチャレビュー)
設計判断の妥当性、アーキテクチャ境界の整合性、データモデルの一貫性を検証する。
When to Use / いつ使うか
- アーキテクチャに影響する変更を含むPRのレビュー時
- ADR(Architecture Decision Record)のレビュー時
- モジュール構成や依存関係の変更時
- API設計の新規作成・変更時
Routing / ルーティング
入力に応じて、適切な個別スキルへルーティングする。
| キーワード |
スキルID |
説明 |
| ADR, 意思決定 |
rr-upstream-adr-decision-quality-001 |
ADR の品質検証 |
| API, エンドポイント |
rr-upstream-api-design-001 |
API 設計レビュー |
| API互換, バージョニング |
rr-upstream-api-versioning-compat-001 |
API バージョン互換性 |
| 境界, モジュール |
rr-upstream-architecture-boundaries-001 |
アーキテクチャ境界 |
| 図, ダイアグラム |
rr-upstream-architecture-diagrams-001 |
設計図の整合性 |
| リスク |
rr-upstream-architecture-risk-register-001 |
リスク登録の検証 |
| トレーサビリティ |
rr-upstream-architecture-traceability-001 |
要件追跡性 |
| 検証計画 |
rr-upstream-architecture-validation-plan-001 |
検証計画レビュー |
| 可用性, 冗長 |
rr-upstream-availability-architecture-001 |
可用性設計 |
| ドメイン, コンテキスト |
rr-upstream-bounded-context-language-001 |
境界づけられたコンテキスト |
| キャッシュ |
rr-upstream-cache-strategy-consistency-001 |
キャッシュ戦略 |
| コスト, キャパシティ |
rr-upstream-capacity-cost-design-001 |
キャパシティ設計 |
| データフロー, 状態 |
rr-upstream-data-flow-state-ownership-001 |
データフロー設計 |
| データモデル, DB |
rr-upstream-data-model-db-design-001 |
データモデル設計 |
| DR, マルチリージョン |
rr-upstream-dr-multiregion-001 |
災害復旧設計 |
| イベント駆動 |
rr-upstream-event-driven-semantics-001 |
イベント駆動設計 |
| 外部依存 |
rr-upstream-external-dependencies-001 |
外部依存関係 |
| 障害, 可観測性 |
rr-upstream-failure-modes-observability-001 |
障害モード分析 |
| 結合, コントラクト |
rr-upstream-integration-contracts-001 |
結合コントラクト |
| マイグレーション |
rr-upstream-migration-rollout-rollback-001 |
マイグレーション計画 |
| マルチテナント |
rr-upstream-multitenancy-isolation-001 |
テナント分離 |
| OpenAPI |
rr-upstream-openapi-contract-001 |
OpenAPI 仕様検証 |
| SLO, 運用性 |
rr-upstream-operability-slo-001 |
運用性・SLO |
| 要件, 受入 |
rr-upstream-requirements-acceptance-001 |
要件・受入条件 |
デフォルト動作
- キーワード指定なし → 変更内容から自動判定
- 複数カテゴリに該当 → もっとも関連性の高いスキルを優先
Execution Flow / 実行フロー
1. 変更種別の判定
├─ ADR/設計ドキュメント → adr-decision-quality を優先
├─ API定義/エンドポイント → api-design, api-versioning-compat を優先
├─ モジュール構成変更 → architecture-boundaries を優先
├─ データモデル変更 → data-model-db-design を優先
└─ キーワード指定あり → 該当スキルを直接選択
2. スキルの実行(該当する専門スキルを並列実行可能)
├─ 設計品質系: adr-decision-quality, architecture-diagrams, architecture-traceability
├─ 構造系: architecture-boundaries, bounded-context-language, data-flow-state-ownership
├─ API系: api-design, api-versioning-compat, openapi-contract, integration-contracts
├─ 運用系: availability-architecture, capacity-cost-design, dr-multiregion, operability-slo
└─ リスク系: architecture-risk-register, failure-modes-observability, external-dependencies
3. 統合
├─ 重複する指摘の除去
└─ 複数カテゴリ該当時は関連性の高いスキルを優先
Output Format / 出力形式
<file>:<line>: <message>
- Finding: 何が問題か(1文)
- Impact: 何が困るか(短く)
- Fix: 次の一手(最小の修正案)
他スキルとの関係
| スキル |
関係 |
棲み分け |
adversarial-review |
補完 |
architecture は「設計の正しさ」、adversarial は「設計の盲点」 |
river-review-security |
補完 |
architecture は「構造」、security は「脆弱性」 |
river-review-code |
補完 |
architecture は「マクロ設計」、code は「ミクロ品質」 |
References
1---2id: river-review-architecture3name: river-review-architecture4description: |5 設計・アーキテクチャ観点のレビューエージェント。6 依存関係、境界設計、データモデル、API設計等の個別スキルへルーティングする。7category: upstream8phase: [upstream]9severity: major10applyTo:11 - 'src/**/*.{ts,tsx,js,jsx,mjs}'12 - 'docs/**/*design*.md'13 - 'docs/adr/**/*'14 - 'pages/**/*design*.md'15inputContext: [diff, fullFile, adr]16outputKind: [findings, questions, actions]17tags: [architecture, design, entry, routing]18version: 0.1.019license: MIT20metadata:21 source: https://skillmd.com/skills/concertonotes/river-review-architecture22---2324# Architecture Review(設計・アーキテクチャレビュー)2526設計判断の妥当性、アーキテクチャ境界の整合性、データモデルの一貫性を検証する。2728## When to Use / いつ使うか2930- アーキテクチャに影響する変更を含むPRのレビュー時31- ADR(Architecture Decision Record)のレビュー時32- モジュール構成や依存関係の変更時33- API設計の新規作成・変更時3435## Routing / ルーティング3637入力に応じて、適切な個別スキルへルーティングする。3839| キーワード | スキルID | 説明 |40| ----------------------- | ---------------------------------------------- | -------------------------- |41| ADR, 意思決定 | `rr-upstream-adr-decision-quality-001` | ADR の品質検証 |42| API, エンドポイント | `rr-upstream-api-design-001` | API 設計レビュー |43| API互換, バージョニング | `rr-upstream-api-versioning-compat-001` | API バージョン互換性 |44| 境界, モジュール | `rr-upstream-architecture-boundaries-001` | アーキテクチャ境界 |45| 図, ダイアグラム | `rr-upstream-architecture-diagrams-001` | 設計図の整合性 |46| リスク | `rr-upstream-architecture-risk-register-001` | リスク登録の検証 |47| トレーサビリティ | `rr-upstream-architecture-traceability-001` | 要件追跡性 |48| 検証計画 | `rr-upstream-architecture-validation-plan-001` | 検証計画レビュー |49| 可用性, 冗長 | `rr-upstream-availability-architecture-001` | 可用性設計 |50| ドメイン, コンテキスト | `rr-upstream-bounded-context-language-001` | 境界づけられたコンテキスト |51| キャッシュ | `rr-upstream-cache-strategy-consistency-001` | キャッシュ戦略 |52| コスト, キャパシティ | `rr-upstream-capacity-cost-design-001` | キャパシティ設計 |53| データフロー, 状態 | `rr-upstream-data-flow-state-ownership-001` | データフロー設計 |54| データモデル, DB | `rr-upstream-data-model-db-design-001` | データモデル設計 |55| DR, マルチリージョン | `rr-upstream-dr-multiregion-001` | 災害復旧設計 |56| イベント駆動 | `rr-upstream-event-driven-semantics-001` | イベント駆動設計 |57| 外部依存 | `rr-upstream-external-dependencies-001` | 外部依存関係 |58| 障害, 可観測性 | `rr-upstream-failure-modes-observability-001` | 障害モード分析 |59| 結合, コントラクト | `rr-upstream-integration-contracts-001` | 結合コントラクト |60| マイグレーション | `rr-upstream-migration-rollout-rollback-001` | マイグレーション計画 |61| マルチテナント | `rr-upstream-multitenancy-isolation-001` | テナント分離 |62| OpenAPI | `rr-upstream-openapi-contract-001` | OpenAPI 仕様検証 |63| SLO, 運用性 | `rr-upstream-operability-slo-001` | 運用性・SLO |64| 要件, 受入 | `rr-upstream-requirements-acceptance-001` | 要件・受入条件 |6566### デフォルト動作6768- キーワード指定なし → 変更内容から自動判定69- 複数カテゴリに該当 → もっとも関連性の高いスキルを優先7071## Execution Flow / 実行フロー7273```text741. 変更種別の判定75 ├─ ADR/設計ドキュメント → adr-decision-quality を優先76 ├─ API定義/エンドポイント → api-design, api-versioning-compat を優先77 ├─ モジュール構成変更 → architecture-boundaries を優先78 ├─ データモデル変更 → data-model-db-design を優先79 └─ キーワード指定あり → 該当スキルを直接選択80812. スキルの実行(該当する専門スキルを並列実行可能)82 ├─ 設計品質系: adr-decision-quality, architecture-diagrams, architecture-traceability83 ├─ 構造系: architecture-boundaries, bounded-context-language, data-flow-state-ownership84 ├─ API系: api-design, api-versioning-compat, openapi-contract, integration-contracts85 ├─ 運用系: availability-architecture, capacity-cost-design, dr-multiregion, operability-slo86 └─ リスク系: architecture-risk-register, failure-modes-observability, external-dependencies87883. 統合89 ├─ 重複する指摘の除去90 └─ 複数カテゴリ該当時は関連性の高いスキルを優先91```9293## Output Format / 出力形式9495```text96<file>:<line>: <message>97```9899- **Finding**: 何が問題か(1文)100- **Impact**: 何が困るか(短く)101- **Fix**: 次の一手(最小の修正案)102103## 他スキルとの関係104105| スキル | 関係 | 棲み分け |106| ----------------------- | ---- | ------------------------------------------------------------- |107| `adversarial-review` | 補完 | architecture は「設計の正しさ」、adversarial は「設計の盲点」 |108| `river-review-security` | 補完 | architecture は「構造」、security は「脆弱性」 |109| `river-review-code` | 補完 | architecture は「マクロ設計」、code は「ミクロ品質」 |110111## References112113- [ROUTING.md](./references/ROUTING.md): 詳細なルーティングルール