Unit Tasks
Unit tasks are perfect for single, well-defined development tasks. When you create a unit task, AutoDev’s AI agent:- Analyzes your request
- Writes the necessary code
- Creates one or more pull requests
- Responds to code reviews automatically
- Fixes any CI failures
When to use unit tasks
- Bug fixes - Fix a specific bug or issue
- Small features - Add a single, straightforward feature
- Refactoring - Improve code structure in a focused area
- Documentation - Update or create documentation
- Quick updates - Make targeted changes to existing code
Example unit tasks
Composite Tasks
Composite tasks are designed for complex projects that require multiple coordinated steps. AutoDev uses AI to break down your request into a task graph (DAG structure) where tasks can run in parallel or sequence based on dependencies.How composite tasks work
- AI Planning - AutoDev analyzes your request and creates a task graph
- Review Plan - You see the proposed tasks and their dependencies
- Start Execution - You approve the plan and start execution
- Sequential Execution - Tasks become ready as dependencies complete
- Auto-approval (Optional) - Enable auto-approval to run tasks automatically
- Coordinated Completion - All tasks work together to complete your project
When to use composite tasks
- Large features - Features that require multiple coordinated changes
- System refactoring - Major code restructure across multiple modules
- New projects - Setting up a new service or application from scratch
- Complex integrations - Integrating multiple systems or APIs
- Multi-step migrations - Database or infrastructure migrations
Example composite tasks
Task Configuration
Both task types support optional configuration:Repository selection
Choose which repository the AI should work on. You can only select repositories where you’ve installed the AutoDev GitHub App.AI Agent selection (Optional)
Choose which AI coding agent to use. See available AI agents for the full list. If not specified, AutoDev uses your team’s default agent.Model version (Optional)
Specify the AI model version (e.g., “sonnet”, “gpt-4”). If not specified, the agent’s default model is used.Base branch (Optional)
Specify which branch to use as the base for the task. Defaults to your repository’s default branch (usuallymain
or master
).
Task Status
Tasks progress through different statuses:- Pending - Task created but not yet started
- In Progress - AI agent is working on the task
- Completed - All work finished and PRs created
- Failed - Task encountered an error
- Cancelled - Task was cancelled by user
Pull Requests
Each task can create multiple pull requests. AutoDev automatically:- Creates descriptive PR titles and descriptions
- Links PRs back to the task
- Posts the task prompt as a comment (configurable)
- Converts PRs to draft during automated updates
- Responds to code review comments
- Fixes failing CI checks
Next steps
- Learn about Unit Tasks
- Learn about Composite Tasks
- See Creating your first PR