# step03 懸念の洗い出しと、ハーネスの配置

対応する演習ステップ: A-2 バイブコーディングの懸念点を自分で洗い出す [8min] ／ A-3 ハーネスを配置する [5min]
対応する演習md: `exercises/exA2_concerns.md` ／ `exercises/exA3_harness_install.md`
VSCode で開くフォルダ: `handson`

このファイルは2つのステップにまたがっています。A-2 は自分の頭で書くステップなので、**参考プロンプトを先に読まないでください**。5分書き出したあとで開いてください。

---

## 参考プロンプト

### A-2 で使うもの（自分で5個書き終えてから）

```
@kadaiA/index.html の危険な点・曖昧な点・実行時に警告が出そうな箇所をすべて指摘してください。
深刻な順に並べてください。
```

指摘が3件しか出ないときは、観点を指定して粘ります。

```
セキュリティ、入力値の扱い、エラー時の挙動、他人が読んだときの分かりやすさ、
半年後に自分が直すときの手がかり。この5つの観点でもう一度見てください。
```

指摘が抽象的なときは、再現する操作を書かせます。

```
挙げてもらった指摘のうち上位3件について、その問題が実際に表面化する操作手順を、それぞれ3行以内で書いてください。
```

### A-3 で使うもの（ファイルを配置したあと）

`_harness_kit/step1_kadaiA/` の中にある `CLAUDE.md`・`.claude`・`docs` の3つを、`handson` 直下にコピーしてください。コピーが終わったら **Claude Code パネルをいったん閉じて開き直します。** そのうえで、A-0 と同じ文を送ります。

```
いま参照している設定ファイルと、そこに書かれているルールの要点を教えてください。
```

## なぜその形か

A-2 で自分が先に書く順番には理由があります。AI に先に聞くと、返ってきたリストを読んで「そのとおりだ」と思うだけで終わります。自分で5個書いてから突き合わせると、**自分が挙げられなかった項目**と、**自分だけが挙げられた項目**の2種類が見えます。後者が重要です。それは、このプロジェクトの事情を知っている人間にしか出せない指摘だからです。AI に渡していない情報が、そこに残っています。

深刻な順に並べさせているのは、指摘の数ではなく順番を見たいからです。順番は判断です。AI がどれを重く見たかがわかると、自分の判断とのずれが測れます。

A-3 でパネルを開き直すのは、`CLAUDE.md` と `.claude/settings.json` が起動時に読み込まれる仕組みだからです。ファイルを置いただけでは、いま開いているセッションには反映されません。ここでつまずく人がいちばん多い箇所です。

A-0 とまったく同じ文を送るのは、変わったのが AI 側ではなく**渡した文脈だけ**だと示すためです。プロンプトは同じ、モデルも同じ、違うのはフォルダに置いたファイル2つだけです。それでも回答は変わります。

参考リンク: `CLAUDE.md` が自動で読み込まれる仕組みは https://docs.claude.com/en/docs/claude-code/memory 、`settings.json` の書式は https://docs.claude.com/en/docs/claude-code/settings に公式ドキュメントがあります。

## 比較観点

- 自分が書いた5個と、AI の指摘リスト。重なった項目、AI だけが挙げた項目、自分だけが挙げた項目の3つに仕分けてください。仕分けた結果を `memo.md` の `## A-2` に残すと、A-6 の比較表がそのまま書けます。
- A-0 で「参照している設定ファイルはありません」と答えた AI が、A-3 では何を答えましたか。技術スタック、業務ルール、してはいけないこと。どれに触れましたか。
- A-1 の応答の末尾と、A-3 の応答の末尾。A-3 からは実行サマリーのブロックが付いているはずです。付いていなければ、パネルを開き直していないか、コピー先が `handson` 直下になっていません。
- `/clear` で文脈を消してから A-2 の質問をもう一度送ると、指摘の内容がどれくらい変わりますか。会話の履歴という文脈が消えると、出力のばらつきが大きくなります。

## よくある勘違い

- 「AI が指摘しなかった箇所は問題がない」。指摘しなかった理由は2つあります。本当に問題がない場合と、判断に必要な情報を渡していない場合です。後者の代表が、社内でどう使われるアプリなのかという前提です。
- 「AI の指摘が隣の人と違うのは、どちらかが間違っている」。違います。文脈を渡していない状態では、指摘の粒度も順番もばらつきます。このばらつき自体が、いまの状態の特徴です。
- 「`CLAUDE.md` は AI に読ませるために `@CLAUDE.md を読んで` と指示する必要がある」。不要です。`handson` 直下に置いてパネルを開き直せば、毎回自動で読み込まれます。指示しなくても効いていることが、チームで使うときの利点です。
- 「ハーネスを置いたら、さっき作ったアプリが作り直しになる」。なりません。置いたのは設定ファイルだけで、`kadaiA/index.html` は触っていません。
- 「`_harness_kit` の中身は移動させる」。コピーです。移動させると、あとで参照できなくなります。演習Bでも `_harness_kit/step2_kadaiB/` を使います。

## 次のアクション

1. `memo.md` の `## A-2` に、自分の5個と AI の指摘の差分を1行以上書きます。
2. `handson` 直下に `CLAUDE.md`・`.claude`・`docs` が並んでいることを、VSCode のエクスプローラで目視確認します。`docs` の中にファイルが4本あることも見てください。
3. 余裕があれば `.claude/settings.json` を開き、`deny` に並んでいる項目を読んでください。どれか1行を選び、それが無かったら何が起きるかを `memo.md` に書くと、A-6 の考察が書きやすくなります。
4. 次は A-4（`exercises/exA4_exec_summary.md`）です。参考プロンプトは `step04_pipeline.md` にあります。

うまくいかないときは次を確認してください。

- 実行サマリーが出ない: パネルを開き直しましたか。`CLAUDE.md` は `handson` 直下ですか（`handson/kadaiA/CLAUDE.md` になっていませんか）。
- `.claude` フォルダがエクスプローラに見えない: 先頭がドットのフォルダは、コピー操作で選択から外れることがあります。`.claude` を選び直してコピーしてください。
- 設定ファイルの要点を答えてくれない: `handson/CLAUDE.md の見出しを全部挙げて、それぞれ1行で要約してください。` と聞くと、読めているかどうかがはっきりします。
