エージェントにセットアップを任せる

面倒な部分はエージェントに任せられます

このリポジトリは、コーディング エージェントが読めるように書かれています。マップ ファイル (llms.txt)、ルール ファイル (AGENTS.md)、ファイルごとのメモリ ノート (.ai/)、タスク スキル (.agents/skills/) が付属しています。スタンドアロンの Desktop チェックアウトには prompts/ フォルダーが含まれていないため、既製のプロンプトはこのガイドに印刷されています。ファイルを開くのではなく、以下からコピーしてください。

入力を任せることは、チェックを省略することではありません。エージェントはリポジトリのあなたのコピー内で作業し、何をしたかを証拠とともに報告しなければなりません。以下のセクションでは、良いレポートがどのようなものかを示すので、あなたが結果を掌握したままでいられます。

このパスは Tauri シェルと Web バックエンド (アカウントとデータを処理するサーバー) への接続をセットアップします。デスクトップ ウィンドウはそのバックエンドを表示するだけです。チェックアウトに apps/web も含まれている場合、エージェントはそれをローカルで実行でき、Desktop 専用チェックアウトでは提供された到達可能なバックエンド アドレスが必要です。

• 代わりに手動で Desktop アプリを実行する

最初に必要なもの

まず準備ガイドを完了してください：Node.js、Git、エディターのインストール、GitHub 招待の承認、supastack フォルダーのコンピューターへのダウンロード。エージェントはそのフォルダー内で作業するため、始める前に のすべての内容が引き続き適用されます。

コーディングエージェントとして機能するツールも必要です — AI コーディングエージェントを内蔵したエディター（AI IDE）、またはターミナルで動作するエージェント（エージェント CLI）です。現在のエージェント対応ツールならどれでも動作します。プロンプトには読むべきものと実行すべきものがすでに明記されているため、自分で指示を書く必要はありません。

最後に、プロンプトが求める 2 つのことを決めます: ウィンドウが読み込むバックエンド アドレス (ローカル バックエンドなら http://localhost:3000、または提供された HTTPS アドレス) と、このコンピューターに Rust とネイティブ ビルド ツールがすでにインストールされているかどうか。

プロンプトをコピーし、2 か所を埋めて、貼り付ける

プロンプトは以下のコード ブロックです — ブロック全体を選択してコピーします。

2 つのプレースホルダーに選択が必要です。<APP_URL> をウィンドウが読み込むバックエンド アドレスに置き換えます — ローカル バックエンドなら http://localhost:3000、または提供された HTTPS アドレス。<TOOLCHAIN: present | install> を、rustc と cargo がすでにバージョンを出力するなら present、エージェントに先に Rust と OS ビルド ツールをセットアップさせるなら install に置き換えます。番号付きステップは記述どおりに保ちます。

Set up this supastack Desktop checkout end to end and open the Tauri window against the backend at **<APP_URL>**.
1. Read llms.txt, AGENTS.md and docs/agent-security.md before changing anything.
2. Run rustc --version and cargo --version. On **<TOOLCHAIN: present | install>** = install, install Rust and this OS's Tauri prerequisites first, then continue.
3. Run corepack pnpm install.
4. If apps/web exists in this checkout, start it in a second terminal; otherwise verify <APP_URL> answers from this computer and report its status.
5. Start the shell with corepack pnpm --filter @supastack/desktop dev and report whether the window opens, the tray icon appears and the summon shortcut works.
6. Stop after any step fails twice and report the failing command and first error. Ask before deleting anything.

エージェントがプロンプトで行うこと

プロンプトはエージェントにマップ、ルール、セキュリティ チェックリストを示し、セットアップを順番に進め、各フェーズを証明するよう指示します。平易に言うと、エージェントは:

• 何かに触れる前に、リポジトリのマップ（llms.txt）、プロジェクトのルール（AGENTS.md）、認証情報の取り扱いルール（docs/agent-security.md）を読みます。
• Rust ツールチェーンとこの OS の Tauri 前提条件をチェックし、コンパイルの途中で失敗するのではなく、何をインストールするかを報告します。
• バックエンドが指定アドレスで応答することを確認します — このチェックアウトに apps/web フォルダーが存在する場合のみ自分で起動します — 存在しないサーバーを仮定しません。
• 依存関係をインストールし、シェルをコンパイルしてウィンドウを開き、ウィンドウ、トレイ、呼び出しショートカットの動作を実際の出力とともに報告します。
• 同じステップが 2 回失敗したら停止して報告します — 失敗を回避したり、確認せずに何かを削除したりしません。

エージェントのレポートで確認すること

良いレポートは主張ではなく証拠を示します。各 PASS の背後に、応答するバックエンド URL、完了した依存関係インストール、終了した Rust コンパイル、開いたウィンドウがあるか確認します — 「すべて動作する」のような文ではなく。

プロンプトはエージェントに、同じステップが 2 回失敗したら停止して報告すること (失敗を回避しないこと)、および破壊的な操作の前に確認することを指示します。エージェントが繰り返し失敗した後も即興で進め続ける場合は停止し、最初のエラーをトラブルシューティング ガイドに持ち込みます。

絶対に現れてはいけないものが 2 つあります：エラーを黙らせるためにオフにされたセキュリティ機能と、チャットやレポートに出力されたパスワードやキーなどのシークレット値です。どちらかを見かけたら、その実行は失敗として扱ってください。

シェルと実際のサインインを頭の中で分けてください。ウィンドウにバックエンドのホームページが表示されることはシェルの証明です — 実アカウントにはまだバックエンドのデータベースが必要です。「ウィンドウが開いた」はまだ「アカウントが動作する」ではありません。

手動で行いたい場合

エージェントが実行するすべてのステップは、以下の手動ガイドに記載されています — 同じコマンド、同じチェックを自分のペースで。

• 5 分で Desktop アプリを実行する
• 完全なシェル セットアップを読む
• セットアップの失敗を修正する