Workflow Overview
Choose the right development workflow based on your task scope.
Three Layers of Development
Vibe coding supports three different workflows depending on the scope and complexity of your changes. Choosing the right workflow ensures efficient development and proper documentation.
| Workflow | Scope | Planning Tool | Typical Duration |
|---|---|---|---|
| Minor Changes | Single feature, bug fix, small update | Claude Code only | Hours |
| Phase Development | Major feature, multi-task work | Claude Web → VS Code | Days to Weeks |
| Big Changes | App restructure, major pivot | Claude Web → Full docs | Weeks+ |
How to Choose
Use Minor Changes when:
- Adding a single feature or fixing a bug
- Making UI tweaks or content updates
- Changes can be completed in one session
- No architectural decisions needed
Use Phase Development when:
- Adding a major new feature with multiple tasks
- Development spans multiple days
- Need structured planning before coding
- Want to track progress across tasks
Use Big Changes when:
- Restructuring the entire app
- Major pivot in functionality
- Existing documentation is outdated
- Need to recreate all AI documentation
Quick Decision Tree
Is this a single, small change?
├── Yes → Minor Changes
└── No → Does it require new documentation structure?
├── Yes → Big Changes
└── No → Phase Development
Common Scenarios
| Scenario | Recommended Workflow |
|---|---|
| Fix a button color | Minor Changes |
| Add user authentication | Phase Development |
| Convert REST API to GraphQL | Big Changes |
| Update copy text | Minor Changes |
| Add a new dashboard page | Phase Development |
| Rebuild app with new framework | Big Changes |
| Add form validation | Minor Changes |
| Implement notification system | Phase Development |