実装プラン

PlanToCodeは、チームリードと関係者がAI生成実装プランのすべての側面を完全に制御できるようにする包括的なヒューマンインザループ(HITL)ワークフローを実装しています。このガバナンスモデルは、AIコーディングエージェントが自律的に動作するときに発生する可能性のあるリグレッション、バグ、意図しない変更を防ぎます。

コード変更が開始される前に、すべてのプランは構造化されたレビューワークフローを通過する必要があります:

• レビュー:プランはMonacoエディターで開き、レビュー担当者は完全な構文ハイライトとプロフェッショナルな編集ツールを使用して、提案されたすべての変更を確認できます。
• 編集:関係者は、VS Code編集機能を使用して、ステップを直接変更し、アプローチを調整し、制約を追加し、またはリスクのある操作を削除できます。
• 変更を要求:チームはAIシステムに変更を要求し、代替アプローチを生成したり、カスタム指示で複数のプランを統合したりできます。
• 承認:明示的な承認の後にのみ、プランは選択されたコーディングエージェントまたは割り当てられたソフトウェア開発者に実行のために安全に送信できます。
• 却下:要件を満たさないプランは完全に却下できます。コンプライアンスと学習のために完全な監査証跡が維持されます。

このワークフローは、すべての開発努力が企業の製品要件、チームワークフロー、ビジネス目標と一致することを保証します。明示的な人間の承認なしにコード変更は発生しません。

実装プランは、プロジェクトのリポジトリ構造に対応する正確なファイルパスを使用して、ファイル単位で開発タスクを分解する非常に詳細な構造を使用します。この詳細度は、リグレッションを防ぎ、企業環境でAIコーディングエージェントを自信を持って導入するための基本です。

プラン内の各ステップは、どのファイルが次のようになるかを明示的に宣言します:

• 変更(特定の行範囲と記述された変更を含む)
• 作成(完全なファイルパスと初期コンテンツ構造を含む)
• 削除(正当化と依存関係分析を含む)
• 参照(コンテキスト用だが変更されない)

この詳細レベルにより、コードに触れる前に提案された変更の影響が非常に明確になります。チームリードは、重要なレガシーコードが変更されるかどうか、破壊的変更が提案されているかどうか、または追加の精査を必要とするファイルにプランが触れているかどうかをすぐに識別できます。

ファイル単位のアプローチにより、承認されたプランをコーディングエージェントに正確に送信することもできます。「認証システムを更新する」などの曖昧な指示の代わりに、エージェントは正確な仕様を受け取ります:「src/auth/session_manager.rsの45〜67行目を変更してトークンローテーションを追加し、次の構造でsrc/auth/token_store.rsを作成します...」

プランコンテンツは、Monaco Editorをラップする共有VirtualizedCodeViewerを通じてレンダリングされます。ビューアーは一般的な言語を自動的に検出し、クリップボードへのコピーアクションをサポートし、非常に大きなプランを仮想化し、文字数や構文対応ハイライトなどのオプションメトリックを提供します。

プランが開かれると、パネルはジョブ識別子によってアクティブなプランを解決し、コンテンツをMonacoに渡し、レビュー担当者が現在開いているモーダルを失うことなく隣接するジョブ間を移動できるようにします。

パネルは、ファイル検出ワークフロー中に選択されたリポジトリルートを保存し、フォローアップアクションが同じスコープを再利用できるようにします。また、プロジェクトディレクトリや準備されたプロンプトコンテンツなどのプラン固有のメタデータも記録するため、ワークフローを再計算することなく、ダウンストリームプロンプトを生成またはコピーできます。

トークン推定はプロンプトがコピーされる前に実行されます。パネルは、プロジェクトディレクトリ、選択されたファイル、現在選択されているモデルを使用してトークン推定コマンドを呼び出し、チームがモデル制限内に収まるように、システムプロンプトとユーザープロンプトの両方の合計を表示します。

すべてのメタデータは監査目的でプランとともに保持されます。企業チームは、どの関係者がどのプランをレビューし、どのような変更が要求され、初期タスクの説明からファイル検出、最終承認されたプランまでの完全な推論チェーンを追跡できます。

プランは統合、削除、または後で再開できます。パネルは選択されたプラン識別子のリストを保持し、プランに関連付けられたターミナル出力専用のモーダルを管理し、レビュー担当者がビューアーを閉じずに以前のプランをページングできるようにナビゲーションヘルパーを公開します。ターミナルアクセス、プロンプトコピーコントロール、統合指示はすべて同じジョブ識別子を共有するため、監査履歴の一貫性が保たれます。