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.

WorkflowScopePlanning ToolTypical Duration
Minor ChangesSingle feature, bug fix, small updateClaude Code onlyHours
Phase DevelopmentMajor feature, multi-task workClaude Web → VS CodeDays to Weeks
Big ChangesApp restructure, major pivotClaude Web → Full docsWeeks+

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

Minor Changes Guide

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

Phase Development Guide

Use Big Changes when:

  • Restructuring the entire app
  • Major pivot in functionality
  • Existing documentation is outdated
  • Need to recreate all AI documentation

Big Changes Guide

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

ScenarioRecommended Workflow
Fix a button colorMinor Changes
Add user authenticationPhase Development
Convert REST API to GraphQLBig Changes
Update copy textMinor Changes
Add a new dashboard pagePhase Development
Rebuild app with new frameworkBig Changes
Add form validationMinor Changes
Implement notification systemPhase Development