「読みにくいDB」はAI開発のコストを1.9倍にする――Claude Codeで検証したDB設計の影響

はじめに Twitterで「mdやskillを整える以外にも、AIが読みやすいDB構成がある」という話を見かけました。 今後AIで開発していくと、開発スピードと同じくらいAIのコストが効いてくると思っています。そこで、読みやすいDBと読みにくいDBで、トークンとコストがどれくらい変わるのかを実験してみました。 先に言ってしまうと、AIにとって読みやすいDBは、人間にとって読みやすいDBとほとんど同じでした。わかりやすい命名、コメント、外部キー。昔から言われてきた「ちゃんとした設計」が、そのままAIのコストにも効いてきます。 この記事の対象読者 Claude Code などのAIエージェントで開発している人 AIに既存のDBを触らせたときのコストや精度が気になっている人 結論

[circled]

DBさえ綺麗なら、フロントやバックエンドのAPI生やすアプリ側のコードはものすごく楽なんだがな、、、と思うことは多々あるので分かる

[miragestlike]

「コストに効く」が臭くてだめだ。言いたいことは分かるんだけどさあ、、、

[kiririmode]

DBの命名・コメント・リレーションから意味を読み取れないAIは、実データの照会やコード探索を繰り返し、開発コストが約1.9倍に増加。仕様を推測で補完することでハルシネーションも。変なカラム名をつけるな高校校歌

[harumomo2006]

適当に命名規則を考えるとだいたいローマ字になる

[misshiki]

Claude CodeでDB設計の影響を各5回検証。読みにくいDBは推定コストが0.21→0.41ドル（約1.9倍）、所要時間60→109秒。命名・コメント・外部キーなどの差を比較。単一タスク・モデルの小規模実験。

[khtno73]

BI周辺でいうセマンティックレイヤーではなくそもそも意味わかるようにテーブルもカラムも名付けろ論。

[hdampty7]

名前に釣られてAIも間違える。先週これでAIをしかりつけたところ。「クソ前任者が作ったクソコードなんで名前だけじゃなくて中身もチェックしろ。」ローカルメモにしっかりメモされてた。八つ当たりはいかんな。

[shag]

schema.sql に -- でコメント書いておけばいいだけだよ。

[strawberryhunter]

個人的には YHVH 症候群（YHVHはヤハウェ）と呼んでる。読めなければそりゃ影響があるだろう。誰かの個人ブログのネタで認知もされていないと思うが出典: https://itoasuka.hatenadiary.org/entry/20071009/1191935137

[hhungry]

AI「読みやすいDBにしてきました」

[magi00]

これだと読みにくいDBが単に情報の欠落したDBでしかなくない？情報が無くて探索でコストと失敗率が上がるのはまぁ当然。同じ情報で与え方の違いで差が出るかどうかで初めて分かるのではないか？

[toyoshi]

LLMが自然言語から学んでるからであって過渡期感あるノウハウ。古典的なDBはいらんってなる日は近そう

[nguyen-oi]

結局人間にとって読みやすい設計がAIにとっても一番効率的というオチ