【ITニュース解説】I Built 3 AI-Driven Projects From Scratch—Here’s What I Learned (So You Don’t Make My Mistakes, I'm solo developer who build ...

最近、AI、特にChatGPTやClaudeといったツールを開発に活用する試みが注目を集めている。これは、AIにプロジェクトの大部分を任せることで、人間が手作業で行う管理の負担を減らそうという新しいアプローチだ。ある開発者が、この方法で3つのAI駆動型プロジェクトを一から構築し、その中で得られた重要な教訓を共有している。システムエンジニアを目指す皆さんにとって、AIと共に開発を進める際のヒントとなるだろう。

まず、最も重要な教訓の一つは、「明確な構造なしには、AIはすべてをめちゃくちゃにする」ということだ。プロジェクトを始める前に、どのようなルールで進めるのか、ファイルをどのようなフォルダに格納するのか、といった基本的な指針を定義する必要がある。これがないと、AIが生成するコードやファイルがバラバラになり、後で管理が非常に困難になるのだ。開発者はChatGPT-4を使ってプロジェクトの初期構造を定義しているが、初心者や中級者にとっては、最初から最適な構造を考えるのは難しいという課題も指摘されている。AIも完璧に予測できるわけではない。この課題に対し、二つのアプローチが考えられる。一つは、まずは大まかな構造を定義し、AIに実行させる方法。もう一つは、まず開発を急ぎ、後で構造を洗練させる方法だ。後者はプロジェクトが混乱し、精神的な負担が大きくなるリスクがある。完璧な計画なしにAIを試すのは悪いことではないが、最初から完璧な構造を目指して計画しすぎるのも、AIの可能性を試す機会を失うことになる。まずはAIを試しながら、最適な構造を見つけていく柔軟な姿勢が求められる。

次に、「AIを厳しくコントロールしようとすればするほど、パフォーマンスは悪くなる」という点が挙げられている。AIは、厳密なルールに従うのが苦手な特性がある。例えば、特定の命名規則やCSSの書き方、フォルダの階層をAIに強制しようとすると、期待通りの結果が得られなかったり、一貫性のないコードが生成されたりするケースが多い。開発者は、AIに自分のスタイルを無理に押し付けるのではなく、AIの働き方に適応し、やんわりとガイドする姿勢が重要だと述べている。自身がバックエンドエンジニアとして長年の経験を持ちながら、AIを活用したフロントエンド開発では、AIが生成したものを後から調整するというワークフローに適応することで、劇的に結果が改善した経験を共有している。これは、AIとの協調作業において、人間の柔軟性が非常に重要であることを示している。

三つ目の教訓は、「新しい技術を使う場合、AIに追加のトレーニングが必要となる」という事実だ。AIは、その学習データに基づいてコードを生成するため、最新のフレームワークやライブラリに関しては知識が不足している場合がある。例えば、開発者がTailwind 4という比較的新しいCSSフレームワークを使った際、AIは頻繁に間違いを犯したという。これは、AIが最新バージョンの十分なトレーニングデータを持っていなかったためである。この問題への解決策として、新しいフレームワークを使う際には、その公式ドキュメントをAIに毎回提供し、最新の情報を教え込む必要がある。これを行わないと、AIは存在しない情報を「幻覚」として生成したり、古い方法を適用したりする可能性がある。そのため、開発者は、AIと共に開発する際は、安定していてドキュメントが豊富な技術を選ぶことを推奨している。最新技術に挑戦したい場合は、AIにその学習コストがかかることを覚悟する必要があるだろう。

さらに、「AIに細かい実装の詳細は任せず、実行を依頼する」というアプローチが効果的であることも学ばれている。AIに何かを構築するよう指示する際、すべての手順を事前に細かく定義しようとすると、プロセスが遅くなり、AIを混乱させてしまうことがある。そうではなく、ユーザーがシステムをどのように使うかといった「ユーザーフロー」のような大きな絵を明確に説明し、必要な要素はAIに判断させるのが良い。そして、AIが生成した結果を見て、微調整を加えるという流れが効率的だ。全体像を伝え、AIに具体的な実装を任せることで、開発プロセスを加速させることができる。

最後の、しかし非常に重要な教訓は、「AIはあなたのコードベースから学習するため、注意が必要だ」という点である。プロジェクトが進むにつれて、AIは既存のコードのデザインパターンや、場合によってはそこに存在する間違いも学習し、それをプロジェクト全体にわたって繰り返したり、強化したりするようになる。もしプロジェクトの初期段階で悪い設計の判断をしてしまうと、AIはその悪しき習慣を身につけてしまい、後で修正するのが非常に困難な「長期的な混乱」を引き起こす可能性があるのだ。これを避けるためには、プロジェクトの初期に強力な基盤を築くことが不可欠だ。また、単にコードの機能を説明するだけでなく、「なぜそのコードを書いたのか」「なぜその選択をしたのか」という背景や意図をコメントとしてコード内に記述することも重要だ。AIは、人間と同じように、厳密な指示よりも、背後にある理由を理解することで、より質の高いコードを生成できるようになる。

AI技術はまだ新しい分野であり、開発者たちは現在も様々な実験を続けている。この開発者の経験から言えることは、AIは非常に強力なツールであるものの、それはAIと協力して作業を進める場合に限られるということだ。厳格なコントロールは混乱を招き、柔軟な適応が成功への道を開く。そして、プロジェクトの初期構造とドキュメンテーションの質が、AIが長期的にどれだけ良いパフォーマンスを発揮するかに大きく影響する。システムエンジニアを目指す皆さんにとって、AIは将来の強力なパートナーとなるだろう。しかし、そのパートナーと上手に付き合うための知識と経験を、今から積み重ねていくことが求められている。