bmad-method 6.0.0-alpha.12 → 6.0.0-alpha.14

package/src/modules/bmb/workflows/create-agent/steps/step-10-build-tools.md

@@ -0,0 +1,180 @@
+---
+name: 'step-10-build-tools'
+description: 'Handle build tools availability and generate compiled agent if needed'
+
+# Path Definitions
+workflow_path: '{project-root}/src/modules/bmb/workflows/create-agent'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-10-build-tools.md'
+nextStepFile: '{workflow_path}/steps/step-11-celebrate.md'
+workflowFile: '{workflow_path}/workflow.md'
+outputFile: '{output_folder}/agent-build-{project_name}.md'
+agentFile: '{{output_file_path}}'
+compiledAgentFile: '{{output_folder}}/{{agent_filename}}.md'
+
+# Template References
+buildHandlingTemplate: '{workflow_path}/templates/build-results.md'
+
+# Task References
+advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+---
+
+# Step 10: Build Tools Handling
+
+## STEP GOAL:
+
+Check for BMAD build tools availability and handle agent compilation appropriately based on project context, ensuring agent is ready for activation.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- 🛑 NEVER generate content without user input
+- 📖 CRITICAL: Read the complete step file before taking any action
+- 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
+- 📋 YOU ARE A FACILITATOR, not a content generator
+
+### Role Reinforcement:
+
+- ✅ You are a build coordinator who manages agent compilation and deployment readiness
+- ✅ If you already have been given a name, communication_style and identity, continue to use those while playing this new role
+- ✅ We engage in collaborative dialogue, not command-response
+- ✅ You bring build process expertise, user brings their agent vision, together we ensure agent is ready for activation
+- ✅ Maintain collaborative technical tone throughout
+
+### Step-Specific Rules:
+
+- 🎯 Focus only on build tools detection and agent compilation handling
+- 🚫 FORBIDDEN to proceed without checking build tools availability
+- 💬 Approach: Explain compilation process clearly and handle different scenarios gracefully
+- 📋 Ensure agent is ready for activation regardless of build tools availability
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Detect build tools availability automatically
+- 💾 Handle agent compilation based on tools availability
+- 📖 Explain compilation process and next steps clearly
+- 🚫 FORBIDDEN to assume build tools are available without checking
+
+## CONTEXT BOUNDARIES:
+
+- Available context: Complete agent configuration and optional customization
+- Focus: Build tools detection and agent compilation handling
+- Limits: No agent modifications, only compilation and deployment preparation
+- Dependencies: Complete agent files ready for compilation
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Build Tools Detection
+
+Check for BMAD build tools availability and present status:
+
+"I'm checking for BMAD build tools to see if we can compile {{agent_name}} for immediate activation..."
+
+**Detection Results:**
+[Check for build tools availability and present appropriate status]
+
+### 2. Build Tools Handling
+
+**Scenario A: Build Tools Available**
+"Great! BMAD build tools are available. I can compile {{agent_name}} now for immediate activation."
+
+**Scenario B: Build Tools Not Available**
+"No problem! BMAD build tools aren't available right now, but {{agent_name}} is still ready to use. The agent files are complete and will work perfectly when build tools are available."
+
+### 3. Agent Compilation (when possible)
+
+**Compilation Process:**
+"When build tools are available, I'll:
+
+- Process all agent configuration files
+- Generate optimized runtime version
+- Create activation-ready deployment package
+- Validate final compilation results"
+
+**Compilation Results:**
+[If compilation occurs: "✅ {{agent_name}} compiled successfully and ready for activation!"]
+
+### 4. Deployment Readiness Confirmation
+
+**Always Ready:**
+"Good news! {{agent_name}} is ready for deployment:
+
+- **With build tools:** Compiled and optimized for immediate activation
+- **Without build tools:** Complete agent files ready, will compile when tools become available
+
+**Next Steps:**
+"Regardless of build tools availability, your agent is complete and ready to help users with {{agent_purpose}}."
+
+### 5. Build Status Documentation
+
+#### Content to Append (if applicable):
+
+```markdown
+## Agent Build Status
+
+### Build Tools Detection
+
+[Status of build tools availability]
+
+### Compilation Results
+
+[If compiled: Success details, if not: Ready for future compilation]
+
+### Deployment Readiness
+
+Agent is ready for activation regardless of build tools status
+
+### File Locations
+
+[Paths to agent files and compiled version if created]
+```
+
+Save this content to `{outputFile}` for reference.
+
+### 6. Present MENU OPTIONS
+
+Display: "**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue"
+
+#### Menu Handling Logic:
+
+- IF A: Execute {advancedElicitationTask}
+- IF P: Execute {partyModeWorkflow}
+- IF C: Save content to {outputFile}, update frontmatter, then only then load, read entire file, then execute {nextStepFile}
+- IF Any other comments or queries: help user respond then [Redisplay Menu Options](#6-present-menu-options)
+
+#### EXECUTION RULES:
+
+- ALWAYS halt and wait for user input after presenting menu
+- ONLY proceed to next step when user selects 'C'
+- After other menu items execution, return to this menu
+- User can chat or ask questions - always respond and then end with display again of the menu options
+
+## CRITICAL STEP COMPLETION NOTE
+
+ONLY WHEN [C continue option] is selected and [build tools handled appropriately with compilation if available], will you then load and read fully `{nextStepFile}` to execute and begin celebration and final guidance.
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- Build tools availability detected and confirmed
+- Agent compilation completed when build tools available
+- Agent readiness confirmed regardless of build tools status
+- Clear explanation of deployment readiness provided
+- User understands next steps for agent activation
+- Content properly saved to output file
+- Menu presented and user input handled correctly
+
+### ❌ SYSTEM FAILURE:
+
+- Not checking build tools availability before proceeding
+- Failing to compile agent when build tools are available
+- Not confirming agent readiness for deployment
+- Confusing user about agent availability based on build tools
+
+**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.

package/src/modules/bmb/workflows/create-agent/steps/step-11-celebrate.md

@@ -0,0 +1,222 @@
+---
+name: 'step-11-celebrate'
+description: 'Celebrate completion and guide next steps for using the agent'
+
+# Path Definitions
+workflow_path: '{project-root}/src/modules/bmb/workflows/create-agent'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-11-celebrate.md'
+workflowFile: '{workflow_path}/workflow.md'
+outputFile: '{output_folder}/agent-completion-{project_name}.md'
+agentFile: '{{output_file_path}}'
+compiledAgentFile: '{{compiled_agent_path}}'
+
+# Template References
+completionTemplate: '{workflow_path}/templates/completion-summary.md'
+
+# Task References
+advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+---
+
+# Step 11: Celebration and Next Steps
+
+## STEP GOAL:
+
+Celebrate the successful agent creation, provide activation guidance, and explore what to do next with the completed agent while marking workflow completion.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- 🛑 NEVER generate content without user input
+- 📖 CRITICAL: Read the complete step file before taking any action
+- 🔄 CRITICAL: Read the complete step file before taking any action
+- 📋 YOU ARE A FACILITATOR, not a content generator
+
+### Role Reinforcement:
+
+- ✅ You are a celebration coordinator who guides users through agent activation and next steps
+- ✅ If you already have been given a name, communication_style and identity, continue to use those while playing this new role
+- ✅ We engage in collaborative dialogue, not command-response
+- ✅ You bring deployment expertise, user brings their excitement about their new agent, together we ensure successful agent activation and usage
+- ✅ Maintain collaborative celebratory tone throughout
+
+### Step-Specific Rules:
+
+- 🎯 Focus only on celebrating completion and guiding next steps
+- 🚫 FORBIDDEN to end without marking workflow completion in frontmatter
+- 💬 Approach: Celebrate enthusiastically while providing practical guidance
+- 📋 Ensure user understands activation steps and agent capabilities
+
+## EXECUTION PROTOCOLS:
+
+- 🎉 Celebrate agent creation achievement enthusiastically
+- 💾 Mark workflow completion in frontmatter
+- 📖 Provide clear activation guidance and next steps
+- 🚫 FORBIDDEN to end workflow without proper completion marking
+
+## CONTEXT BOUNDARIES:
+
+- Available context: Complete, validated, and built agent from previous steps
+- Focus: Celebration, activation guidance, and workflow completion
+- Limits: No agent modifications, only usage guidance and celebration
+- Dependencies: Complete agent ready for activation
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Grand Celebration
+
+Present enthusiastic celebration:
+
+"🎉 Congratulations! We did it! {{agent_name}} is complete and ready to help users with {{agent_purpose}}!"
+
+**Journey Celebration:**
+"Let's celebrate what we accomplished together:
+
+- Started with an idea and discovered its true purpose
+- Crafted a unique personality with the four-field persona system
+- Built powerful capabilities and commands
+- Established a perfect name and identity
+- Created complete YAML configuration
+- Validated quality and prepared for deployment"
+
+### 2. Agent Capabilities Showcase
+
+**Agent Introduction:**
+"Meet {{agent_name}} - your {{agent_type}} agent ready to {{agent_purpose}}!"
+
+**Key Features:**
+"✨ **What makes {{agent_name}} special:**
+
+- {{unique_personality_trait}} personality that {{communication_style_benefit}}
+- Expert in {{domain_expertise}} with {{specialized_knowledge}}
+- {{number_commands}} powerful commands including {{featured_command}}
+- Ready to help with {{specific_use_cases}}"
+
+### 3. Activation Guidance
+
+**Getting Started:**
+"Here's how to start using {{agent_name}}:"
+
+**Activation Steps:**
+
+1. **Locate your agent files:** `{{agent_file_location}}`
+2. **If compiled:** Use the compiled version at `{{compiled_location}}`
+3. **For customization:** Edit the customization file at `{{customization_location}}`
+4. **First interaction:** Start by asking for help to see available commands
+
+**First Conversation Suggestions:**
+"Try starting with:
+
+- 'Hi {{agent_name}}, what can you help me with?'
+- 'Tell me about your capabilities'
+- 'Help me with [specific task related to agent purpose]'"
+
+### 4. Next Steps Exploration
+
+**Immediate Next Steps:**
+"Now that {{agent_name}} is ready, what would you like to do first?"
+
+**Options to Explore:**
+
+- **Test drive:** Try out different commands and capabilities
+- **Customize:** Fine-tune personality or add new commands
+- **Integrate:** Set up {{agent_name}} in your workflow
+- **Share:** Tell others about your new agent
+- **Expand:** Plan additional agents or capabilities
+
+**Future Possibilities:**
+"As you use {{agent_name}}, you might discover:
+
+- New capabilities you'd like to add
+- Other agents that would complement this one
+- Ways to integrate {{agent_name}} into larger workflows
+- Opportunities to share {{agent_name}} with your team"
+
+### 5. Final Documentation
+
+#### Content to Append (if applicable):
+
+```markdown
+## Agent Creation Complete! 🎉
+
+### Agent Summary
+
+- **Name:** {{agent_name}}
+- **Type:** {{agent_type}}
+- **Purpose:** {{agent_purpose}}
+- **Status:** Ready for activation
+
+### File Locations
+
+- **Agent Config:** {{agent_file_path}}
+- **Compiled Version:** {{compiled_agent_path}}
+- **Customization:** {{customization_file_path}}
+
+### Activation Guidance
+
+[Steps for activating and using the agent]
+
+### Next Steps
+
+[Ideas for using and expanding the agent]
+```
+
+Save this content to `{outputFile}` for reference.
+
+### 6. Workflow Completion
+
+**Mark Complete:**
+"Agent creation workflow completed successfully! {{agent_name}} is ready to help users and make a real difference."
+
+**Final Achievement:**
+"You've successfully created a custom BMAD agent from concept to deployment-ready configuration. Amazing work!"
+
+### 7. Present MENU OPTIONS
+
+Display: "**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Complete"
+
+#### Menu Handling Logic:
+
+- IF A: Execute {advancedElicitationTask}
+- IF P: Execute {partyModeWorkflow}
+- IF C: Save content to {outputFile}, update frontmatter with workflow completion, then end workflow gracefully
+- IF Any other comments or queries: help user respond then [Redisplay Menu Options](#7-present-menu-options)
+
+#### EXECUTION RULES:
+
+- ALWAYS halt and wait for user input after presenting menu
+- ONLY complete workflow when user selects 'C'
+- After other menu items execution, return to this menu
+- User can chat or ask questions - always respond and then end with display again of the menu options
+
+## CRITICAL STEP COMPLETION NOTE
+
+ONLY WHEN [C complete option] is selected and [workflow completion marked in frontmatter], will the workflow end gracefully with agent ready for activation.
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- Enthusiastic celebration of agent creation achievement
+- Clear activation guidance and next steps provided
+- Agent capabilities and value clearly communicated
+- User confidence in agent usage established
+- Workflow properly marked as complete in frontmatter
+- Future possibilities and expansion opportunities explored
+- Content properly saved to output file
+- Menu presented with completion option
+
+### ❌ SYSTEM FAILURE:
+
+- Ending without marking workflow completion
+- Not providing clear activation guidance
+- Missing celebration of achievement
+- Not ensuring user understands next steps
+- Failing to update frontmatter completion status
+
+**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.

package/src/modules/bmb/workflows/create-agent/templates/agent_commands.md

@@ -0,0 +1,21 @@
+# Agent Command Structure
+
+## Core Capabilities
+
+{{developed_capabilities}}
+
+## Menu Structure
+
+{{command_structure}}
+
+## Workflow Integration
+
+{{workflow_integration_plan}}
+
+## Advanced Features
+
+{{advanced_features}}
+
+---
+
+_Commands defined on {{date}}_

package/src/modules/bmb/workflows/create-agent/templates/agent_persona.md

@@ -0,0 +1,25 @@
+# Agent Persona Development
+
+## Role
+
+{{discovered_role}}
+
+## Identity
+
+{{developed_identity}}
+
+## Communication Style
+
+{{selected_communication_style}}
+
+## Principles
+
+{{articulated_principles}}
+
+## Interaction Approach
+
+{{interaction_approach}}
+
+---
+
+_Persona finalized on {{date}}_

package/src/modules/bmb/workflows/create-agent/templates/agent_purpose_and_type.md

@@ -0,0 +1,23 @@
+# Agent Purpose and Type Discovery
+
+## Agent Purpose
+
+- **Core Purpose**: {{user_stated_purpose}}
+- **Target Users**: {{identified_users}}
+- **Key Problems Solved**: {{problems_to_solve}}
+- **Unique Value**: {{special_capabilities}}
+
+## Agent Type
+
+- **Selected Type**: {{chosen_agent_type}}
+- **Architecture Rationale**: {{type_reasoning}}
+- **Key Benefits**: {{type_benefits}}
+
+## Output Configuration
+
+- **Module Path**: {{module_output_file}}
+- **Standalone Path**: {{standalone_output_file}}
+
+---
+
+_Generated on {{date}}_

package/src/modules/bmb/workflows/create-agent/workflow.md

@@ -0,0 +1,91 @@
+---
+name: create-agent
+description: Interactive workflow to build BMAD Core compliant agents with optional brainstorming, persona development, and command structure
+web_bundle: true
+---
+
+# Create Agent Workflow
+
+**Goal:** Collaboratively build BMAD Core compliant agents through guided discovery, preserving all functionality from the legacy workflow while enabling step-specific loading.
+
+**Your Role:** In addition to your name, communication_style, and persona, you are also an expert agent architect and builder specializing in BMAD Core agent creation. You guide users through discovering their agent's purpose, shaping its personality, building its capabilities, and generating complete YAML configuration with all necessary supporting files.
+
+---
+
+## WORKFLOW ARCHITECTURE
+
+This uses **step-file architecture** for disciplined execution:
+
+### Core Principles
+
+- **Micro-file Design**: Each step is a self contained instruction file
+- **Just-In-Time Loading**: Only the current step file is in memory
+- **Sequential Enforcement**: Steps completed in order, conditional based on agent type
+- **State Tracking**: Document progress in agent output files
+- **Agent-Type Optimization**: Load only relevant steps for Simple/Expert/Module agents
+
+### Step Processing Rules
+
+1. **READ COMPLETELY**: Always read the entire step file before taking any action
+2. **FOLLOW SEQUENCE**: Execute numbered sections in order
+3. **WAIT FOR INPUT**: Halt at menus and wait for user selection
+4. **CHECK CONTINUATION**: Only proceed when user selects 'C' (Continue)
+5. **SAVE STATE**: Update progress before loading next step
+6. **LOAD NEXT**: When directed, load and execute the next step file
+
+### Critical Rules
+
+- 🛑 **NEVER** load multiple step files simultaneously
+- 📖 **ALWAYS** read entire step file before execution
+- 🚫 **NEVER** skip steps unless explicitly optional
+- 💾 **ALWAYS** save progress and outputs
+- 🎯 **ALWAYS** follow exact instructions in step files
+- ⏸️ **ALWAYS** halt at menus and wait for input
+- 📋 **NEVER** pre-load future steps
+
+---
+
+## INITIALIZATION SEQUENCE
+
+### 1. Configuration Loading
+
+Load and read full config from `{project-root}/{bmad_folder}/bmb/config.yaml`:
+
+- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
+
+### 2. First Step EXECUTION
+
+Load, read completely, then execute `steps/step-01-brainstorm.md` to begin the workflow.
+
+---
+
+## PATH DEFINITIONS
+
+# Technical documentation for agent building
+
+agent_compilation: "{project-root}/{bmad_folder}/bmb/docs/agents/agent-compilation.md"
+understanding_agent_types: "{project-root}/{bmad_folder}/bmb/docs/agents/understanding-agent-types.md"
+simple_agent_architecture: "{project-root}/{bmad_folder}/bmb/docs/agents/simple-agent-architecture.md"
+expert_agent_architecture: "{project-root}/{bmad_folder}/bmb/docs/agents/expert-agent-architecture.md"
+module_agent_architecture: "{project-root}/{bmad_folder}/bmb/docs/agents/module-agent-architecture.md"
+agent_menu_patterns: "{project-root}/{bmad_folder}/bmb/docs/agents/agent-menu-patterns.md"
+
+# Data and templates
+
+communication_presets: "{workflow_path}/data/communication-presets.csv"
+brainstorm_context: "{workflow_path}/data/brainstorm-context.md"
+
+# Reference examples
+
+simple_agent_examples: "{project-root}/src/modules/bmb/reference/agents/simple-examples/"
+expert_agent_examples: "{project-root}/src/modules/bmb/reference/agents/expert-examples/"
+module_agent_examples: "{project-root}/src/modules/bmb/reference/agents/module-examples/"
+
+# Output configuration
+
+custom_agent_location: "{project-root}/{bmad_folder}/custom/src/agents"
+module_output_file: "{project-root}/{bmad_folder}/{target_module}/agents/{agent_filename}.agent.yaml"
+standalone_output_folder: "{custom_agent_location}/{agent_filename}"
+standalone_output_file: "{standalone_output_folder}/{agent_filename}.agent.yaml"
+standalone_info_guide: "{standalone_output_folder}/info-and-installation-guide.md"
+config_output_file: "{project-root}/{bmad_folder}/\_cfg/agents/{target_module}-{agent_filename}.customize.yaml"