Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 22 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -441,7 +441,9 @@ start_development({ workflow: "waterfall" })

Available workflows include:
- **waterfall**: Classical waterfall development process (default)
- **agile**: Iterative development with sprint cycles
- **epcc**: Explore, Plan, Code, Commit - comprehensive workflow for smaller features
- **bugfix**: Focused workflow for bug fixing: Reproduce, Analyze, Fix, Verify
- **minor-enhancement**: Streamlined workflow for small-impact changes: Explore → Implement
- **custom**: Custom workflow defined in `.vibe/state-machine.yaml`

> **Important**: The `start_development` tool must be called before any other tools (`whats_next`, `proceed_to_phase`, `resume_workflow`). This ensures that development follows a deliberate workflow selection process.
Expand Down Expand Up @@ -568,7 +570,7 @@ The primary tool that analyzes conversation state and provides LLM instructions.
Tool for explicitly transitioning to a new development phase when current phase is complete.

**Parameters:**
- `target_phase` (string): The phase to transition to (requirements, design, implementation, qa, testing, complete)
- `target_phase` (string): The phase to transition to (depends on selected workflow - e.g., waterfall: requirements, design, implementation, qa, testing, complete; epcc: explore, plan, code, commit; minor-enhancement: explore, implement)
- `reason` (string, optional): Reason for transitioning now

**Returns:**
Expand All @@ -577,6 +579,24 @@ Tool for explicitly transitioning to a new development phase when current phase
- `plan_file_path` (string): Path to the plan file to update
- `transition_reason` (string): Confirmation of phase transition

#### `start_development`
Tool for beginning a new development project with a structured workflow. Must be called before any other development tools.

**Parameters:**
- `workflow` (string): Choose your development workflow:
- **waterfall**: Classical waterfall development process (default)
- **epcc**: Explore, Plan, Code, Commit - comprehensive workflow for smaller features
- **bugfix**: Focused workflow for bug fixing: Reproduce, Analyze, Fix, Verify
- **minor-enhancement**: Streamlined workflow for small-impact changes: Explore → Implement
- **custom**: Use custom workflow from .vibe/state-machine.yaml in your project

**Returns:**
- `phase` (string): Initial development phase
- `instructions` (string): Instructions for the initial phase
- `plan_file_path` (string): Path to the plan file
- `conversation_id` (string): Unique conversation identifier
- `workflow` (object): State machine object with workflow details

#### `resume_workflow`
Tool for resuming development workflow after conversation compression. Returns comprehensive project context, current state, system prompt instructions, and next steps to seamlessly continue development.

Expand Down
55 changes: 55 additions & 0 deletions resources/workflows/minor-enhancement.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
# yaml-language-server: $schema=../state-machine-schema.json
---
name: "minor-enhancement"
description: "A streamlined workflow for small-impact changes: Explore (analysis + design) → Implement (code + test + commit) - optimized for minor enhancements"
initial_state: "explore"

# States with default instructions and transitions
states:
explore:
description: "Analysis and design phase - understanding and planning without implementation"
default_instructions: "Starting exploration phase for minor enhancement. Focus on analysis and design only - do not write any code yet. Understand the problem, analyze existing patterns, and design your approach. Consider the scope and impact of the change. Document your analysis and design decisions in the plan file. This phase should be efficient since it's a minor enhancement."
transitions:
- trigger: "exploration_complete"
to: "implement"
instructions: >
Analysis and design complete! ✅ Now transition to implementation phase.
You have a clear understanding of the problem and a solid design approach.
Now implement the solution by writing code, testing it, and preparing for commit.
Follow your design decisions and keep the scope focused on the minor enhancement.
Update the plan file with implementation progress and mark completed exploration tasks.
transition_reason: "Analysis and design complete, ready for streamlined implementation"

- trigger: "abandon_feature"
to: "explore"
instructions: >
Minor enhancement abandoned. Return to exploration state for new tasks.
The plan file will remain for future reference if needed.
additional_instructions: "Minor enhancement development abandoned. Clean up any analysis work and prepare for new tasks."
transition_reason: "User decided to abandon current minor enhancement"

implement:
description: "Combined implementation phase - code, test, and commit"
default_instructions: "Starting implementation phase for minor enhancement. This phase combines coding, testing, and commit preparation. Follow your design from the exploration phase. Write clean, focused code for the minor enhancement. Test your changes to ensure they work correctly and don't break existing functionality. Prepare documentation and commit when ready. Update progress in the plan file."
transitions:
- trigger: "need_more_analysis"
to: "explore"
additional_instructions: "Implementation revealed gaps in analysis or design. Focus on the specific areas that need clarification before continuing with implementation."
transition_reason: "Implementation work revealed need for more analysis or design"

- trigger: "implementation_complete"
to: "explore"
instructions: >
Minor enhancement is complete! ✅ All implementation, testing, and commit work is finished.
The feature is ready for delivery. Return to exploration state, ready for the next minor enhancement or task.
Mark all implementation tasks as complete in the plan file.
additional_instructions: "Minor enhancement is complete and ready for delivery. Prepare for the next development task."
transition_reason: "Minor enhancement delivery complete, ready for next task"

- trigger: "abandon_feature"
to: "explore"
instructions: >
Minor enhancement abandoned during implementation. Clean up any incomplete code and return to exploration.
The plan file and any completed work will remain for future reference.
additional_instructions: "Minor enhancement abandoned during implementation. Clean up any incomplete code and prepare for new tasks."
transition_reason: "User decided to abandon minor enhancement during implementation"