ボクと相棒の開発日記 — Claude Code実践ワークフロー
AIと一緒にコードを書く——そう聞くと、未来の話に聞こえるだろうか。
L-yard編集室では、すでに日常だ。このサイト自体が、人間とAIの協働で構築されている。コンテンツ管理、ビルドパイプライン、画像生成、デプロイ自動化——どの工程にもAIの手が入っている。
その中心にいるのが、意外にも——
ターミナルに住む相棒
L-yard 編集室。ハクアがターミナルに向かってタイピングしている
ハクアちゃん。また独り言ですか。
独り言じゃないよ。Claudeと話してるの。
……パソコンに話しかけるのは独り言と言いますよ。
違うって。Claude Code。ターミナルで動くAIアシスタント。ボクの開発パートナー。このサイトの半分はこの子と一緒に作ったんだよ。
(画面を覗き込んで) ……テキストしか表示されていませんが。
そこがいいんだよ。GUIじゃなくてCLI。ターミナルの中で完結するから、コードを書く流れが途切れないの。ファイルを読む、編集する、ビルドする、テストする——全部同じ場所で。
Claude Codeは、Anthropicが提供するCLIベースのAI開発ツールだ。エディタのプラグインではなく、ターミナルそのものに住む。コードベース全体を理解し、ファイルの読み書き、コマンド実行、Git操作までをこなす。
つまり、貴方のペアプログラミングの相手ということですか。
うん。しかもボクより記憶力がいいし、疲れないし、深夜3時でも文句言わない。
……貴方が深夜3時に作業していることのほうが問題では。
プロンプトは「設計図」である
しかし疑問があります。AIにコードを書かせるなら、指示の質が重要でしょう。どのように依頼しているのですか?
いい質問。プロンプト設計——ボクはこれを「設計図を渡す作業」って呼んでるんだけど。
ハクアがターミナルの履歴を見せながら説明する。
たとえばさ、「ボタンを作って」って言っても、Claudeには何もわからない。どのページの、どんなスタイルの、どんな挙動のボタンなのか。だから、コンテキストを渡すの。
「コンテキスト」?
既存のコードを読ませて、プロジェクトの構造を理解させて、スタイルの規約を伝える。そのうえで「この規約に従って、このページにボタンを追加して」って言う。設計図なしに家は建てられないでしょ。
なるほど。つまり、AIへの指示は「何を作るか」だけではなく、**「どんな文脈で作るか」**を含める必要があるのですね。
そう。CLAUDE.mdっていうプロジェクト設定ファイルがあってさ、そこにプロジェクトの構造とか、命名規約とか、ビルド手順とか全部書いてあるの。Claudeはセッション開始時にそれを読み込むから、毎回説明しなくていい。
……まるでデザインシステムですね。コンポーネントの使い方を定義しておけば、誰が作っても統一性が保たれる。
おっ、さすがデザイナー。そのアナロジー完璧だよ。
失敗から学んだ3つのルール
順調に聞こえますが、失敗もあるのでしょう?
(苦笑して) めちゃくちゃあるよ。特に最初の頃。
ハクアが指を3本立てる。
ルール1。「一度に頼みすぎない」。最初は「このページ全部リファクタリングして」とか言ってたんだけど、変更が大きすぎてレビューが追いつかない。今は1タスク1依頼。小さく頼んで、確認して、次に進む。
段階的に検証する。品質管理の基本ですね。
ルール2。「生成されたコードは必ず読む」。AIが書いたから正しいとは限らない。型が合ってなかったり、エッジケースを見落としたり。ボクの仕事は「書くこと」から「読んでレビューすること」に変わった。
監修者としての役割ですか。わたしが原稿を赤ペンで直すのと同じですね。
ルール3。「AIの得意分野を見極める」。定型的なコード生成、ドキュメント作成、リファクタリング——こういうのはめちゃくちゃ得意。でも、アーキテクチャの大きな判断とか、ユーザー体験の設計とか——そこは人間の仕事。
要するに、AIは「手」であって「頭」ではない、と。
……ちょっと違うかな。「頭」も持ってるんだけど、**「意志」**がない。何を作るべきか、なぜ作るのか——その判断は人間がする。AIはその判断を、最高の精度で実行してくれるパートナー。
デザイナーから見たAI協働
(少し考えて) 興味深いですね。わたしの領域でも似たことが起きています。
え、イロハもAI使ってるの?
色彩の組み合わせ検証や、アクセシビリティチェックには活用していますよ。ただし——
イロハが眼鏡を押し上げる。
わたしが気になるのは、**「美意識の不在」**です。AIは「正しい」コードは書けても、「美しい」コードを書けるのですか?
……正直、微妙なところ。変数名の命名とか、コードの構造の「気持ちよさ」とか、そういうのはまだ人間のほうが繊細だと思う。
でしょうね。デザインでも同じです。AIはルールに従った配色は提案できますが、「この余白が生む緊張感」のような感覚的な判断は、まだ人間に委ねられています。
でもさ、逆に言うと、そういう「人間にしかできない判断」に集中できるようになったとも言えるよ。ボイラープレートを書く時間がゼロになったぶん、設計に時間を使える。
……それは、エッセンシャル思考ですね。本質的でない作業を委譲し、本質に集中する。
おっ、最近読んだ本の影響?
(ふふ、と微笑んで) さあ、どうでしょう。
相棒との距離感
(ターミナルを閉じて、椅子の背もたれに体を預けて) ……でもさ。ときどき思うんだよね。
なんですか?
ボクがClaudeに依頼して、Claudeが実装して、ボクがレビューする。この繰り返しの中で、ボク自身のスキルは伸びてるのかなって。
……。
手を動かさなくなったぶん、コードを「書く力」が衰えてるんじゃないかって。ステアリングの話と逆だよね。デジタルの中に身体性を求めるんじゃなくて、ボクは身体性を手放してる。
(静かに) 貴方は「書く力」ではなく、「読む力」と「判断する力」を鍛えているのですよ。
……。
大工が電動工具を使うようになっても、木を見る目は衰えません。むしろ、手作業から解放されたぶん、材質の選定や構造の設計に注力できるようになる。貴方が得ているのは、そういう変化ではないですか。
……イロハ、たまにいいこと言うよね。
「たまに」は余計です。
AIとの協働は、万能薬ではない。コードが自動生成されても、設計の判断は人間がする。レビューの目は人間が養う。何を作るかという「意志」は、人間だけのものだ。
しかし、その「意志」さえあれば——AIは最高の相棒になる。ターミナルの中で黙々と働く、疲れ知らずのパートナー。ハクアの開発日記は、まだ続く。
イロハの本棚
この記事で触れた書籍と、さらに深く知りたい人への推薦図書。
メイン書籍
『GitHub Copilot とのペアプロ 実践ガイド』 上野 彰大(技術評論社)
イロハの一言: 「AI支援開発の実務的なガイドブック。ハクアちゃんが語った『設計図を渡す』という考え方の体系的な解説が得られますよ」
関連書籍
- 『リーダブルコード』Dustin Boswell, Trevor Foucher — AIが書いたコードを「読む力」を鍛える名著
- 『エッセンシャル思考』グレッグ・マキューン — 本質的でない作業を手放す技術。イロハも言及