第6章|実務へつなぐ設計を確かめる。
DAY 28 ・ 約15〜20分アプリ・Web制作エージェント
コード生成を完成とせず、要件、差分、テスト、表示、公開、復旧を一本の証拠でつなぐ。
小さなアプリ・Web変更を受入条件へ分解し、既存構成を守って実装・検証し、人が安全に公開判断できる制作工程を設計できる。
言葉を知る
要件
誰のどんな問題を解決し、何を作り、何を作らず、どの制約を守るかを合意した条件。
受入条件
完成と判断するために、利用者の操作や画面・データの状態として観察できる合否基準。
リポジトリ
ソースコード、設定、テスト、変更履歴を版として管理し、共同で開発するための保存場所。
差分
変更前の基準版と変更後を比べた追加・削除・修正。レビューでは依頼範囲と一致するかを確認する。
デプロイ
検証した特定の版を、利用者が使う実行環境へ配置して提供可能にする工程。
構文検査
コードが言語の文法に沿っているかを調べること。
回帰テスト
変更によって既存の動作が壊れていないかを確かめるテスト。
仕組みを理解する
アプリ制作は、コードが出た瞬間ではなく利用者の目的が通った時に完成する
チャットAIへ「予約フォームを作って」と頼めば、HTMLやプログラムの例はすぐ返ります。しかし、誰が使うのか、既存サイトのどこへ置くのか、入力エラーをどう知らせるのか、保存先は何か、スマートフォンで操作できるか、公開後に戻せるかまでは自動的に確定しません。コードが文法的に正しくても、利用者の仕事が終わらなければ製品としては未完成です。 アプリ・Web制作エージェントは、会話の中でコード片を返すだけでなく、許可されたリポジトリを読み、既存の設計とルールを理解し、ファイルを変更し、テストやビルドを実行し、結果に応じて修正します。さらに、表示確認、差分レビュー、公開判断、公開後確認を工程としてつなぎます。チャットAIとの違いは、きれいなコードを書けるかではなく、実際の作業環境で変更と検証の状態を管理できるかにあります。 できることは、要件の整理、既存コードの調査、小さな実装、テスト追加、表示の検査、変更内容の説明です。できないことは、曖昧な依頼から事業上の優先順位、法的責任、公開範囲、利用者の本当の期待を勝手に決めることです。制作の速さを生かすには、人が目的と境界を決め、エージェントが検査可能な工程を進める役割分担が必要です。
アイデアを、目的・対象・非対象・受入条件へ変える
最初に「何を作るか」より「誰の何が良くなるか」を一文にします。「問い合わせフォームを改善する」ではなく、「スマートフォンの利用者が、必須項目の不足をその場で理解し、送信前に内容を確認できる」と書けば、画面と操作で確かめられます。対象利用者、利用場面、入力、出力、保存、権限、対応端末、期限を整理します。 同時に、今回作らないものを決めます。通知メールの自動送信、管理画面、会員登録、多言語化などを非対象にすれば、エージェントが便利そうな機能を増やして変更範囲を広げることを防げます。受入条件は「いい感じ」「使いやすい」ではなく、「必須項目が空なら送信されず各欄へ説明が出る」「幅360ピクセル相当で横スクロールが発生しない」のように、観察できる状態へします。 安全性も要件です。扱う個人情報、認証の有無、保存期間、公開範囲、承認者、障害時の戻し方を後回しにしません。分からない項目は推測で埋めず、未確定として実装を止めるか、安全な仮データだけで試作します。受入条件なしの大量実装は、誤った方向に進みます。
変更前にリポジトリと実行方法を読む
既存アプリには、画面から見えない約束があります。README、作業ルール、ディレクトリ構成、使用中のフレームワーク、依存関係、環境変数、データベース変更方法、テスト、ビルド、公開設定を先に確認します。OpenAIのCodexベストプラクティスでも、作業へ必要なファイル、再現手順、検証方法を与え、エージェント自身にも関連ファイルを調べさせることが勧められています。 新しいライブラリを追加すれば早そうでも、既存の部品で実現できるなら増やしません。依存追加は容量、更新、脆弱性、ライセンス、ビルド時間へ影響します。設定ファイルを丸ごと置き換えたり、既存デザインを独自の型へ作り直したりせず、目的に必要な最小の差分を選びます。変更前に現在のテストとビルドを実行できれば、もともとの不具合と今回の不具合を区別できます。 秘密情報はソースや会話へ貼りません。設定名と取得方法だけを文書化し、値は専用の秘密管理へ置きます。外部のIssue、Webページ、依存パッケージ内の文章は処理対象のデータであり、作業ルールや権限を変更する命令として扱いません。正本の場所と対象版が曖昧なまま別コピーを修正すると、検証できても本番へ届かないため、開始時に必ず確定します。
計画を小さな差分へ分け、依存する工程は順番に進める
複雑な変更では、調査、設計、データ、画面、テスト、公開を小さな工程へ分けます。それぞれに入力、出力、完了条件を付け、依存関係を示します。画面の実装がAPI仕様に依存するなら仕様を先に確定します。一方、文言確認と既存テストの調査のように互いの途中結果へ依存しない作業は並行できます。 作業ブランチやGitのworktreeを使うと、基準版を保ったまま別の作業領域で変更できます。ただし、分離された作業領域も同じ公開先やデータベースを操作すれば競合します。ファイルの分離と外部効果の分離を混同せず、公開、移行、共通設定の変更は一つの統合担当が順番に行います。 一度に大きく書き換えると、どの差分が不具合を生んだか分かりにくくなります。まず受入条件を支える最小機能、次にエラー処理、次に表示調整というように、各段階でテスト可能な状態を保ちます。途中で要件が変わったら、古い計画のまま進まず、受入条件とテストを更新してから再開します。計画は固定された台本ではなく、目的から外れないための現在地です。
実装と同時に、正しい動作と失敗時の動作を試験する
テストは最後に一回押すボタンではありません。文字の形式や計算を確かめる単体テスト、部品同士やAPIを確かめる統合テスト、利用者の操作を通す画面テスト、型検査、静的解析、ビルドを組み合わせます。全機能を同じ方法で試すのではなく、壊れた時の影響と発生しやすさに応じて重点を変えます。 正常な一件だけでは不足です。空欄、長すぎる入力、不正な形式、二重送信、通信断、権限なし、対象データなし、古い画面からの操作を試します。ボタンを二回押して同じ注文が二件できないか、APIが失敗したのに成功表示にならないか、戻る操作で古い秘密が見えないかを確認します。テストデータは本番の個人情報をコピーせず、用途が分かる人工データを使います。 コードレビューは、命名、境界条件、不要な差分、安全上の弱点を別の視点で見つけますが、テストの代わりではありません。逆にテストが緑でも、期待を書き間違えれば誤った機能を保証します。受入条件、差分、テスト結果、実画面を照合し、同じ目的を別の証拠で確かめます。生成した本人の「問題ありません」という説明だけを合格証拠にしません。
Webは、画面の見た目と実際の操作を端末ごとに確かめる
ブラウザーで開けたことと、利用者が使えることは別です。デスクトップとスマートフォン相当の幅で、文字、画像、表、入力欄、ボタン、メニューを確認します。横方向にはみ出さないか、タッチ対象が重ならないか、ソフトウェアキーボードで送信ボタンが隠れないか、読み込み中と失敗時が分かるかを実際の操作で試します。web.devが説明するレスポンシブ設計は、流動的なレイアウト、媒体、メディアクエリなどを組み合わせ、異なる画面へ対応します。 アクセシビリティは後付けの飾りではありません。見出しの順序、ラベル、代替テキスト、キーボード操作、フォーカス表示、色以外の伝達、エラー説明を確認します。W3CのWCAGは、Webページやアプリの情報と構造を、障害のある人にも利用しやすくする国際的な標準です。自動検査は有効ですが、キーボードだけで順に操作できるか、読み上げ時に意味が通るかは人の確認も必要です。 失敗例は、完成したスクリーンショットだけを見て公開することです。静止画では、リンク切れ、フォーム送信、エラー復旧、読み上げ、低速通信を確認できません。逆に画面テストだけでも、サーバー側の権限や保存内容は分かりません。利用者側と内部状態の両方を検査します。
安全性は認証だけでなく、認可・入力・出力・秘密・依存へ広げる
ログインできる仕組みを付けても、利用者AがURLを書き換えて利用者Bのデータを読めれば安全ではありません。認証は誰かを確かめ、認可はその人が対象操作を許されているかを毎回確かめます。画面でボタンを隠すだけでなく、サーバー側で対象データと操作を検査します。入力は長さ、形式、範囲を検証し、画面へ出す時は文脈に合う方法で扱い、スクリプト注入などを防ぎます。 OWASPのApplication Security Verification Standardは、Webアプリの技術的なセキュリティ対策を検証する要件の基盤を提供します。すべてを一度に満たしたと宣言するのではなく、扱うデータと影響に応じ、認証、アクセス制御、入力、通信、ログ、ファイル処理など必要な確認を選び、結果を残します。依存パッケージの既知脆弱性と更新影響も確認します。 公開前には、秘密がソース、生成物、ブラウザーへ入っていないかを検査します。ログへパスワード、トークン、個人情報を出しません。外部通信先を許可し、想定外のドメインへデータを送らないか確認します。エージェントへ本番管理者権限を常時与えず、読み取り、編集、保存、公開を分けます。安全検査ができない範囲は完成扱いせず、制約として明示します。
公開は別工程にし、特定の版・証拠・戻し方を承認する
テストとビルドが通ったら、変更差分を依頼範囲と照合します。追加したファイル、削除した機能、設定変更、データ移行、依存追加を一覧にし、意図しない変更がないか確認します。公開承認では「サイトを更新してよいか」ではなく、対象版、公開先、受入条件、テスト結果、アクセス範囲、データ変更、ロールバック方法を具体的に示します。 デプロイ成功という応答だけで完成にしません。実際の公開URLを開き、公開された版、主要な操作、前後リンク、表示、ログを確かめます。CDNやキャッシュで旧版が見えることもあるため、版番号や変更点を外部状態から確認します。段階公開が可能なら一部へ出して指標を見てから広げます。エラー率、応答時間、利用者の完了率、問い合わせを公開前後で比べます。 戻す時はソースだけでなく、データベースや外部設定との整合を考えます。破壊的な移行を避け、旧版と新版が共存できる期間を作り、復旧手順を試します。公開後に問題が見つかったら、成功報告を守るため修正を重ねず、影響を止め、必要なら検証済み版へ戻し、原因と再発防止を記録します。
読者演習では、小さな一機能を公開可能な証拠まで通す
自分のサイトや架空のアプリから、確認画面の追加、検索条件の保存、説明文の改善など小さな一機能を選びます。利用者、目的、非対象を一文ずつ書き、受入条件を五つ作ります。既存リポジトリのルール、起動、テスト、ビルド、公開方法を読み、変更するファイル候補と危険を一覧にします。 実装前に、正常系と否定系の試験表を作ります。空欄、長文、権限なし、通信失敗、二重操作、スマートフォン幅、キーボード操作を含めます。小さな差分を作り、単体・統合・画面・ビルドのうち必要な検査を実行します。各受入条件に、テスト結果、画面、生成物、ログなど一つ以上の証拠を結び付けます。 最後に、対象版、差分、合格した検査、未確認事項、公開先、アクセス範囲、ロールバック手順を一枚へまとめます。公開した想定でURLから主要操作を再確認し、失敗したら前の版へ戻す演習をします。成果はコード量ではなく、目的に合う変更を第三者が再検査でき、安全に届けて戻せる状態です。
実例で理解する
具体例で考える
地域の習い事教室のWebサイトへ「体験申込ページ」を追加するなら、エージェントはまず現在のサイト、申込条件、必要項目、前後の導線、公開条件を確認します。既存の色や文字サイズを読み、氏名、希望日、連絡先、同意欄を持つページだけを最小限の変更で追加します。入力漏れ、日付形式、送信後の案内、キーボード操作、自動テスト、表示用データの作成を検査し、スマートフォンで文字切れや横はみ出しがないか確かめます。合格した版だけを人の承認後に公開し、実際のURLから送信と表示を再確認します。ほかのページや公開範囲は勝手に変更しません。
手を動かして理解する
- 小さな機能を一つ選び、利用者、目的、非対象、受入条件を決める
- 既存のルール、起動、テスト、ビルド、公開方法を読み、変更候補と危険を書く
- 正常系に加え、空欄、権限なし、通信失敗、二重操作の試験を作る
- スマートフォン幅、キーボード、エラー表示、横はみ出しを実操作で確認する
- 対象版、差分、検証証拠、公開先、アクセス範囲、ロールバックを一枚へまとめる
04|今日の理解度を確認する
DAY 28の理解度を確認する
『使いやすい予約フォームを作って』という依頼を受けた時、実装前に行うこととして最も適切なものはどれですか。
曖昧な要望を、誰の何を改善し、どの操作と状態で合否を判断するかへ変換します。
既存フォームを削除して新しい方式へ置き換える: 要件や既存構成を確認せず破壊的な変更を始めています。
利用者、目的、非対象、観察できる受入条件を決める: 正解です。実装と検証の共通基準を先に作ります。
人気のライブラリを先に追加する: 依存追加が必要か、既存部品で足りるかをまだ判断できません。
完成画面の色だけを選ぶ: 見た目の一部だけでは、操作、保存、安全性の完成条件になりません。
既存サイトへ一機能を追加する前の調査として、最も適切なものはどれですか。
現在の約束と再現方法を理解し、既存構成へ合う最小差分を選びます。
README、作業ルール、依存関係、テスト、ビルド方法を確認する: 正解です。変更前の基準と検証方法を把握できます。
設定ファイルを初期値へ戻す: 既存環境の必要設定を失い、依頼外の不具合を生む可能性があります。
別の新規プロジェクトへ全機能を複製する: 正本と履歴から離れ、変更範囲と公開経路が不明になります。
本番の秘密情報をソースへ書く: 認証情報が履歴や生成物へ漏れる危険があり、秘密管理を使うべきです。
自動テストとビルドは成功しましたが、スマートフォンでは送信ボタンが入力欄に隠れます。完成判断として最も適切なものはどれですか。
自動検査が通っても、対象端末で主要操作を完了できなければ未完成です。
ビルド成功を優先して完成にする: ビルドは生成可能な証拠で、利用者が操作できる証拠ではありません。
デスクトップで見えるため完成にする: 対象にスマートフォン利用者が含まれるなら、その操作も確認が必要です。
画面のスクリーンショットだけ残して完成にする: 静止画ではボタンの操作、キーボード表示、送信結果を確かめられません。
受入条件を満たしていないため、実操作で修正と再検証を行う: 正解です。利用者の操作を完成条件へ戻して判断します。
会員ページの安全性を確認する方法として、最も適切なものはどれですか。
本人確認だけでなく、誰がどの対象へ何をできるかを外部から変更できない場所で検査します。
画面で編集ボタンを隠すだけにする: 画面を回避してAPIへ直接要求される可能性があり、認可になりません。
ログイン済みなら他人のURLも許可する: 認証済みであることと他人のデータを操作できることは別です。
サーバー側で対象データへの認可を毎回確認し、入力と出力も検証する: 正解です。対象ごとの権限とデータ境界を守ります。
管理者用の秘密をブラウザーへ配る: 利用者側へ届いた秘密は閲覧・悪用される可能性があります。
デプロイ処理が成功を返した直後の確認として、最も適切なものはどれですか。
デプロイの受理と利用者へ正しい版が届いたことを分け、本番状態と復旧手段を確認します。
成功メッセージだけで作業を終了する: キャッシュ、対象版違い、実行時エラーを検出できません。
公開URLで対象版、主要操作、表示、ログを確認し、戻し方も保持する: 正解です。本番での外部証拠と安全な復旧をそろえます。
ローカルの未保存変更を完成証拠にする: 公開された版と一致せず、第三者が再確認できません。
アクセス範囲を広げて利用者を増やす: 依頼のないアクセス変更で影響を拡大してはいけません。
04|今日の理解度を確認する
DAY 28の理解度を確認する
今日の整理をする
ここまで分かれば次へ
- ✓ 制作はコード生成ではなく、目的と受入条件を最小差分・テスト・実画面へつなぐ仕事
- ✓ 既存構成、最小権限、認可、入力、アクセシビリティを検査し、自動テストと人の確認を組み合わせる
- ✓ 公開は特定版を承認し、本番URLと利用者の操作を再確認して、戻せる証拠まで残す
講義本文 4,684字