手元ガイド 課題A編

今から作業するフォルダに、AI に渡す設定が1つも置かれていないことを確認します。このステップ単体では何も作りません。それでも最初に置いているのは、あとで設定ファイルを配置したときに「何が変わったか」を言えるようにするためです。

A-3 以降で「前はこうだった」と言うためには、いまの状態を記録に残しておく必要があります。研修が終わって社内で説明するときも、前後の差が手元のファイルとして残っているかどうかで説得力が変わります。

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

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

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

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

• CLAUDE.md というファイル
• .claude というフォルダ

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

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

3. Claude Code パネルを開く

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

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

入力欄に、次の2点を尋ねる1文を自分の言葉で書いて送ります。短くて構いません。

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

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

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つ以上書き出します。正解はありません。A-3 で答え合わせをするので、いま思ったことをそのまま書いてください。

handson/memo.md は最初から handson 直下にあり、A-0 から A-6 までの見出しが空のまま並んでいます。該当する見出しを探して、その下に書き足してください。見出しの順番は入れ替えないでください。

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 では、この空白を自分の指示でどこまで埋めるかを試します。埋めなかった分だけ、AI の判断が入ります。

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

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

テンプレートも雛形も無いところから、指示だけでアプリが立ち上がることを体験します。

もう1つ、指示を分けて出すことの効果を確かめます。1回で全部を頼むと、返ってきたものが自分の想像と違ったときに、どこから直せばよいかがわかりません。3回か4回に分けると、1回ごとに画面を見て、次の指示で方向を足せます。この差は A-6 の比較にも効いてきます。

前提の確認

• VSCode で開いているのは handson です。kadaiA を単体で開いていないことを確認してください
• 作業対象は @kadaiA/ のようにパスで指定します。ファイルを名指しするときは @kadaiA/dummy_data.csv のように書くと、AI がそのファイルを読みに行きます

1回目：一覧を出す

最初の指示で伝える内容は次の4点です。文面は自分で組み立ててください。

4点目を落とさないでください。ここを書くか書かないかで、このあと10分間の作業内容が変わります。理由は「自分で考える」で扱います。

2. ブラウザで開いて確かめる

VSCode のエクスプローラで kadaiA/index.html を右クリックし、「エクスプローラーで表示」（Mac は「Finder で表示」）を選びます。表示されたファイルをダブルクリックすると、既定のブラウザで開きます。

一覧が表示されたら、件数を数えます。50件あるはずです。ここで件数が足りない場合は、先へ進む前に直してください。データの読み込みが途中で切れている状態のまま機能を足すと、原因の切り分けが難しくなります。

3. 2回目：検索を足す

備品名の一部を入れると一覧が絞り込まれる検索を足します。伝えるのは「何ができるようになってほしいか」です。実装方法は指定しません。

ブラウザを再読み込み（F5、Mac は Cmd+R）して、動きを確認します。試しに「ノート」と入力してください。3件に絞り込まれます。

4. 3回目：詳細表示を足す

一覧の1件をクリックすると、その備品の全項目が見える表示に切り替わり、一覧に戻れるようにします。全項目とは、備品コード・備品名・カテゴリ・在庫数・保管場所・購入日・備考の7つです。

ここでも実装方法は指定しません。別ページに遷移するか、同じページ内で表示を切り替えるかは AI が選びます。選んだ結果を見てから、気に入らなければ次の指示で変えれば十分です。

5. 4回目（任意）：見た目を整える

表示が崩れている、文字が詰まって読みにくいといった不満があれば、そこだけを差分で伝えます。「作り直してください」ではなく「ここをこう変えてください」と伝えるほうが速く、いま動いている部分が壊れにくくなります。

残り時間が3分を切ったら、見た目には手を付けずに次のステップへ進んでください。A-1 の目的は完成度ではありません。

ブラウザには、ローカルのファイルから別のローカルファイルを読み込むことへの制限があります。index.html の中から dummy_data.csv を通常の方法で読もうとすると、この制限に当たって読めません。AI はそれを避けるため、簡易サーバーを起動する前提の作りを選ぶことがあります。そうなると、アプリを見るたびにコマンドを実行することになり、確認の手間が増えます。

指示に添えた一文が、環境構築の有無を決めています。指示の中でどこを譲れないと伝えるか、という判断がそのまま実装の形に出た例です。自分の指示のどこがこの結果を決めたのか、memo.md の ## A-1 に1行書いておいてください。

単一ファイルが基本です。AI が CSS や JavaScript を別ファイルに分けた場合も、kadaiA/ の直下にまとめて置かせてください。別の場所に置かれると、A-5 の /selfcheck が点検対象として拾えないことがあります。

1. 一覧に備品が 50件 表示される
2. 検索欄に「ノート」と入力すると 3件 に絞り込まれる
3. 一覧の1件をクリックすると詳細が表示され、一覧に戻れる
4. index.html をダブルクリックするだけで動く（コマンドの実行が不要）

3番の詳細は、7項目すべてが出ていることを確認してください。備考が空欄の備品も50件中22件あります。そのうち1件を開いて、表示が崩れないかも見ておきます。ここで崩れていても、いまは直さなくて構いません。A-2 で書き出す材料になります。

指示を3回に分けたことで、1回ごとに画面を見て方向を足せました。1回目で全部を頼んだ場合と比べて、どちらが自分の意図に近いものになったと思いますか。

分けることには手間もあります。3回聞けば3回待ちます。それでも分けたほうがよい場面と、まとめて頼んだほうが速い場面があります。境目はどこにありそうか、memo.md に1行だけ書いておいてください。A-5 で /selfcheck を回すと、この「まとめて頼む」の極端な形を体験することになります。

もう1つ気づいておきたいことがあります。ここまでの応答には、AI が何をしたかの一覧が付いていません。どのファイルを読んで、どこを書き換えたのかは、応答の本文を読んで自分で拾う必要があります。A-4 でこの状態が変わります。

カテゴリでの絞り込みを足したいとき、AI にどう問いかければ「なぜその実装にしたのか」まで返ってくるでしょうか。指示の文面を自分で考えて試してください。

作業指示ではなく、理由を引き出す問いを作るのがこの課題です。「カテゴリで絞り込めるようにしてください」だけでは、動くコードは返ってきても判断の理由は返ってきません。何を足せば理由が付いてくるかを、実際に2通り試して比べてみてください。

手順まで含めた発展版は exercises/challenges/ch01_category_filter.md にあります。時間が余った人向けです。A-2 の開始時刻になったら、途中でも切り上げてください。

自分が何を不安に思っているかを、先に言語化します。順番には理由があります。先に AI へ聞くと、返ってきた指摘が「そういうものか」と頭に入り、自分の視点が上書きされます。あとから自分の懸念を思い出そうとしても、AI の指摘をなぞったものしか出てきません。

先に5分だけ自分で考えると、AI が挙げなかった項目が手元に残ります。この残りが、あなたが持っていて AI が持っていない情報の正体です。

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

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

memo.md の ## A-2 見出しの下に、いま作ったアプリについて不安な点を 5個以上 書きます。箇条書きで構いません。文の途中で切れていても構いません。手が止まったら、次の5つの観点を順に眺めてください。答えを与える観点ではなく、視点を移すための手がかりです。

2. AI に指摘させる

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

3. 突き合わせる

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

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

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

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

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

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

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

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

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 で置いたあとにもう一度この発展課題を試すと、変わり方の幅が縮んでいることを確認できます。

「AI に指示を出す」以外に、「AI が読む場所にあらかじめ置いておく」という渡し方があります。この2つは実務での効き方が違います。指示は毎回書き直しになりますが、置いたものは全員に同じように効きます。その差を体験するのがこのステップです。

1. コピー元を開く

VSCode 左のエクスプローラで handson > _harness_kit > step1_kadaiA の順にフォルダを開きます。中には7つ入っていますが、handson 直下へコピーするのは上の3つだけです。

2. handson 直下にコピーする

• Windows：エクスプローラで step1_kadaiA を開き、CLAUDE.md をクリック、Ctrl を押しながら .claude と docs をクリックして3つ選びます。Ctrl+C でコピーし、handson フォルダを開いて Ctrl+V で貼り付け
• Mac：Finder で step1_kadaiA を開き、CLAUDE.md をクリック、Cmd を押しながら .claude と docs をクリックして3つ選びます。Cmd+C でコピーし、handson フォルダを開いて Cmd+V で貼り付け
• VSCode のエクスプローラ内でドラッグして移動させても構いませんが、移動ではなくコピーにしてください。_harness_kit の中身は残しておきます

.claude のように先頭にドットが付くフォルダは、Windows のエクスプローラや Mac の Finder では既定で見えません。Windows は「表示」タブの「隠しファイル」にチェック、Mac の Finder は Cmd+Shift+. で表示が切り替わります。VSCode のエクスプローラからは最初から見えています。

移動してしまった場合も演習は続けられます。元に戻したいときだけ講師に声をかけてください。

3. 配置されたことを確認する

VSCode のエクスプローラで handson の直下を見て、CLAUDE.md・.claude・docs の3つが並んでいることを確認します。docs を開くとファイルが4本あります。A-0 で「無い」ことを確認した場所に、いま「ある」状態です。

4. Claude Code パネルを閉じて開き直す

5. A-0 と同じ質問をもう一度送る

A-0 で送ったのと同じ文を、そのまま送ります。文面を控えていない場合は、いま参照している設定ファイルと、そこに書かれているルールの要点を尋ねる形にしてください。

同じ問いを2回送ることに意味があります。問いが同じで答えが違えば、変わったのは問いの側ではなく環境の側です。

CLAUDE.md を開いて、見出しを上から順に見てください。次の9つが、いま AI が毎回読む前提です。

このうち、A-2 で自分が書いた懸念に関係する見出しはどれですか。1つ選んで memo.md の ## A-3 に書いてください。関係するものが見つからない場合は、「自分の懸念は CLAUDE.md では手当てされていない」と書いてください。それも正しい観察です。

• handson/CLAUDE.md
• handson/.claude/（settings.json / commands/selfcheck.md / skills/kadaia-review/SKILL.md / agents/reviewer.md）

A-3 は置くだけのステップです。書き換えたくなる箇所を見つけたら、memo.md に控えておいて、A-4 の発展課題で試してください。

1. handson 直下に CLAUDE.md・.claude・docs の3つがある
2. handson/docs/ の中にファイルが 4本 ある
3. AI の回答が、CLAUDE.md の内容（技術スタック・業務ルール・してはいけないこと のいずれか）に触れている
4. 回答の末尾に「実行サマリー」のブロックが付いている

3番は A-4 の主題です。ここでは「何か出るようになった」ことに気づければ十分です。もし出ていなければ、パネルの開き直しができていないか、コピー先が handson 直下ではない可能性があります。

コピーしただけで、AI に「これを読んでください」とは一度も言っていません。CLAUDE.md は Claude Code が起動時に自動で読み込む決まりになっています。

この自動読込があるから、チーム全員が同じ前提で AI を使えます。1人が毎回うまい指示を書いて成果を出す状態と、全員が同じ前提から始められる状態は、再現性の面で別物です。前者は書いた人が休むと止まります。

.claude/settings.json も同時に効き始めています。中を見ると deny という一覧があり、そこに書かれた操作は AI が実行できません。dummy_data.csv の書き換えもここで止めています。A-5 で点検と修正を任せても元データが壊れないのは、この1ファイルが理由です。

"deny": [
  "Read(./**/.env*)",
  "Read(./**/*credentials*)",
  "Bash(rm -rf:*)",
  "Bash(git push:*)",
  "Edit(./kadaiA/dummy_data.csv)",
  "Edit(./kadaiB/src/main/resources/data.sql)"
]

.claude/settings.json を開いて中身を読んでください。deny の一覧に並んでいる行のうち、1行を選びます。その1行が無かったら何が起きるでしょうか。memo.md に書いてください。

たとえば Edit(./kadaiA/dummy_data.csv) を外したとすると、AI が「データ形式を整えます」と判断したときに元データを書き換えられる状態になります。書き換わったことに気づくのは、たいてい件数が合わなくなったあとです。

もう1歩進めるなら、自分の職場で「AI にやらせたくない操作」を1つ挙げ、それを deny に足す書き方を AI に聞いてみてください。書き方の正解より、何を止めたいかを言語化するほうが実務では重要です。

コードレビューで一番手間がかかるのは、変更内容を読むことではなく「どこが変わったかを探すこと」です。AI に作業させると、この探す作業が毎回発生します。応答の末尾に「どのファイルに何をしたか」が出ていれば、探す時間がなくなります。

もう1つ、書かれていることと実際が一致しているかを自分で確かめます。自己申告は便利ですが、鵜呑みにする前に1回は照合してください。1回照合すると、どの欄が信用できて、どの欄を毎回見るべきかの感覚がつかめます。

1. 機能を1つ追加させる

@kadaiA/index.html に対して、在庫が少ない備品の行を目立たせる表示を足してもらいます。伝える条件は次の2つです。

• 対象は在庫が 5個以下 の備品（5個ちょうども含みます）
• 一覧を見たときに、その行が他と違って見えること

見せ方は指定しません。背景色でも、文字色でも、印を付けるのでも構いません。AI が選んだ見せ方を見てから、気に入らなければ次の指示で変えられます。

2. 応答のいちばん下を読む

応答の末尾に「実行サマリー」というブロックが出ています。次の4項目を上から順に読んでください。

「従った設定」の欄には、## 出力の作法 のように CLAUDE.md の見出し名がそのまま書かれているはずです。書かれていたら、実際に CLAUDE.md を開いてその見出しを探してください。設定と応答が1対1でつながっていることが目で見えます。

3. 書かれているとおりか照合する

サマリーの「対象ファイル」に挙がっているファイルを開き、書かれているとおりの変更が入っているかを目で確かめます。見るのは2点です。挙がっているファイルが実際に変わっているか。そして、挙がっていないファイルが変わっていないか。VSCode のエクスプローラでは変更のあったファイルに印が付くわけではないため、気になる場合はファイルの更新日時を見てください。

4. ブラウザで確認する

ブラウザを再読み込みして、在庫の少ない備品の行が目立っているかを確認します。dummy_data.csv の中で在庫5個以下の備品は 4件 です。目立っている行が4件あれば、条件の解釈も表示も合っています。

3件しかない場合は、5個ちょうどの備品が対象から外れています。境目の取り違えです。「5個ちょうども含めてください」と伝えて直してもらってください。

5. サマリーを memo.md に貼る

出てきた実行サマリーの中身を、memo.md の ## A-4 にそのまま貼り付けます。A-6 の比較で、ハーネスを入れる前後の応答の違いを説明する材料になります。

書かれていた場合、それは AI の判断で今回やらなかったことです。省いてよかったものでしたか。それとも、頼んだつもりだったのに落ちていたものでしたか。

「なし」と書かれていた場合も1つ考えてみてください。本当に残件はゼロでしょうか。たとえば、在庫のしきい値である5という数字は、いまコードのどこに書かれているでしょうか。直書きされているとしたら、しきい値を変えたい人はコードを探すことになります。これは残件と呼べる状態かもしれません。判断したことを1行、memo.md に書いてください。

• handson/kadaiA/index.html（更新）
• handson/memo.md の ## A-4（実行サマリーの貼り付けと、気づいたこと1行）

1. 応答の末尾に実行サマリーの4項目（動作／従った設定／対象ファイル／未実施・保留）がすべて出ている
2. サマリーの「対象ファイル」に書かれたファイルと、実際に変更されたファイルが一致している
3. ブラウザで、在庫5個以下の 4件 が他の行と区別できる表示になっている
4. memo.md の ## A-4 にサマリーを貼り付けた

A-1 のときの応答には、このサマリーは出ていませんでした。出るようになったのは、CLAUDE.md の末尾に ## 応答の最後に必ず出すもの という節が1つあるからです。開いて読んでみてください。書かれているのは日本語の指示文です。プログラムではありません。

読み取りだけでも出させているのには理由があります。出たり出なかったりすると、出なかったときに「壊れたのか、そういう仕様なのか」がわからなくなります。毎回出ると決めておけば、出ないこと自体が異常の合図になります。

設定ファイルの1節で、AI の振る舞いをここまで変えられます。逆に言えば、書いていないことは変わりません。

実行サマリーに、あなたの仕事で欲しい項目を1つ足すとしたら何ですか。例を挙げます。「参照した外部情報の一覧」「変更前の状態に戻す方法」「この変更で影響を受けそうな他のファイル」。自分の職場のレビューで毎回聞かれることを思い出すと出てきます。

決まったら CLAUDE.md の ## 応答の最後に必ず出すもの を書き換えて、実際にその項目が出るか試してください。書き換えたあとはパネルを開き直します。出なかった場合、書き方に問題があります。何を書けば出るようになるかを2通り試して、違いを memo.md に書いてください。

この演習で書き換えた CLAUDE.md は元に戻さなくて構いません。A-5 の点検には影響しません。在庫の表示そのものを深めたい場合は exercises/challenges/ch02_low_stock_highlight.md に進んでください。しきい値を画面から変えられるようにする課題です。

A-1 から A-4 まで、依頼はすべて会話でした。会話は柔軟ですが、毎回書き方が違います。同じ点検を明日もう一度やろうとすると、同じようには書けません。手順を1本のファイルに書いておけば、コマンド名を打つだけで同じ手順が動きます。

このステップでは、実行中に何が起きているかを見ることに時間を使います。結果だけ受け取ると、中で何をしたのかがわからないまま報告書を信じることになります。.work/ に残る途中経過を開けば、どのファイルを見て、何を根拠に、何を直すと決めたのかが全部追えます。

1. コマンドを実行する

Claude Code パネルで次を送ります。

/ を打つと候補が出ます。selfcheck を選び、引数に kadaiA を付けて送信してください。引数を省略しても kadaiA が対象になりますが、明示するほうが何を点検したかが記録に残ります。3分から5分かかります。途中で止めないでください。

2. 実行中に .work/ を眺める

実行が始まったら、VSCode のエクスプローラで handson/.work/ フォルダを開いたままにします。フォルダは実行開始時に作られます。ファイルが順に増えていく様子が見えます。

番号順に増えます。増えていく間、AI は点検専任のサブエージェント（.claude/agents/reviewer.md）を呼び出しています。このサブエージェントは読み取りしかできない設定になっていて、コードを書き換えません。点検する役と、直す役を分けてあります。

3. 報告書を読む

完了したら handson/kadaiA/REPORT.md を開きます。6つの節が並んでいます。

まず1節と2節を読み、数字を頭に入れてください。そのあと5節に飛びます。5節がこの報告書で一番重要です。AI が「自分では決められない」と判断した箇所が並んでいます。全部を AI が決めて終わる報告書にしていないのは、そこが実務での線引きだからです。

4. 中間データを番号順に開く

報告書を読んだあと、.work/ の4本を順に開きます。読む観点を挙げておきます。

5. ループが何周で止まったかを確認する

04_loop_log.md の一番下を見ます。止まった理由が書かれています。次の3通りのどれかです。

• 深刻度「高」が0件になったので停止
• 上限3周に達したので打ち切り（残件は報告書の未対応欄へ）
• 同じ指摘の修正が2周続けて失敗したので打ち切り

自分がどれだったかを memo.md の ## A-5 に書いてください。周回数と止まった理由の2行で構いません。

6. アプリがまだ動くことを確かめる

ブラウザを再読み込みして、一覧50件・検索・詳細が動くことを確認します。点検の過程で修正が入っているため、直した結果として壊れていないかを人間の目で見ます。

数は増えましたか。増えたとしたら、増えた分は何を見ているから出てきたのでしょうか。観点の一覧は .claude/skills/kadaia-review/SKILL.md に書かれています。開くと、A-01 から A-13 までの観点が表になっています。

この表を見てから、もう一度自分の5個を読み返してください。同じことを別の言葉で書いていた項目はありませんか。逆に、この表に無い視点を自分が書いていませんでしたか。

最後の観点 A-13 に注目してください。自分の書いた懸念が指摘に入っていたら、内容 の冒頭に「受講者の懸念より:」と付いています。探してみてください。

• handson/kadaiA/REPORT.md（最終報告・人間向け）
• handson/.work/01_inventory.md
• handson/.work/02_findings.json
• handson/.work/03_fix_plan.md
• handson/.work/04_loop_log.md
• handson/kadaiA/index.html（修正が入っている場合）

1. kadaiA/REPORT.md が生成され、指摘件数・修正件数・残件数が 数字で 書かれている
2. .work/ に中間ファイルが 4本 揃っている
3. 04_loop_log.md に 2周以上 の記録がある（1周で深刻度「高」が0件になった場合は1周でも可。その旨がログに書かれていること）
4. REPORT.md の第5節「人間に判断してほしいこと」に 1件以上 書かれている
5. 修正後もブラウザでアプリが動く（一覧50件・検索・詳細）

4番が空の報告書は、この演習の趣旨から外れています。空だった場合は「判断が分かれた箇所か、置いた前提を1件挙げてください」と追加で依頼してください。

/selfcheck は .claude/commands/selfcheck.md に書かれた手順書です。中身は日本語の文章で、プログラムではありません。

開いて読んでみてください。「0. 前提と引数」から始まり、入力を読む、棚卸しを書く、点検する、修正する、ログを書く、報告書を書く、という順に手順が並んでいます。表の書式まで見本付きで指定されています。書いてあるとおりに AI が動いた結果が、いま手元にある .work/ と REPORT.md です。

「コマンドを作る」とは、この文章を1本書くことです。プログラミングの知識は要りません。必要なのは、自分がいつもやっている手順を、抜けなく順番どおりに書き出せることです。手順が言語化できていない作業は、コマンドにもできません。

もう1点、実行中にサブエージェントを1件ずつ順番に呼んでいたことにも触れておきます。20名が同時に実行する研修環境では、並列で走らせると接続先の上限に当たります。手順書の中で「並列で起動しないでください」と1行指定してあります。動く仕組みを書くだけでなく、動かす環境の都合も手順書に書ける、という例です。

.claude/skills/kadaia-review/SKILL.md の観点リストに、自分の職場でレビューされる観点を1つ足してください。観点IDは A-14 から続けます。

足すときに難しいのは「具体的に見るもの」の欄です。ここが抽象的だと、点検時に拾われません。「可読性を確認する」では拾えません。「関数が50行を超えていないか」なら拾えます。コードのどの記述を見れば判定できるかまで書くのが条件です。

足したら /selfcheck kadaiA をもう一度回します。指摘は増えましたか。増えなかった場合、原因は2つ考えられます。そもそも該当する箇所が無かったか、観点の書き方が拾える形になっていなかったかです。どちらかを切り分けるには、index.html を自分の目で見て、その観点に該当しそうな箇所があるかを探します。あるのに拾われなかったなら、書き方の問題です。

2回目以降の .work/ は上書きされます。1回目の結果を残したい場合は、REPORT.md を REPORT_1.md に名前を変えてから回してください。

「Claude Code が便利だった」では、聞いた人は何をすればよいかわかりません。「設定ファイルを1本置いたら、レビューの観点が毎回同じになった」なら、置く場所と中身を聞けば真似できます。この10分で作るのは表1つと数行の文章です。

1. 比較表を作らせる

Claude Code に、次の2つのファイルを突き合わせて kadaiA/COMPARE.md を作らせます。

• @memo.md の ## A-2：素の状態で自分が書いた懸念
• @kadaiA/REPORT.md：ハーネスを入れて回した点検の結果

表の列は次の3つにします。

2. できた表を読む

COMPARE.md を開いて、1列目と2列目を突き合わせます。自分が書いた懸念のうち、/selfcheck でも拾われたものはどれですか。自分だけが挙げていた項目は、2列目に対応するものがないはずです。その行が、あなたが持っていて仕組みが持っていない視点です。

3. 3列目に自分で1行足す

書きにくければ、次の問いから考えてください。

• このアプリを実際に社内で使うとしたら、最初に困るのは誰か
• データが50件ではなく5000件になったら何が起きるか
• 備品を借りた人・返した人の記録は、どこにも残っていない
• このファイルを引き継いだ人が、最初に開くべきファイルはどれか

4. 持ち帰りの節を書く

COMPARE.md の末尾に ## 自分の職場に持ち帰るなら という見出しを作り、1行から3行書きます。自分の仕事のどの作業で、今日の何を使えそうか。使うとしたら、最初に用意するファイルは何か。ここも AI に書かせず、自分の言葉で書いてください。他人が読んで意味が通るかは気にしなくて構いません。あとで読み返すのは自分です。

もう1つ、数に表れない変化があります。毎回同じ観点で見てくれるという再現性です。A-2 で AI に聞いたときは、聞くたびに指摘の内容が変わる状態でした。/selfcheck は観点リストを持っているので、明日回しても同じ観点で見ます。

1人で使うときと、5人のチームで使うときとで、どちらの価値が大きくなると思いますか。1人なら、頭の中に観点があれば足ります。5人だと、頭の中は共有できません。誰が回しても同じ観点で点検されることが、そのままレビュー品質の下限になります。逆に言えば、観点リストに書き忘れたものは、チームの誰も見なくなります。ファイルに書くとは、そういう責任を持つことでもあります。

この考えを1行、COMPARE.md か memo.md に足しておいてください。

1. 3列の比較表
2. 3列目に自分の手で足した1行以上
3. ## 自分の職場に持ち帰るなら の節（1行以上）

1. COMPARE.md に 3列 の表がある
2. 3列目に 自分の手で1行以上 足してある
3. ## 自分の職場に持ち帰るなら に 1行以上 書いてある

表の行数は問いません。1列目が3行しかなくても、それが A-2 で書けた分なら正しい記録です。実際より多く見せる必要はありません。

このステップの成果物は、研修後にそのまま社内共有できる形にしてあります。ファイル名と場所を控えておいてください。handson/kadaiA/COMPARE.md です。

社外に持ち出す前に、業務データや社名が混ざっていないかは必ず確認してください。本研修のデータは架空の備品データです。

COMPARE.md を、上司に見せる1枚の報告として整えるとしたら、どの情報を足し、どの情報を削りますか。足す候補は、たとえば所要時間、何人で何分かかったか、この仕組みを自部署に置くのに必要な作業。削る候補は、演習の手順そのものや、技術的な用語です。

AI に「この読み手向けに書き直してください」と頼むとき、次の3通りを実際に試して、出力の違いを見比べてください。

1. 「上司向けに書き直してください」
2. 「開発経験のない部門長向けに、A4半ページで書き直してください」
3. 「開発経験のない部門長向けに、導入判断に必要な情報だけを A4半ページで書き直してください。技術用語には初出で1行の補足を付けてください」

3番まで書くと出力がどう変わるかを見ておくと、明日から書く指示の粒度が決まります。余力があれば exercises/challenges/ch04_csv_export.md にも進めます。作った一覧を CSV で書き出す課題で、dummy_data.csv を書き換えない制約の中でどう実現するかを考えます。