AI Flow Generator:ジャーニーを記述するだけで、プロジェクト横断フローが完成

実際のアーキテクチャフローは、単一のプロジェクトに収まることはほとんどありません。チェックアウトのジャーニーは、ストアフロントから始まり、決済サービスを経由し、注文サービスに書き込み、通知サービスが消費するイベントを発火させます。4 つのサービス。Archyl 上では 4 つのプロジェクト。しかし実際のユーザージャーニーは 1 つだけです。

これまで、AI Flow Generator は事前にプロジェクトを 1 つ選ぶことを要求していました。単一サービスのフローには有効でしたが、本当に重要なフローには合いませんでした。

本日より:フローを自然言語で記述し、Generate をクリックするだけ。Archyl が組織内のすべてのプロジェクトを読み、どれが関与しているかを判断し、サービスの境界をまたぐ場合も含めて、ステップごとの完全なフローを生成します。

できること

テキストフィールドが 1 つ表示されます。ドキュメント化したい内容を書きます:

「カートから確認メールまでのチェックアウト決済パス」

「ユーザーが auth と email サービスを通してパスワードをリセットする方法」

「データ取り込みからダッシュボードまでのデータパイプライン」

それだけです。AI が組織内のプロジェクトカタログをスキャンし、関連するものを特定し、それらの C4 モデル(およびそれらを接続するプロジェクト間関係)を読み込み、各ステップに対してソース、ターゲット、1 文の説明を記述します。

複数プロジェクトにまたがるフローは、リストで Cross-project バッジが付けられ、一目で見分けられます。

AI Flow Generator — プロンプトから完成したフローまで

仕組み

Generate をクリックすると、Archyl は 2 つの AI パスを順次実行します:

パス 1 — プロジェクトの選定。 AI は、組織内の各プロジェクトの軽量カタログを受け取ります:名前、説明、トップレベルシステム。プロンプトに関連するサブセットを返します — 通常 1〜5 プロジェクトです。20 プロジェクトの組織で「チェックアウト決済パス」と問い合わせると、実際に参加する 3〜4 のサービスが返ってきます。

パス 2 — フローの記述。 次に AI は、それらのプロジェクトだけの統合された C4 モデルを受け取ります:システム、コンテナ、コンポーネント、およびすべての関係 — それらを接続するプロジェクト間のエッジを含みます。ソース、ターゲット、関係の有効な 3 つ組として、実在する要素に基づいたステップの順序付きリストを返します。

各ステップは永続化の前に C4 モデルに対して検証されます。AI が存在しない関係をハルシネートしようとした場合、そのステップは破棄されます。推測ではなく、実際のアーキテクチャから構築されたフローが得られます。

ほとんどの組織では、全シーケンスが 10 秒以内に完了します。

プロンプトが必須になった理由

ショートリストパスには、対象となる意図が必要です。プロンプトがないと、組織内のどのプロジェクトを選ぶべきか、AI には信号がありません。そのためプロンプトフィールドは必須となり、ダイアログは入力なしでの送信を許可しません。

利点:プロンプトが具体的であるほど、ショートリストが絞り込まれ、ステップの精度も上がります。

「認証ジャーニー」は「ログイン」より優れています。

「チェックアウト後に注文確認メールが送信される仕組み」は「メール」より優れています。

具体性によって、プロジェクト数は減り、ステップ数も減り、編集なしで出荷できるフローが得られます。

必要なもの

組織内の少なくとも 1 つのプロジェクトに C4 モデルが必要です。含めたいプロジェクトに対して AI Discovery を実行してください — これがコードベースを読み込み、Flow Generator が参照するコンテナと関係を生成するステップです。

組織内のどのプロジェクトにも C4 データがない場合、明確なエラーが返ります:アーキテクチャがなければフローはありません。意図的な設計です — AI はアーキテクチャを推測せず、すでに作成したドキュメントを読みます。

この機能は Business プラン に含まれます。

結果を編集する

生成されたフローは通常の Archyl フローです。作成後は以下のことが可能です:

  • ステップ名の変更
  • ステップの追加・削除
  • 任意の説明の書き換え
  • 順序の並び替え
  • 公開リンクの共有

AI は最初のドラフトを提供します。出荷可能かどうか、もう一度推敲が必要かどうかはあなたが決めます。ほとんどの場合、近いところまで来ています。

始め方

  1. サイドバーの Flows を開く
  2. Generate with AI をクリック
  3. 文書化したいジャーニーを記述する — 具体的に
  4. Generate → をクリック

準備ができ次第、結果が自動的に開きます。フローが複数のプロジェクトにまたがる場合、Flows リストに Cross-project バッジが表示されます。

無料プランの場合、Business プランのゲートが表示されます。AI Discovery 機能で、モデルがあなたのコードベースで何ができるかを体感できます — フロー生成はアーキテクチャをドキュメント化した後の次のステップです。


関連記事: