AIでプロジェクトを過剰設計する方法

この記事は、著者が早まった仮定に基づいて小さなウェブサイトの再構築プロジェクトを過度に複雑化した話です。話は著者の隣人が経営する理学療法ビジネスのウェブサイトに問題があり、元の開発者にコードを人質に取られているところから始まります。著者は自分は専門のウェブ開発者ではないが、AIを使えば簡単にサイトを複製できると考えました。著者は元のサイトのファイルをダウンロードし、シンプルな構造（HTMLページと画像ファイルのみ）であることを確認しました。しかし、詳細を確認せずに、元のコードは混乱していると決めつけ、AIを使ってゼロから再構築するのが最善の方法だと判断しました。Claude CodeとAgent Skillsフレームワークを選択し、仕様駆動開発を採用しました。/interview-meスキルで要件を収集し、/specで32ページの詳細な仕様を作成し、/planで7ステップの計画を立てました。しかし、AIが生成した最初のドラフトはナビゲーションバーが乱れ、スタイルが一致しませんでした。著者は20以上のスクリーンショットを提供して修正を指示し、最終的にClaudeにMacBookのスクリーンショットツールを使って自己検証させることで改善しました。丸一日かけてサイトはほぼ完成し、翌朝に最終調整を終えました。完成後、ブログ記事を書くために元のファイルを確認したところ、元のサイトも各ページにHTMLファイルがあり、CSSとJavaScriptがHTML内に埋め込まれているだけで、再構築版と構造がほぼ同一であることに気づきました。著者は、画像をassetsフォルダに整理し、再利用可能なCSSスタイルを作成したことが主な改善点でしたが、その程度で済むなら、単にファイル構造を整理するだけで20分で終わる作業だったと悟りました。この経験から、既存のコードを十分に評価せずに仮定に基づいて行動することの危険性を学びました。