AIソフトウェア開発における最低限の知識
AIはツールです。アーキテクチャやエンジニアリングに関するあなたの知識に取って代わるものではありません。
意思決定をAIに丸投げするのはやめましょう。機能要件と非機能要件のすべてを、あなた自身が定義しなければなりません。あらゆる詳細について具体的に記述してください。
タダより高いものはありません。無料または安価なモデルは、プロフェッショナル級のモデルに及びません。ソフトウェアエンジニアリングには、高い推論能力を持つOpusやGPTを使用してください。低品質なモデルは手戻りを増やします。これは、あなた自身とレビュアーの時間の無駄につながります。
AIエージェントはローカルマシンで使用しましょう。実行環境（harness）が重要です。GPTにはCodexを、OpusにはClaude Codeを使用してください。たとえ同じモデルであっても、実行環境が不十分であれば結果も不十分なものになります。
安価なプランはアマチュア向けのプロジェクトには適していますが、プロフェッショナルなプロジェクトには、最高峰のモデルへのアクセスと高い利用制限を備えたプランが必要です。
すべてのプロジェクトにCLAUDE.mdまたはAGENTS.mdファイルが必要です。簡潔かつ客観的に保ってください。言語は英語で記述してください。プロジェクトの重要な情報のみを含めます。
すぐにコードを実装してはいけません。以下のプロセスに従ってください：
- 問題を分析する。
- プランを作成する。
- プランをレビューする。
- コードを実装する。
プランには、アーキテクチャ、受け入れ条件、テスト、およびフィードバックループを含める必要があります。
自分のプランを疑ってください。コードを書く前にすべてをレビューしましょう。AIに対して、欠陥を見つけ出し、自分の決定に異議を唱えるよう求めてください。AIが失敗するとすれば、それはあなたのプランが悪い時だけであるべきです。
批判的思考（クリティカルシンキング）を養ってください。AIは実行速度を上げますが、判断力やエンジニアリング上の決定に取って代わるものではありません。
役割を変えてください。単なるタスクの実装者になるのをやめましょう。アーキテクト、テックリード、そしてプロダクトオーナーとして振る舞ってください。システム全体について考えるのです。
コンテキストがすべてです。プロンプト一つでは不十分です。ビジネスルール、アーキテクチャ、規約、および制約事項を提供してください。
常に自動的に検証してください。すべてのサイクルは、ビルド、テスト、リンター、および静的解析で終了しなければなりません。
「動くから」という理由だけでコードを受け入れてはいけません。可読性、シンプルさ、セキュリティ、および保守性を要求してください。
スキルを活用して、社内のプロンプトを標準化しましょう。これにより、指示を繰り返すことなく、すべてのプロジェクトにおいて品質とアーキテクチャを維持できます。
もしプランニングやテストが過剰な負担だと感じるなら、ソフトウェア開発にAIを使わないでください。低品質なコードと技術的負債を生み出すことになります。
責任はあなたにあります。本番環境にあるすべてのコードに対して、あなたには責任があります。AIやツールのせいにしないでください。会社はあなたに結果を求めているのです。
出典: https://dev.to/andredarcie/o-minimo-que-voce-precisa-saber-para