Execution Modes Guide

Learn how to use BatonAI's execution modes to implement your coding tasks efficiently.

Execution Modes Overview

Available Execution Modes

BatonAI offers two execution modes to suit different development needs:

One-Click Execution

A streamlined development mode where BatonAI handles both planning and implementation automatically. Perfect for:

  • Quick implementations
  • Straightforward coding tasks
  • When you want to see the solution first and then make adjustments

Guided Execution

A collaborative development mode where you work together with BatonAI. Ideal for:

  • Complex implementations requiring careful planning

  • Tasks where you want to maintain control over the implementation

  • Learning and understanding the implementation process

  • Customizing the solution to specific requirements

    Execution Modes Comparison

How to Use Execution Modes

1. Create a New Task

  1. Navigate to your repository's page

  2. Click "New Task" or use the quick-start form

  3. Enter your task description

  4. Optionally, tag relevant files to provide context

    New Task Form

2. Choose Execution Mode

When creating your task, you'll see two options:

Choose execution mode
  • One Click Execution: AI handles everything automatically
  • Guided Execution: Collaborate with AI on the planning phase

Select your preferred mode to proceed.

The Planning Phase

One-Click Execution Planning

When using one-click execution, BatonAI will:

  • Analyze your requirements
  • Create an implementation plan
  • Determine necessary changes and start executing

Note that if you check in on the progress of a one-click execution in planning model, it will simply show "Planning in progress..."

Planning Progress

Guided Execution Planning

When using guided execution, you'll collaborate with AI through:

  1. Initial Analysis

    • AI analyzes your requirements
    • Identifies key components and dependencies
    • Proposes an implementation approach
    Initial Analysis

  2. Collaborative Planning Via Chat

    • Chat with the AI agent to answer any implementation questions and discussion alternatives
    • Once you've agreed on the changes, you can prompt the AI to revise the solution
    Collaborative Planning

    You can also see the revision history of the implementation plan. Whichever plan you are on will be the implementation plan that the chat will reference. So if you have want to use the old plan as the starting point for a new revision, you can do that.

Plan Revisions

  1. Direct Editing of the Plan

    • You can also directly edit the plan steps by either:
      • Changing the order of implementation
      • Changing / deleting the steps
      • Adding new steps
    Implementation Strategy Changes

  2. Prompt AI to Begin Execution

    • Whichever plan is currently selected will be the one that's executed when you click "Start Execution"
    • Once you click start execution, the AI agent will start the coding
    • After execution is started, you cannot go back to the planning module

Monitoring Progress

During execution, you can monitor the progress:

  1. Execution Phase

    • Real-time progress updates
    • Shows current step being completed
    • Displays any errors or warnings
    Detailed Execution Progress

  2. Completion

    • Shows "Complete" when finished
    • Displays total execution time
    • Presents the implemented solution
    Execution Complete

Best Practices

  1. Task Description
    • Be clear and specific
    • Include any requirements or constraints
    • Mention expected outcomes
Task Description Example
  1. File Tagging
    • Tag relevant files for better context
    • Include configuration files if needed
    • Tag test files for test-driven development
File Tagging Example
  1. Review Process
    • Always review the implemented solution
    • Check for edge cases
    • Verify all requirements are met
Review Process

Troubleshooting

Common Issues

  1. Execution Stuck
    • Check the progress indicator
    • Verify repository access
    • Contact support if stuck for more than 10 minutes
Execution Stuck
  1. Unexpected Results
    • Review the implementation plan
    • Request specific changes
    • Provide more context if needed
Unexpected Results
  1. Error Messages
    • Check the error details
    • Verify repository permissions
    • Ensure all dependencies are available
Error Messages

Need Help?

Related Resources