> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# コーディングエージェントで構築する

コーディング エージェントにタスクを渡す: エージェントが読むファイル、付属スキル、制御を保つレビュー。

## 初心者向けのウォークスルー

前提条件: 以下の 2 つの初心者ガイドを読み、Desktop ローカル セットアップを完了します。コーディング エージェントは AI ツール — Cursor、Claude Code、Devin、または類似のアシスタント — で、プロジェクトを読み、ファイルを編集し、コマンドを実行します。このページのすべての内容は、使用するどのツールにも当てはまります。

早わかり用語：プロンプトはエージェントに貼り付ける指示テキストです。差分（diff）はエージェントが提案するファイル変更の一覧です。リポジトリルートは package.json を含む最上位フォルダーです — エージェントは常にそこから始めるべきです。

1. リポジトリ ルートの `.agents/skills/` を開き、タスクに最も近いスキルをコピーします — `add-a-desktop-capability` が良い最初の選択です。

2. それをエージェントに貼り付けて変更を説明し、次の 1 行を追加します: コードに触れる前に `llms.txt`、次に `AGENTS.md`、次に `.ai/PROJECT_CONTEXT.md` を読んでください。

3. 編集前に、エージェントに変更するファイルと実行するチェックを列挙させます。終了したら差分をレビューします — 製品への実際の変更を承認するのです。

4. 公開、インストーラーのリリース、有料プロバイダー呼び出しは、タスク プロンプトの一部になることは決してありません。明示的に承認する別のステップとして保ちます。

[始める前に](https://supastack.dev/ja/docs/desktop/before-you-start.md)

【端末の基本】(/docs/desktop/terminal-basics)

[デスクトップローカルセットアップ](https://supastack.dev/ja/docs/desktop/ship-in-5-minutes.md)


## エージェントが読むファイル

リポジトリには、人間だけでなくエージェントのために書かれた小さなファイル群が同梱されています。このコンテキストを手動で貼り付ける必要はありません — エージェントを `llms.txt` に向ければ、残りは自分で読みます。

読む順序が重要です：`llms.txt` はマップ、`AGENTS.md` は境界を定め、`.ai/PROJECT_CONTEXT.md` は以前のセッションが学んだことを保持しています。境界をスキップするエージェントは、公開できないコードを生み出します。

| ファイル | エージェントにもたらすもの |
|---|---|
| `llms.txt` | このチェックアウトが実際に同梱するものだけをリストするよう生成された、リポジトリのエントリ マップ |
| `AGENTS.md` | 譲れない境界: 承認するまではローカル作業のみ、シェルはプロダクト UI を決してフォークしない |
| `.ai/PROJECT_CONTEXT.md` | セッションをまたぐメモリ — 最近何が、なぜ変わったか。コード変更前に読む |
| .ai/ ミラードキュメント | 重要なファイルの隣にある対応する .ai/<path>.md メモ。ファイルごとの決定と未解決スレッドを記録 |
| `.agents/skills/` | エージェント向けに書かれたタスク ランブック — 以下に列挙する 5 つの Desktop スキル |
| `docs/agent-security.md` | 受け入れチェックリスト — 認証、ワークスペースと権限チェック、マスクされたログ |
| `docs/desktop-updates.md` | 更新チャンネル ランブック — 署名キー、エンドポイント、リリース チャンネル |
| `.env.example` | 環境設定の完全な目録 — エージェントはこのファイルにない変数名を決して作りません |


## 付属スキル

`.agents/skills/` 下の各ファイルは完全なブリーフです: 貼り付けるかエージェントに読ませるだけで、キットのルールが一緒に伝わります — プロダクト UI は Web アプリに残り、OS 動作のみが Rust に入ります。

貼り付け可能な `prompts/` ライブラリは Web リポジトリにのみ付属し、このチェックアウトには代わりにスキルが入っています。無人セットアップには、agent-setup ガイドの既製プロンプトを使います。

[エージェントにセットアップを実行させる](https://supastack.dev/ja/docs/desktop/agent-setup.md)

- `add-a-desktop-capability` — ウィンドウ、トレイ、ショートカット、更新、ビルドの変更
- `adding-a-dependency` — npm 依存関係の安全な追加・アップグレード・移動
- `reviewing-a-pr` — 正確性、ワークスペース分離、シークレットについて差分をレビュー
- `upgrading-from-upstream` — 新しいキット リリースをシェルに取り込む
- `verify-changes` — 引き渡し前に正しいチェックを選んで実行


## エージェントがセッション間で記憶する仕組み

エージェントはセッション間にメモリを持ちません — `.ai/` フォルダーがメモリです。`.ai/PROJECT_CONTEXT.md` は最近の変更とその理由を記録します。その隣の `.ai/apps/desktop/src-tauri/src/lib.md` のようなミラー ドキュメントは、コードだけでは示されない `apps/desktop/src-tauri/src/lib.rs` の背後の決定を説明します。

契約は単純です：ファイルを編集する前にそのミラーを読み、変更が入ったらミラーを更新します。Open Threads のエントリは未完の作業を記録し、次のセッションが最初からではなく再開できるようにします。古いミラーはないより悪いものです — エージェントの差分をレビューするとき、変更されたファイルのミラーがコードと一緒に動いたか確認してください。


## エージェントの作業を正直にレビューする

完了したタスクは要約ではなく証拠です。エージェントの作業を採用する前に、`docs/agent-security.md` がデプロイをチェックするのと同じ方法で確認してください：

何かが間違っているときは差分を送り返します — 失敗したチェックを指名すると、エージェントは自分の作業を最も速く修正します。単独で試みるべきではなかったことについては、一度明示的に伝えてください。その境界はセッションの残りで保たれます。

[検証ゲートとテストスイート](https://supastack.dev/ja/docs/desktop/testing.md)

- cargo test、cargo check、またはリリース プレフライトなど、主張するチェックを実際に実行したか — 結論ではなく、コマンドとその出力を求めてください。
- シークレットはサーバーのみに留まりました — 署名キーや証明書がレポートやコミットに出力されず、シェルは引き続きプロバイダー資格情報を持ちません。
- プロダクト動作は Web アプリに留まりました — 差分は Rust での並行 UI、認証、チャット ロジックを追加しません。
- 変更された各ファイルの `.ai/` ミラーがコードと一緒に動きました。
- 公開、インストーラーのリリース、有料プロバイダー呼び出しは、承認した別のステップのままです — エージェントが自分でマージ、プッシュ、リリースすることは決してありません。
- ステップが 2 回失敗した場合、即興で回避せずに停止して失敗したコマンドを報告しました。


設定を続けるには、[デスクトップリリースアカウントを作成する](https://supastack.dev/ja/docs/desktop/external-accounts.md)をご覧ください。


## 次へ

[デスクトップリリースアカウントを作成する](https://supastack.dev/ja/docs/desktop/external-accounts.md)