Claude Codeを半年使って気づいた「振り返り不足」の穴
Claude Codeを使い始めて半年が経つ。サイト構築の実装速度は確実に上がったが、同時に「なぜこの実装になったのか」を説明できない場面が増えていた。
転機は2週間前。新しいページのレイアウトが崩れているのに気づかず、公開後に修正する羽目になった。原因はClaude Codeが提案したCSSの詳細を確認せず、そのまま反映させていたことだった。
「AIが出したコードは正しいはず」という前提で動いていた自分に気づいた。そこで始めたのが実行履歴の朝レビューだ。
毎朝10分、前日の実行ログを眺める習慣
朝のルーティンに「前日のClaude Code実行履歴を10分眺める」時間を追加した。見るのは次の3点だ。
-
どのファイルをどう変更したか
変更差分を目で追う。特にCSSとTypeScriptは、提案内容を理解せず反映していた箇所が多かった。 -
エラーが出た回数と内容
同じエラーを3回以上繰り返している場合、プロンプトの指示が曖昧だった証拠。指示の出し方を見直す。 -
実装の選択肢が複数あったか
Claude Codeは「こういう方法もあります」と代替案を出すことがある。その場合、なぜ最終的にその実装を選んだのかを言語化しておく。
最初は「面倒だな」と思ったが、2週間続けると明確な変化があった。「AIに任せてよい作業」と「人間が判断すべき境界」が見えてきた。
ログから読み取れる3つの判断境界線
実行履歴を眺める習慣を続けた結果、次の3つの境界線が浮かび上がった。
① 定型作業はAIに完全委任してよい
記事の自動投稿スクリプト、画像最適化、リンクチェックなどの定型的な処理は、Claude Codeに任せても問題が起きにくい。ログを見ると、これらの実装では一度もエラーが出ていなかった。
判断基準は「入力と出力が明確で、変動要素が少ない作業」かどうか。この範囲であれば、AIに任せる判断は速くなった。
② レイアウト・デザインは人間の目で最終確認が必須
CSSの調整、レスポンシブ対応、色の選択など、見た目に関わる実装は、Claude Codeの提案をそのまま反映すると意図しない結果になることが多かった。
ログを見返すと、CSSの変更は「一度実装→確認→微調整→再確認」のサイクルを3〜4回繰り返していた。この領域は、AIに提案させた後、必ず人間の目で確認する工程が要る。
③ ビジネスロジックは「なぜそうするか」を言語化してから実装
記事の自動生成ロジック、カテゴリの振り分け条件、投稿タイミングの判定など、事業の判断を含む実装は、Claude Codeに任せる前に「なぜその条件にするのか」を言語化しておく必要があった。
ログを見ると、ロジック系の実装は「一度動いた後に仕様変更」のパターンが多かった。事前に判断基準を明文化していれば、実装の手戻りは減らせる。
「振り返り10分」がAI開発の精度を上げる
実行履歴を眺める習慣を始めてから、同じミスを繰り返す頻度が明らかに減った。AIに任せる範囲と、人間が判断すべき境界が見えてきたことで、実装判断が速くなった。
朝の10分は、AIとの協働において「何を任せてよいか」を自分の中で整理する時間になっている。ログは「AIが何をしたか」の記録であると同時に、「自分がどう判断したか」の記録でもある。
Claude Codeを使い続けるなら、実行履歴を定期的に振り返る習慣は、AIに振り回されないための仕組みとして機能する。
参考
- Claude Code公式ドキュメント: https://docs.anthropic.com/
- GitHub Actions 公式ドキュメント: https://docs.github.com/actions
- Astro 公式サイト: https://astro.build/
関連記事
- 38歳が司令塔役を兼任して精度事故を3回出してから作り直した役割分離設計:判断する人と手を動かす人を一人でも分ける
- 38歳が Claude Code で3日分の作業を3時間で終わらせてから気づいた「速すぎる問題」の解決策3つ:成果の出現速度を受け手の期待値に合わせて調整する
- 38歳が『達人プログラマー(第2版)』を読んでClaude Code運用に組み込んだDRY原則3段階:「何を書かないか」の判断軸を設計する
まとめて読む: AI活用・自動化