Verdent Docs
主な機能

Plan Rules

役割と専門的なバックグラウンドに応じて、確認事項とプランの提示方法をカスタマイズする

Plan Rules は Plan フェーズをサポートし、Verdent が要件、確認事項、実装プランを提示する方法をパーソナライズします。組み込みの役割ベースのテンプレートを出発点として使用したり、自分の思考スタイルや作業習慣に合わせた完全カスタムのルールを作成したりできます。

学べること

  • Plan Rules がプランの提示方法をどのようにカスタマイズするか
  • 組み込みの役割テンプレート(Frontend、Test、Product Manager)
  • カスタムプランルールの作成
  • プランルールが適用されるタイミング

Plan Rules でカスタマイズできること

Plan Rules は、Verdent が Plan Mode でプランを提示する方法を制御します。

  • 要約-詳細-要約 - 最初にエグゼクティブサマリー、中間に詳細なステップ、最後に影響の要約を配置
  • 図優先 - 視覚的な表現を先頭に置き、テキストで補足の詳細を提供
  • 表形式 vs 説明文 - スキャンしやすいデータには構造化された表、文脈的な説明には散文
  • セクションの順序 - どのセクションを最初に表示するかをカスタマイズし、階層を定義

迅速な理解が重要なステークホルダーレビューには要約-詳細-要約を使用します。実装に入る前にアーキテクチャの理解が不可欠な場合は図優先を使用します。

  • 高レベルの戦略的 - 技術的な詳細を最小限にして「何を」「なぜ」に焦点を当てる
  • 詳細な技術的 - 実装の詳細、コードパターン、アーキテクチャの決定を含む
  • コード例 - コードを表示するかどうかを制御(含める/除外する、全体 vs スニペット、diff 形式)
  • テストコンテンツ - QA ワークフローではデフォルトで含め、PM 向けのプランでは省略

コンテンツの詳細度を対象読者に合わせます。チーム横断のコラボレーションには高レベルの戦略的を、単独またはシニア開発者と実装する場合は詳細な技術的を使用します。

  • Mermaid 図 - フローチャート、シーケンス図、ステートマシン(自動生成または明示的指定)
  • DOM 階層ツリー - ツリー形式のフォルダー表示によるコンポーネント構造
  • ワイヤーフレーム - UI モックアップとレイアウトのスケッチ
  • スタイルテーブル - セルを結合した CSS 仕様、コンポーネント別に整理

Mermaid 図はリクエスト時にプランの内容から自動生成されます。デフォルトで特定の図のタイプが必要な場合は、プランルールで明示的にリクエストしてください。

  • デフォルトで省略 - テスト、スタイル、後方互換性(プランの長さを削減)
  • 必須要素 - 受け入れ基準、エッジケース、KPI(本番運用への準備を確保)
  • 確認の設定 - 複数回の確認 vs 単一の確認 vs 確認なし

まずは省略項目から始めてプランを簡潔に保ち、実際に必要なものだけ必須要素を追加します。省略したコンテンツは特定のプランセッションでいつでもリクエストできます。

  • Frontend - 図、DOM ツリー、スタイルテーブルを使った視覚的なアーキテクチャ、デフォルトでテストを省略
  • QA/Test - カバレッジマトリックス、境界値分析、トレーサビリティを含むテストケーステーブル
  • Product Manager - ビジネス要件のみ、図/ワイヤーフレーム、コードスニペットなし

役割テンプレートから始めてカスタマイズしましょう。多くの開発者は Frontend または QA テンプレートをベースとして使用し、特定のセクションをワークフローに合わせて調整します。


役割ベースのプランテンプレート

Verdent は、プランの構造、コンテンツの詳細度、提示スタイルを自動的に調整する専門的な役割テンプレートを提供します。

焦点: 視覚的な構造を持つ技術的な実装プラン

主な特徴:

  • プランニング前の包括的なコードベース調査
  • インタラクションフロー向けの Mermaid フローチャートとステート図
  • ツリー形式のフォルダー表示による DOM 階層
  • CSS プロパティ向けのセル結合スタイルテーブル
  • 省略: デフォルトでテストコンテンツとスタイルを省略(リクエストがない限り)
  • 提供: 複数の選択肢を提示せず、確定的なソリューションを提供

最適な対象: 視覚的なアーキテクチャと明確な実装パスを必要とするフロントエンド開発者

焦点: 包括的なテストケースの生成と品質保証

主な特徴:

  • 目標指向のテスト設計(ビジネスロジック、セキュリティ、安定性)
  • 9 列の Markdown テーブルによる構造化されたテストケース
  • 同値クラス、境界値、主要パラメータ
  • 完全なカバレッジ: 正常系、代替系、例外系、エッジケース
  • 自動化サポートを備えた実行可能性への注力
  • 要件項目へのトレーサビリティ

最適な対象: 体系的なテストカバレッジを必要とする QA エンジニアとテスト自動化のスペシャリスト

焦点: ビジネス視点からの製品要件

主な特徴:

  • コードスニペットや技術的な実装なし
  • 「どうやって」ではなく「何を」「なぜ」に焦点を当てる
  • シーケンス図、フローチャート、ワイヤーフレーム
  • 優先度と Before/After 比較を含む要件リスト
  • 対処戦略付きのエッジケース
  • KPI とイベントトラッキングを含むデータ仕様

最適な対象: 技術的な要素を混在させずにビジネス要件を定義する製品マネージャー


カスタムプランルール

以下を定義してパーソナライズされたプランルールを作成します。

ルールの構成要素:

  • 提示スタイル - 要約-詳細-要約、図優先、または表形式
  • コンテンツの詳細度 - 高レベルの概要 vs 詳細な実装
  • 省略項目 - デフォルトで除外するもの(テスト、スタイル、後方互換性)
  • 必須要素 - 必須のセクション(図、受け入れ基準、データ仕様)
  • インタラクションの設定 - 確認のアプローチ、確認の要件

Plan Mode では、入力ボックスの Plan Rules ボタンを選択すると、プランルールにすばやくアクセスして変更できます。

ルールの適用:

  • すべての Plan Mode セッションに適用
  • ワークスペースのセッションをまたいで保持
  • インラインの指示で上書き可能
  • カスタムサブエージェントと連携

詳細情報: ワークスペースで Plan.md を作成または編集し、Markdown 形式でカスタムプランルールを定義します。


関連項目