Module planning_workflow 

Planning workflow tools for entering, exiting, and managing planning workflow

These tools allow the agent to programmatically enter and exit planning workflow. The agent can:

• Enter planning workflow to switch to read-only exploration
• Exit planning workflow (triggering plan review) to start implementation
• Persist canonical plans under .vtcode/plans/ by default (with optional custom path)

Based on insights from Claude Code’s planning workflow implementation:

• Plan files are written to a dedicated directory
• The agent edits its own plan file during planning
• Exiting planning workflow reads the plan file and starts execution
• User confirmation is required before transitioning to execution (HITL)

Structs

FinishPlanningArgs

Arguments for exiting planning workflow

FinishPlanningTool

Tool for exiting planning workflow

PersistedPlanDraft

PlanValidationReport

PlanningWorkflowState

Shared state for planning workflow across tools

StartPlanningArgs

Arguments for entering planning workflow

StartPlanningTool

Tool for entering planning workflow

Enums

PlanLifecyclePhase

Functions

generate_tracker_markdown_from_plan

merge_plan_content

persist_plan_draft

plan_file_for_tracker_file

sync_tracker_into_plan_file

tracker_file_for_plan_file

validate_plan_content