AIアプリビルダー教本

目次

1. この教本の使い方
2. 第1章 作業の定義とエージェントへの指示

   作業を任せるということ · 完了の基準：「終わり」を先に決める · 良い作業指示の4つの要素 · 1枚の画面に収まらない状態も決める · 小さく分ける：縦に切る · 既存の方式を指し示して任せる · 先に計画を出させる · 計画をレビューする5つの問い · リポジトリの指示ファイル：ツールごとの読み方 · 指示ファイルに何を入れるか · ルールが未定の機能：インタビューと仕様書 · コンテキストという予算 · 人が見守らない作業

3. 第2章 実行と検証のループ

   アプリが動く場所：ブラウザ、サーバー、データの保存先 · ローカル実行：開発サーバーとポート · 初めて受け取ったリポジトリを実行できるようにする · チェックツールの役割 · エラーメッセージを読み解く · 失敗時の出力から原因を絞り込む · 検証ループと強制の仕組み · ブラウザでユーザーのように確かめる · 主張と証拠を区別する · コンテキストが混乱したら、やり直す · 通るテストと役に立つテスト · ときどき失敗するテスト · 自分のコンピューターと別の環境で結果が違うとき

4. 第3章 バージョン管理と変更レビュー

   Gitはセーブポイント付きのタイムマシン · 自分のコンピューターの履歴とリモートリポジトリ · diff：何と何を比較するか · diffをレビューする順番とチェックリスト · チェックを弱めた変更 · コミットは小さく、目的は1つ · ブランチとプルリクエストの流れ · 競合は意味を考えて解決する · 取り消し方法の判断表 · エージェントの巻き戻し機能とGit · 消えたコミットの復旧：reflog · 共有済みの履歴を書き換えるとき · 複数のエージェントを同時に動かすとき

5. 第4章 セキュリティと依存関係

   シークレットは家の鍵 · 環境変数と.envファイル · ブラウザに届く値、サーバーに残る値 · シークレットが漏れる経路 · コミット前に防ぐ · 漏れたときは、先に鍵を替える · 認証情報は小さく与える · 権限モード：名前は違っても問いは同じ · 権限ルールとサンドボックス · サプライチェーンとロックファイル · プロンプトインジェクション：読んだ文章が命令になるとき · データを扱うときの露出を最小限に · 自動化にエージェントを組み込むとき

6. 第5章 デプロイと運用

   デプロイが行うこと · プレビューと本番 · プレビューを共有するとき · 環境ごとに異なる環境変数 · 開発サーバーとビルドは違う · デプロイ前の点検 · デプロイ直後の確認 · ログとモニタリング · ロールバック：直前の正常なバージョンに戻る · 障害対応の順序 · コードは戻っても、データは戻らない · 少しずつ公開する · 小さなアプリの運用制約

7. 付録A 用語集
8. 付録B セルフチェックの解答と解説
9. 付録C 試験当日のガイド
10. 付録D 参考文書一覧