Skip to content
Berktug Berke Ates
Berktug Berke Ates

ソフトウェアエンジニア

ブログ

AI支援開発にはなお判断が要る

· 7分で読める

エンジニアリング責任を外注せずにコーディングエージェントを使う、規律あるワークフロー。

加速はボトルネックを変える

AIは実装オプション、テスト、移行、文書、調査を驚く速さで生み出せる。その速さはボトルネックをタイピングから判断へ移す。エンジニアは問題を定義し、制約を選び、もっともらしい誤りを認識し、結果がそれを所有するシステムに合うかを決めねばならない。

生成された変更は構文的に正しく、アーキテクチャ的に間違っていることがある。既存抽象を複製し、認可を迂回し、デプロイ制約を無視し、局所関数を最適化しつつプロダクト境界を弱めるかもしれない。リポジトリ理解が、コード生成とエンジニアリングの差であり続ける。

エージェントに有界な成果を与える

強いタスクは、ユーザーに見える成果、関連ファイルやモジュール、真であり続ける不変条件、成功の検証方法を記述する。すべての行を処方しつつ、無関係なリファクタへの拡大を防ぐ。

編集前に、ローカル規約、フレームワーク文書、現在の依存バージョンを検査しろ。AIシステムは歴史的パターンで訓練されている。急速に動くフレームワークはしばしば馴染みのAPIを無効にする。実際のリポジトリに仕事を接地させることは、儀式ではなく正しさの一部だ。

  • 譲れない振る舞いを述べる
  • 重要なテストと環境を名付ける
  • 無関係なユーザー変更を保つ
  • 逆転コストが高い決定では代替案を求める

diffを設計としてレビューする

生成された仕事を複数レベルでレビューしろ。ユーザーフローは筋が通るか?境界とデータ所有は明確か?失敗状態は扱われているか?リポジトリの言語で読みやすいか?その後、セキュリティ、アクセシビリティ、性能、運用振る舞いを検査しろ。

大きな生成diffはレビュー品質を下げる。あいだに検証を挟んだ小さく一貫した増分を好め。変更が機械的なら自動化は広くてよい。アーキテクチャ判断を含むなら、人が本当に理解できるほど表面をコンパクトに保て。

検証は任意ではない

静的解析、型チェック、テスト、本番ビルドを走れ。インターフェース作業では、関連ブレークポイントとインタラクション状態で実ブラウザ振る舞いを検査しろ。移行では前方実行と復旧の両方をテストしろ。APIでは、ハッピーパスだけでなく認可と不正入力を検証しろ。

AIはこの検証の設計を手伝えるが、責任を消すことはできない。テストスイートが弱ければ、生成された確信度も弱い。変更している振る舞いを守る、最小の高価値テストを足せ。

所有を人に保て

エンジニアが意図と結果に説明責任を持つとき、コーディングエージェントは強力な協力者だ。重要な決定を記録し、生成された依存を開示し、承認された境界なしに秘密や機微な本番データをツールに送るな。

耐久する優位は、より多くのコードを生むことではない。よく枠付けられた問題から検証済み成果への道を短くし、システムの一貫性を保つことだ。


2024年12月11日、Berktug Berke Ates が公開。