Markdown ドキュメント間の整合性を検証する contextlint を作っている話
2026年3月7日 22:38
はじめに
AI を活用したソフトウェア開発では、要件・仕様・設計といった構造化ドキュメントを SSOT(Single Source of Truth: 信頼できる唯一の情報源)として管理し、それを基に AI がコードを生成する、いわゆる 仕様駆動開発(SDD) のようなアプローチが定着しつつあります。
こうしたアプローチでは、ドキュメントの品質が生成されるコードの品質に大きく影響します。
つまり、ドキュメントが壊れていれば、そこから生まれるコードにも影響が及ぶということです。
私は実際に SDD ベースのドキュメント管理を実践しており、その過程で「Markdown ドキュメント間の整...