S
設計書間の矛盾を自動検出して報告する
by Shu-Tanaka-Group
複数の設計ドキュメント(docs/ 配下)間の矛盾を9つのチェックポイント単位で自動検出し、不整合を一覧で報告できます。 リンク切れやセクションアンカーの不一致などの参照整合性を検証し、ドキュメント間のナビゲーション品質を保証できます。 タイムアウト・リトライ回数・リソース制限・ポート番号など、複数箇所で記載される数値・定数が統一されているか確認できます。 DBカラム定義・APIフィールド・K8sラベル・状態遷移グラフなど、スキーマとライフサイクルの矛盾を多角的に検出できます。 用語の表記ゆれ(ディスパッチャ/Dispatcher など)やコンポーネント名の統一を確認し、ドキュメント全体の一貫性を向上させられます。 複数の設計ドキュメントを管理するテクニカルライターやドキュメント担当者 アーキテクチャドキュメント・API仕様書・インフラ設定の整合性を保証したいアーキテクト マイクロサービスやシステム設計で、各コンポーネント間の責務・データフロー矛盾を検出したいシステムデザイナー ドキュメント品質を継続的に監視し、古い記述の残存を防ぎたいプロジェクトマネージャー 設計書間整合性チェックは docs/ 配下の設計書を対象(docs_en/ 除外、docs/migration/ 除外)。並列 Explore サブエージェントで9つのチェックポイント実行後、メインエージェントが検証して報告(修正なし)。チェックポイント:(A)参照整合性=リンク・アンカー確認、(B)数値定数一致=環境変数・K8sリソース・SQL型・URL・単位換算、(C)スキーマ重複記述=DBカラム・APIフィールド・K8sラベル名、(D)状態遷移ライフサイクル一致=ジョブ状態集合・遷移グラフ・条件、(E)用語命名ゆれ=表記統一・初出定義・略語一貫性、(F)データフロー責務矛盾=書き込みコンポーネント・依存方向・明確矛盾のみ報告、(G)古い記述残存=最近変更設計書の関連ドキュメント追随確認、(H)設定値相互制約階層整合性=値の不等式・大小関係・倍数関係維持。引数でファイル・コンポーネント名指定可。
ドキュメント設計コミット