---
session: S03
exercise: A-6
title: ハーネスの有無を比較する
duration: 10min
difficulty: 2
prerequisite: [A-2, A-5]
phases:
  作らせる: 4min
  自分で足す: 4min
  持ち帰りを書く: 2min
files_to_edit:
  - kadaiA/COMPARE.md  # AI に作らせ、自分で書き足します
hints: hints/step04_pipeline.md
challenge: true
tags: [比較, 再現性, 持ち帰り]
---

# 演習 A-6: ハーネスの有無を比較する

設定なしで作ったときと、設定を置いてコマンド1本を回したあとで、何がどう変わったかを比較ファイルとして手元に残します。

| 項目 | 内容 |
|---|---|
| 所要 | 10分 |
| 触るフォルダ | `kadaiA/` |
| 生成物 | `handson/kadaiA/COMPARE.md` |
| 終わったと言える状態 | 3列の表があり、3列目に自分の手で1行足してあり、持ち帰りの節が書けている |

---

## 目的

70分でやったことを、社内で説明できる1ファイルに落とします。

研修の価値は、当日できたことではなく、月曜日に自分の職場で再現できることで決まります。「Claude Code が便利だった」では、聞いた人は何をすればよいかわかりません。「設定ファイルを1本置いたら、レビューの観点が毎回同じになった」なら、置く場所と中身を聞けば真似できます。

この10分は、その差を埋めるために使います。作るのは表1つと数行の文章です。

---

## 操作

### 1. 比較表を作らせる

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

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

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

| 列 | 中身 |
|---|---|
| 素の状態で気づけたこと | A-2 で自分が書き出せた項目 |
| ハーネスを入れてから拾えたこと | `/selfcheck` の指摘のうち、A-2 に無かったもの |
| まだ誰も拾えていないこと | どちらにも出ていないが、実務では問題になりそうなこと |

参考プロンプトは `hints/step04_pipeline.md` にあります。3列の意味だけ伝えれば、文面は自由です。

### 2. できた表を読む

`COMPARE.md` を開いて、1列目と2列目を突き合わせます。

自分が書いた懸念のうち、`/selfcheck` でも拾われたものはどれですか。自分だけが挙げていた項目は、2列目に対応するものがないはずです。その行が、あなたが持っていて仕組みが持っていない視点です。

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

**この操作は AI に頼まないでください。** 3列目「まだ誰も拾えていないこと」に、自分の手で1行以上書き足します。

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

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

AI が拾えなかったのは、能力の問題ではなく、渡していない情報があるからです。何を渡していなかったのかを1行で書けると、`CLAUDE.md` に何を書き足すべきかもわかります。

### 4. 持ち帰りの節を書く

`COMPARE.md` の末尾に `## 自分の職場に持ち帰るなら` という見出しを作り、1行から3行書きます。

書く内容の目安です。自分の仕事のどの作業で、今日の何を使えそうか。使うとしたら、最初に用意するファイルは何か。ここも AI に書かせず、自分の言葉で書いてください。他人が読んで意味が通るかは気にしなくて構いません。あとで読み返すのは自分です。

---

## 自分で考える

ハーネスを入れて増えたのは「指摘の数」だけでしょうか。

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

1人で使うときと、5人のチームで使うときとで、どちらの価値が大きくなると思いますか。

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

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

---

## 生成物の名前と場所

`handson/kadaiA/COMPARE.md`

中身は次の3つです。

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

---

## OK基準

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

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

---

## 追加と考察

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

一緒に持ち帰るとよいファイルを挙げておきます。

| ファイル | 何が書いてあるか | 誰に見せると効くか |
|---|---|---|
| `kadaiA/COMPARE.md` | 導入前後の差 | 上司、チームの意思決定者 |
| `kadaiA/REPORT.md` | 点検の結果と、人間に残した判断 | 同僚、レビュー担当 |
| `.work/02_findings.json` | 指摘の根拠付き一覧 | 仕組みを作りたい人 |
| `CLAUDE.md` | 何を前提として渡したか | 同じ設定を自部署で作りたい人 |
| `.claude/commands/selfcheck.md` | 手順を文章で書くとどうなるか | 同上 |

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

---

## 発展課題

`COMPARE.md` を、上司に見せる1枚の報告として整えるとしたら、どの情報を足し、どの情報を削りますか。

足す候補は、たとえば所要時間、何人で何分かかったか、この仕組みを自部署に置くのに必要な作業。削る候補は、演習の手順そのものや、技術的な用語です。

AI に「この読み手向けに書き直してください」と頼むとき、読み手をどこまで具体的に伝えると精度が上がるでしょうか。次の3通りを実際に試して、出力の違いを見比べてください。

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

3番まで書くと出力がどう変わるかを見ておくと、明日から書く指示の粒度が決まります。この違いこそが、本日の午後に扱った「文脈を渡す」の実際です。

余力があれば `exercises/challenges/ch04_csv_export.md` にも進めます。作った一覧を CSV で書き出す課題で、`dummy_data.csv` を書き換えない制約の中でどう実現するかを考えます。

---

## うまくいかないとき

**表が3列にならない、2列で出てくる**

「3列目は空欄で構わないので、列だけ作ってください」と伝えてください。3列目は自分で埋める欄です。空欄の列があるほうが、埋める場所がはっきりします。

**`REPORT.md` が無いと言われる**

A-5 が完了していない可能性があります。`kadaiA/` の中を確認してください。`REPORT.md` が無い場合は、`.work/02_findings.json` を代わりに使って比較表を作ることもできます。指摘の一覧はそちらにも入っています。

**`memo.md` の `## A-2` が空だった**

いまから3行だけでも書いてください。作ったアプリを思い出して、不安なところを書けば十分です。空のまま比較しても、1列目が空の表しかできません。

**AI が3列目まで勝手に埋めてしまった**

埋まっている行はそのまま残して構いません。その下に、自分で1行足してください。AI が書いた行と自分が書いた行が並ぶと、視点の違いが見えます。どちらが自分の行かがわかるよう、行頭に「（自分）」と付けておくと後で読みやすくなります。

**時間が足りない**

3列の表と、3列目の1行だけを優先してください。`## 自分の職場に持ち帰るなら` は、休憩時間や研修後に書き足せます。書く場所を作っておくだけでも、あとから戻ってこられます。

---

## 演習Aはここまで

ここまでで、次の5つが手元に残っています。

- `kadaiA/index.html`：設定なしで作り、設定ありで点検・修正したアプリ
- `memo.md`：自分の懸念と、各ステップの気づき
- `.work/` の4本：点検の途中経過
- `kadaiA/REPORT.md`：人間向けの報告書
- `kadaiA/COMPARE.md`：導入前後の比較

休憩のあとは演習Bです。今度は自分が書いたコードではなく、初見の Java プロジェクトを相手にします。[B-0 課題Bを起動して現状を掴む](exB0_start_kadaiB.md) から始めます。最初に Skill 3種の配置を全員同時に行いますので、講師の案内を待ってください。
