コンテンツにスキップ

プロジェクトメモリ

プロジェクトメモリは、aqua サーバー上にプロジェクトごとに保存される Markdown ドキュメントです。QAセッションから得られた知見を蓄積し、将来のセッションで AI エージェントやチームメンバーが利用できる永続的なナレッジベースとして機能します。

目的

QA セッションを実行するうちに、テスト対象のアプリケーションについてさまざまなことを学びます。認証の仕組み、信頼性の高いセレクター、存在する制約など。プロジェクトメモリは、この知識をセッション間で失われないように記録する場所を提供します。

仕組み

AI エージェントがやること

セッション開始時にメモリを読み込む。 エージェントは自動的にプロジェクトメモリを取得し、プロジェクトのコンテキスト（既知のセレクター、認証フロー、制約、過去の学び）を理解します。
プラン作成時に知識を活用する。 エージェントは QA プランの構築、セレクターの選択、ステップの設定にプロジェクトメモリの情報を活用します。
セッション終了時に新しい発見を保存する。 QA セッションの後、エージェントに学んだことをプロジェクトメモリに保存するよう依頼できます。

「今回のセッションで学んだことをプロジェクトメモリに保存して。」

エージェントは新しい知見（発見したセレクター、動作する API パターン、タイミングの考慮事項など）を既存のメモリにマージします。

ユーザーができること

Web UI から編集する。 プロジェクトメモリは aqua の Web UI から閲覧・編集できます。手動での修正、エージェントが知らない情報の追加、セッション開始前のメモリ事前登録に便利です。
エージェントに表示を依頼する。 いつでもエージェントに現在のプロジェクトメモリの取得を依頼できます。

「プロジェクトメモリを見せて。」
エージェントに特定のセクションの更新を依頼する。 特定の内容の追加、変更、削除をエージェントに指示できます。

「プロジェクトメモリに、/api/v2 エンドポイントは Bearer トークンが必要という注記を追加して。」

「プロジェクトメモリから古いステージング URL を削除して。」

推奨コンテンツ

適切に管理されたプロジェクトメモリには、通常以下のセクションが含まれます。

アプリケーションアーキテクチャ

アプリケーションの全体的な構造を記録します。フロントエンドフレームワーク、バックエンドサービス、API パターン、およびコンポーネント間の関係などです。

ソースコードの参照先

テストに関連する主要なファイルやディレクトリの場所を記録します。ルート定義、API ハンドラー、データベーススキーマ、設定ファイルなどです。

認証フロー

アプリケーションでの認証の仕組みを記録します。ログインエンドポイント、トークン形式、セッション管理、および異なる環境で利用可能なテストアカウントなどです。

よく使うセレクター

頻繁にテストされる UI 要素の信頼性の高い CSS セレクターをリスト化します。不安定なセレクターや環境依存のセレクターについても記録します。

制約事項

既知の制限、癖、エッジケースを記録します。レート制限、必要なフィーチャーフラグ、環境固有の動作、タイミングの問題などです。

テスト作成メモ

このアプリケーションに対するテスト作成の実践的なヒントを記録します。うまく機能する一般的なパターン、避けるべき落とし穴、過去の QA セッションで得られた教訓などです。

ベストプラクティス

各セッション後にエージェントに更新を依頼する。 セッション終了時に、エージェントに学んだことを保存するよう依頼してください。メモリが常に最新で有用な状態に保たれます。
簡潔に保つ。 テストの作成と保守に役立つ情報に焦点を当てます。他の場所に存在するドキュメントの重複は避けてください。
見出しで構造化する。 Markdown の見出しを使用してコンテンツを整理し、AI エージェントやチームメンバーが関連情報をすばやく見つけられるようにしてください。
古い情報を削除する。 アプリケーションの進化に合わせて、Web UI からまたはエージェントに依頼して、プロジェクトメモリを見直し古くなった詳細を更新してください。