Vibe Guide

Best practices, workflows, and tips for getting the most out of Vibe Kanban and AI coding agents.

Getting Started

If you're new to Vibe Kanban, start with our getting started guide. Once you have it installed, these best practices will help you maximize your productivity.

Task Planning

Break Down Large Tasks

Large tasks are better handled when broken into smaller, focused tasks. This allows agents to work more effectively and makes it easier to review and merge changes.

• Create separate tasks for different features or components
• Use clear, specific task descriptions
• Include context about the codebase and requirements

Use Task Templates

Create task templates for common workflows like bug fixes, feature implementations, or refactoring. This standardizes your process and saves time.

Agent Selection

Choose the Right Agent for the Task

Different agents excel at different tasks. Consider:

• Claude Code: Complex refactoring, understanding large codebases
• OpenAI Codex: Quick code generation, natural language tasks
• GitHub Copilot: GitHub-integrated workflows
• Cursor CLI: If you're already using Cursor

See the full list of supported agents.

Parallel Execution

Run Multiple Tasks Simultaneously

One of Vibe Kanban's biggest advantages is parallel execution. You can run multiple agents on different tasks at the same time without conflicts.

• Assign independent tasks to different agents
• Monitor all tasks from the unified interface
• Review and merge changes as tasks complete

Code Review

Review Agent Changes Thoroughly

Always review agent-generated code before merging. Use Vibe Kanban's built-in diff tool to:

• Inspect all changes line by line
• Edit code directly in the diff view
• Approve or request changes

Learn more about code review workflows.

Git Workflow

Leverage Git Worktrees

Vibe Kanban uses git worktrees to isolate agent workspaces. This means:

• Each task has its own isolated workspace
• No conflicts between parallel tasks
• Easy to merge or discard changes

Read about Git integration for advanced workflows.

Monitoring and Control

Stay in Control

Vibe Kanban provides real-time monitoring and control:

• Monitor agent progress and logs
• Pause, resume, or stop agents at any time
• Get detailed visibility into what agents are doing

See the monitoring guide for details.

IDE Integration

Work from Your IDE

Use the VS Code extension to:

• Monitor agents directly in your IDE
• Interact with agents without leaving your editor
• Perform code review in familiar tools

MCP Integration

Extend Your Workflow

Connect Vibe Kanban to MCP clients like Claude Desktop to create tasks from your personal AI assistant. Learn about MCP integration.

Common Patterns

Feature Development

1. Create a task template for the feature
2. Break the feature into smaller tasks
3. Assign tasks to appropriate agents
4. Run tasks in parallel when possible
5. Review and merge changes incrementally

Bug Fixes

1. Create a focused task with bug description
2. Include reproduction steps and expected behavior
3. Let the agent investigate and fix
4. Review the fix thoroughly
5. Test before merging

Refactoring

1. Start with a clear refactoring goal
2. Break into smaller, safe refactoring steps
3. Use agents that excel at code understanding (like Claude Code)
4. Review each change carefully
5. Run tests after each step

Best Practices Summary

• ✅ Break large tasks into smaller, focused ones
• ✅ Use task templates for common workflows
• ✅ Choose the right agent for each task
• ✅ Leverage parallel execution
• ✅ Always review agent-generated code
• ✅ Monitor agent progress and intervene when needed
• ✅ Use IDE integration for better workflow
• ✅ Test changes before merging

Resources

• Full Documentation
• FAQ
• Blog - Latest tips and tutorials
• GitHub - Community and issues