sqlew

DeNA Perl→Go移行事例から見る、コードに依存しない設計記録の価値

Perl 6000行のレガシーAPIを、AIエージェントを駆使してGoへ移行する。DeNAのエンジニアリングブログで公開されたこの事例は、AIコーディングの可能性と限界の両面を鮮やかに描いています。 結果として移行は成功しましたが、それでも約1ヶ月を要しました。この事例が突きつけているのは「AIにコードを読ませれば移行…

方針と誓約：sqlewが分離した2つの記録がAIの思考パターンを変える

AIコーディングツールに設計方針を伝える手法として、ADR（Architecture Decision Record）がコーディングエージェントの推論効率を格段にアップする可能性が示唆されています。しかし従来のADRでは「なぜこの技術を選んだか」という判断の記録と「この技術を使う以上やってはいけないこと」というルールが…

「TDDで開発して」をAIが無視する理由：指示と根拠の遵守率ギャップ

CLAUDE.mdに「TDDで開発すること」と書いておいたのに、AIがテストを書いてくれない。あるいは、テストは書くけれど明らかに形骸化している。AIコーディングでテスト駆動開発を実践しようとした方なら、一度はこうした経験があるのではないでしょうか。 指示は確かに書いてある。なのになぜAIは従わないのか。その原因は、A…

設計意図をAIで高効率に記録・伝播する：実測データが示す「なぜ」の効果

文字列で返す関数を書いて AIコーディングツールにこう指示したとき、返ってくる実装は環境や文脈によってまちまちです。C++なら char* かもしれないし、std::string かもしれない。どちらも「文字列を返す」という指示には合致していますが、用途によって正解はまったく異なります。 では、こう伝えたらどうでしょう…

レガシーコードをAIで保守するとき、最初にぶつかる壁

レガシーコードの保守をAIコーディングで効率化したい。そう考えてコードベースをAIエージェントに読ませたとき、最初にぶつかる壁があります。 「なぜこの実装になっているのか、分からない」