10年以上、銀行とフィンテックのインターフェースを設計してきた。オンボーディングフロー、承認画面、取引ダッシュボード、投資アプリ。プロダクトチーム、エンジニアリングチーム、プロジェクトマネージャー、規制当局と仕事をした。

過去6ヶ月で、Claudeをコーディングパートナーとして完全な3言語ブログを構築した。そのプロセスで、業界での10年が一度も教えなかった6つの専門的実践を採用した。AIが経験より優れた教師だからではない。AIが職場文化がスキップすることを正常化していたことを強制したからだ。

1. 以前の倍の質問をする

企業環境では、質問はプロジェクトの範囲に限定される。サイトの目的は何か。必要な機能は何か。納期はいつか。「何」を解決するが「どこへ」を解決しない運用上の質問。

AIと働くことで、質問が拡大した。サイトの目的だけでなく、12ヶ月後にその目的がどう進化するかを問う。その目的が変わった場合、構築しているアーキテクチャはそれをサポートするか、再構築が必要か。選んでいるスタックは技術的決定か習慣か。

AIは浅い質問にはうまく答えない。深いコンテキストを与えるとうまく答える。それがすべてのプロジェクトの前に深いコンテキストを開発することを強制した。このの習慣はAIなしで仕事をするときも消えない。

2. 他の人が読むことを前提に文書化する

業界では、ドキュメンテーションは後回しだ。素早く書かれ、一般的に書かれ、誰かが理解するためではなく要件を満たすために書かれる。「コードは自己文書化する」というフレーズを何十回も聞いた。

Claudeと働くとき、すべての指示がドキュメンテーションだ。欲しいものを明確に説明しなければ、出力は不正確だ。明確に説明するとは、言語を基本概念まで下げることだ。

副作用として、コンテキストのない人が読むことを想定してすべてを文書化するようになった。最も要求の厳しい聴衆が何も推論しない機械であるため、ドキュメンテーションが改善した。

3. 非技術者に自分の仕事を説明する

クライアントレポートは技術的だった。「@graphで5エンティティのJSON-LDを実装した。」「TTFBを200msに最適化した。」正確だが、技術メトリックではなくビジネス結果に支払う人には理解不能だ。

現在はすべてを非技術者向けの説明レイヤーを通す。AIと働くプロセスが複雑な概念を簡単な言語に翻訳する訓練をしたからだ。Claudeに一文で欲しいものを説明できるなら、クライアントに一段落でしたことを説明できる。

4. 習慣ではなくデータで技術的決定を正当化する

開発チームでは、技術的決定はしばしば惰性で行われる。「使っているからReactを使う。」「チームが知っているからLaravel。」合理的な決定だがめったに疑問を持たれない。

AIはすべての決定で代替案を突きつける。技術を使うと言ったとき、正しいと仮定しない。なぜそれで他ではないのかを問う。ブログがバニラPHPで動くのは、フレームワークを知らないからではなく、必要なものを分析し、フレームワークはそのケースに不要な複雑さだったからだ。

5. 近似ではなく精度で表現する

ミーティングで「ユーザー体験を改善しよう」と言えば全員がうなずく。それが正確に何を意味するか誰も問わない。曖昧さは共有コンテキストと暗黙の仮定で解決される。

AIでは、曖昧さは曖昧な出力を生む。「UXを改善して」と言えばベストプラクティスの汎用リストが返る。「60歳以上のユーザーのオンボーディングフォームで最初のインタラクションから最初の完了アクションまでの時間を短縮して」と言えば有用なものが返る。

AIが曖昧な指示を理解しないなら、人間も理解しない。人間はただ理解したふりをする。AIは言ったことの正確な結果を返す。意味したことではなく。職場文化にはないミラーだ。

6. 何かが機能しているのかまだ壊れていないだけなのかを問う

プログラミングにはすべてのチームで繰り返されるフレーズがある。「動いているなら触るな。」サバイバルルールだ。壊れていないものを動かすな。しかしそのルールは知識も凍結する。

AIがコードを生成するとき、知らないパターンを使うことがある。出力が動けば無視するのが最初の反応だ。時間とともに採用した2番目は、なぜそのパターンを使い、自分が使うはずだったものを使わなかったかを問うことだ。足し算が人生のある段階で有用で、次に掛け算が来るように、コードで何かが動くことはより良いものが存在しないことを意味しない。

json_encodeのフラグはClaudeが入れたからコードにあった。動いた。疑問に思わなかった。freeCodeCampのAbbeyがなぜ重要か聞いたとき、3言語ブログのサイレントバグを防いでいることを発見した。

「動いているなら触るな」は「動いている、しかしなぜこのように動き、別の方法では動かないのか」になった。

これが業界について語ること

これら6つの実践のどれも新しくない。深く質問する、よく文書化する、非技術者にコミュニケーションする、決定を正当化する、表現に精度を持つ、動くものを疑問視する。シニアプロフェッショナルなら持つべき基本的な実践だ。

しかしフィンテックと銀行の職場文化はそれらを優先しない。納期の速さ、要件の遵守、イノベーションより安定性を優先する。そのコンテキストではドキュメンテーションは犠牲にされ、深い質問は時間の無駄と認識され、「動いているなら触るな」は悪徳ではなく美徳だ。

AIはこれらの実践を教えなかった。推論しない、仮定しない、よく説明しなかったことを理解したふりをしないツールから品質の高い出力を得る唯一の方法であるため、採用を強制した。

これはAIについて良いことを語っていない。10年の経験を持つプロフェッショナルがそれらなしにここまで来ることを許した業界について懸念すべきことを語っている。