アプリケーションのアーキテクチャを共有の対話に変え、その対話を実行可能な開発作業に落とし込みます。
このテンプレートは、アプリケーションアーキテクト、開発者、セキュリティ担当者が集まり、システム設計をレビューしてフィードバックを収集し、合意した変更を実装ガイダンスに落とし込むためのものです。既存アプリケーションの再評価や、開発開始前の新規アプリケーション設計の検討にご利用ください。
ワークフローは、リポジトリで管理されているダイアグラムを Miro の共同デザインとつなぎます。まず、AI コーディングエージェントと Miro の MCP コネクタを使い、マーメイド記法のアーキテクチャー図をインポートするか、ボード上で提案するアーキテクチャーを直接スケッチしてください。異なる分野からフィードバックを集め、AI を使って推奨事項を整理し、チームレビュー用に改訂設計を用意します。次に、合意した変更を Agile ユーザーストーリーと、お使いのコーディングエージェント向けの指示に翻訳してください。
テンプレートの使い方
アーキテクチャを取り込む。 既存のマーメイド記法ダイアグラムをインポートしてコラボレーション用の自由形式ダイアグラムに変換するか、新しいアプリケーションのコンポーネントとデータフローをスケッチします。
多職種のフィードバックを集める。 アーキテクト、開発者、セキュリティ担当者を招待して、設計に懸念点、要件、改善提案を注釈で付けてもらいます。ワークショップで一緒に作業するか、非同期で参加できます。
設計を洗練する。 AI ワークフローを使ってフィードバックを推奨事項に要約します。出力を確認し、未解決の質問を解消し、アーキテクチャを更新して変更点を記録します。改訂した設計をマーメイド記法に変換してリポジトリで利用できるようにします。
実装作業を準備する。アジャイルのユーザーストーリーと、コンポーネント、統合、データフロー、制約、受け入れ基準を網羅したアーキテクチャの実装仕様書を生成します。これらの成果物を開発チームまたはコーディングエージェントと共有します。
ボードには、空のワークフロー、完成例、専門領域別のフィードバック用スペース、推奨事項のマインドマップ、アジャイルのユーザーストーリー表、そして実装仕様の例が含まれています。例では、認証、暗号化、信頼境界、データアクセスに関するフィードバックがどのように具体的な設計変更につながるかを示しています。
このテンプレートは、アーキテクチャレビュー、初期のアプリケーション設計、セキュリティ設計の議論、モダナイゼーション計画にご利用ください。チームは、目指すアーキテクチャに関する共通理解と文書化された意思決定を得て、設計から実装へのより明確な道筋を手に入れられます。
AI支援部分は、Miro の AI ワークフローでの利用を想定しており、リポジトリ統合の場合は MCP を介して Miro に接続された AI コーディングエージェントの利用を想定しています。チームはダイアグラムを手描きで作成したり、フィードバックを手動で収集したりすることもできます。
