# step01 最初の1指示と、素の状態の確認

対応する演習ステップ: A-0 素の状態を確認する [5min]
対応する演習md: `exercises/exA0_baseline.md`
VSCode で開くフォルダ: `handson`

このファイルは、手が止まったときに開く補助資料です。先に読むと、自分で考える時間が減ります。まず演習mdの手順で進めて、詰まってから戻ってきてください。

---

## 参考プロンプト

Claude Code パネルは、VSCode の左端にあるアクティビティバーの Claude Code アイコンから開きます。パネルの入力欄に、次の1文をそのまま貼り付けて送信してください。

```
いま参照している設定ファイルがあれば教えてください。
```

「参照している設定ファイルはありません」に相当する回答が返ってきたら、それが正解です。続けて、AI がこのフォルダについて何を知らないかを確かめます。

```
このフォルダの中身をファイルを読まずに推測してください。どんなデータが、どのくらいの件数ありそうですか。
```

推測を聞いたあとで、実物を読ませます。パスの先頭に `@` を付けると、そのファイルを読み込ませられます。

```
@kadaiA/dummy_data.csv を読んで、どんな項目が何件入っているかを日本語で説明してください。
```

最後にもう1歩だけ進めて、集計まで頼みます。

```
@kadaiA/dummy_data.csv のカテゴリごとの件数を、件数の多い順に表で見せてください。
```

## なぜその形か

1つ目のプロンプトは、答えが空になることを期待して送っています。ここで「何もありません」という回答を自分の目で見ておくと、A-3 で設定ファイルを置いたあとに同じ質問をしたときの変化が、記憶ではなく画面の差として残ります。基準点を取るための1文です。

2つ目で推測させてから3つ目で実物を読ませるのは、AI が何を知っていて何を知らないかの境目を見るためです。推測は、ファイル名やフォルダ名から組み立てた「それらしい話」になります。ずれた分が、文脈を渡さないと埋まらない差です。

`@kadaiA/dummy_data.csv` のように書くのは、VSCode で開いているのが `handson` フォルダだからです。`handson` を起点にした相対パスで指定します。`kadaiA` を単体で開くと、あとで配置する `CLAUDE.md` も `.claude` も読み込まれなくなるため、本研修では最後まで `handson` を開いたまま進めます。

Claude Code はターミナルで `claude` と入力しても起動しますが、本研修ではアクティビティバーのアイコンからパネルを開く方法に統一します。画面の見え方が全員そろい、講師が巡回で状況を掴みやすくなるためです。

参考リンク: Claude Code の概要は https://docs.claude.com/en/docs/claude-code/overview に公式ドキュメントがあります。

## 比較観点

- 推測させた内容と、実物の `dummy_data.csv`（備品50件・カテゴリ5種）の差はどこにありましたか。件数はどうでしたか。項目名はどうでしたか。
- 「読んで説明して」と頼んだときと、「集計して表で」と頼んだときで、AI の動き方が違って見えましたか。前者は読み取りだけ、後者は読み取ったうえで数える処理が入ります。
- 隣の席の受講者と、同じプロンプトを送っても回答の言い回しや表の形が違います。同じ入力でも出力は毎回ぶれます。このぶれ幅は、あとで設定ファイルを置くとどうなるかを、A-3 で確かめます。

## よくある勘違い

- 「AI はフォルダの中身を最初から全部読んでいる」。読んでいません。`@` で指定したファイル、または AI 自身が必要と判断して読みに行ったファイルだけを見ています。だから A-0 の時点では、`kadaiA/docs/お題シート.md` の中身も知りません。
- 「設定ファイルが無いと Claude Code は使えない」。使えます。素の状態でも十分に動きます。設定ファイルが変えるのは、毎回説明し直す手間と、出力のばらつきです。
- 「ターミナルで `claude` と打たないと始まらない」。アクティビティバーのアイコンからパネルを開けば始まります。ターミナルからの起動は同じものへの別の入口です。
- 「`kadaiA` を直接開いたほうがパスが短くて楽」。短くはなりますが、`handson` 直下に置く `CLAUDE.md`・`.claude`・`docs` が読み込まれなくなります。A-3 以降が成立しません。

## 次のアクション

1. `memo.md` の `## A-0` の見出しの下に、AI が知らないと思うことを3つ書きます。書けたらこのステップは終わりです。
2. A-1（`exercises/exA1_vibe_build.md`）へ進みます。参考プロンプトは `step02_crud_build.md` にあります。

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

- パネルが出てこない: VSCode を再読込します（コマンドパレットで `Developer: Reload Window`）。それでも出ないときは挙手してください。
- 応答が途中で止まった: `続けてください` と送ると再開します。
- 英語で返ってきた: `日本語で答えてください` と1行足します。
- `@` を打っても候補が出ない: 候補が出なくてもパスを手で書けば読み込まれます。`@kadaiA/dummy_data.csv` と全部入力してください。
