---
session: S03
exercise: A-0
title: 素の状態を確認する
duration: 5min
difficulty: 1
prerequisite: []
phases:
  確認: 3min
  記録: 2min
files_to_edit:
  - memo.md  # ## A-0 の見出しの下に書き足します
hints: hints/step01_first_prompt.md
challenge: false
tags: [準備, 基準点, CLAUDE.md]
---

# 演習 A-0: 素の状態を確認する

演習Aは「AI に渡す設定が1つも無い状態」から始めます。最初の5分は、その状態を自分の目で確かめることに使います。

| 項目 | 内容 |
|---|---|
| 所要 | 5分 |
| 触るフォルダ | `handson`（VSCode で開いているフォルダ全体） |
| 生成物 | `handson/memo.md` の `## A-0` に3行以上 |
| 終わったと言える状態 | `CLAUDE.md`・`.claude`・`docs` が無いことを確認し、AI の回答を1つ受け取っている |

---

## 目的

今から作業するフォルダに、AI に渡す設定が1つも置かれていないことを確認します。

このステップ単体では何も作りません。それでも最初に置いているのは、あとで設定ファイルを配置したときに「何が変わったか」を言えるようにするためです。基準点を取らずに変化を語ると、印象の話になります。A-3 以降で「前はこうだった」と言えるように、いまの状態を記録に残します。

---

## 操作

### 1. VSCode で `handson` フォルダを開く

VSCode のメニューから「ファイル」→「フォルダーを開く」を選び、配布フォルダの中の `handson` を選びます。キーボードなら Windows は `Ctrl + K` を押してから `Ctrl + O`、Mac は `Cmd + K` を押してから `Cmd + O` です。

開くフォルダは、この研修を通してずっと `handson` です。`kadaiA` や `kadaiB` を単体で開かないでください。単体で開くと、あとで配置する設定ファイルが読み込まれる範囲の外に出てしまい、A-3 以降が動かなくなります。

### 2. 直下に何があるかを見る

画面左のエクスプローラで `handson` の直下を上から下まで眺めます。次の3つが**無い**ことを確認してください。

- `CLAUDE.md` というファイル
- `.claude` というフォルダ
- `docs` というフォルダ

この3つが、A-3 で配置する「ハーネス」の中身です。いまは1つもありません。

`.claude` は先頭にドットが付く隠しフォルダです。VSCode のエクスプローラでは既定で表示されます。見当たらなければ、それは「無い」という意味です。

代わりに `_harness_kit` というフォルダがあります。この中に設定ファイル一式が入っていますが、いまは開かないでください。中身を先に読むと、このあと5分かけて確かめることの答えを読んでしまうことになります。

### 3. Claude Code パネルを開く

VSCode の左端に縦に並んでいるアイコン列（アクティビティバー）から、Claude Code のアイコンをクリックします。パネルが開き、入力欄が表示されます。

ターミナルで `claude` と入力して起動する方法もありますが、本研修ではパネルからの起動に統一します。操作の説明が1本になるほうが、詰まったときに原因を切り分けやすいためです。

### 4. AI に、いま何を参照しているかを尋ねる

入力欄に、次の内容を尋ねる1文を**自分の言葉で**書いて送ります。

- いま参照している設定ファイルがあるか
- あるとしたら、どのファイルか

短くて構いません。ここで書いた文面は、A-3 でもう一度そのまま使います。送ったあと、自分が何と書いたかを `memo.md` に控えておいてください。同じ問いを2回送るからこそ、答えの違いが設定ファイルによるものだと言い切れます。

参考プロンプトは `hints/step01_first_prompt.md` にあります。自分で1文書けたなら、開かずに進んでください。

### 5. 課題Aの材料を眺める

次の2つを開いて中身を見ます。読むだけで、まだ何も作りません。

- `kadaiA/docs/お題シート.md`：これから作る画面の要件が書かれています
- `kadaiA/dummy_data.csv`：備品データの実物です

CSV は1行目が見出し行で、そのあとにデータが50行続きます。カテゴリは PC周辺機器・AV機器・家具・事務用品・その他の5種類です。備考の列は空欄の行が22件あります。この数字はあとで OK 基準の判定に使うので、いま見ておいてください。

---

## 自分で考える

設定ファイルが1つも無い状態で、AI はこのプロジェクトについて**何を知っていて、何を知らない**でしょうか。

知っていることは、あなたが送った文と、AI が自分で読みに行ったファイルの中身だけです。では知らないことは何でしょうか。次の3つの視点で考えると出しやすくなります。

- 決まりごと：このプロジェクトで守るべき書き方や禁止事項
- 前提：誰が何のために使うアプリなのか、どこまで作れば完成なのか
- 手順：作ったあとに何を確認すればよいのか

思いついたものを `memo.md` の `## A-0` の下に3つ以上書き出します。正解はありません。あとで答え合わせをするので、いま思ったことをそのまま書いてください。

---

## 生成物の名前と場所

`handson/memo.md` の `## A-0` 見出しの下に3行以上。

`memo.md` は最初から `handson` 直下にあります。`README.md` のすぐ下に見えているはずです。開くと `## A-0` から `## B-6` までの見出しが空のまま並び、それぞれの下に「何を書くか」がコメント（`<!-- -->` で囲まれた灰色の行）で書いてあります。該当する見出しを探して、その下に書き足してください。コメントは残しても消してもかまいません。

見出しの文字列と順番は変えないでください。`/selfcheck` が `## A-2` の位置を見て読み込むため、見出しの文字列がそのまま目印になっています。

---

## OK基準

次の3つがすべて満たせたら A-0 は終わりです。

1. `handson` 直下に `CLAUDE.md`・`.claude`・`docs` が無いことを、エクスプローラで目視確認した
2. AI から「参照している設定ファイルはありません」に相当する回答が返ってきた
3. `memo.md` の `## A-0` に、AI が知らないと思うことを3項目以上書いた

2番については、AI が「このフォルダには設定ファイルが見当たりません」のように答えれば同じ意味です。言い回しの一致は求めません。逆に、AI が特定のファイル名を挙げて「これを読みました」と答えた場合は、開いているフォルダが `handson` ではない可能性があります。エクスプローラの一番上に表示されているフォルダ名を確認してください。

---

## 追加と考察

`kadaiA/docs/お題シート.md` には、技術スタックの指定がありません。使う言語も、ライブラリも、書かれていません。これは書き忘れではなく、意図的に空けてあります。

指定が無いとき、AI は自分で選びます。選んだ結果が自分の環境で動くかどうかは、選ばれてみるまでわかりません。A-1 では、この空白を自分の指示でどこまで埋めるかを試します。

数字も控えておいてください。備品は50件、カテゴリは5種類、備考が空欄の備品は22件です。作ったアプリが正しく動いているかは、この数字と画面を突き合わせれば判定できます。「なんとなく動いている」で済ませないための材料です。

---

## 発展課題

`dummy_data.csv` を AI に読ませずに、「このフォルダにはどんなデータが入っていそうか推測してください」と聞いてみてください。フォルダ名とファイル名だけから、AI が何をどこまで言い当てるかを見ます。

推測と実物のずれが、そのまま「文脈を渡していない状態のずれ幅」です。ずれた項目を1つ `memo.md` に書いておくと、A-3 で設定ファイルを置いたあとの比較材料になります。

---

## うまくいかないとき

**Claude Code のアイコンがアクティビティバーに見当たらない**

拡張機能がインストールされていない可能性があります。VSCode の拡張機能ビュー（四角が4つ並んだアイコン）で「Claude Code」を検索し、インストール済みかを確認してください。インストール済みでもアイコンが出ない場合は、VSCode をいったん終了して開き直します。

**パネルは開くが、送信しても応答が返ってこない**

初回はサインインや接続先の確認が入ることがあります。パネル内に表示されている案内に従ってください。案内が出ないまま無反応の場合は、事前セットアップガイドの接続確認の手順に戻ります。それでも変わらなければ挙手してください。ここで止まったまま先へ進むと、以降のステップがすべて動きません。

**`.claude` フォルダが見えている**

すでに誰かがコピー済みか、配布フォルダを取り違えています。エクスプローラの一番上のフォルダ名が `handson` であることを確認してください。それでも `.claude` がある場合は、`_harness_kit` からコピーされた状態です。演習の出発点としては不都合なので、講師に声をかけてください。

**日本語のファイル名が文字化けして見える**

ZIP の展開に Windows 標準以外の解凍ソフトを使うと起きることがあります。配布フォルダをいったん削除し、`genai-nyumon-handson.zip` を右クリックして「すべて展開」から展開し直してください。

**英語で応答が返ってくる**

「日本語で答えてください」と一言送れば切り替わります。A-3 で設定ファイルを置いたあとは、この指定を毎回書かなくてもよくなります。

---

## 次のステップ

[A-1 素の状態で CRUD 業務アプリを作る](exA1_vibe_build.md) に進みます。ここからは15分間、講師は巡回しません。手が止まっても、まず自分で AI に聞いてみてください。
