Markdown ドキュメント間の整合性を検証する contextlint を作っている話
AI要約
AI駆動開発で注目される仕様駆動開発(SDD)では、ドキュメント品質がコード品質を左右します。Markdownドキュメント間の整合性を自動検証するcontextlintというツールが開発中です。要件IDの参照切れ・安定度管理の漏れ・リンク切れを静的解析で検出し、LLMの高コスト問題を回避。実装例付きで、SDD実践者の課題解決策を提示しています。
AI要約
AI駆動開発で注目される仕様駆動開発(SDD)では、ドキュメント品質がコード品質を左右します。Markdownドキュメント間の整合性を自動検証するcontextlintというツールが開発中です。要件IDの参照切れ・安定度管理の漏れ・リンク切れを静的解析で検出し、LLMの高コスト問題を回避。実装例付きで、SDD実践者の課題解決策を提示しています。
Cursor や Claude Code などのAIエージェントをチームで使うと、コミットルールが崩れやすくなります。これを防ぐには「禁止事項・手順・メッセージ形式」の3点を明文化し、.cursor/rules や CLAUDE.md に記述することが重要です。チケット番号を先頭に入れる、git add .を禁止するなど、具体的なルール設定で追跡性が大幅に向上します。

