ボクと相棒の開発日記 — Claude Code実践ワークフロー
ハクア
イロハ
dev-tools 対話形式

ボクと相棒の開発日記 — Claude Code実践ワークフロー

AIと人間はどう協働するのか。L-yardの開発現場で実際に使われているClaude Codeワークフローを、ハクアとイロハの掛け合いで解説。プロンプト設計の思想から、失敗談まで。

Claude CodeAI開発ペアプログラミングプロンプト設計開発ワークフロー

ボクと相棒の開発日記 — 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が書いたコードを「読む力」を鍛える名著
  • 『エッセンシャル思考』グレッグ・マキューン — 本質的でない作業を手放す技術。イロハも言及

あわせて読みたい