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