---
session: S03
exercise: A-2
title: バイブコーディングの懸念点を自分で洗い出す
duration: 8min
difficulty: 2
prerequisite: [A-1]
phases:
  自分で書く: 5min
  AIに聞く: 2min
  突き合わせ: 1min
files_to_edit:
  - memo.md  # ## A-2 の見出しの下に書きます
hints: hints/step03_warning_check.md
challenge: false
tags: [懸念の言語化, 差分, memo.md]
---

# 演習 A-2: バイブコーディングの懸念点を自分で洗い出す

勢いで作ったものに何が足りないかを、AI に聞く**前に**自分の言葉で書き出します。ここで書いたものは、A-5 のパイプラインが読み込む入力になります。

| 項目 | 内容 |
|---|---|
| 所要 | 8分（自分で5分、AI に2分、突き合わせ1分） |
| 触るファイル | `handson/memo.md` |
| 生成物 | `## A-2` の下に、自分の懸念5個以上と AI との差分 |
| 終わったと言える状態 | 自分の5個、AI の指摘3件以上、差分1行が揃っている |

このステップから講師が巡回します。書き出しの手が止まっていたら声をかけます。

---

## 目的

自分が何を不安に思っているかを、先に言語化します。

順番には理由があります。先に AI へ聞くと、返ってきた指摘が「そういうものか」と頭に入り、自分の視点が上書きされます。あとから自分の懸念を思い出そうとしても、AI の指摘をなぞったものしか出てきません。先に5分だけ自分で考えると、AI が挙げなかった項目が手元に残ります。この残りが、あなたが持っていて AI が持っていない情報の正体です。

もう1つ、実務上の理由があります。ここで書いた懸念は A-5 で `/selfcheck` の入力になります。AI に点検させるとき、汎用の観点だけでなく「自分が気にしていること」を混ぜられると、点検の当たりが変わります。その効果を A-6 で比較します。

---

## 操作

### 1. 5分間、自分だけで書き出す（AI に聞かない）

`memo.md` の `## A-2` 見出しの下に、いま作ったアプリについて不安な点を **5個以上** 書きます。箇条書きで構いません。文の途中で切れていても構いません。

手が止まったら、次の5つの観点を順に眺めてください。答えを与える観点ではなく、視点を移すための手がかりです。

| 観点 | 自分に問いかける形 |
|---|---|
| データの扱い | 元の CSV を壊す動きは入っていないか。データが増えたときはどうなるか |
| 入力値 | 検索欄に思いがけない文字を入れたら何が起きるか |
| エラー時の挙動 | ファイルが読めなかったとき、画面には何が出るか |
| 他人が読めるか | 明日、隣の席の人がこのファイルを開いて意味がわかるか |
| 明日の自分が直せるか | 1か月後の自分が、どこを直せばよいか見当を付けられるか |

観点を眺めるのは構いませんが、AI に聞くのはまだです。この5分は自分の頭だけを使います。

書くときは、できるだけ具体的に書いてください。「セキュリティが不安」ではなく「検索欄にタグらしき文字を入れたら、そのまま画面に反映されそう」と書くほうが、あとで照合できます。抽象的な1行は、A-5 で点検観点に混ぜても拾われません。

### 2. AI に指摘させる

5分経ったら、Claude Code に `@kadaiA/index.html` を対象として、危険な点・曖昧な点・実行時に警告が出そうな箇所を挙げてもらいます。深刻な順に並べるよう添えると読みやすくなります。

参考プロンプトは `hints/step03_warning_check.md` にあります。

### 3. 突き合わせる

返ってきた指摘と、自分が書いた5個を並べて見ます。次の3つに仕分けてください。

- 自分も AI も挙げた（重なった）
- 自分は挙げられず、AI が挙げた
- 自分は挙げたが、AI は触れなかった

3つ目があれば、その1件を `memo.md` に太字でも記号付きでも構いませんので、目立つ形で残しておいてください。A-6 の比較で使います。

---

## 自分で考える

自分が挙げられなかった項目のうち、AI が挙げたものはどれですか。それは知識が足りなかったからでしょうか、それとも見る時間が足りなかったからでしょうか。

逆に、自分は気づいたのに AI が触れなかったものはありますか。あるとしたら、それはなぜ AI に見えなかったのでしょう。考えられるのは次のような理由です。

- そのファイルの中に書かれていない情報だった（運用の都合、社内の慣習、過去の失敗）
- 画面を実際に操作した人にしかわからない挙動だった
- 「このアプリを誰が使うか」を AI が知らなかった

3つ目に当たるものが出てきたら、それは A-3 で配置する `CLAUDE.md` が扱う領域です。設定ファイルで渡せる情報と、渡しても伝わらない情報の境目が、ここで一度見えます。

---

## 生成物の名前と場所

`handson/memo.md` の `## A-2` 見出しの下。

書く内容は3つです。

1. 自分が書いた懸念（5個以上）
2. AI が挙げた指摘（要点だけで構いません）
3. 両者の差分（1行以上）

この見出しの下に書いたものは、A-5 で `/selfcheck` が読み込みます。見出しの文字列 `## A-2` は変えないでください。読み込みの目印にしています。空のままだと、点検が汎用の観点だけで行われ、A-6 の比較で差が出なくなります。

---

## OK基準

1. 自分の言葉で **5個以上** 書けた（AI に聞く前に書いたもの）
2. AI の指摘が **3件以上** 返ってきた
3. 自分と AI の差分を **1行以上** 書けた

3番は、重なった件数を数えるだけでも構いません。「5個中2個が重なった。AI は入力値の扱いを3件挙げたが、自分は1件も挙げられなかった」のように書けていれば十分です。

---

## 追加と考察

AI の指摘は毎回同じにはなりません。隣の受講者と内容が違っていても、どちらかが失敗しているわけではありません。

指摘の粒度がばらつくこと自体が、文脈を渡していない状態の特徴です。何を重く見るかの基準を渡していないので、AI はそのつど自分で基準を決めます。決め方が毎回変われば、出てくる指摘も変わります。

A-5 では、観点リストを持った状態で同じ点検をします。そのときに何がどう変わるかを見るために、いまの指摘の件数だけでもメモしておいてください。

---

## 発展課題

同じ質問を、`/clear` で会話の文脈をリセットしてからもう一度送ってみてください。`/clear` は、それまでのやり取りを AI の記憶から外すコマンドです。

指摘の内容はどれくらい変わりましたか。変わったとしたら、原因はどこにあると思いますか。1回目は A-1 の作業の流れが会話に残っていました。2回目はそれがありません。同じファイルを見ているのに結果が変わるなら、AI が見ているのはファイルだけではないということです。

この観察は、`CLAUDE.md` が「毎回同じ前提から始められる仕組み」であることの裏返しです。A-3 で置いたあとに、もう一度この発展課題を試すと、変わり方の幅が縮んでいることを確認できます。

書き出した懸念のうち「データを壊す操作」に関するものを、実際に手を動かして確かめたい場合は `exercises/challenges/ch03_crud_cud.md`（新規登録・編集・削除を足す）へ進んでください。読むだけのアプリに書き換える機能を足すと、先に決めておかなければならないことが一気に増えます。所要20分から30分の重い課題なので、当日の演習が全部終わってから開いてください。

---

## うまくいかないとき

**5個も思いつかない**

いま画面でできないことを書いても構いません。「削除ができない」「並べ替えができない」も立派な懸念です。作ったものへの不満と、危なそうなところを分けずに、まず数を出してください。

**AI の指摘が抽象的で、何を言われているかわからない**

「どのファイルの何行目のことですか」と聞き返してください。場所を答えられない指摘は、そのアプリを見て言っているものではない可能性があります。指摘に場所と根拠を付けさせることは、A-5 の点検でも同じ考え方で扱います。

**AI が指摘ではなく、勝手に修正を始めた**

止めて構いません。「修正はしないでください。指摘だけを挙げてください」と伝えます。いま直してしまうと、A-5 のパイプラインで拾える指摘が減り、比較の材料が薄くなります。直すのはあとです。

**指摘が20件以上出てきて読み切れない**

「深刻な順に上位5件だけ、理由を1行ずつ付けて挙げてください」と絞ってください。全部読む必要はありません。件数だけメモしておけば、A-5 との比較には足ります。

**A-1 が未完成で、指摘するものが少ない**

未完成な部分をそのまま懸念として書いてください。「詳細画面が未実装。実装したときに備考の空欄で崩れそう」のような書き方で構いません。予想を書いておくと、A-5 の結果と突き合わせられます。

---

## 次のステップ

[A-3 ハーネスを配置する](exA3_harness_install.md) に進みます。ここからは全員同時に作業します。講師の合図があるまで、`_harness_kit` は開かずに待ってください。
