Refactor workflow options and steps to introduce Quick and Expert modes

- Updated the main question prompt to clarify workflow building modes.
- Reorganized workflow options into 'Quick Mode' for speed and 'Expert Mode' for complexity.
- Added a new condition group for workflow actions with corresponding options.
- Separated steps for Quick Mode and Expert Mode, enhancing user experience.

Author: moazbuilds

config/main.agents.js

@@ -4,12 +4,12 @@ const promptsDir = path.join(__dirname, '..', 'prompts', 'templates');
 
 module.exports = [
   // ========================================
-  // Ali - CodeMachine Workflow Builder
+  // Ali - CodeMachine Workflow Builder (Expert Mode)
   // ========================================
   {
     id: 'cm-workflow-builder',
     name: 'Ali | The CM Guy',
-    description: 'CodeMachine workflow builder for creating agents, prompts, and workflows',
+    description: 'CodeMachine workflow builder for creating agents, prompts, and workflows (Expert Mode - 5 guided steps)',
     promptPath: [
       path.join(promptsDir, 'ali', 'ali.md'),
       path.join(promptsDir, 'ali', 'workflow.md'),
@@ -38,4 +38,18 @@ module.exports = [
       },
     ],
   },
+
+  // ========================================
+  // Ali - Quick Workflow Builder (Quick Mode)
+  // ========================================
+  {
+    id: 'cm-workflow-builder-quick',
+    name: 'Ali | The CM Guy',
+    description: 'CodeMachine workflow builder - Quick Mode (one-step build with all requirements gathered upfront)',
+    promptPath: [
+      path.join(promptsDir, 'ali', 'ali.md'),
+      path.join(promptsDir, 'ali', 'quick-workflow.md'),
+    ],
+    // No chainedPromptsPath - everything in one step
+  },
 ];

docs/overview.md

@@ -0,0 +1,75 @@
+# Overview
+
+## Get Started in 30 Seconds
+
+```bash
+npm install -g codemachine
+```
+
+```bash
+codemachine
+```
+
+```bash
+/start
+```
+
+That's it. Follow the workflow.
+
+---
+
+## Prerequisites
+
+One working AI engine CLI configured. See supported engines →
+
+---
+
+## Installation
+
+```bash
+# npm
+npm install -g codemachine
+
+# bun
+bun install -g codemachine
+
+# pnpm
+pnpm install -g codemachine
+
+# yarn
+yarn global add codemachine
+```
+
+After installation, run `codemachine` or `cm` from any directory.
+
+---
+
+## What CodeMachine Does For You
+
+### Build Once, Run Forever
+
+Define complex workflows once and execute them reliably on every project. Stop rebuilding the same patterns manually.
+
+### Multi-Agent Orchestration
+
+Assign different coding agents to different tasks.
+
+### Parallel Execution
+
+Run multiple agents simultaneously on different parts of your workflow for faster results.
+
+### Long-Running Workflows
+
+Execute workflows for hours or days. CodeMachine handles persistence so you don't have to babysit.
+
+### Context Engineering
+
+Centralize prompts, manage dynamic context, and control what each agent sees at each step.
+
+---
+
+## Next Steps
+
+- Building Workflows →
+- CLI Reference →
+- Supported Engines →

prompts/templates/ali/chained/step-00-setup.md

@@ -1,18 +1,19 @@
 ---
 name: "Step 00 - Setup"
-description: "Mode selection, workflow concept, and journey preview"
+description: "Welcome, journey preview, and gather workflow context"
 ---
 
-# Step 00: Setup
+# Step 00: Setup (Expert Mode)
 
 ## STEP GOAL
 
-1. Welcome user
+1. Welcome user to Expert Mode
 2. Show journey preview with step count
 3. Explain template.json reset option
-4. Ask mode selection
-5. Gather track-specific context
-6. Push to proceed to Step 01
+4. Gather track-specific context (workflow concept, existing workflow name, or question topic)
+5. Push to proceed to Step 01
+
+**Note:** Mode selection (Quick vs Expert) happens at the workflow track level before this step loads. This is the Expert Mode flow - thorough questions with education as we go.
 
 ## 🚨 CRITICAL RULES FOR STEP 00
 
@@ -45,7 +46,7 @@ You don't have full context in Step 00 - only general info. Always guide user to
 
 **Rule:** Process selected conditions IN ORDER. Never skip ahead. Guide user step-by-step.
 
-## UNIFIED WELCOME (All Tracks)
+## UNIFIED WELCOME (All Actions)
 
 **Calculate step count from `{selected_conditions}` FIRST:**
 
@@ -64,11 +65,13 @@ You don't have full context in Step 00 - only general info. Always guide user to
 
 **Then display this entire message, wait for user response:**
 
-"Welcome to CodeMachine, your one stop for orchestrating any workflows inside your own terminal. I'm Ali, your Workflow Builder.
+"Welcome to **Expert Mode**! I'm Ali, your CodeMachine Workflow Builder.
+
+You've chosen the guided 5-step process where I'll walk you through every detail with thorough explanations.
 
 **You selected:**
-- Track: **{selected_track}**
-- Conditions: **{selected_conditions}**
+- Action: **{selected_conditions}** (from workflow_action)
+- Scope: **{selected_conditions}** (from workflow_scope, if applicable)
 
 **Based on your selections, here's your journey ({total_steps} steps):**
 
@@ -87,66 +90,49 @@ Just delete `./.codemachine/template.json`. A fresh instance of me will load and
 
 ---
 
-**Which mode would you like?**
-
-| Mode | What It Means |
-|------|---------------|
-| **Quick** | Minimum questions, skip explanations |
-| **Expert** | Thorough questions, education as we go |
-
-Enter **1** for Quick or **2** for Expert:"
-
-Wait for response. Store as `mode`.
+Now let's get started!"
 
 ---
 
-## Track-Based Behavior (After Mode Selected)
+## Action-Based Behavior
 
 ### `create-workflow`
 
-**1. Confirm mode:**
-
-- If Quick: "Got it! Quick mode."
-- If Expert: "Great! Expert mode - I'll guide you thoroughly."
-
-**2. Ask for workflow concept (call to action):**
+**Ask for workflow concept:**
 
 "**Describe your workflow idea in 1-2 sentences:**
 
 Example: *'A workflow that reviews pull requests and suggests improvements'*"
 
 Wait for response. Store as `workflow_concept`.
 
-**4. Confirm and proceed:**
+**Confirm and proceed:**
+
+"Excellent! Let's build **{workflow_concept}** together.
 
-"Let's build **{workflow_concept}**!
+I'll guide you thoroughly through each step, explaining CodeMachine concepts as they become relevant.
 
 Press **Enter** to proceed to Step 01: Brainstorming."
 
 ---
 
 ### `modify-workflow`
 
-**1. Confirm mode:**
-
-- If Quick: "Got it! Quick mode."
-- If Expert: "Great! Expert mode."
-
-**2. Ask which workflow (call to action):**
+**Ask which workflow:**
 
 "**Which workflow do you want to modify?**
 
 Enter the workflow name (e.g., `docs-generator`):"
 
 Wait for response. Store as `existing_workflow_name`.
 
-**3. Ask what to modify (call to action):**
+**Ask what to modify:**
 
 "**What do you want to modify in {selected_conditions}?**"
 
 Wait for response. Store as `modify_focus`.
 
-**4. Push to proceed:**
+**Push to proceed:**
 
 "Ready to start modifying **{existing_workflow_name}**.
 
@@ -156,20 +142,15 @@ Press **Enter** to proceed to Step 01."
 
 ### `have-questions`
 
-**1. Confirm mode:**
-
-- If Quick: "Got it! Quick mode."
-- If Expert: "Great! I'll explain thoroughly."
-
-**2. Ask what they need (call to action):**
+**Ask what they need:**
 
 "**What would you like to know about in {selected_conditions}?**"
 
 Wait for response. Store as `question_topic`.
 
-**3. Push to proceed:**
+**Push to proceed:**
 
-"Ready to answer your questions about **{question_topic}**.
+"I'll explain everything thoroughly. Ready to answer your questions about **{question_topic}**.
 
 Press **Enter** to proceed to Step 01."
 
@@ -179,8 +160,8 @@ Press **Enter** to proceed to Step 01."
 
 ```xml
 <step-00 completed="true" timestamp="{ISO timestamp}">
-  <track>{selected_track}</track>
-  <mode>{quick|expert}</mode>
+  <mode>expert</mode>
+  <action>{create-workflow|modify-workflow|have-questions}</action>
   <workflow-concept>{workflow_concept - if create-workflow}</workflow-concept>
   <existing-workflow>{existing_workflow_name - if modify-workflow}</existing-workflow>
   <modify-focus>{modify_focus - if modify-workflow}</modify-focus>
@@ -192,17 +173,15 @@ Press **Enter** to proceed to Step 01."
 
 ## SUCCESS METRICS
 
-- Mode selected (quick/expert)
 - Journey preview shown with step count
-- Track-specific questions answered with clear call to action
+- Action-specific questions answered with clear call to action
 - `create-workflow`: workflow_concept captured
 - `modify-workflow`: existing_workflow_name and modify_focus captured
 - `have-questions`: question_topic captured
 - User pushed to press Enter to proceed
 
 ## FAILURE METRICS
 
-- Skipping mode selection
 - Not showing journey preview with step count
 - Ending on informational content instead of call to action
 - Not asking for workflow concept (create-workflow)

prompts/templates/ali/chained/step-02-workflow-definition.md

@@ -242,14 +242,6 @@ Let's continue!"
 
 ### 5. Ask About Tracks (Optional)
 
-**Quick Mode:**
-"Most workflows don't need tracks. Skipping for now - you can add them later if needed."
-Store `tracks: null` and proceed to Section 7 (Workflow Mode).
-
----
-
-**Expert Mode - Start with intent question:**
-
 "**Quick question:** Will your workflow need different paths for different situations?
 
 For example:
@@ -441,14 +433,6 @@ Ali will inform users about these placeholders when creating prompts in Step 4.
 
 ---
 
-**Quick Mode:**
-"Skipping condition groups - you can add them later if needed."
-Store `conditionGroups: []` and proceed to Section 7.
-
----
-
-**Expert Mode - Start with intent question:**
-
 "**Quick question:** Will some parts of your workflow be optional based on user choices?
 
 For example:
@@ -604,23 +588,6 @@ Repeat if yes. Store all in `conditionGroups` array.
 
 ### 7. Ask About Workflow Mode
 
-**Quick Mode:**
-
-"**How should your workflow run?**
-
-1. **Manual** - You control the flow, agents wait for your input
-2. **Continuous** - Runs start to finish automatically
-3. **Hybrid** - Mix of auto and interactive agents (you decide per-agent)
-4. **Autonomous with Controller** (Beta) - A controller agent responds on your behalf
-
-Enter **1**, **2**, **3**, or **4**:"
-
-Wait for response. Handle same as Expert mode responses below.
-
----
-
-**Expert Mode:**
-
 "**Workflow Execution Mode**
 
 How should your workflow run?
@@ -1076,14 +1043,6 @@ Proceed to Section 8 (Specification Flag).
 
 ### 8. Ask About Specification Flag
 
-**Quick Mode:**
-"Skipping specification file configuration. You can add it later if needed."
-Store `specification: false` and proceed to Section 9.
-
----
-
-**Expert Mode - Smart Inference:**
-
 **Determine likely need based on workflow mode:**
 
 - If `autonomousMode: 'never'` (Manual Mode) OR `interactive: true` without controller → User will provide input through conversation. Specs likely NOT needed.