SDDを実践すると起こること 仕様を定義する際に、How（実装の詳細）が仕様書に入り込む。そしてしばしば、Howのボリュームは大きくなりがちである。実装フェーズに入る前に、仕様レビューに時間がかかり、本来のエージェント開発の持つスピード感を得られない感覚に陥る。 SDDから、IDDへ SDDの問題とは、仕様書にHowが混入し、スペックレビュー地獄に陥ることにある。ドキュメントとコードの二重管理コストが膨らみ、やがて開発者の認知できる以上の差分が出来上がる。 必要なのは、SDDを止めることではなく、SDDの課題点を改良した、意図駆動開発(IDD) へ進化することである。 Int...

💾

こんにちは、ナウキャストで LLM エンジニアをしている Ryotaro です。 バックエンドの ER 図、ちゃんとメンテナンスできていますか？ 「コードは変えたけど ER 図の更新を忘れた」「いつの間にかドキュメントが実態と乖離していた」という経験は、多くのエンジニアに心当たりがあるのではないでしょうか。 この記事では、SQLAlchemy モデルを Single Source of Truth（SSoT）として、GitHub Actions で DBML を自動生成・コミットする仕組みを構築しました。やってみたら結構うまくハマったので、その方法を紹介します。開発者はコードだけ修正すれ...

💾