中核となる概念
Verdentのアーキテクチャと主要な用語を理解する
Verdent for VS Codeは、AIを活用した開発に精度と制御をもたらします。従来のAIコーディングツールは、あなたの意図を推測します。Verdentでは、AIが実行する内容を実行前に正確に確認し、正しく動作することを検証して、毎回信頼できるコードを提供できます。
まず計画し、早期に検証し、信頼できるコードを提供する
Verdentのワークフローは、3つの中核フェーズを中心に構築されています。
- Plan - 何かを実行する前に、AIとの明確化のループを通じて対話します。plan ルールでその動作をカスタマイズし、対話型のアーキテクチャ計画、ビジュアルな図、タスクの分解を使って要件を明確にできます
- Code - Code Diff のエンタープライズグレードの分析で変更をレビューし、本番環境に対応した成果を自信を持って提供します
- Verify - Verify サブエージェントとブラウザアクションによる品質保証。コードが包括的な検証に合格するまで、マルチパスの修復サイクルを繰り返します
これらの中核となる概念とVerdentのアーキテクチャを理解することで、拡張機能をより効果的に活用できます。
詳しくはこちら: Plan-Code-Verify ワークフロー
アーキテクチャの概要
複雑なタスクは分解され、特定の目的に最適化された専門のAIエージェントに委任されます。各サブエージェントは独自のカスタムシステムプロンプトと、それを呼び出したメインエージェントから隔離された専用のコンテキストウィンドウで動作します。
この分離によりピーク時のパフォーマンスが維持され、コンテキストの汚染が防止されます。これにより、各サブエージェントは実装の細部すべてでメインエージェントに負担をかけることなく、自身の専門タスクに集中できます。
組み込みのデフォルトサブエージェント:
Verdentには、すぐに利用できる3つのデフォルトサブエージェントが含まれています。
| サブエージェント | 目的 | 使用される場面 |
|---|---|---|
| @Verifier | コードの迅速なチェックと検証 | コーディングタスク中にコードの品質と正しさを確保する場面 |
| @Explorer | コードベースの高速な探索 | ファイルの検索や、コードベース構造に関する質問への回答 |
| @Code-reviewer | コード品質の即時評価 | セキュリティ、保守性、パフォーマンスの問題を能動的にスキャンする場面 |
カスタムサブエージェント:
特定のニーズに合わせてカスタムサブエージェントを作成できます。各カスタムサブエージェントは独自のシステムプロンプトで動作するため、特定のタスクやワークフロー向けに専門的な動作を定義できます。
カスタムサブエージェントは、タスクのパターンに基づいて自動的に呼び出すことも、@メンションで手動で呼び出すこともできます。一般的なユースケースは以下のとおりです。
- 技術スタックの専門家 - React パフォーマンス最適化担当、SQL クエリ最適化担当、Docker 構成レビュー担当
- 品質保証 - テストカバレッジ分析担当、エラー処理レビュー担当、ロギング標準の実施担当
- チーム固有のワークフロー - コードスタイルの実施担当、ドキュメント整合性のチェック担当、依存関係の監査担当
- プロジェクト固有のニーズ - レガシーコードのモダナイズ担当、移行アシスタント、パフォーマンスバジェットの実施担当
詳しくはこちら: サブエージェントの管理
実行モード
Verdentは、AIが権限と操作をどのように扱うかを制御する複数の実行モードをサポートしています。
権限モード:
- Manual Accept Mode - 各ツールを初めて使用する際に権限を要求します。最大限の制御を求める学習や一般的な開発に最適です。
- Auto-Run Mode（デフォルト）- 安全な操作（ファイルの読み取り、Web 検索）の権限を自動的に承認します。ファイルの編集やコマンドの実行には引き続き承認が必要です。信頼できるプロジェクトや迅速なプロトタイピングに最適です。
- Skip Permissions Mode - すべての確認をバイパスする完全自律動作です。自動テストやサンドボックスなど、隔離された安全な環境でのみ使用してください。
権限モードを切り替えるには、入力ボックスの Switch Permission ボタン（"Manual" や "Auto" など現在のモードが表示されます）を選択し、ドロップダウンから希望のモードを選択します。
Switch Mode（操作スタイルを制御）:
- Agent Mode - 自律的なタスク実行とファイル操作を伴う完全なエージェント動作
- Plan Mode - 実行前にアプローチをレビューするための計画重視の操作
- Chat Mode - 自律的なファイル操作を伴わない対話形式の操作
操作スタイルを切り替えるには、入力ボックスの Switch Mode ボタン（"Agent" や "Plan" など現在のモードが表示されます）を選択し、ドロップダウンから希望のモードを選択します。
追加のモード:
- Think Hard Mode - 最大限の計算リソースを割り当て、問題を深く分析し、複数のアプローチを検討して、より徹底した解決策を提供します。アーキテクチャの意思決定、複雑なデバッグ、高度な推論を必要とするタスクに最適です。
Think Hard Modeを有効にするには、リクエストを送信する前に入力ボックスの Think Hard ボタンを選択します。
詳しくはこちら: 実行モードの概要
コンテキスト管理
コンテキスト管理は、セッション中にVerdentがアクセスできる情報を制御します。コンテキストウィンドウはエージェントのメモリ上限で、トークンで測定され、システム指示、ファイルの内容、会話メッセージ、エージェントの応答といった複数のコンポーネント間で共有されます。
コンテキストの仕組み:
- @メンション -
@filename.jsを使ってファイルを明示的にコンテキストに追加し、精密に制御します - 自動読み込み - Verdentは、タスクに基づいて関連ファイルを自動的に含めます
- 独立したサブエージェントコンテキスト - 各サブエージェントは隔離されたコンテキストウィンドウで動作し、メインエージェントのメモリの汚染を防ぎます
- コンテキストウィンドウの制限 - コンテキストはトークンで測定され有限です。会話が長くなるにつれて利用可能なスペースは減少し、モデルのパフォーマンスは低下します
ベストプラクティス:
- 大きなタスクを自然な区切りで小さなまとまりに分割する
- 複雑なタスクではPlan Modeを使い、実行前にアプローチをレビューする
- コンテキストの枯渇を避けるため、統合前に個々のコンポーネントを完成させる
- 新しいタスクを始めるときは新しい会話を開始し、コンテキストをクリアして最適なパフォーマンスを維持する
詳しくはこちら: コンテキスト管理のベストプラクティス
モデルの選択
Verdentは、単一のワークフロー内で複数のAIプロバイダー（Claude、GPT-5、Gemini、MiniMax）のモデルをオーケストレーションします。各専門エージェントは、特定のタスクに最適なモデルを活用できます。
プリセットモデル:
- Performance - 最大のコンテキスト、最先端モデル（クレジット使用量1〜2倍）
- Balance - パフォーマンスとコストの最適なバランス（クレジット使用量1倍）
- Efficiency - 高速で応答性の高い、コスト効率の良いタスク向け（クレジット使用量約0.3倍）
個別に利用可能なモデル:
| プロバイダー | モデル | 最適な用途 | コスト効率 |
|---|---|---|---|
| Anthropic | Claude 4.5 Opus | 深いコーディングタスクや問題解決に最適。 | 1.5倍のコスト |
| Anthropic | Claude 4.5 Sonnet | バランスの取れた複雑なタスク | 1倍（基準） |
| Anthropic | Claude 4.5 Sonnet 1M | 長いまたは複雑なタスク（入力 >200k） | 0.5倍の効率（2倍のコスト） |
| Anthropic | Claude 4.5 Haiku | 高速でシンプルなタスク | Sonnet より3.2倍効率的 |
| OpenAI | GPT-5（Beta） | 推論と創造性 | Sonnet より1.3倍効率的 |
| OpenAI | GPT-5 Codex（Beta） | コーディングとデバッグ | Sonnet より1.3倍効率的 |
| Gemini 3 Pro | 高度な推論とマルチモーダル | 可変 | |
| Kimi | Kimi 2 Turbo（Beta） | コーディング向けの高速モデル | Sonnet より3.1倍効率的 |
詳しくはこちら: 構成設定
よくある質問
コンテキストの汚染とは何ですか？
コンテキスト内の過去の操作や情報が意図しない動作パターンを生み出し、将来のタスクに影響を与えることです。たとえば、コードを繰り返し更新してデプロイすると、単に試している場合でも、エージェントはすべてのコード更新を即時のデプロイと関連付け始めることがあります。サブエージェントは隔離されたコンテキストウィンドウで動作することでコンテキストの汚染を防ぎ、各専門タスクをクリーンなコンテキストで開始できるようにし、異なる種類の作業間での相互汚染を回避します。
安全な操作とは何ですか？
変更を加えずにデータを読み取るだけの操作です。ファイルの読み取りと Web 検索が該当します。これらはAuto-Run Modeでは自動的に承認されますが、ファイルの編集やコマンドの実行は安全のため引き続き承認が必要です。
コマンドの実行とは何ですか？
Verdentを通じてターミナルコマンドやシェルスクリプトを実行することで、テストの実行、パッケージのインストール、ビルドコマンドの実行などの操作が含まれます。コマンドの実行は、意図しないシステムの変更を防ぐため、ほとんどの権限モードで承認が必要です。
トークンとは何ですか？
コンテキストウィンドウの測定単位です。トークンは、AIモデルが処理するテキストの断片（単語、単語の一部、または文字）を表します。コンテキストの上限は文字数や単語数ではなくトークンで測定され、一般的な会話では数千トークンを消費します。
クレジットとは何ですか？
Verdentの利用通貨です。モデルによってコスト効率は異なります（例: Haiku は Sonnet 基準より3.2倍効率的、Sonnet は1倍の基準）。サブスクリプションには月ごとのクレジット割り当てが含まれます（例: Starter は640クレジット、Pro は2,000クレジット、Max は6,000クレジット）。
マルチパスの生成・テスト・修復サイクルとは何ですか？
コードを生成し、テストし、包括的なテストに合格するまで修復する反復的な検証プロセスです。Verdentは自動的にテストを実行し、失敗を分析し、問題を修正し、コードが正しく動作するまで複数のパスで再テストします。これにより、単なる提案ではなく本番環境に対応したコードが提供されます。各結果には、変更された内容を正確に示す詳細なサマリーとコード差分が含まれます。