> ## 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 つの初心者ガイドを読み、Mobile ローカル セットアップを完了します。コーディング エージェントは AI ツール — Cursor、Claude Code、Devin、または類似のアシスタント — で、プロジェクトを読み、ファイルを編集し、コマンドを実行します。このページのすべての内容は、使用するどのツールにも当てはまります。

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

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

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

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

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

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

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

[モバイルローカルセットアップ](https://supastack.dev/ja/docs/mobile/ship-in-5-minutes.md)


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

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

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

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


## 付属スキル

`.agents/skills/` 下の各ファイルは完全なブリーフです: 貼り付けるかエージェントに読ませるだけで、キットのルールが一緒に伝わります — サーバーファーストのデータ、バンドルにシークレットなし、オフラインはネットワーク エラーのフォールバックのみ。

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

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

- `add-a-mobile-screen` — 画面、そのデータ フロー、オフライン動作の追加または変更
- `adding-a-dependency` — npm 依存関係の安全な追加・アップグレード・移動
- `reviewing-a-pr` — 正確性、ワークスペース分離、シークレットについて差分をレビュー
- `upgrading-from-upstream` — 新しいキット リリースをアプリに取り込む
- `verify-changes` — 引き渡し前に正しいチェックを選んで実行
- `writing-unit-tests` — Vitest で新しいロジックをカバー


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

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

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


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

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

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

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

- 主張するテストを実行した — 結論ではなくコマンドとその出力を求めてください。
- シークレットがサーバー専用のまま — 新しいものに `NEXT_PUBLIC_` や `EXPO_PUBLIC_` プレフィックスがなく、レポートやコミットにキーが出力されていません。
- すべてのユーザー所有の読み書きが `workspaceId` でスコープされたまま — どのクエリもブラウザから送られた id を信用しません。
- 変更された各ファイルの `.ai/` ミラーがコードと一緒に動きました。
- 公開、デプロイ、有料プロバイダーの呼び出しがあなたが承認した別のステップのまま — エージェントは自分でマージ、プッシュ、デプロイをしていません。
- ステップが 2 回失敗した場合、即興で回避せずに停止して失敗したコマンドを報告しました。


設定を続けるには、[ネイティブ認証](https://supastack.dev/ja/docs/mobile/authentication.md)をご覧ください。


## 次へ

[ネイティブ認証](https://supastack.dev/ja/docs/mobile/authentication.md)