丸投げでは完成しない — AI開発の到達作品

AI開発の到達作品。パソコンと対話の吹き出し、家計簿と確認のチェック。

※本記事はアフィリエイト広告(PR)を含みます。

AIに丸投げすると完成しません。要件を先に決め、出てきた差分を1つずつ検証しながら小さな作品を作る演習です。

前回: AIが書いた差分は読まずに入れない — AIを開発に使う

これは「AIと組んで開発する」カテゴリの到達作品の回です。 前回の AIが書いた差分は読まずに入れない — AIを開発に使う が 「AIとの付き合い方の心構え」 だとすれば、この回は その心構えを持ったまま、実際にAIと組んで小さな作品を1つ作り、その過程を再現できる形で記録する 回です。 新しい技術はほとんど出てきません。すでに知っていることを、AIと二人で1つの動くものに束ねる回です。

この記事は、使うAIを Claude に固定して書きます。AI同士の優劣を比べる回ではありません。 手順は他のAIでも考え方は同じですが、画面やコマンドは Claude を前提にします。 どれが優秀か、というランキングは出しません。 この記事がやるのは、1つの道具の1つの使い方を、最初から最後まで見せることだけです。

「AIがあれば、もうプログラミングは要らない」と言われます。

半分は本当で、半分は罠です。 実際、この記事で作る家計簿ツールも、コードの多くは Claude が書きました。でも、Claude に「家計簿を作って」と1行だけ投げて出てきたものは、動きませんでした。 正確には、動いたように見えて、合計金額が間違っていました。

bash
$ node kakeibo.js total
食費: 1200500

1,200円と500円を足して、1,200,500円になっています。エラーは1つも出ていません。 これが、この記事の出発点です。

AIは「速い相棒」であって「発注先」ではありません。 「〇〇を作って」だけでは、動かないものか、頼んだのとずれたものが返ってきます。 そして前回書いたとおり、返ってきたものを読まずに入れると、間違いはそのまま自分のコードになります。

この記事は、AIを使わない話ではありません。 AIと二人三脚で、1つの作品を完成まで持っていく話です。そのために必要なのは、頼み方と、受け取り方と、直させ方の、たった3つの往復です。

そして最後に、隠さずに書きます。 このサイト(obmes.com)自体が、Claude Code というAIと一緒に書かれています。 記事の下書きも、投稿スクリプトも、AIが書いた部分がたくさんあります。だからこそ、AIに任せて良かったことと、任せてはいけなかったことを、実感を持って書けます。

対象レベル: 中級 / 区分: 必修

目次

めがける作品

このカテゴリを終えたら、これができるようになっている。 ——そう言い切れる1本を、ここで作ります。

作るのは 「コマンドラインの家計簿」 です。地味に見えますが、AIと組んで作るときの勘所が全部入っています。

  • 支出を1件記録できる(add 1200 食費 ランチ)
  • 記録した一覧を表示できる(list)
  • カテゴリごとの合計を出せる(total)
  • プログラムを終了しても、記録が消えない(ファイルに保存)

完成すると、こう動きます。

┌──────────────────────────────────────────┐
│  $ node kakeibo.js add 1200 食費 ランチ     │
│  記録しました: 食費 1200円(ランチ)        │
│                                            │
│  $ node kakeibo.js list                    │
│  1. 食費   1200円  ランチ                   │
│  2. 交通費  240円  バス                     │
│  3. 食費    500円  コーヒー                  │
│                                            │
│  $ node kakeibo.js total                   │
│  食費:   1700円                             │
│  交通費:  240円                             │
│  合計:   1940円                             │
└──────────────────────────────────────────┘

なぜ家計簿で、なぜコマンドラインなのか。 理由は3つあります。

理由中身
小さいAIに一度に大量を作らせないため。画面もデータベースも要らない、1ファイルで足りる大きさにする
正しさが数字で分かる1200 + 500 は 1700。合っているか間違っているかが、一目で分かる。AIの間違いが隠れられない
手を動かした記録が残しやすいコマンドと出力がそのまま証拠になる。この記事の目的(再現性)に一番向いている

作業場所はこれまでどおり VMの中(Ubuntu Server)です。 Node.js は サーバーとは待ち続けるプログラム の回で入れたものを使います。編集は VS Code の Remote SSH からでも、nano でも構いません。 ブラウザで Claude と対話する部分は、Windows本体のブラウザからで構いません。 手元にコードを貼るだけです。

この記事でわかること

  • 「作って」だけの丸投げでは完成しないこと。AIは発注先ではなく、速い相棒であること
  • AIと組む作業には型があること(対話で設計 → 小さく作らせる → 自分で読む → テストで確かめる → 直させる)
  • 良いプロンプトには要素があること(何を作るか・制約・入出力の例・使う言語)。それを渡すと、返ってくるものが変わる
  • 1回で完成しないのが普通であること。往復してこそ完成に近づく。往復の記録こそが資産になること
  • AIの出力は「仮説」であること。読んで・動かして・テストして初めて採用する。AIは自信満々に嘘をつく
  • AIは学びを加速するが、学びを肩代わりはしないこと。理解を飛ばすと、AIの間違いに気づけなくなる

この記事でやること

  1. 作らないものリストを先に書く。今日の題材を、小さく1つに絞る
  2. Claude に設計を相談し、それから小さく1機能ずつ作らせる
  3. 返ってきたコードを1行ずつ読み、実際に2つの間違いを見つける
  4. 間違いを、エラーメッセージと再現手順を添えて指摘し、直させる
  5. 小さなテストを1本書いて、緑になることを確かめてから採用する
  6. 完成させ、最後は自分の手で動かして確認する。そして何を頼み・どう直したかを記録に残す

先に知る言葉

この記事で軸になる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
ペアプログラミング2人で1つのコードを作ること。片方が書き、もう片方が読む。今回は相方がAI
プロンプトAIへの頼み方の文章。これの質が、返ってくるものの質を決める
反復(イテレーション)1回で仕上げず、少しずつ往復して仕上げること
仮説「たぶん正しい」だけで、まだ確かめていない答え。AIの出力はこれ
ハルシネーションもっともらしいが事実でない出力。前回に出てきた言葉。存在しない関数を自信満々に書く
CLICommand Line Interface。 画面ではなく、コマンドで操作する形の道具
引数(argument)コマンドに渡す値。node kakeibo.js add 1200 食費 の 1200 や 食費
テストコードが正しいかを、別のコードで自動で確かめる仕組み。今回は Node 標準の node --test を使う
Claude CodeClaude がファイルを読み書きしコマンドも実行する形の道具。このサイトはこれで書かれている

この記事の一番大事な1行を、先に書きます。 AIに任せてよいのは「作業」であって、「判断」ではありません。 何を作るか、これで正しいか、なぜこうするか——ここを手放すと、完成できません。

① 丸投げは完成しない — まず「作らないもの」を決める

最初にやってはいけないことを、実際にやってみます。 そのほうが、なぜダメかが体で分かります。

Claude の対話画面(ブラウザの claude.ai でも、エディタ内蔵のチャットでも構いません)を開いて、こう打ちます。

家計簿を作って

返ってくるものは、毎回違います。 ある時はWebアプリ、ある時は Python、ある時は巨大な一枚岩のコード。そもそも、あなたが何を作りたかったのかを、AIは知りません。

「作って」だけの丸投げは、AIに設計を丸投げしているということです。 設計はこの記事で一番大事な「判断」です。前回の一番大事な1行——判断は代行させない——が、いきなりここで効いてきます。

作らないものリストを、先に書く

作らないものリストを先に書く — 個人開発の題材選び で書いたことが、AIと組むときはもっと大事になります。範囲を決めないと、AIはいくらでも大きく作ろうとするからです。

今回、作らないものを先に宣言します。

作らないもの理由
収入の管理まずは支出だけ。1つのことだけできる道具にする
画面(Web/GUI)一度に大きくしない。コマンドラインで足りる
データベースJSONファイル1つで足りる。DBは題材が大きくなりすぎる
月またぎの集計・グラフ合計が出れば十分。「便利機能」は完成の敵
ログイン・複数ユーザー自分1人が使う道具。認証は要らない

作るものは、これだけです。

作るものコマンド
支出を1件足すadd <金額> <カテゴリ> [メモ]
一覧を出すlist
カテゴリ別合計を出すtotal

これを決めてからAIに頼むと、AIの出力が急に安定します。 AIは「速い相棒」です。 ただし、どこへ向かうかを決めるのは、相棒ではなく、あなたです。

[スクリーンショット: 01_claude_prompt.png] Claude の対話画面で、次の節のプロンプト(設計の相談)を実際に送っている画面を撮ってください。返答が出ている状態が分かるとよいです。

② どのAIを、どう使うか — Claude に固定して、型どおりに

使うAIは Claude です。 この記事では最後までそれ1つで進めます。「どれが一番賢いか」は扱いません。 大事なのは道具選びではなく、1つの道具を、決まった型で回すことだからです。

まず、正直な開示

このサイト obmes.com は、Claude Code というAIと一緒に作られています。 記事の下書きも、WordPress へ投稿するスクリプト(post-draft.mjs など)も、AIが書いた部分がたくさんあります。作り話ではありません。

では、AIに全部任せて楽をしたのか。 ——逆でした。AIが書いたものを人間が読んで直す時間のほうが、書かせる時間より長いのが実際です。前回のAIが書いた差分は読まずに入れない は、その実感から書かれています。この記事も同じ立場で書きます。

Claude の使い方は2通り、どちらでも再現できる

使い方どういうものかこの記事での扱い
① 対話(ブラウザ / チャット)質問して、コードをもらい、貼り付けるのは自分こちらを基本にします。ブラウザだけで誰でも同じことができる
② Claude Code(CLI / エージェント)Claude が自分でファイルを読み書きし、コマンドも実行するこのサイトで使っている形。便利だが、見ていない量が増えるので今回は補足に留める

再現性のため、この記事は①の対話を基本にします。 どちらを使っても、頼み方(プロンプト)と、受け取り方(読む・確かめる)は同じです。 エージェント型は、判断を任せていないつもりでも、気づかないうちに複数ファイルを変えます。 学習中は、変更を人間が読んでから入れる①の形が安全です。

AIと組む作業の「型」

行き当たりばったりで頼むと、行き当たりばったりの結果が返ります。 型を1つ決めます。

1. 対話で「何を作るか」を詰める(設計)……ここは人が主役
2. 小さく1機能だけ作らせる(add だけ、など)
3. 返ってきたコードを、自分で1行ずつ読む
4. 小さく動かす/テストで確かめる
5. 間違いを、具体的に指摘して直させる
6. 通ったら採用し、次の1機能へ(2に戻る)

一度に全部を作らせない理由は、はっきりしています。 一度に大量のコードが返ってくると、人間が読み切れません。 読み切れないものは、確かめられず、直せず、結局「動くらしいから入れる」になる——前回の一番危ない状態です。 小さく作らせれば、1回分の差分は数十行で済みます。 これなら最後まで自分の目が届きます。

まず設計を相談する(コードはまだ書かせない)

いきなりコードを頼まず、先に設計を1往復します。 Claude にこう送ります。

Node.js でコマンドラインの家計簿を作りたい。まだコードは書かないで、
設計だけ相談させてほしい。要件は次のとおり。

- 支出だけを扱う(収入は扱わない)
- コマンドは3つだけ: add / list / total
- add は「金額 カテゴリ メモ」を受け取る。メモは省略可
- データは1つのJSONファイルに保存する(DBは使わない)
- 画面(Web/GUI)は作らない

この要件で、データの持ち方とファイル構成だけ提案して。
気になる点や、決めきれていないところがあれば質問して。

ここでの狙いは、コードではありません。 AIに「質問させる」ことで、自分が決めていなかったことを、先にあぶり出すのが狙いです。実際、この相談で次のような論点が出てきます。

  • 金額は整数(円)で持つか、小数で持つか → 整数(円)にします。 小数で金額を持つと1円ずれることがあるからです
  • 同じカテゴリ名の表記ゆれ(「食費」と「食 費」)をどうするか → 今回はそのまま(作らないものに入れる)
  • 保存ファイルが無いとき、最初にどうするか → 空の一覧として扱う

設計をAIと詰めるのは良い使い方です。 ただし最後に「これでいく」と決めるのは自分です。AIの提案の中から、自分の要件(作らないものリスト)に合うものだけを選びます。

相談の結果、決まったこと

この1往復で、コードを1行も書く前に、次のことが決まりました。 ここを先に決めておくと、あとの往復が短くなります。

決めたこと決めた中身なぜ
金額の型整数(円)小数だと1円ずれることがある。円なら整数で足りる
保存の形1つのJSON配列に追記1件=1オブジェクト。読むのも人が確認しやすい
ファイル構成kakeibo.js 1本(+あとでテスト1本)小さく保つ。ファイルが増えると読む範囲が広がる
ファイルが無いとき空の一覧として始める初回でエラーにしない。「まだ記録がありません」を出す
表記ゆれの正規化やらない作らないものリスト。まず動くものを1つ完成させる

この表は、Claude の提案そのままではありません。 提案を読んで、自分の要件に合うものだけを選び、合わないものは落とした結果です。 AIの提案を全部飲むのは、丸投げと同じです。選ぶという判断を、ここで1回はさんでいます。

③ プロンプトの実例と、その反復

ここが、この記事の山場です。 1回で完成させようとしない——それを、実際の往復で見せます。

良いプロンプトには要素がある

「add コマンドを作って」では足りません。 良いプロンプトには、だいたい次の4つが入っています。

要素今回の例
何を作るか「add コマンドを1つだけ作る」
制約「1ファイル、JSONに保存、依存パッケージを増やさない」
入出力の例「node kakeibo.js add 1200 食費 ランチ → 記録しました: …」
使う言語・環境「Node.js の標準機能だけ。追加インストールはしない」

同じ「add を作って」でも、要素が入っているかどうかで、返ってくるものが変わります。 並べてみます。

悪いプロンプト何が起きるか
add コマンドを作って言語も保存先も決まっていない。AIが勝手に決める。毎回違うものが返る
家計簿の add を Python で使う言語は決まったが、入出力の形が無い。呼び出し方が想像で決まる
add を作って。list と total も一度に大きくなる。 差分が読み切れず、確かめられない

良いプロンプトは、AIが「勝手に決める」余地を、先につぶしておきます。 決めるべきことを自分で決めて渡すのが、頼む側の仕事です。

実際に送ったプロンプトが、これです。

Node.js で家計簿CLIの add コマンドだけを作って。以下を守って。

- ファイルは kakeibo.js の1つだけ。追加パッケージは使わない(標準機能だけ)
- 使い方: node kakeibo.js add <金額> <カテゴリ> [メモ]
  例: node kakeibo.js add 1200 食費 ランチ
- 記録は data.json に配列で追記する。ファイルが無ければ空配列から始める
- 実行したら「記録しました: 食費 1200円(ランチ)」と表示する
- list と total は、まだ作らないで。add だけにして
- コードには、なぜその処理が必要かを短いコメントで添えて

list と total は、まだ作らないで の一文が効いています。 これを書かないと、AIは頼んでいない機能まで一気に作ります。 小さく保つのは、頼む側の仕事です。

最初の出力(そのままは載せません、要点だけ)

返ってきた kakeibo.js は、だいたいこういう形でした。読みやすく整えてあります。

const fs = require("fs");
const FILE = "data.json";

// 保存ファイルを読む。無ければ空の配列を返す
function load() {
  if (!fs.existsSync(FILE)) return [];
  return JSON.parse(fs.readFileSync(FILE, "utf8"));
}

// 配列をファイルに書き戻す
function save(items) {
  fs.writeFileSync(FILE, JSON.stringify(items, null, 2));
}

const [cmd, amount, category, ...memoParts] = process.argv.slice(2);

if (cmd === "add") {
  const items = load();
  // ⚠️ ここが後で問題になる
  items.push({ amount: amount, category: category, memo: memoParts.join(" ") });
  save(items);
  console.log(`記録しました: ${category} ${amount}円(${memoParts.join(" ")})`);
}

動かしてみます。

bash
$ cd ~
$ mkdir -p kakeibo && cd kakeibo
$ node kakeibo.js add 1200 食費 ランチ
$ node kakeibo.js add 500 食費 コーヒー
記録しました: 食費 1200円(ランチ)
記録しました: 食費 500円(コーヒー)

一見、うまくいっています。 data.json にもちゃんと2件入っています。問題は、合計を出そうとした瞬間に出ます。

反復1: 合計がおかしい(実際のバグ)

total を頼む前に、手で足し算を確かめてみます。試しに data.json を見ると、金額がこうなっていました。

[
  { "amount": "1200", "category": "食費", "memo": "ランチ" },
  { "amount": "500", "category": "食費", "memo": "コーヒー" }
]

amount が数字ではなく、文字列("1200")で入っています。 コマンドライン引数は、すべて文字列で渡ってくるからです。このまま足すと、JavaScript では 足し算ではなく、文字列の連結になります。

"1200" + "500"  →  "1200500"   ← 足していない。くっつけている

これを、丸投げで直そうとしてはいけません。 「合計が変です、直して」だけでは、AIはどこが変なのか分かりません。 前回のエラーは下から読むと同じで、再現手順と、実際に起きたことを添えて指摘します。

add で保存した data.json を見たら、amount が文字列で入っていた。
(例: "amount": "1200")
このままだと合計が "1200" + "500" = "1200500" と連結されてしまう。

原因は、process.argv の引数がすべて文字列だからだと思う。
add で保存するときに、金額を数値に変換してほしい。
あわせて、金額が数値でない(例: node kakeibo.js add ランチ 食費)ときは
「金額は数字で入力してください」と表示して、保存せずに終了してほしい。

指摘に「原因はこうだと思う」を添えています。 これは丸投げではありません。 自分の仮説を渡すと、AIは的外れな修正をしにくくなります。当たっていなくても構いません。 会話が具体的になるだけで、直る確率が上がります。

返ってきた修正は、add の該当行がこう変わりました。

if (cmd === "add") {
  const value = Number(amount); // 文字列 → 数値に変換
  // 数値でなければ保存せずに終了する
  if (!Number.isFinite(value)) {
    console.log("金額は数字で入力してください");
    process.exit(1);
  }
  const items = load();
  items.push({ amount: value, category, memo: memoParts.join(" ") });
  save(items);
  console.log(`記録しました: ${category} ${value}円(${memoParts.join(" ")})`);
}

古い data.json を消してから、もう一度入れ直して確かめます。

bash
$ rm -f data.json
$ node kakeibo.js add 1200 食費 ランチ
$ node kakeibo.js add 500 食費 コーヒー

data.json を見ると、今度は "amount": 1200(引用符なし=数値)になっています。 反復1は、これで通りました。

反復2: 頼んでいない機能が、勝手に増えていた

修正版をよく読むと、頼んでいない delete コマンドの処理が、静かに足されていました。

// 頼んでいないのに増えていた
} else if (cmd === "delete") {
  const items = load();
  items.pop(); // 最後の1件を消す、という勝手な仕様
  save(items);
  console.log("最後の記録を削除しました");
}

親切のつもりなのは分かります。 でもこれは「頼んでいない仕様変更」です。前回のAIが書いた差分は読まずに入れない で見た、「頼んでいない変更が静かに混ざる」が、そのまま起きています。

しかも中身が危ない。 items.pop() は「最後の1件」を、確認なしで消します。 押し間違えたら戻せません。今回の作らないものリストに、削除は入っていません。

指摘は、はっきり断ります。

delete コマンドは頼んでいないので消して。今回は add / list / total の3つだけ。
機能を増やすときは、こちらから頼むまで足さないで。

「余計なことをしないで」も、立派なプロンプトです。 AIは、良かれと思って範囲を広げます。 範囲を守らせるのは、頼む側の仕事です。作らないものリストがここでも効きます——「delete は作らないもの」と自分の中で決まっているから、増えた瞬間に気づけました。

1回で完成しないのが普通です。 最初の出力は「たたき台」で、そこから往復して仕上げるのが当たり前です。 大事なのは、往復のたびに「何が間違っていて、どう直したか」を、自分が理解していることです。理解しないまま直った差分だけ受け取ると、次に同じ間違いが出ても気づけません。

④ 受け取ったコードを、必ず自分で検証する

反復1で合計は直りました。 では list と total を頼みます。ここで、もっと厄介な間違いが出ます。

AIは、自信満々に嘘をつく

total を頼んだら、返ってきたコードの load() が、いつの間にかこう書き換わっていました。

function load() {
  if (!fs.existsSync(FILE)) return [];
  // Node標準の fs.readJson を使えば JSON.parse が要りません、と説明された
  return fs.readJson(FILE);
}

説明文には、こう書いてありました。 「fs.readJson() を使うと、JSON.parse を書かなくてよいので簡潔です」。いかにも本当らしい説明です。 実際に動かすと、こうなります。

bash
$ node kakeibo.js list
TypeError: fs.readJson is not a function

fs.readJson() は、Node.js の標準機能には存在しません。 それは別のパッケージ(fs-extra)の関数です。Claude は、存在しない関数を、存在するかのように自信満々に書きました。 これが前回出てきたハルシネーションの、コードでの姿です。

AIの出力は「仮説」です。 もっともらしい説明が添えてあっても、それが正しさの証拠にはなりません。 裏の取り方は前回と同じです。公式ドキュメントは読まずに引く の要領で、fs に readJson があるかを、公式で引いて確かめます。 ——ありません。だから使いません。

「そんな関数は標準には無い。標準だけで書いて」と指摘すると、JSON.parse を使う元の形に戻りました。 ここで、指摘できたのは、自分が load() を読んでいたからです。読まずに入れていたら、list を打った瞬間まで気づけませんでした。

検証は「読む」だけでは足りない。小さくテストする

目で読むのは検証の半分です。もう半分は、動かして、テストで固定することです。金額が数値で足せることを、テスト1本で確かめます。

まず、合計を出す処理を、テストしやすいように関数へ切り出してもらいます。

// kakeibo.js の中に、外から呼べる形で置く
function totalByCategory(items) {
  const sums = {};
  for (const item of items) {
    sums[item.category] = (sums[item.category] || 0) + item.amount;
  }
  return sums;
}
module.exports = { totalByCategory };

Node 標準のテスト機能で、1本だけ書きます。 追加インストールは要りません。

// kakeibo.test.js
const test = require("node:test");
const assert = require("node:assert");
const { totalByCategory } = require("./kakeibo.js");

test("同じカテゴリの金額は数値として足される", () => {
  const items = [
    { amount: 1200, category: "食費", memo: "ランチ" },
    { amount: 500, category: "食費", memo: "コーヒー" },
  ];
  // 文字列連結なら "1200500" になる。数値の足し算なら 1700
  assert.strictEqual(totalByCategory(items)["食費"], 1700);
});

走らせます。

bash
$ node --test
✔ 同じカテゴリの金額は数値として足される
# pass 1
# fail 0

このテストが緑になって、初めて total を採用します。 テストは「反復1のバグが、もう起きない」ことを固定します。 次にAIがうっかり amount を文字列に戻すような変更をしても、このテストが赤くなって教えてくれます。 1本でいいので、一番大事な性質を1つ、テストで固定する——これが、AIと組むときの安全網です。

[スクリーンショット: 02_node_test_green.png] VMの中で node --test を実行し、テストが1本 pass(緑)になっている画面を撮ってください。

⑤ 作品を完成させる — 最後は自分の手で動かす

反復を重ねて、3コマンドがそろいました。 ここまでの往復で、kakeibo.js は次の形に落ち着きます。これは説明用に整えた最終形です。

const fs = require("fs");
const FILE = "data.json";

// 保存ファイルを読む。無ければ空配列(標準の JSON.parse を使う)
function load() {
  if (!fs.existsSync(FILE)) return [];
  return JSON.parse(fs.readFileSync(FILE, "utf8"));
}

function save(items) {
  fs.writeFileSync(FILE, JSON.stringify(items, null, 2));
}

// カテゴリごとに金額を合計する(テストで固定した関数)
function totalByCategory(items) {
  const sums = {};
  for (const item of items) {
    sums[item.category] = (sums[item.category] || 0) + item.amount;
  }
  return sums;
}

function main() {
  const [cmd, amount, category, ...memoParts] = process.argv.slice(2);

  if (cmd === "add") {
    const value = Number(amount);
    if (!Number.isFinite(value)) {
      console.log("金額は数字で入力してください");
      process.exit(1);
    }
    const items = load();
    items.push({ amount: value, category, memo: memoParts.join(" ") });
    save(items);
    console.log(`記録しました: ${category} ${value}円(${memoParts.join(" ")})`);

  } else if (cmd === "list") {
    const items = load();
    if (items.length === 0) {
      console.log("まだ記録がありません");
      return;
    }
    items.forEach((item, i) => {
      console.log(`${i + 1}. ${item.category}  ${item.amount}円  ${item.memo}`);
    });

  } else if (cmd === "total") {
    const sums = totalByCategory(load());
    let all = 0;
    for (const [cat, sum] of Object.entries(sums)) {
      console.log(`${cat}: ${sum}円`);
      all += sum;
    }
    console.log(`合計: ${all}円`);

  } else {
    console.log("使い方: node kakeibo.js <add|list|total> ...");
  }
}

// テストからは main を呼ばず、関数だけ使えるようにする
if (require.main === module) main();
module.exports = { totalByCategory };

ここで終わりにしません。 このサイトの方針は、「コピペで動いた」で終わらせないことです。最後は、必ず自分の手で動かして確かめます。

bash
$ rm -f data.json
$ node kakeibo.js add 1200 食費 ランチ
$ node kakeibo.js add 240 交通費 バス
$ node kakeibo.js add 500 食費 コーヒー
$ node kakeibo.js list
$ node kakeibo.js total
記録しました: 食費 1200円(ランチ)
記録しました: 交通費 240円(バス)
記録しました: 食費 500円(コーヒー)
1. 食費  1200円  ランチ
2. 交通費  240円  バス
3. 食費  500円  コーヒー
食費: 1700円
交通費: 240円
合計: 1940円

わざと壊れる入力も、自分で試します。 これも「動かして確かめる」の一部です。

bash
$ node kakeibo.js add コーヒー 食費
金額は数字で入力してください

保存されていないことも確かめます。 list を打って、件数が増えていなければ正しい動きです。

「AIが書いたから正しいだろう」は、確認ではありません。 自分でコマンドを打って、期待どおりの数字が出て、初めて「完成した」と言えます。 ここを飛ばすと、読者に「コピペで動く」だけを渡すことになり、このサイトが一番やりたくないことになります。

[スクリーンショット: 03_kakeibo_total.png] VMの中で node kakeibo.js total を実行し、カテゴリ別の合計と総合計が正しく出ている画面を撮ってください。

⑥ 再現性の担保 — 記録に残すのは「コード」より「判断」

ここが、この回の一番の肝です。

動くコードが完成しました。 でも、「AIに任せて動いた」で終わると、次に同じことができません。 なぜその形にしたのか、どこで間違えて、どう直したのかが、どこにも残っていないからです。

AIの出力そのものより、自分の判断の記録のほうが、資産になります。 コードは、また同じものが生成できます。でも「金額を文字列で保存して連結バグが出た。だから Number() で変換し、テストで固定した」という判断の流れは、記録しないと消えます。

記録する場所は、2つで足りる

記録する場所何を書くか
コミットメッセージ「何を・なぜ変えたか」を1行で。 GitとGitHubは別物 で入れた git をそのまま使う
作業ログ(メモ)AIに何を頼み、どう直させたか。プロンプトそのものを残すのが一番確実

コミットは、機能ごとに区切って残します。 「一気に全部」ではなく「add ができた」「連結バグを直した」「total を足した」と、判断の単位で刻みます。

bash
$ cd ~/kakeibo
$ git init
$ git add kakeibo.js
$ git commit -m "add: 支出を1件記録する(金額は数値で保存)"

$ git add kakeibo.js kakeibo.test.js
$ git commit -m "fix: 金額を Number() で変換。連結バグをテストで固定"

$ git add kakeibo.js
$ git commit -m "add: list と total を追加。fs.readJson の誤りは標準の JSON.parse に戻した"

3つ目のコミットメッセージに注目してください。 fs.readJson の誤りは…に戻した と、AIの間違いと、その判断まで残しています。 半年後の自分が git log を読んだとき、「ここは標準に無い関数をAIが提案してきた場所だ」と分かります。 これが再現性です。

作業ログには、プロンプトを残す

この記事そのものが、実は作業ログの見本です。 「こう頼んだら、こう返って、こう直した」を順番に書いてあるので、読者が同じ道をたどれます。

最低限、これだけメモしておけば再現できます。

題材: コマンドライン家計簿(add/list/total、支出のみ、JSON保存)
使ったAI: Claude(対話)
反復1: 金額が文字列で保存され合計が連結された → Number() で変換、テスト追加
反復2: fs.readJson(存在しない関数)を提案された → 標準の JSON.parse に戻した
判断: DB/画面/収入管理は「作らないもの」に入れて範囲を固定した

再現性とは、「あなたが同じ手順・同じ種類のプロンプトで、同じような結果に辿り着けること」です。 完成したコードだけを見せても、そこには辿り着けません。 頼み方と、直し方と、判断を残して初めて、他人(と未来の自分)が再現できます。

⑦ 何をAIに任せ、何を任せないか

最後に、この作品づくりで見えた線引きを、表にまとめます。 これはランキングではありません。 「どのAIが優秀か」ではなく、「AIという道具に、何を任せ、何を自分で持つか」の話です。

内容今回の例
任せてよい定型・繰り返しlist の表示ループ、似た形のコードの下書き
任せてよい調べもの・言語の作法「Node で引数を受け取る書き方」「JSONの読み書き」
任せてよいたたき台を速く出す最初の kakeibo.js の骨組み
任せない設計の最終判断「支出だけにする」「DBは使わない」——作らないものリスト
任せないセキュリティの要秘密情報を渡さない、.env を読ませない(前回の回)
任せない「なぜそうするか」の理解なぜ金額を数値にするのか、なぜテストで固定するのか

理解を飛ばすと、レビューができなくなります。 レビューできないと、AIの間違い(連結バグ・存在しない関数)に気づけません。 今回それに気づけたのは、コードを読める・動かせる・テストできるだけの理解が、これまでの回で積み上がっていたからです。

この線引きは、道具が変わっても動きません。 どのAIを使っても、「判断」と「理解」は手放せない——それが、この記事で1つの道具を最後まで使って分かったことです。

締めの1行です。 AIは学びを加速しますが、学びを肩代わりはしません。 速く書けるようになった分、読む・確かめる・判断する力が、これまで以上に要ります。 AIと組めるようになるとは、楽をすることではなく、その力を持つことです。

つまずいたところ

  • 「家計簿を作って」で出てきたものが、毎回違った。 ——設計を丸投げしていたのが原因。作らないものリストを先に書いたら、出力が安定した
  • 合計が 1200500 になった。 コマンドライン引数はすべて文字列なので、+ が足し算ではなく連結になっていた。Number() で変換し、Number.isFinite() で数字以外を弾いた
  • Number() の落とし穴。 Number("") は 0、Number("abc") は NaN。NaN は Number.isFinite() で弾けるが、空文字が 0 として通る点に注意。今回はカテゴリの前に金額が必須なので実害は出なかったが、total で 0円の行が混ざったら、この変換を疑う
  • fs.readJson is not a function で落ちた。 AIが存在しない標準関数を自信満々に提案していた。公式で fs を引いて確かめ、標準の JSON.parse に戻した。読んでいなければ気づけなかった
  • テストで require したら main() まで走った。 テストファイルが kakeibo.js を読み込んだ瞬間に本体が動いてしまった。if (require.main === module) main(); で「直接実行したときだけ動く」ようにして解決
  • 古い data.json が残っていて、直したのに合計が変なまま見えた。 文字列で保存された古いデータが混ざっていた。rm -f data.json で作り直してから確認した。「直したのに直らない」ときは、古いデータを疑う
  • 一度に頼みすぎて、差分が読み切れなくなった。 add/list/total を一括で頼んだら、返ってきたコードが長すぎて読む気が失せた。1コマンドずつ頼み直したら、1回分が数十行で収まり、最後まで目が届いた
  • 日本語のカテゴリ名で、表示がずれた。 全角文字は幅が2つ分なので、桁揃えが崩れた。今回は揃えない(作らないものに入れた)と割り切った。見た目より、数字が合っていることを優先した

後片づけ

この作品は、消しても、残しても、どちらでも構いません。 VMの中の1フォルダに収まっているので、環境を汚しません。

残す場合は、git で記録済みなので、そのまま次の題材の土台にできます。消す場合は、フォルダごと消せば元に戻ります。

bash
$ cd ~
$ # 残すなら何もしなくてよい。消すなら↓(消す前に中身を確認する)
$ ls kakeibo
$ rm -rf kakeibo

rm -rf は戻せません。 消す前に ls で場所を確かめる癖をつけてください。 秘密情報は一切含めていませんが、もし途中で .env などを作っていたら、Claude に渡していないか(貼り付けていないか)だけ、確認しておいてください。前回の回のとおりです。

まとめ — 理解できたこと

  • 「作って」だけの丸投げでは完成しない。 AIは発注先ではなく、速い相棒。向かう先を決めるのは自分
  • AIと組むには型がある。 対話で設計 → 小さく作らせる → 自分で読む → テストで確かめる → 直させる、を回す
  • 一度に大量を作らせない。 1回分の差分を、自分が最後まで読める大きさに保つ
  • 良いプロンプトには4要素(何を作るか・制約・入出力の例・使う言語)。渡すと、返ってくるものが安定する
  • 1回で完成しないのが普通。 最初の出力はたたき台。往復して仕上げる
  • 「動かない」を丸投げしない。 エラーと再現手順、そして自分の仮説を添えると、直る確率が上がる
  • AIの出力は仮説。 読んで・動かして・テストして、初めて採用する
  • AIは自信満々に嘘をつく(存在しない関数)。公式ドキュメントで裏を取る
  • テストは1本でいい。 一番大事な性質を1つ固定すれば、次の変更で壊れたら赤くなる
  • 最後は自分の手で動かす。 「コピペで動いた」で終わらせない
  • 記録に残すのは、コードより判断。 何を頼み・どう直し・なぜそうしたか。コミットメッセージと作業ログに残す
  • 判断と理解は、AIに任せない。 設計の最終決定、セキュリティの要、「なぜそうするか」は自分が持つ
  • 理解を飛ばすとレビューできなくなり、AIの間違いに気づけない
  • AIは学びを加速するが、学びを肩代わりはしない。 速く書ける分、読む・確かめる・判断する力が、これまで以上に要る

この記事は対話画面の Claude で進めましたが、同じ「設計を相談して小さく作らせ、差分を検証する」型を Claude Code で体系的に学びたい人向けの講座もあります。バイテックGEEKは Claude Code に特化したオンラインのコースで、環境構築から Skills・サブエージェント、MCP・API での業務自動化、品質・セキュリティまで5フェーズ44レッスンで学び、2ヶ月コースは一括 178,000円です(2026-11 時点の表示)。受講料は高額で、規約上クーリングオフは適用外、成果は保証しないと明記され、Claude Code 自体の利用には有料プランが別に要るので、この記事のように無料の対話画面で型を一周してから検討するのが現実的です。

参考リンク


次に読む

この記事は 【第8段階】深掘り の 14 / 30 本目です。

記事
← 前の記事AIが書いた差分は読まずに入れない — AIを開発に使う
→ 次の記事Electronは重くTauriは軽い — ブラウザの外へ

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

【番外編】AIと組んで開発する回の到達作品です。 Claude と一緒に小さなツールを作り、その過程を再現できる形で残します。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次