いつのまにか腐る docs、エージェントに直させる ── LLM なしの決定的ドリフト検出 OSS を作った
この記事で分かること
ドキュメントの陳腐化を自動検出するOSSの仕組みが分かる。LLMを使わずに決定的なドリフト検出を行うため、コストがかからず再現性が高い。具体的には、ドキュメントとコードの構造を比較して不一致を検出し、エージェントに修正を指示するフローを実装している。
詳細要約
ドキュメントの陳腐化を自動検出し、エージェントに修正させるためのOSSツールを、LLMに依存せずに実装した。このツールは、ドキュメントと実際のコードや仕様との間に生じた「ドリフト」を、構文解析や差分比較などのルールベースで検出する。利用時は、監視対象のドキュメントとソースコードを指定し、検出ルールを設定するだけで、ドリフトが発生した時点でエージェントが自動修正を試みる。LLMを使わないため、コストがかからず、結果の再現性が高い点が実務上の利点となる。