For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/web/agent-setup.md (or send Accept: text/markdown).
エージェントにセットアップを任せる
出来合いのプロンプトを 1 つコーディングエージェントに貼り付け、コンピューター上で Web セットアップを実行させ、各ステップについて書かれたレポートを確認します。
面倒な部分はエージェントに任せられます
このリポジトリは、コーディングエージェントが読めるように書かれています。マップファイル（llms.txt）、ルールファイル（AGENTS.md）、ステップバイステップのランブック（docs/agent-setup.md）、出来合いのプロンプト（prompts/agent-setup.md）が同梱されています。各セットアップコマンドを自分で覚える代わりに、プロンプトを 1 つ貼り付けるだけで、エージェントがコンピューター上でランブックに従って作業します。
入力を任せることは、チェックを省略することではありません。エージェントはリポジトリのあなたのコピー内で作業し、何をしたかを証拠とともに報告しなければなりません。以下のセクションでは、良いレポートがどのようなものかを示すので、あなたが結果を掌握したままでいられます。
正直な制限が 1 つあります。この自動化された経路は、Web アプリとそのバックエンド（アカウントとデータを処理するサーバー）をセットアップします。プロンプトとランブックは、Web リポジトリと All Platforms モノレポに同梱されています。モバイルのみ・デスクトップのみのチェックアウトには、代わりにそれぞれのスコープの llms.txt とプラットフォームのセットアップガイドが含まれます。
最初に必要なもの
まず準備ガイドを完了してください：Node.js、Git、エディターのインストール、GitHub 招待の承認、supastack フォルダーのコンピューターへのダウンロード。エージェントはそのフォルダー内で作業するため、始める前に のすべての内容が引き続き適用されます。
コーディングエージェントとして機能するツールも必要です — AI コーディングエージェントを内蔵したエディター（AI IDE）、またはターミナルで動作するエージェント（エージェント CLI）です。現在のエージェント対応ツールならどれでも動作します。プロンプトには読むべきものと実行すべきものがすでに明記されているため、自分で指示を書く必要はありません。
最後に、アプリを実行する 2 つの方法のうち 1 つが必要です：コンピューターにインストールされた Node.js 22 以降（準備ガイドで設定した経路）、または Docker や Podman などのコンテナツール（アプリをコンテナ内で実行し、インストール済みの Node.js を必要としません）。プロンプト内でどちらかを選ぶと、エージェントがそれに従います。
プロンプトをコピーし、2 か所を埋めて、貼り付ける
エディターで prompts/agent-setup.md を開きます — これは supastack フォルダーの最上位にある prompts フォルダー内、llms.txt の隣にあります。全文を選択してコピーします。
2 つのプレースホルダーに選択肢を入力します。<SETUP_PATH: docker | podman | host> を docker、podman、host のいずれかに置き換えます — host はインストールした Node.js を使ってアプリをコンピューター上で直接実行し、docker または podman はコンテナ内で実行します。<DEPLOY_TARGET: coolify | vps-docker | local-only> をアプリの最終的な配置先に置き換えます — local-only はこのコンピューター上で実行するだけで何もデプロイしないため、最初の確認には最適な選択です。
編集したテキストをエージェントのチャットに貼り付けて送信します。下の記入済みの 1 行目は docker と local-only を選んだ例です。その行の下にある番号付きの手順は、ファイルに同梱されているままの状態です。
Stand up this supastack checkout end to end for **docker**
and deploy it to **local-only**.エージェントがプロンプトで行うこと
プロンプトはエージェントをランブックとセキュリティルールに向けさせ、それらを順番に実行し、各フェーズを証明するよう指示します。平たく言うと、エージェントは次のことを行います：
- 何かに触れる前に、リポジトリのマップ（
llms.txt）、プロジェクトのルール（AGENTS.md）、認証情報の取り扱いルール（docs/agent-security.md）を読みます。 node scripts/setup-env.mjsで.env設定ファイルを作成します。このヘルパーは.env.exampleからのみコピーするため、エージェントが設定名をでっち上げることはなく、既存のシークレットを上書きせずに保持します。- Postgres（アプリがアカウントとレコードを保存するデータベース）とアプリ自体を起動します — docker または podman 経路ではコンテナとして、host 経路ではコンピューター上のコマンドで起動します。
- 最初の実際のサインインの前にデータベースマイグレーション（アプリのテーブルを作成するコマンド）を実行します — テーブルが存在する前に作成されたアカウントは壊れたアカウントになるからです。
- 各フェーズをチェックポイントで検証し、すべてのチェックに PASS、FAIL、BLOCKED、NOT RUN のいずれかを付け、その根拠となる出力とともにレポートを出して終了します。
エージェントのレポートで確認すること
良いレポートは主張ではなく証拠を示します。各 PASS の裏にある実際のヘルス応答とコマンド出力を確認してください — 「すべて動きます」のような一文ではありません。
プロンプトは、同じステップが 2 回失敗したら停止して報告するよう（失敗を回避して回るのではなく）エージェントに指示し、データベースの消去など破壊的な操作の前にはあなたに尋ねるようにしています。エージェントが繰り返しの失敗後も即興で続ける場合は、停止して最初のエラーを トラブルシューティングガイド に持ち込んでください。
絶対に現れてはいけないものが 2 つあります：エラーを黙らせるためにオフにされたセキュリティ機能と、チャットやレポートに出力されたパスワードやキーなどのシークレット値です。どちらかを見かけたら、その実行は失敗として扱ってください。
デモと実際のサインインは頭の中で分けておいてください。/dashboard デモのローカル参照フローはデータベースを必要としないため、それ単体で通過できます。/auth でアカウントを作成できるのは、マイグレーションが実行された後だけです。「デモが動いた」はまだ「アカウントが動く」ではありません。
手動で行いたい場合
上記のすべてのステップは、クリックごとのチュートリアルとしても存在します。最初のデモには 5 分間の Web ガイド を実行し、次に実際のデータベースを備えた完全なローカル環境には Web ローカルセットアップ を実行してください。
インストールをエージェントが行わなかった場合でも、セットアップ後もエージェントは役立ちます — エージェントワークフローガイド では、新しい画面、スタイル変更、レビューなどの日常のタスクを扱っています。