# アーキテクチャを失わずにAIコーディングツールを使う

速度が無料なのは、システム境界が意図的なままのときだけだ。

Published: 2024-11-05

## オートコンプリートではなく制約から始める

AIコーディングツールは、タスクが有界なときに優れる：このインターフェースを実装、このテストを追加、この呼び出し箇所を移行。リポジトリがまだ表現していないアーキテクチャの発明を求められると苦しむ。まず不変条件を与えろ——所有境界、命名規約、エラーモデル、禁止された近道。

フレーミングの責任はエンジニアにある。曖昧なプロンプトは、既存モジュールを静かに複製したり共有ユーティリティを迂回したりする、もっともらしいコードを生む。

## 生成された変更をアーキテクチャとしてレビューする

構文の先を見ろ。変更はモジュール境界を尊重するか？新しい永続化経路を導入するか？認可と失敗を扱うか？大きな生成diffは斜め読みを招く。人が本当に理解できる小さなコミットを求めろ。

逆転コストが高い決定では、ツールに代替案を求めろ。初稿を受け入れるより、二つのアプローチを比較する方がしばしば価値が高い。

- 目視で検証できない振る舞いにテストを要求する
- 新しいヘルパーを足す前に既存を探す
- 秘密と本番データをプロンプトから外す
- 汎用フレームワークの伝承よりリポジトリ文書を好む

## フィードバックループを守れ

型チェック、lint規則、契約テスト、プレビュー環境こそが、高速生成を安全にする。スイートが弱ければ、AIは未検証の複雑さをより速く生み出す助けになるだけだ。

節約した時間の一部を、より良いフィクスチャ、明確なモジュールREADME、好ましいパターン例に投資しろ。それらの成果物は人とAIの両方の貢献者を改善する。

## センスをループに残せ

アーキテクチャは制約下で蓄積されたセンスだ。AIは実装を提案できるが、プロダクトの未来を所有できない。検証済みの仕事を加速するためにツールを使い、システムが何になるべきかの判断を外注するな。

AIコーディングツールで成功するチームは境界に厳格だ。レールが明確だからコードが速く動く。