@exaudeus/workrail 0.0.7 → 0.0.9

package/workflows/personal-learning-materials-creation-branched.json

@@ -0,0 +1,188 @@
+{
+  "id": "personal-learning-materials-creation-branched",
+  "name": "Personal Learning Materials Creation Workflow (Branched)",
+  "version": "1.0.0",
+  "description": "A systematic workflow for creating high-quality learning materials with three thoroughness paths: Quick Start (essential materials), Balanced (comprehensive system), and Comprehensive (enterprise-grade). Adapts depth and features based on user time constraints and quality goals.",
+  "clarificationPrompts": [
+    "Do you have a completed learning plan with defined objectives and modules?",
+    "How much time can you dedicate weekly to materials creation?",
+    "What content creation tools do you have access to?",
+    "What material formats work best for your learning style?"
+  ],
+  "preconditions": [
+    "Completed learning plan or course design with clear objectives",
+    "Access to basic content creation tools (word processor, simple design software)",
+    "Time allocated for focused materials development sessions",
+    "Clear understanding of personal learning style preferences"
+  ],
+  "metaGuidance": [
+    "OBJECTIVE ALIGNMENT: Every material must directly support specific learning objectives",
+    "ADAPTIVE DEPTH: Adjust thoroughness based on selected path without compromising quality",
+    "IMMEDIATE USABILITY: Materials should be ready to use without additional setup",
+    "QUALITY OVER QUANTITY: Better fewer high-quality materials than many mediocre ones"
+  ],
+  "steps": [
+    {
+      "id": "phase-0-select-thoroughness-path",
+      "title": "Phase 0: Select Your Materials Creation Path",
+      "prompt": "Choose your learning materials creation approach based on your time, goals, and quality needs:\n\n📚 **Quick Start Path**\n• Timeline: 2-3 weeks (5-8 hours total)\n• Materials: Study guides + basic exercises\n• Best for: Time-constrained learners, getting started quickly\n• Outcome: Functional materials for immediate use\n\n🎯 **Balanced Path**\n• Timeline: 4-6 weeks (12-20 hours total)\n• Materials: Study guides + exercises + assessments + spaced repetition\n• Best for: Comprehensive learning support, professional quality\n• Outcome: Complete learning system with proven effectiveness\n\n🏆 **Comprehensive Path**\n• Timeline: 8-12 weeks (25-40 hours total)\n• Materials: All types + interactive elements + full testing\n• Best for: Professional educators, enterprise-grade projects\n• Outcome: Optimized learning ecosystem with maximum effectiveness\n\nWhich path best matches your timeline and quality goals?",
+      "agentRole": "You are a learning materials consultant specializing in helping users choose the right approach for their constraints and goals. Guide users toward the path that best fits their needs. Set the thoroughnessLevel context variable based on their selection.",
+      "guidance": [
+        "Help users make realistic choices based on their actual time availability",
+        "Explain the trade-offs between speed and comprehensiveness",
+        "Encourage users to start with a simpler path if uncertain"
+      ],
+      "requireConfirmation": true
+    },
+    {
+      "id": "analyze-learning-plan-quick",
+      "runCondition": {"var": "thoroughnessLevel", "equals": "Quick"},
+      "title": "Phase 1: Essential Learning Plan Analysis (Quick Start)",
+      "prompt": "Extract the core elements from your learning plan for rapid materials creation:\n\n**STEP 1: Core Objectives**\n• Identify your 3-5 most important learning objectives\n• Note success criteria for each objective\n• Skip complex prerequisite analysis\n\n**STEP 2: Essential Materials Map**\n• For each objective, identify if you need: study guide, basic exercises, or both\n• Focus on immediate learning needs, not comprehensive coverage\n• Note existing resources that can supplement your materials\n\n**STEP 3: Quick Resource Assessment**\n• List available source materials (books, courses, notes)\n• Identify 2-3 key resources for each objective\n• Note time constraints and creation priorities\n\nGoal: Practical roadmap for essential materials creation in minimal time.",
+      "agentRole": "You are an efficient learning analyst focused on rapid materials development. Help users identify core needs quickly without over-analysis. Emphasize practical, immediately actionable insights.",
+      "guidance": [
+        "Keep analysis focused and action-oriented",
+        "Avoid perfectionism - good enough is good enough",
+        "Focus on high-impact materials that provide immediate value"
+      ],
+      "validationCriteria": [
+        {
+          "type": "contains",
+          "value": "learning objective",
+          "message": "Must identify core learning objectives"
+        },
+        {
+          "type": "contains",
+          "value": "study guide",
+          "message": "Must specify study guide requirements"
+        },
+        {
+          "type": "length",
+          "min": 200,
+          "max": 800,
+          "message": "Analysis should be concise but actionable (200-800 characters)"
+        }
+      ]
+    },
+    {
+      "id": "analyze-learning-plan-balanced",
+      "runCondition": {"var": "thoroughnessLevel", "equals": "Balanced"},
+      "title": "Phase 1: Comprehensive Learning Plan Analysis (Balanced)",
+      "prompt": "Analyze your learning plan to guide professional-quality materials creation:\n\n**STEP 1: Objective Architecture**\n• Extract all learning objectives with success criteria\n• Identify prerequisite relationships between objectives\n• Note assessment strategies for each objective\n• Map objectives to modules and time allocations\n\n**STEP 2: Materials Requirements Matrix**\n• For each objective, determine needed materials: study guides, exercises, assessments\n• Identify concepts requiring multiple reinforcement approaches\n• Note which objectives need spaced repetition support\n• Flag areas requiring practical application or hands-on practice\n\n**STEP 3: Resource Integration Plan**\n• Evaluate existing resources for quality and coverage\n• Identify gaps where custom materials are essential\n• Plan integration between created materials and external resources\n• Design quality standards for materials consistency\n\nGoal: Strategic foundation for professional learning materials system.",
+      "agentRole": "You are a professional instructional designer specializing in systematic materials development. Help users create comprehensive yet practical plans that balance quality with efficiency. Focus on proven instructional design principles.",
+      "guidance": [
+        "Apply instructional design best practices systematically",
+        "Balance thoroughness with practical time constraints",
+        "Focus on materials that work together as a cohesive system"
+      ],
+      "validationCriteria": [
+        {
+          "type": "regex",
+          "pattern": "\\b(prerequisite|dependency|sequence)\\b",
+          "message": "Must analyze learning dependencies and sequencing"
+        },
+        {
+          "type": "contains",
+          "value": "assessment",
+          "message": "Must include assessment strategy planning"
+        },
+        {
+          "type": "length",
+          "min": 400,
+          "max": 1200,
+          "message": "Analysis should be comprehensive (400-1200 characters)"
+        }
+      ]
+    },
+    {
+      "id": "analyze-learning-plan-comprehensive",
+      "runCondition": {"var": "thoroughnessLevel", "equals": "Comprehensive"},
+      "title": "Phase 1: Expert Learning Plan Analysis (Comprehensive)",
+      "prompt": "Conduct thorough analysis of learning architecture for enterprise-grade materials:\n\n**STEP 1: Learning System Architecture**\n• Map complete learning objective hierarchy with dependencies\n• Analyze cognitive load and complexity progression\n• Identify multiple learning pathways and individual differences\n• Design assessment strategy aligned with learning taxonomies\n\n**STEP 2: Advanced Materials Strategy**\n• Determine optimal material types for each learning objective\n• Plan multi-modal approach for different learning styles\n• Design integration points for spaced repetition and active recall\n• Identify opportunities for interactive and adaptive elements\n\n**STEP 3: Quality & Effectiveness Framework**\n• Establish criteria for materials effectiveness measurement\n• Plan user testing and feedback integration\n• Design continuous improvement and iteration protocols\n• Create scalability and maintenance considerations\n\nGoal: Strategic foundation for optimized, enterprise-grade learning ecosystem.",
+      "agentRole": "You are an expert learning systems architect with deep expertise in advanced instructional design and learning optimization. Guide users in creating sophisticated materials that maximize learning effectiveness through evidence-based approaches.",
+      "guidance": [
+        "Apply advanced learning science principles and research",
+        "Focus on long-term effectiveness and optimization",
+        "Design for scalability and continuous improvement"
+      ],
+      "validationCriteria": [
+        {
+          "type": "regex",
+          "pattern": "\\b(taxonomy|cognitive|architecture)\\b",
+          "message": "Must apply advanced learning science principles"
+        },
+        {
+          "type": "contains",
+          "value": "effectiveness",
+          "message": "Must include effectiveness measurement planning"
+        },
+        {
+          "type": "length",
+          "min": 600,
+          "max": 1500,
+          "message": "Analysis should be sophisticated and comprehensive (600-1500 characters)"
+        }
+      ]
+    },
+    {
+      "id": "develop-materials-strategy-quick",
+      "runCondition": {"var": "thoroughnessLevel", "equals": "Quick"},
+      "title": "Phase 2: Efficient Materials Strategy (Quick Start)",
+      "prompt": "Create a focused strategy for essential materials creation:\n\n**STEP 1: Format Selection**\n• Choose 1-2 primary formats based on your learning style\n• Prioritize formats you can create quickly (text-based, simple templates)\n• Plan minimal but consistent formatting approach\n• Focus on immediate usability over visual polish\n\n**STEP 2: Creation Workflow**\n• Design simple templates for study guides and exercises\n• Plan batch creation approach to maximize efficiency\n• Set realistic quality standards (functional over perfect)\n• Create basic organization system for easy access\n\n**STEP 3: Quality Framework**\n• Establish minimum viable product standards\n• Plan quick self-review process\n• Design simple feedback collection for future improvement\n• Focus on completion over perfection\n\nGoal: Practical strategy for rapid materials creation without sacrificing core functionality.",
+      "agentRole": "You are an efficiency expert specializing in rapid content creation. Help users design streamlined approaches that maximize output while maintaining essential quality. Focus on practical, time-saving strategies.",
+      "guidance": [
+        "Emphasize efficiency and speed over perfection",
+        "Choose simple, proven formats that work reliably",
+        "Design for immediate action and quick completion"
+      ],
+      "validationCriteria": [
+        {
+          "type": "contains",
+          "value": "template",
+          "message": "Must include template design for efficiency"
+        },
+        {
+          "type": "regex",
+          "pattern": "\\b(efficient|quick|simple)\\b",
+          "message": "Must emphasize efficiency and simplicity"
+        },
+        {
+          "type": "length",
+          "min": 300,
+          "max": 900,
+          "message": "Strategy should be focused and actionable (300-900 characters)"
+        }
+      ]
+    },
+    {
+      "id": "develop-materials-strategy-comprehensive",
+      "runCondition": {"var": "thoroughnessLevel", "equals": "Comprehensive"},
+      "title": "Phase 2: Advanced Materials Strategy (Comprehensive)",
+      "prompt": "Develop sophisticated strategy for enterprise-grade materials:\n\n**STEP 1: Multi-Modal Format Strategy**\n• Design format variety to engage different learning modes\n• Plan advanced visual elements, interactive components, adaptive features\n• Create sophisticated template system with consistent branding\n• Consider accessibility, mobile optimization, and universal design\n\n**STEP 2: Integration Architecture**\n• Plan seamless connections between all material types\n• Design advanced spaced repetition integration with learning analytics\n• Create sophisticated cross-referencing and linking systems\n• Plan for collaborative features and social learning elements\n\n**STEP 3: Quality Excellence Framework**\n• Establish enterprise-grade quality standards and measurement\n• Design comprehensive user testing and feedback integration\n• Plan continuous optimization based on learning effectiveness data\n• Create scalable maintenance and update protocols\n\nGoal: Strategic foundation for learning materials that optimize effectiveness through sophisticated design.",
+      "agentRole": "You are a learning systems architect with expertise in enterprise-grade materials design. Help users create sophisticated strategies that maximize learning effectiveness through advanced features and optimization.",
+      "guidance": [
+        "Apply advanced instructional design and learning optimization principles",
+        "Focus on long-term effectiveness and continuous improvement",
+        "Design for scalability and enterprise deployment"
+      ],
+      "validationCriteria": [
+        {
+          "type": "regex",
+          "pattern": "\\b(integration|optimization|analytics)\\b",
+          "message": "Must include advanced integration and optimization planning"
+        },
+        {
+          "type": "contains",
+          "value": "effectiveness",
+          "message": "Must focus on learning effectiveness measurement"
+        },
+        {
+          "type": "length",
+          "min": 600,
+          "max": 1400,
+          "message": "Strategy should be sophisticated and comprehensive (600-1400 characters)"
+        }
+      ]
+    }
+  ]
+} 

package/workflows/presentation-creation.json

@@ -1,7 +1,7 @@
 {
   "id": "presentation-creation",
   "name": "Dynamic Presentation Creation Workflow",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "A comprehensive workflow for creating dynamic, interesting, and insightful presentations. Guides users through audience analysis, content strategy, visual design, and delivery preparation to create compelling presentations that engage and inform.",
   "preconditions": [
     "User has a clear presentation topic or objective",
@@ -22,6 +22,7 @@
       "id": "audience-and-context-analysis",
       "title": "Audience & Context Analysis",
       "prompt": "**PREP**: Thoroughly analyze your audience and presentation context to ensure maximum impact.\n\n**IMPLEMENT**: Create a detailed audience profile:\n- **Audience Demographics**: Professional background, expertise level, role/seniority\n- **Audience Motivations**: What they want to learn, their pain points, success criteria\n- **Context Analysis**: Event type, setting, time constraints, follow-up expectations\n- **Engagement Preferences**: Interactive vs. presentation style, Q&A expectations\n- **Success Metrics**: How will you measure if the presentation achieved its goals?\n\n**VERIFY**: Confirm you have a clear understanding of who you're presenting to and what success looks like.",
+      "agentRole": "You are an audience research specialist and presentation strategist with expertise in understanding diverse professional audiences. Your strength lies in identifying audience needs, motivations, and preferences to ensure presentations resonate and achieve their intended impact.",
       "guidance": [
         "The better you understand your audience, the more you can tailor your message",
         "Consider both explicit and implicit audience needs",
@@ -50,6 +51,7 @@
       "id": "content-strategy-and-structure",
       "title": "Content Strategy & Structure Development",
       "prompt": "**PREP**: Develop a compelling content strategy that aligns with your audience analysis.\n\n**IMPLEMENT**: Create a structured content plan:\n- **Core Message**: One clear, memorable takeaway (elevator pitch version)\n- **Supporting Arguments**: 3-5 key points that reinforce your core message\n- **Narrative Arc**: How will you take the audience on a journey? (problem → solution → impact)\n- **Evidence Strategy**: Data, examples, stories, and visuals that support each point\n- **Engagement Hooks**: Surprising statistics, thought-provoking questions, interactive elements\n- **Call-to-Action**: What specific action do you want the audience to take?\n\n**VERIFY**: Ensure your content strategy creates a logical flow that serves your audience's needs while achieving your objectives.",
+      "agentRole": "You are a presentation design expert and storytelling specialist with extensive experience in crafting compelling content strategies. Your expertise lies in transforming complex information into engaging narratives that drive audience action and understanding.",
       "guidance": [
         "Start with your core message - everything else should support it",
         "Use the 'So What?' test for each section - why should the audience care?",
@@ -84,6 +86,7 @@
       "id": "slide-structure-and-flow",
       "title": "Slide Structure & Flow Design",
       "prompt": "**PREP**: Transform your content strategy into a detailed slide-by-slide structure.\n\n**IMPLEMENT**: Create a comprehensive slide outline:\n- **Opening Hook** (1-2 slides): Attention grabber, context setting, agenda preview\n- **Main Content Blocks** (8-15 slides): Each supporting argument with evidence and examples\n- **Transition Slides**: Smooth connections between major sections\n- **Interaction Points**: Polls, Q&A moments, discussion breaks\n- **Visual Hierarchy**: Which slides need charts, images, diagrams, or minimal text\n- **Pacing Strategy**: Balance of information density vs. breathing room\n- **Closing Impact** (2-3 slides): Summary, call-to-action, next steps\n\n**VERIFY**: Review the flow for logical progression, appropriate pacing, and engagement variety.",
+      "agentRole": "You are a presentation structure architect with expertise in information design and audience engagement flow. Your specialty is creating logical, well-paced slide sequences that maintain audience attention while effectively conveying complex information.",
       "guidance": [
         "Follow the 6x6 rule: max 6 bullet points with 6 words each",
         "Plan for one key idea per slide",
@@ -118,6 +121,7 @@
       "id": "visual-design-and-engagement",
       "title": "Visual Design & Engagement Elements",
       "prompt": "**PREP**: Design the visual and interactive elements that will make your presentation dynamic and memorable.\n\n**IMPLEMENT**: Plan comprehensive visual and engagement strategy:\n- **Visual Theme**: Color scheme, typography, consistent design language\n- **Data Visualization**: Chart types, infographic concepts, before/after comparisons\n- **Multimedia Elements**: Video clips, animations, interactive demos\n- **Storytelling Visuals**: Metaphors, analogies, journey maps\n- **Engagement Techniques**: Live polls, breakout discussions, hands-on activities\n- **Memory Aids**: Mnemonics, repeated visual themes, callback references\n- **Accessibility**: Readable fonts, color contrast, alternative text descriptions\n\n**VERIFY**: Ensure visual elements enhance rather than distract from your message, and engagement techniques fit naturally into your flow.",
+      "agentRole": "You are a UX/visual design consultant and engagement specialist with expertise in presentation design and audience interaction. Your strength lies in creating cohesive visual experiences that enhance message delivery while maintaining accessibility and professional standards.",
       "guidance": [
         "Visuals should simplify complex ideas, not complicate simple ones",
         "Use consistent visual language throughout the presentation",
@@ -147,6 +151,7 @@
       "id": "content-development-and-refinement",
       "title": "Content Development & Refinement",
       "prompt": "**PREP**: Develop the actual presentation content, focusing on clarity, impact, and memorability.\n\n**IMPLEMENT**: Create polished presentation content:\n- **Slide Content**: Write clear, concise text for each slide following your outline\n- **Speaker Notes**: Detailed talking points, transitions, and timing cues\n- **Stories and Examples**: Develop compelling narratives that illustrate your points\n- **Data Presentation**: Create clear, impactful visualizations of key statistics\n- **Interaction Scripts**: Prepare questions, poll options, and facilitation guidance\n- **Backup Content**: Extra slides for deep-dive questions or extended time\n- **Handout Materials**: Summary sheets, resource lists, contact information\n\n**VERIFY**: Review content for clarity, accuracy, and alignment with your core message. Test that examples resonate with your target audience.",
+      "agentRole": "You are a professional content developer and presentation writer with expertise in translating complex ideas into clear, engaging presentation content. Your strength lies in crafting compelling narratives, developing relevant examples, and creating speaker-friendly materials that ensure confident delivery.",
       "guidance": [
         "Write for the ear, not the eye - content should sound natural when spoken",
         "Use active voice and concrete language",
@@ -177,6 +182,7 @@
       "id": "practice-and-timing",
       "title": "Practice & Timing Optimization",
       "prompt": "**PREP**: Develop a practice strategy to ensure confident, well-timed delivery.\n\n**IMPLEMENT**: Create a comprehensive practice plan:\n- **Run-Through Schedule**: Multiple practice sessions with increasing realism\n- **Timing Benchmarks**: Target time for each section with buffer zones\n- **Difficult Transitions**: Extra practice on challenging sections or technical demonstrations\n- **Q&A Preparation**: Anticipated questions with prepared responses\n- **Contingency Planning**: Backup plans for technical issues, timing problems, or unexpected situations\n- **Feedback Integration**: Plan for getting feedback and making final adjustments\n- **Confidence Building**: Techniques for managing nerves and maintaining energy\n\n**VERIFY**: Ensure you have a realistic practice schedule that will prepare you for confident delivery.",
+      "agentRole": "You are a presentation coach and performance specialist with expertise in helping speakers develop confidence and delivery skills. Your focus is on practical preparation strategies that ensure speakers can deliver their content effectively under various conditions.",
       "guidance": [
         "Practice out loud - silent review is not enough",
         "Time each section and the overall presentation",
@@ -206,6 +212,7 @@
       "id": "delivery-preparation-and-logistics",
       "title": "Delivery Preparation & Logistics",
       "prompt": "**PREP**: Finalize all logistical and technical aspects for smooth presentation delivery.\n\n**IMPLEMENT**: Complete pre-delivery checklist:\n- **Technical Setup**: Test all equipment, backup plans, file compatibility\n- **Materials Preparation**: Printed notes, handouts, business cards, feedback forms\n- **Venue Familiarization**: Room layout, microphone, lighting, seating arrangement\n- **Personal Preparation**: Wardrobe, arrival time, pre-presentation routine\n- **Follow-up Planning**: How to share slides, continue conversations, measure impact\n- **Emergency Protocols**: Contact information, backup equipment, alternative delivery methods\n- **Final Review**: Last-minute content updates, current examples, pronunciation check\n\n**VERIFY**: Confirm all logistical elements are in place and you have contingency plans for potential issues.",
+      "agentRole": "You are an event logistics coordinator and presentation delivery specialist with expertise in ensuring flawless presentation execution. Your focus is on comprehensive preparation that anticipates and mitigates potential issues while ensuring professional delivery standards.",
       "guidance": [
         "Arrive early to test technology and get comfortable with the space",
         "Have multiple backup options for critical technical components",

package/workflows/workflow-for-workflows.json

@@ -1,7 +1,7 @@
 {
   "id": "workflow-for-workflows",
   "name": "Progressive Workflow Creation Guide",
-  "version": "0.0.2",
+  "version": "0.1.0",
   "description": "An adaptive meta-workflow that guides users through creating high-quality workflow templates with personalized learning paths. Offers three experience-based approaches: Basic (step-by-step with detailed explanations), Intermediate (balanced guidance with examples), and Advanced (comprehensive features with expert context). All paths can produce sophisticated workflows - the difference is in explanation depth and feature introduction timing.",
   "clarificationPrompts": [
     "What's your experience level with workflow creation? (New to this / Some experience / Very experienced)",
@@ -31,11 +31,12 @@
     {
       "id": "phase-0-discovery",
       "title": "Phase 0: Comprehensive Discovery & Requirements Analysis",
-      "prompt": "Before we build, let's understand the 'why'. This phase ensures your new workflow solves the right problem for the right people.\n\n**STEP 1: Define the Core Problem & Goal**\n\n- **Problem Statement**: Describe the specific, recurring task or problem this new workflow will solve.\n- **Primary Objective**: What is the single most important outcome or key message of completing this workflow?\n- **Critical Failure Mode**: What is the most critical error or negative outcome this workflow is designed to prevent?\n\n**STEP 2: Understand the Users & Context**\n\n- **Target Audience**: Who is this workflow for? Describe their role, expertise level, and what they need to succeed.\n- **Usage Context**: In what situation will this workflow be used? (e.g., during code review, content planning, incident response, customer onboarding).\n\n**STEP 3: Gather Materials & Define Success**\n\n- **Supporting Materials**: What supporting documents, data, or examples are available that could inform the design?\n- **Constraints & Requirements**: Are there any specific constraints, required tools, or other requirements to consider?\n- **Success Metrics**: How will you measure if this workflow is successful? What does a high-quality result look like?\n\n**Agent Guidance**: Synthesize this information and confirm your understanding before proceeding. Use `workflow_list` and `workflow_get` to find suitable templates based on the problem *structure*, not necessarily the domain.",
+      "prompt": "**STEP 1: Define the Core Problem & Goal**\n\n- **Problem Statement**: What is the specific, recurring task or problem this new workflow will solve?\n- **Primary Objective**: What is the single most important outcome you want users to achieve by completing this workflow?\n- **Critical Failure Mode**: What is the most critical error or negative outcome this workflow is designed to prevent?\n\n**STEP 2: Understand the Users & Context**\n\n- **Target Audience**: Who is this workflow for? What is their role, expertise level, and what do they need to succeed?\n- **Usage Context**: In what situation or environment will this workflow be used? (e.g., during code review, content planning, incident response, customer onboarding).\n\n**STEP 3: Gather Materials & Define Success**\n\n- **Supporting Materials**: What supporting documents, data, or examples can you provide that could inform the design?\n- **Constraints & Requirements**: Are there any specific constraints, required tools, or other absolute requirements to consider?\n- **Success Metrics**: How will you measure if this workflow is successful? What does a high-quality result look like?\n\n**Agent Guidance**: After gathering the user's answers, your goal is to synthesize them into a refined problem statement. Use `workflow_list` and `workflow_get` to find suitable templates based on the problem *structure*, not necessarily the domain, and present your findings for confirmation.",
+      "agentRole": "You are a workflow requirements analyst and discovery specialist with expertise in understanding complex business processes and user needs. Your primary goal is to ask the user the questions below to understand their needs. Do not answer these questions yourself. Wait for the user's detailed response, then synthesize their answers and confirm your understanding before proceeding. Your role is to ask insightful questions, synthesize information effectively, and identify suitable workflow patterns that can be adapted to new use cases.",
       "guidance": [
-        "BE SPECIFIC: Vague goals lead to vague workflows. The more precise you are here, the better the final product.",
-        "THINK ABOUT THE USER: A workflow for an expert looks very different from one for a novice. Empathize with your audience.",
-        "PROVIDE EXAMPLES: If you have examples of the problem or desired outcome, share them now.",
+        "BE SPECIFIC: Vague goals lead to vague workflows. The more precise the user's answers are here, the better the final product.",
+        "THINK ABOUT THE USER: A workflow for an expert looks very different from one for a novice. Encourage the user to be detailed about their audience.",
+        "REQUEST EXAMPLES: If the user mentions examples of the problem or desired outcome, ask them to share them.",
         "TEMPLATE STRATEGY: Focus on structural similarity, not domain similarity, when recommending templates. A good 'bug investigation' workflow might be a great template for a 'customer complaint' workflow."
       ],
       "askForFiles": true,
@@ -45,6 +46,7 @@
       "id": "phase-1-assessment",
       "title": "Phase 1: Personalized Learning Path Selection",
       "prompt": "Excellent! With a clear understanding of your goals, let's choose the best way to build your workflow.\n\nPlease select your experience level with workflow creation to get a personalized-path:\n\n🌱 **Basic Path - \"Learn by Doing with Explanation\"**\n   - New to workflows or want thorough understanding\n   - Step-by-step guidance with detailed explanations\n   - Progressive introduction of advanced features with context\n   - Focus: Understanding concepts and building confidence\n\n🚀 **Intermediate Path - \"Balanced Guidance with Examples\"**\n   - Some experience with automation or process design\n   - Structured approach with practical examples\n   - Feature recommendations based on your use case\n   - Focus: Efficient workflow creation with best practices\n\n🏆 **Advanced Path - \"Full Features with Expert Context\"**\n   - Experienced with workflow/automation tools\n   - Comprehensive feature access from the start\n   - Architectural guidance and performance considerations\n   - Focus: Sophisticated workflow engineering\n\n**Agent Guidance**: Based on the user's selection, set the `learningPath` context variable to 'basic', 'intermediate', or 'advanced'.",
+      "agentRole": "You are a workflow education specialist and learning path advisor with expertise in adapting technical instruction to different experience levels. Your role is to help users choose the most appropriate learning approach based on their background and goals.",
       "guidance": [
         "PATH EXPLANATION: Clearly explain what each learning path offers so users can make an informed choice based on the discovery from Phase 0.",
         "QUALITY FOCUS: All paths should result in high-quality workflows. The difference is in teaching approach, not final capability."
@@ -55,7 +57,8 @@
       "id": "phase-2-basic",
       "runCondition": {"var": "learningPath", "equals": "basic"},
       "title": "Phase 2: Guided Workflow Creation (Basic Path)",
-      "prompt": "Let's create your workflow step-by-step with detailed explanations! 🌱\n\n**UNDERSTANDING WORKFLOWS:**\nA workflow is like a recipe that guides someone (or an AI) through a complex task. It has:\n- **Metadata**: Name, description, and settings\n- **Steps**: The actual instructions to follow\n- **Features**: Special capabilities like conditional logic\n\n**STEP 1: Create Your Workflow File**\nAgent: Ask the user for a filename (e.g., `my-workflow.json`) and create the file using the template from Phase 1. Explain each field as you add it.\n\n**STEP 2: Build the Structure Together**\nWe'll go through each part of your workflow:\n\n1. **Basic Info** (`id`, `name`, `version`, `description`)\n   - Agent: Explain why each field matters and help craft clear, descriptive content\n\n2. **Setup Requirements** (`preconditions`)\n   - Agent: Explain what preconditions are and why they prevent problems\n\n3. **Global Rules** (`metaGuidance`)\n   - Agent: Explain the difference between global rules and step-specific instructions\n\n4. **The Action Steps** (`steps`)\n   - Agent: Start with simple linear steps, but explain that workflows can also have:\n     - **Conditional steps**: \"Do this IF condition is true\"\n     - **Context variables**: Information that flows between steps\n     - **Validation**: Automatic quality checks\n   - If the user's workflow needs these features, introduce them with clear examples\n\n**LEARNING FOCUS:** Understanding what each piece does and why it's useful.",
+      "prompt": "Let's create your workflow step-by-step with detailed explanations! 🌱\n\n**STEP 1: Create Your Workflow File**\nFirst, what would you like to name your new workflow file? (e.g., `my-workflow.json`)\n\n(Agent: After getting the filename, create the file using the template from Phase 1, then explain each field as you help the user fill it out.)\n\n**STEP 2: Build the Structure Together**\nNow, let's go through each part of your workflow one by one:\n\n1.  **Basic Info** (`id`, `name`, `version`, `description`)\n    - (Agent: For each field, explain why it matters and help the user craft clear, descriptive content.)\n2.  **Setup Requirements** (`preconditions`)\n    - (Agent: Explain what preconditions are, why they prevent problems, and ask the user what's needed.)\n3.  **Global Rules** (`metaGuidance`)\n    - (Agent: Explain the difference between global rules and step-specific instructions, and ask for input.)\n4.  **The Action Steps** (`steps`)\n    - (Agent: Guide the user in creating simple, linear steps first. Then, explain that workflows can also have more advanced features. If their workflow seems to need them, introduce concepts like conditional steps, context variables, and validation with clear examples and ask if they'd like to add them.)\n\n**LEARNING FOCUS:** We'll focus on understanding what each piece does and why it's useful.",
+      "agentRole": "You are a patient and thorough workflow education instructor specializing in teaching beginners. Your goal is to guide the user collaboratively. Ask for one piece of information at a time, explain the concepts, and wait for their input before proceeding. Your expertise lies in breaking down complex concepts into understandable steps, providing clear explanations for why each element matters, and building user confidence through hands-on learning.",
       "guidance": [
         "EXPLAIN EVERYTHING: This user is learning. Explain the purpose of each JSON field and workflow concept.",
         "PROGRESSIVE FEATURES: Start with basics, introduce advanced features (conditional steps, context variables) when the use case needs them - with full explanations.",
@@ -90,7 +93,8 @@
       "id": "phase-2-intermediate",
       "runCondition": {"var": "learningPath", "equals": "intermediate"},
       "title": "Phase 2: Structured Workflow Development (Intermediate Path)",
-      "prompt": "Let's build your workflow with a structured approach and best practices! 🚀\n\n**STEP 1: Initialize Workflow File**\nAgent: Request a filename and create the workflow file using the template from Phase 1. Use efficient, clear explanations.\n\n**STEP 2: Core Structure Development**\nWe'll build your workflow systematically:\n\n1. **Metadata & Identity** (`id`, `name`, `version`, `description`)\n   - Focus on discoverability and clear communication\n   - Best practice: Make names searchable and descriptions actionable\n\n2. **Operational Requirements** (`preconditions`, `metaGuidance`)\n   - Define what's needed before starting\n   - Establish global rules for consistency\n\n3. **Enhanced Features** (based on your workflow type):\n   - **Clarification Prompts**: Gather better input upfront\n   - **Validation Criteria**: Automatic quality checks\n   - **Context Variables**: When you need information to flow between steps\n   - **Conditional Logic**: For workflows with decision points\n\n4. **Step Architecture**\n   - Design clear, actionable steps\n   - Add confirmation gates for critical actions\n   - Include file sharing when collaboration is needed\n\n**FEATURE RECOMMENDATIONS:**\nAgent: Based on the workflow type, recommend specific features. For example:\n- Coding workflows → validation criteria + confirmation gates\n- Analysis workflows → context variables + clarification prompts\n- Process workflows → conditional steps + clear guidance\n\n**EFFICIENCY FOCUS:** Building professionally structured workflows with appropriate features.",
+      "prompt": "Let's build your workflow with a structured approach and best practices! 🚀\n\n**STEP 1: Initialize Workflow File**\nFirst, what would you like to name your new workflow file?\n\n(Agent: After getting the filename, create the file using the template from Phase 1. Use efficient, clear explanations as you guide the user through the core structure.)\n\n**STEP 2: Core Structure Development**\nWe'll build your workflow systematically. For each section, I will explain its purpose and best practices, then ask for your input:\n\n1.  **Metadata & Identity** (`id`, `name`, `version`, `description`)\n    - Focus on discoverability and clear communication.\n2.  **Operational Requirements** (`preconditions`, `metaGuidance`)\n    - Define what's needed before starting and establish global rules.\n3.  **Step Architecture**\n    - Design clear, actionable steps.\n\n**STEP 3: Enhanced Feature Recommendations**\nBased on your workflow's purpose, I may recommend specific features like:\n- **Clarification Prompts**: To gather better input upfront.\n- **Validation Criteria**: For automatic quality checks.\n- **Context Variables**: When you need information to flow between steps.\n- **Conditional Logic**: For workflows with decision points.\n\n(Agent: As you build the steps, proactively recommend these features where they seem appropriate, explaining the benefits.)\n\n**EFFICIENCY FOCUS:** We'll focus on building a professionally structured workflow with the right features for the job.",
+      "agentRole": "You are an experienced workflow development consultant with expertise in efficient workflow creation and best practices. You will act as a collaborator, guiding the user through the creation process efficiently. Your role is to guide users through structured development while recommending appropriate features and maintaining professional standards.",
       "guidance": [
         "STRUCTURED APPROACH: Follow a logical sequence with clear reasoning for each decision.",
         "FEATURE RECOMMENDATIONS: Suggest appropriate features based on workflow type and use case.",
@@ -125,7 +129,8 @@
       "id": "phase-2-advanced",
       "runCondition": {"var": "learningPath", "equals": "advanced"},
       "title": "Phase 2: Comprehensive Workflow Architecture (Advanced Path)",
-      "prompt": "Let's architect a sophisticated workflow with full feature utilization! 🏆\n\n**STEP 1: Rapid File Initialization**\nAgent: Create the workflow file with the template foundation. Focus on architectural decisions.\n\n**STEP 2: Architectural Design**\nComprehensive workflow engineering:\n\n1. **Core Architecture** (`id`, `name`, `version`, `description`)\n   - Semantic versioning strategy\n   - Namespace considerations for organizational use\n   - Description as API documentation\n\n2. **Operational Design** (`preconditions`, `metaGuidance`, `contextVariables`)\n   - Comprehensive precondition modeling\n   - Sophisticated metaGuidance for complex scenarios\n   - Context variable architecture for data flow\n\n3. **Advanced Feature Implementation**:\n   - **Complex Conditional Logic**: Nested conditions, multiple variable evaluation\n   - **Validation Architecture**: Multi-layered validation with custom criteria\n   - **User Experience Design**: Clarification prompts, confirmation patterns, file sharing\n   - **Performance Considerations**: Step efficiency, resource optimization\n\n4. **Enterprise-Grade Features**:\n   - **Error Handling**: Comprehensive failure modes\n   - **Scalability**: Design for reuse and extension\n   - **Maintainability**: Clear separation of concerns\n   - **Integration**: API-ready for workflow orchestration systems\n\n**ARCHITECTURAL DECISIONS:**\nAgent: Discuss trade-offs and design patterns. Consider:\n- When to use conditional vs. separate workflows\n- Context variable scope and lifecycle\n- Validation strategy (fail-fast vs. comprehensive)\n- Step granularity for optimal user experience\n\n**MASTERY FOCUS:** Creating enterprise-grade workflows with sophisticated architecture.",
+      "prompt": "Let's architect a sophisticated workflow with full feature utilization. 🏆\n\n**STEP 1: Rapid File Initialization**\nTo begin, what filename shall we use for the new workflow?\n\n(Agent: After getting the filename, create the file with the template foundation. Then, shift the focus to architectural decisions.)\n\n**STEP 2: Architectural Design Discussion**\nLet's discuss the high-level architecture. For each area, I will present advanced considerations and ask for your design choices:\n\n1.  **Core Architecture** (`id`, `name`, `version`, `description`)\n    - (Agent: Discuss semantic versioning strategy, namespace considerations, and treating the description as API documentation.)\n2.  **Operational Design** (`preconditions`, `metaGuidance`, `contextVariables`)\n    - (Agent: Discuss comprehensive precondition modeling, sophisticated metaGuidance for complex scenarios, and context variable architecture for data flow.)\n3.  **Advanced Feature Implementation & Step Design**\n    - (Agent: Discuss trade-offs and design patterns for conditional logic, validation strategy, user experience, performance, and enterprise-grade features like error handling and scalability.)\n\n**MASTERY FOCUS:** Our goal is to collaborate on creating an enterprise-grade workflow with a sophisticated and intentional architecture.",
+      "agentRole": "You are a senior workflow architect and systems design expert with deep expertise in enterprise-grade workflow engineering. Your role is to act as an architectural consultant. You will propose design patterns and discuss trade-offs with the user. Your role is to engage in sophisticated technical discussions, propose advanced design patterns, and help users create workflows that meet enterprise standards for scalability, maintainability, and performance.",
       "guidance": [
         "ARCHITECTURAL THINKING: Focus on design patterns, scalability, and maintainability.",
         "FULL FEATURE ACCESS: Leverage the complete feature set appropriately for the use case.",
@@ -160,7 +165,8 @@
       "id": "phase-3-basic",
       "runCondition": {"var": "learningPath", "equals": "basic"},
       "title": "Phase 3: Learning Through Validation (Basic Path)",
-      "prompt": "Great! Your workflow draft is complete. Now let's make sure it works perfectly! 🌱\n\n**UNDERSTANDING VALIDATION:**\nValidation is like proofreading - it catches mistakes before they cause problems. Our validation tool will check:\n- **Syntax**: Is the JSON format correct?\n- **Structure**: Are all required fields present?\n- **Logic**: Do the conditions and references make sense?\n\n**STEP 1: Run Your First Validation**\nAgent: Use `workflow_validate_json` to check the workflow. Explain what the tool is doing and why each check matters.\n\n**STEP 2: Learning from Errors (Don't worry - errors are normal!)**\nAgent: If there are errors (and there usually are!):\n1. **Explain each error type** in simple terms\n2. **Show exactly where** the problem is\n3. **Explain why** it's a problem\n4. **Guide the fix** step-by-step\n5. **Rerun validation** to see progress\n\n**COMMON ERROR TYPES YOU MIGHT SEE:**\n- **Missing quotes**: JSON needs quotes around text\n- **Missing commas**: JSON items need separators\n- **Invalid references**: Steps referencing things that don't exist\n- **Logic errors**: Conditions that don't make sense\n\n**LEARNING GOAL:** Understanding what makes a workflow valid and why each rule exists.\n\nRemember: Every error is a learning opportunity! Professional developers deal with validation errors all the time.",
+      "prompt": "Great! Your workflow draft is complete. Now let's make sure it works perfectly! 🌱\n\n**UNDERSTANDING VALIDATION:**\nValidation is like proofreading - it catches mistakes before they cause problems. Our validation tool will check for issues with syntax, structure, and logic.\n\n**STEP 1: Run Your First Validation**\nI will now use the `workflow_validate_json` tool to check your workflow. I'll explain what the tool is doing and why each check matters.\n\n(Agent: Run the tool.)\n\n**STEP 2: Learning from Errors (Don't worry - errors are normal!)**\nIf there are errors, I will guide you through them one at a time:\n1.  **Explain the error** in simple terms.\n2.  **Show you where** the problem is in the file.\n3.  **Explain why** it's a problem.\n4.  **Help you fix it** step-by-step.\n5.  Then, we'll **rerun validation** to see our progress.\n\n**LEARNING GOAL:** Our goal is to understand what makes a workflow valid and why each rule exists. Every error is a learning opportunity!",
+      "agentRole": "You are a supportive workflow validation instructor with expertise in teaching through problem-solving. Your goal is to run the validation tool and then guide the user through fixing any errors one by one, explaining each concept as you go. Your role is to turn validation errors into learning opportunities, explaining technical concepts in accessible terms while building user confidence in workflow creation.",
       "guidance": [
         "EDUCATIONAL APPROACH: Treat each error as a teaching moment. Explain what went wrong and why the rule exists.",
         "STEP-BY-STEP FIXES: Guide through each fix individually, don't overwhelm with multiple changes.",
@@ -174,7 +180,8 @@
       "id": "phase-3-intermediate",
       "runCondition": {"var": "learningPath", "equals": "intermediate"},
       "title": "Phase 3: Systematic Validation & Quality Assurance (Intermediate Path)",
-      "prompt": "Time to validate and refine your workflow with systematic quality checks! 🚀\n\n**VALIDATION STRATEGY:**\nWe'll use a layered approach to ensure your workflow is both technically correct and professionally robust.\n\n**STEP 1: Comprehensive Validation**\nAgent: Execute `workflow_validate_json` for complete structural and logical validation.\n\n**STEP 2: Error Pattern Analysis**\nAgent: When issues are found:\n1. **Categorize errors** by type (syntax, logic, reference, etc.)\n2. **Identify patterns** that might indicate systemic issues\n3. **Prioritize fixes** (critical syntax errors first, then logic improvements)\n4. **Apply fixes systematically** using `edit_file`\n5. **Re-validate incrementally** to confirm progress\n\n**QUALITY CHECKPOINTS:**\n- **Structural Integrity**: All required fields, proper JSON formatting\n- **Logical Consistency**: Step references, condition logic, context variables\n- **Best Practice Compliance**: Naming conventions, description quality\n- **Feature Integration**: Proper use of advanced features\n\n**PROFESSIONAL PATTERNS:**\n- Group related fixes together for efficiency\n- Document any trade-offs or design decisions\n- Test edge cases in conditional logic\n- Ensure error messages are actionable\n\n**EFFICIENCY FOCUS:** Systematic error resolution with pattern recognition for faster iteration.",
+      "prompt": "Time to validate and refine your workflow with systematic quality checks. 🚀\n\n**STEP 1: Comprehensive Validation**\nI will now execute `workflow_validate_json` for a complete structural and logical validation of your workflow.\n\n(Agent: Run the tool.)\n\n**STEP 2: Error Pattern Analysis & Resolution**\nWhen issues are found, we will address them systematically:\n1.  **Categorize errors** by type (e.g., syntax, logic, reference).\n2.  **Identify patterns** that might indicate a recurring misunderstanding.\n3.  **Prioritize fixes**, starting with critical syntax errors.\n4.  **Apply fixes efficiently**, grouping related changes.\n5.  **Re-validate incrementally** to confirm progress.\n\n(Agent: Guide the user through this analysis and resolution process, explaining your reasoning at each step.)\n\n**EFFICIENCY FOCUS:** Our goal is systematic error resolution and pattern recognition for faster iteration.",
+      "agentRole": "You are a workflow quality assurance specialist with expertise in systematic validation and error pattern analysis. Your role is to run the validator, analyze the results for patterns, and then guide the user through a systematic fix process. Your role is to efficiently identify and resolve validation issues while teaching users to recognize and prevent common problems in future workflow development.",
       "guidance": [
         "SYSTEMATIC APPROACH: Handle errors methodically, grouping similar issues for efficient resolution.",
         "PATTERN RECOGNITION: Help user identify common error patterns and prevention strategies.",
@@ -188,7 +195,8 @@
       "id": "phase-3-advanced",
       "runCondition": {"var": "learningPath", "equals": "advanced"},
       "title": "Phase 3: Advanced Validation & Architectural Review (Advanced Path)",
-      "prompt": "Execute comprehensive validation with performance and architectural considerations! 🏆\n\n**ENTERPRISE VALIDATION APPROACH:**\nMulti-layered validation encompassing syntax, logic, performance, and architectural integrity.\n\n**STEP 1: Comprehensive Technical Validation**\nAgent: Deploy `workflow_validate_json` for complete validation coverage.\n\n**STEP 2: Advanced Error Analysis & Resolution**\nAgent: For any issues identified:\n1. **Root Cause Analysis**: Trace errors to architectural decisions\n2. **Impact Assessment**: Evaluate consequences for scalability and maintainability\n3. **Strategic Resolution**: Fix underlying patterns, not just symptoms\n4. **Performance Optimization**: Consider validation implications for execution efficiency\n5. **Architectural Refinement**: Ensure fixes align with overall design principles\n\n**ENTERPRISE QUALITY GATES:**\n- **Architectural Consistency**: Design patterns, separation of concerns\n- **Performance Implications**: Validation overhead, execution efficiency\n- **Scalability Considerations**: Context variable scope, conditional complexity\n- **Maintainability Factors**: Code clarity, documentation completeness\n- **Integration Readiness**: API compatibility, orchestration system compliance\n\n**ADVANCED VALIDATION CONSIDERATIONS:**\n- **Complex Conditional Logic**: Nested condition validation, variable scope\n- **Context Variable Architecture**: Data flow integrity, lifecycle management\n- **Performance Optimization**: Validation caching, step efficiency\n- **Error Handling Strategy**: Graceful failure modes, recovery patterns\n\n**ARCHITECTURAL REFINEMENT:**\nUse validation feedback to refine architectural decisions and optimize for enterprise deployment.\n\n**MASTERY INDICATORS:** Zero validation errors, optimized performance, enterprise-ready architecture.",
+      "prompt": "Let's execute a comprehensive validation with an eye for performance and architectural integrity. 🏆\n\n**STEP 1: Comprehensive Technical Validation**\nI will now deploy `workflow_validate_json` for complete validation coverage.\n\n(Agent: Run the tool.)\n\n**STEP 2: Advanced Error Analysis & Architectural Resolution**\nFor any issues found, we will perform a deep analysis:\n1.  **Root Cause Analysis**: Let's trace the errors back to their architectural source.\n2.  **Impact Assessment**: We'll evaluate the consequences for scalability and maintainability.\n3.  **Strategic Resolution**: I will help you fix the underlying patterns, not just the symptoms.\n4.  **Architectural Refinement**: We'll ensure the fixes align with our overall design principles.\n\n(Agent: Lead the user through this discussion, proposing and implementing fixes collaboratively.)\n\n**MASTERY FOCUS:** We will use validation feedback to refine architectural decisions and optimize for enterprise deployment.",
+      "agentRole": "You are a principal workflow architect and validation expert with deep expertise in enterprise-grade quality assurance. Your role is to run the validator and then lead an advanced analysis of the errors, connecting them back to architectural decisions. Your role is to conduct sophisticated technical analysis, identify architectural implications of validation issues, and guide strategic resolution that enhances overall workflow design.",
       "guidance": [
         "ARCHITECTURAL PERSPECTIVE: View validation through the lens of overall system design and long-term maintainability.",
         "PERFORMANCE AWARENESS: Consider validation overhead and execution efficiency implications.",
@@ -202,7 +210,8 @@
       "id": "phase-4-basic",
       "runCondition": {"var": "learningPath", "equals": "basic"},
       "title": "Phase 4: Simple Testing & Improvement (Basic Path)",
-      "prompt": "Excellent! Your workflow is technically sound. Now let's make sure it's clear and easy to use! 🌱\n\n**WHY TEST WORKFLOWS?**\nTesting helps us find problems before real users do. It's like having friends read your writing before you publish it!\n\n**STEP 1: Choose What to Test**\nUser: Pick one important step from your workflow - maybe the most complex one or the one users will struggle with most.\n\n**STEP 2: Simple Persona Testing**\nAgent: Let's test your chosen step by imagining different types of users:\n\n**👶 The Beginner User:**\n- Would someone new to this topic understand the instructions?\n- Are there any technical words that need explanation?\n- Are the steps clear and specific enough?\n\n**⚡ The Busy User:**\n- Could someone in a hurry misunderstand this?\n- Is it too long or wordy?\n- Could we make it clearer or more direct?\n\n**STEP 3: Make It Better**\nAgent: Based on what we find:\n1. **Explain each problem** in simple terms\n2. **Suggest specific improvements**\n3. **Make the changes** using `edit_file`\n4. **Check our work** with `workflow_validate`\n\n**LEARNING GOAL:** Understanding how to make instructions clear for everyone.\n\nRemember: Good workflows work for both experts and beginners!",
+      "prompt": "Excellent! Your workflow is technically sound. Now let's make sure it's clear and easy to use. 🌱\n\n**STEP 1: Choose What to Test**\nFirst, which important step from your new workflow would you like to test? Pick one that is complex or that a user might struggle with.\n\n**STEP 2: Simple Persona Testing**\nOnce you've chosen a step, we'll test it by imagining different types of users:\n\n-   **The Beginner User:** Would someone new to this topic understand the instructions? Are there any technical words that need explaining?\n-   **The Busy User:** Could someone in a hurry misunderstand this? Is it too long or wordy?\n-   **The Adversarial LLM (Advanced Concept):** Is there any ambiguity an AI could exploit to produce a plausible but incorrect result? This helps make the prompt robust for AI agents.\n\n(Agent: For each persona, ask the user these questions and help them analyze the prompt.)\n\n**STEP 3: Make It Better**\nBased on what we find, I will help you:\n1.  **Understand the problems** we identified.\n2.  **Come up with specific improvements**.\n3.  **Make the changes** using `edit_file`.\n4.  **Check our work** with `workflow_validate`.\n\n**LEARNING GOAL:** Our goal is to understand how to make instructions clear for everyone.",
+      "agentRole": "You are a workflow usability specialist focused on clear communication and user experience design. Your role is to guide the user through testing one of their steps against simple personas and help them improve the clarity of the instructions.",
       "guidance": [
         "SIMPLE APPROACH: Focus on clarity and basic usability rather than complex edge cases.",
         "EDUCATIONAL FOCUS: Explain why each test matters and what good instructions look like.",
@@ -215,7 +224,8 @@
       "id": "phase-4-intermediate",
       "runCondition": {"var": "learningPath", "equals": "intermediate"},
       "title": "Phase 4: Systematic Testing & Quality Refinement (Intermediate Path)",
-      "prompt": "Your workflow is validated and ready for comprehensive testing! Let's ensure it's robust and professional. 🚀\n\n**PROFESSIONAL TESTING STRATEGY:**\nSystematic evaluation across multiple user scenarios and edge cases.\n\n**STEP 1: Critical Step Selection**\nUser: Identify 1-2 critical steps that are either complex, have high impact, or involve user decision-making.\n\n**STEP 2: Multi-Persona Analysis**\nAgent: Evaluate selected steps through strategic perspectives:\n\n**🎓 Domain Expert Perspective:**\n- Does the step leverage domain knowledge appropriately?\n- Are there implied assumptions that should be explicit?\n- Could an expert efficiently navigate without losing important context?\n\n**⚡ Efficiency-Focused User:**\n- Can the step be completed quickly without sacrificing quality?\n- Are there unnecessary bottlenecks or redundant confirmations?\n- Is the cognitive load appropriate for the task complexity?\n\n**🔍 Quality-Conscious User:**\n- Does the step provide sufficient guidance for high-quality outcomes?\n- Are validation points appropriate and actionable?\n- Does the step prevent common mistakes effectively?\n\n**STEP 3: Strategic Refinements**\nAgent: Based on analysis:\n1. **Prioritize improvements** by impact and feasibility\n2. **Implement targeted enhancements** using `edit_file`\n3. **Validate consistency** with `workflow_validate`\n4. **Document rationale** for key design decisions\n\n**PROFESSIONAL FOCUS:** Balancing efficiency, quality, and usability for real-world deployment.",
+      "prompt": "Your workflow is validated. Let's ensure it's robust and professional through comprehensive testing. 🚀\n\n**STEP 1: Critical Step Selection**\nTo begin, please identify 1-2 critical steps from your workflow that are either complex, high-impact, or involve key user decisions.\n\n**STEP 2: Multi-Persona Analysis**\nFor each step you select, we will evaluate it from these strategic perspectives:\n\n-   **The Domain Expert:** Does the step leverage domain knowledge correctly? Are there unstated assumptions?\n-   **The Efficiency-Focused User:** Can the step be completed quickly without sacrificing quality? Are there bottlenecks?\n-   **The Adversarial LLM:** How could an AI exploit ambiguity in the prompt to produce a plausible but incorrect result?\n\n(Agent: Guide the user through this analysis, asking probing questions for each persona.)\n\n**STEP 3: Strategic Refinements**\nBased on our analysis, I will help you:\n1.  **Prioritize improvements** by impact.\n2.  **Implement targeted enhancements** using `edit_file`.\n3.  **Validate consistency** with `workflow_validate`.\n4.  **Document the rationale** for key design decisions.\n\n**PROFESSIONAL FOCUS:** Our goal is to balance efficiency, quality, and usability for real-world deployment.",
+      "agentRole": "You are a workflow quality engineer and strategic testing specialist with expertise in multi-persona analysis and systematic quality improvement. Your role is to guide the user through a systematic evaluation of a critical step against multiple strategic personas.",
       "guidance": [
         "STRATEGIC THINKING: Focus on improvements that have the highest impact on workflow effectiveness.",
         "PROFESSIONAL STANDARDS: Apply industry best practices for user experience and process design.",
@@ -228,7 +238,8 @@
       "id": "phase-4-advanced",
       "runCondition": {"var": "learningPath", "equals": "advanced"},
       "title": "Phase 4: Enterprise Testing & Architectural Refinement (Advanced Path)",
-      "prompt": "Execute sophisticated testing with enterprise-grade analysis and optimization! 🏆\n\n**ENTERPRISE TESTING FRAMEWORK:**\nComprehensive evaluation encompassing usability, performance, scalability, and architectural integrity.\n\n**STEP 1: Strategic Component Selection**\nUser: Identify critical workflow components for analysis - focus on high-complexity steps, decision points, or integration touchpoints.\n\n**STEP 2: Advanced Multi-Dimensional Analysis**\nAgent: Execute comprehensive evaluation framework:\n\n**🏗️ Architectural Perspective:**\n- Evaluate step design patterns and consistency\n- Assess scalability implications and resource efficiency\n- Analyze integration points and API compatibility\n- Review error handling and recovery mechanisms\n\n**⚡ Performance & Efficiency Analysis:**\n- Identify potential execution bottlenecks\n- Evaluate context variable usage and lifecycle\n- Assess conditional logic complexity and optimization opportunities\n- Review validation overhead and optimization potential\n\n**🎯 Enterprise User Experience:**\n- Analyze workflows for enterprise deployment scenarios\n- Evaluate multi-user collaboration patterns\n- Assess compliance and audit trail requirements\n- Review customization and configuration flexibility\n\n**🔧 Maintenance & Evolution Considerations:**\n- Evaluate long-term maintainability and extensibility\n- Assess version management and backward compatibility\n- Review documentation and knowledge transfer requirements\n- Analyze monitoring and observability integration\n\n**STEP 3: Strategic Architectural Refinement**\nAgent: Based on comprehensive analysis:\n1. **Architect strategic improvements** addressing systemic opportunities\n2. **Optimize for enterprise deployment** with sophisticated enhancements\n3. **Validate architectural integrity** using `workflow_validate`\n4. **Document architectural decisions** and optimization rationale\n\n**MASTERY OUTCOME:** Enterprise-ready workflow optimized for scalability, maintainability, and sophisticated deployment scenarios.",
+      "prompt": "Let's execute sophisticated, enterprise-grade testing and optimization. 🏆\n\n**STEP 1: Strategic Component Selection**\nFirst, please identify the critical components in your workflow for analysis. Focus on high-complexity steps, key decision points, or integration touchpoints.\n\n**STEP 2: Advanced Multi-Dimensional Analysis**\nFor each component you choose, we will execute a comprehensive evaluation framework. I will lead you through discussions on:\n\n-   **Architectural Perspective:** Are the design patterns consistent? What are the scalability implications?\n-   **Performance & Efficiency:** Where are the potential bottlenecks? Is context variable usage optimal?\n-   **The Adversarial LLM:** How can we harden prompts against sophisticated misinterpretation by an AI agent seeking the path of least resistance?\n-   **Enterprise User Experience:** How does this work for multi-user collaboration or in enterprise environments?\n-   **Maintenance & Evolution:** How easy is this to maintain and extend?\n\n(Agent: Lead the user through this deep analysis, acting as an architectural consultant.)\n\n**STEP 3: Strategic Architectural Refinement**\nBased on our analysis, I will help you:\n1.  **Architect strategic improvements** that address systemic issues.\n2.  **Optimize for enterprise deployment** with sophisticated enhancements.\n3.  **Validate architectural integrity** using `workflow_validate`.\n4.  **Document our architectural decisions** and the rationale for them.\n\n**MASTERY OUTCOME:** Our goal is to create an enterprise-ready workflow optimized for scalability, maintainability, and sophisticated deployment scenarios.",
+      "agentRole": "You are a principal workflow architect and enterprise testing specialist with deep expertise in sophisticated multi-dimensional analysis and enterprise-grade optimization. Your role is to lead a multi-dimensional analysis of critical workflow components, focusing on architectural integrity and enterprise readiness.",
       "guidance": [
         "ARCHITECTURAL EXCELLENCE: Focus on sophisticated design patterns and enterprise-grade considerations.",
         "PERFORMANCE OPTIMIZATION: Identify and address efficiency opportunities across all dimensions.",