sqlew

なぜClaude Codeが選ばれるのか

AIコーディングツールを選ぶとき、多くの方はまずLLMの性能に目が向くのではないでしょうか。どのモデルが賢いか、どれだけ正確にコードを生成できるか。もちろんそれは重要な観点です。 しかし、実際にプロジェクトで使い込んでいくと、気になるのはモデルそのものよりも「その周りの仕組み」だったりします。Claude Codeが後…

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

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

あなたのCLAUDE.md、「社訓」になっていませんか

CLAUDE.mdにルールを書き足していくうちに、気づけば数百行を超えていた。こんな経験のある方は少なくないのではないでしょうか。 コーディング規約、アーキテクチャ方針、命名ルール、テスト方針…。プロジェクトが進むほど「これも書いておこう」と追記が増え、CLAUDE.mdはどんどん長くなっていきます。でもふと気づくと、…

AIは設計意図の「空白」を埋めようとする：ADR途中導入で見えた過剰実装のメカニズム

設計意図をAIに渡すと、コード品質が上がる。これは私たちの実験でも確認された事実です。しかし実験はもうひとつ、興味深い事実を明らかにしました。 設計意図の記録が「一部だけ」存在する状態は、AIにとって独特のプレッシャーになる、ということです。

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

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

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

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