未来を形作るテクノロジーの深掘り記事。

開発者とアーキテクト:どちらが活きる場面か

開発者かアーキテクトかは肩書きの話ではなく、設計判断を誰が持つかの話です。ADR、結合度、可逆性の観点から考えます。

左右に分かれる光の道を配したデスクのイラスト。片方は絡まり、もう片方は整然としている。
タイピングは速くなった。判断こそが今の仕事だ。

先月、ブラウザ拡張機能の新規インストールを記録するために、AIコーディングアシスタントが try/catch を連ねたコードを書いた差分をレビューしました。最初にユーザーのメールアドレスを取得しようとし、失敗したらユーザーIDにフォールバックします。それも失敗すると、「インストールはあったが誰かは不明」という、なんとも言えないログを残すのです。コードは動きます。でも間違っていました。プラットフォームが最近、アドオンが要求できるID情報を厳しく制限していたからです。開発者とアーキテクトの違いは、まさにこういう差分に潜んでいます。そして、今の自分がどちら側にいるのかを教えてくれる人は誰もいません。

正解はより良い catch ブロックではありませんでした。タイムスタンプを記録し、ウェルカム画面を出し、マーケティングチームには「ユーザーが後から自分から提供しない限り、インストール時点ではメールアドレスは取得できない」と伝えることでした。この判断はモデルにはできません。モデルはあなたのユーザー、プラットフォームのポリシー、マーケチームの四半期目標を知らないからです。モデルは頼まれたことを、恐ろしい速さで実行するだけです。つまり、頼んでいる側、つまりあなたが、単なるコードより大きなものに責任を負うことになったのです。昇進おめでとうございます。誰も教えてくれなくてごめんなさい。

もっともな反論もあります。優れたチームでは、どこでも要件に異を唱え、担当チケットのデータモデルを設計するのが当たり前だった、と言うエンジニアは多いでしょう。確かにそれは昔から良いチームの仕事でした。ただ、本当に変わったこともあります。以前はタイピングの速さが、悪いアイデアに対する自然なブレーキになっていました。拙い計画を実装するのに3日かかるなら、人は先に考えます。しかし90秒で作れてしまうと、誰も考える前に計画がコードになってしまいます。アーキテクチャ的思考を強いていた摩擦は消えました。そして、その代わりになるものは、あなたしかいないのです。

開発者とアーキテクト:まったく別の仕事

違いを一番すっきり言うならこうです。開発者はチケットを受け取ってどうやるかを問います。アーキテクトは同じチケットを見てそもそも作るべきか、作るならどんな形にするかを問います。開発者は制約の中で最適化します。アーキテクトは制約そのものを選び、しかもその選択が次の2年にもたらす結果に責任を持ちます。どちらも立派なエンジニアリングです。ただ、仕事の種類が違い、失敗の仕方も違います。開発者の失敗はバグです。アーキテクトの失敗は、誰かが気づく頃には3つのチームがその上に構築してしまった、冗長なテーブルだらけのデータモデルです。

AIコーディングツールは、いつの間にか開発者の席に座っていました。これまで雇った中で最速のジュニアのようなものです。疲れを知らず、流暢で、要件そのものが問題かもしれないと指摘することは決してしません。インストールごとのログを頼めば、プラットフォームが望んでいなくても「動く」ように、フォールバックを重ねたインストールごとのログが返ってきます。モデルはあなたのアプリのレイテンシ予算も、プライバシーの姿勢も、オンコール体制も気にしません。それはツールの欠陥ではなく、そのツールが座った席の職務記述書です。だからこそ、「それは違う」と言える席は、あなたが座らない限り空いたままなのです。

では、その席に座るとは実際にどういうことか。主に三つです。要件がユーザーの利益と矛盾しているときに気づけるほど、ユーザーを理解すること。一行の変更がどこまで影響するかが見えるほど、システムの結合度を理解すること。そして、コードが書かれる前に、要件を書いた相手と気まずい会話をする覚悟を持つことです。誰も読まないwikiに箱と矢印の図を描くことは、どれも含みません。すべて、「いつも反論しないツール」には委ねられない判断力が必要なのです。

すでに下している設計判断

肩書きがなくても、設計判断は毎週、普通のチケットの中で下しています。バリデーションをどこに置くか(クライアント、API、データベース)。呼び出しを同期にするかキューに入れるか。何をログに残し、何を意図的に残さないか。新しいテーブルの形と、どのテーブルへ外部キーを張るか。どれも未来への賭けであり、その後の十件のチケットを制約することも可能にすることもあります。インストールログの差分は監視タスクに見えました。実際にはプライバシーの判断であり、セキュリティの判断であり、そしてプロダクトの判断が一行のコードの衣装を着ていたのです。

ここで、「インストールしたユーザーをログに残す」を忠実に実装した、アシスタントの修正前のコードを示します。

async function logInstall(req, res) {
let identity = null;
try {
identity = { email: await getUserEmail(req) };
} catch {
try {
identity = { userId: await getUserId(req) };
} catch {
identity = { note: "install without identity" };
}
}
await db.installs.insert({ ...identity, at: new Date() });
res.redirect("/welcome");
}

15行、失敗パターンは3つ、そして「メールかユーザーIDか、どちらもないか」を永遠に受け入れるスキーマ。フォールバックのそれぞれが、インストール処理をIDのAPIに密かに結合させています。そのため、同意管理されたサービスの障害が、オンボーディングのファネルを遅らせたり壊したりしかねません。さらに「誰かがインストールしたが、誰かは不明」という行は、分析の観点ではほぼ役に立ちません。マーケティングが実行できることは何も教えてくれないのです。要件は文字通りには満たされ、その趣旨は裏切られていました。

async function logInstall(req, res) {
await db.installs.insert({ at: new Date() });
res.redirect("/welcome");
// Email is collected on the welcome screen, with consent,
// posted asynchronously — and never gates the install path.
}

修正後は4行です。ただ、変わったのはコードではなく、要件だという点に注目してください。目的は一度も「メールアドレスを取得すること」ではありませんでした。「インストールを計測し、新規ユーザーにフォローアップすること」だったのです。タイムスタンプはインストールを計測します。ユーザーがすでに同意の画面を見ているウェルカム画面こそ、メールアドレスを非同期に尋ねるのにふさわしい場所であり、そこで失敗しても何のコストもかかりません。アーキテクトのやったことは、コードを少なく書くことではありませんでした。コードの目的を交渉し直すことだったのです。

身につける価値のある習慣があります。自明でない変更の前には、二分間の結合度の棚卸しをしてください。このコードが何を呼び出すのか、何がこれを呼び出すのか、そして各依存先が遅延したり、停止したり、非推奨になったりしたとき何が壊れるのかを問います。修正前のバージョンでは、インストール処理が本来知るべきでない二つのIDサービスに依存していました。修正後は、一つのテーブルにしか依存しません。将来のインシデントを予測する数字は、行数でも循環的複雑度でもなく、この依存数です。同じパターンはAIコーディングアシスタントが予測可能でテスト可能な形で失敗する仕方にも見られます。出力は局所的にはもっともらしいのに、全体としては密結合になっているのです。

ADRと暗黙知:それぞれが勝つとき

Architecture Decision Record(ADR)は、あえて地味なものです。文脈、決定、検討した代替案、受け入れた結果を書いた1ページ。それだけです。儀式もなく、必要でなければ承認フローもありません。ADRがあると便利なものから、AIの時代には必須のものへと変わった理由は記憶です。モデルには記憶がありません。半年後、誰かがアシスタントにインストールモジュールを指して変更を頼んだとき、同意とプラットフォームポリシーについての慎重な検討は消えてしまいます。人間とツールの両方が見つけられる場所に書かれていなければ、なおさらです。リポジトリ内のADRは、次にそのコードに触れる人(あるいは何か)が必ず読むものになります。

暗黙知が確かに勝つ場面もあり、それを無視することがADRを官僚的だと思わせてきた原因です。寿命が数週間の試作を作る二人のチームには、決定記録は要りません。意思決定者は隣に座っていて、どうせコードは書き直されるからです。そのくらいの規模なら、口頭の文脈の方が速く、豊かで、安上がりです。問題は、チームが境界を越えたことに気づきにくいという点です。最初の新人が入ったとき、最初にそのAPIを使うチームが現れたとき、「なぜこうしたのか?」に答えが存在しなくなったインシデントが起きたとき。その瞬間を越えているのです。

  • 決定の取り消しコストが高い。稼働中のデータに対するスキーマ変更、公開APIの契約、ベンダーロックインなど。
  • 決定がチームの境界をまたぐため、影響を受ける人が決定の場にいない。
  • 将来の問いがすでに聞こえる。「なぜわざわざこうしたのか?」
  • AIツールが実装を生成したため、人間が推論を言葉にする必要がなかった。
  • トレードオフが自明ではなく、実際のコスト(レイテンシ、プライバシーの露出面、運用負荷)をあえて受け入れている。

四つ目の項目こそ新しいものです。人間がコードを書くとき、推論はコミットメッセージ、PRでの議論、試行錯誤の形などに痕跡を残します。アシスタントがコードを書くと、推論は一時的にあなたの頭の中にだけ存在し、その後はどこにも残りません。ADRは、レビューを成立させる成果物です。レビュアーがコードを照らし合わせて確認できるものを与えてくれるからです。ADRがなければ、レビューは体裁の指摘に堕し、その間にアーキテクチャは静かにずれていきます。

手描きの箱と矢印の図と万年筆が、柔らかい窓の光に照らされたノート。
ADRは、差分が忘れ去られたあとも残る1ページです。

システム設計における可逆な決定と不可逆な決定

アーキテクトの道具箱の中で最も役に立つ問いはこれです。考えを変えるのにどれくらいコストがかかるか? 一方通行ではない扉の決定もあります。ログのフォーマット、内部関数のシグネチャ、キャッシュのTTLなどは、どれも午後一つあれば元に戻せます。一方で、一方通行の扉もあります。外部クライアントが組み込んでいる公開APIの契約、半年分の本番データが蓄積されたデータベーススキーマ、法的な立場がその上に成り立っている同意フローなどです。一度その扉をくぐると、見直しのコストはリファクタリングではなく、マイグレーション、非推奨化のスケジュール、そして謝罪になります。

作る前に扉の種類を分類しましょう。AIによって作ることは安くなりましたが、取り消すことの高さは相変わらずだからです。制約なしに任せると、アシスタントは喜んであなたのデータモデルを設計してくれます。その失敗パターンは、冗長なテーブル、重複したカラム、そしてマイグレーションコードの上に積み重なるマイグレーションコードです。プロンプトのたびに、モデルを見直すのではなくテーブルが1つ増えていくからです。稼働中のデータを持ち、3つのサービスが読んでいるテーブルを削除するのは、業界で最もつらい作業の一つです。スキーマを安く生成できるからこそ、スキーマには高い熟考が必要なのです。熟考に使う予算は、コードを書くのにかかる時間ではなく、取り消せなさに比例させてください。その比率はすでに逆転しています。

私の運用ルールはこうです。決定が、再作成できないデータ、またはチーム外の人が依存するインターフェースに関わるなら、実装の前にADRを書き、もう一人の目でレビューしてもらう。それ以外は出荷して改善を続けます。このルールは、個人プロジェクトからプラットフォームチームまで、手を加えずに通用します。速く進むことと、どこにも戻れない方向に速く進むことの違いはここにあります。

アーキテクトとして要件に異を唱える

アーキテクトの仕事の居心地の悪い核心は、自分より立場が上の人にノーと言うことです。「インストールしたユーザーをログに残す」は要件に聞こえましたが、実際には「インストールを計測し、新規ユーザーにフォローアップする」という目的に対して、誰かが事前に思い描いた解決策にすぎませんでした。アーキテクトは解決策を目的に翻訳し直し、その目的へのより安いルートを提示します。その翻訳こそが仕事の核心で、ツールにはそれができません。ツールの設計そのものが、従うことだからです。アシスタントにユーザーの文脈を与えて、まずまずの判断を引き出すエンジニアもいます。それは周辺では役立ちます。しかしモデルは、会議室に入って「インストール時点ではフォローアップのメールは送れない」とマーケティングに告げることはしないのです。

  1. 解決策ではなく目的を言い直す。「インストールを計測し、新規ユーザーにリーチしたい」。
  2. より安いルートと、それがもたらすものを提示する。タイムスタンプのログでインストールは完璧に計測できる。
  3. 高くつくルートの実際のコストを挙げる。同意の摩擦、結合されたインストール処理、マーケティングが使えない行。
  4. 現実的な選択肢を与える。「メールが重要なら、ウェルカム画面で尋ねる。その1日版はこうなります」。
  5. 決まったことは書き残す。次の人が一からやり直さないように。

では、正直な反論にも目を向けましょう。誰も昇進していません。もっとありそうなのは、モデルが下した決定の責任を押し付けられる役割に、同じ給料で、楽しい部分は減ったまま就いているということです。それが間違いだとは思いません。だからこそ、ドキュメントの習慣をスキップせず、真剣に取り組む理由になると考えています。ADRの履歴は紙の記録でもあります。決定した人間であることが責任になるのは、推論を示せないときだけです。「プラットフォームが識別情報を制限しているため、メール取得よりタイムスタンプを選んだ」と書き残した人は守られます。アシスタントの出力を何でもマージした人は守られません。

開発者とアーキテクト:それぞれが勝つとき

これはランキングではなく、モードの切り替えです。大事なのは、目の前の仕事がどちらのモードを必要としているかを知ることです。私のバックログから具体的な例を挙げます。

  • 仕様が明確なバグ修正で、影響範囲が分かっている場合:開発者モードが勝ちます。再現し、修正し、テストして、出荷する。ここで設計を考え込むのは、スーツを着て先延ばしにしているだけです。
  • 需要を検証するプロトタイプ:開発者モード。うまくいけば書き直され、だめなら削除されます。使い捨てのコードにADRを書くのは無駄です。
  • 要件があいまいなグリーンフィールドの機能:まず、たとえ1時間だけでもアーキテクトモード。あいまいさの中でこそ、AIが生んだ勢いが最も害を及ぼします。
  • お金、識別情報、同意に関わるもの:例外なくアーキテクトモード。作ることと取り消すことのコストの非対称性が、ここで最も悪化します。
  • 稼働中のデータへのスキーマ変更、または公開APIの変更:可逆性のルールに従い、ADRを付けてアーキテクトモード。
  • 二人のチームで、コードベースが生まれて半年未満:実行中のメモファイルを持った開発者モード。まだ本格的な儀式は何も得られません。
  • 規制の対象となる領域や、複数のチームが利用する場合:記録を伴うアーキテクトモード。「なぜ」を尋ねるのは友人ではなく、監査人や見知らぬ人になるからです。

どちらの方向においても失敗するのは、一つのモードに居続けることです。切り替えない開発者は、間違ったものをエレガントに実装し続けます。下りない(具体的な実装に降りてこない)アーキテクトは、存在しないシステムの図を描き続けます。チームで失いたくない人は、同じ午後の中で両方をこなす人たちです。午前10時にデータモデルを議論し、午後2時には「自分の仕事ではない」と文句も言わずにオフバイワンのバグを直す。AIの出力を中心にレビュープロセスを組み立てているなら、エージェント型コーディングツールがループ、文脈、権限をどう構成しているかを読んでおく価値があります。モードの切り替えは、そのループの後ではなく、ループの中で起きなければならないからです。

AIは、誤ったものを高速に作り続けることを、いつまでも喜んでやります。アーキテクトの仕事は、正しいものが何かを決め、推論が消えてしまう前にその理由を書き残すことです。

発光する接続線で図形を結んだ青写真が、ノートPCの横に広げられている。
アーキテクチャとは、誰かがどの線を引くかを決める前に、どの線が存在を許されるかを決めることです。

結論:昇進を受け入れよう

私の立場は「場合による」ではなく、はっきりしています。データモデル、外部との契約、セキュリティの姿勢に関わるものはアーキテクトモードを基本とし、閉じた範囲のものは開発者モードのままにする。比率は50対50にはなりません。多くのエンジニアにとって、それは相変わらず、20%が設計、80%が実装です。変わったのは、実装が速くなり、20%の設計を飛ばすコストが、その速度の倍率と同じだけ上がったことです。タイピングを任せれば任せるほど、あなたの価値は任せられない部分に集中していきます。

最初の一歩は三つの習慣です。どれも今週から始められます。第一に、リポジトリにADRのテンプレートを置く。文脈、決定、代替案、結果、半ページほど。本当のトレードオフを受け入れたら、そのたびに一つ書く。第二に、すべてのエピックに二分間の結合度の棚卸しを加える。何を呼び出すのか、何がそれを呼び出すのか、それらが失敗したとき何が壊れるのか。第三に、チケットのテンプレートに可逆性の問いを入れる。「これが間違っていたら、考えを変えるのにどれくらいコストがかかるか?」。答えが「マイグレーションと謝罪」なら、立ち止まってください。「午後一つ」なら、立ち止まらなくていいです。

コードを書く仕事はなくなりません。なくなるのはタイピングの仕事です。両者は同じものではなかったのです。静かにパニックになっている人は、チケットを構文に翻訳するだけに役割が縮んでいた人たちです。「なぜこれはIDのAPIに結合しているのか」と差分を読みながら問うなら、あなたはすでにアーキテクトの仕事をしていたのです。本当に変わったのは、それが今や公式になり、文書化され、そしてあなたのものになったことだけです。昇進を受け入れましょう。