Content last updated 2026-07-01

ADR-001:Semantic Code Search

Agentic Duo Chat 向けの Semantic Code Search ツールを導入するための意思決定記録

コンテキスト

コードベースを意味的に検索する方法を提供する “Codebase as Chat Context” 機能は、Classic Duo Chat と密結合していました。これを Agentic Duo Chat で利用可能にする方法が必要でした。

決定

  1. Semantic Code Search 機能を GitLab MCP (Model Context Protocol) Server 上のツールとして公開することを決定しました。

    MCP を通じて Semantic Code Search を公開することで、Agentic Duo Chat の実装から切り離され、両方のシステムを独立して進化させられます。さらに、他のツールやエージェントが同じ MCP インターフェイスを活用して Semantic Code Search にアクセスできるため、コードの再利用と一貫性が促進されます。

  2. このツールを Semantic Code Search と呼ぶことを決定し、今後はこの機能をその名称で参照します。

    ツールに “Semantic Code Search” という名前を使うことで、その機能が自明になります。

詳細については、Semantic Code Search 設計ドキュメントを参照してください。

検討した代替案:ネイティブな Agentic Duo Chat ツール

MCP Server を通じて公開せず、Agentic Duo Chat システム内に直接ネイティブツールとして Semantic Code Search を実装する。

このアプローチは不要な結合を生み、システムの拡張性を制限するため、採用しないことにしました。

関連 Work Item