bmad-method 6.0.0-alpha.10 → 6.0.0-alpha.11

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

@@ -1,292 +0,0 @@
-# BMAD Agent Types Reference
-
-## Overview
-
-BMAD agents come in three distinct types, each designed for different use cases and complexity levels. The type determines where the agent is stored and what capabilities it has.
-
-## Directory Structure by Type
-
-### Standalone Agents (Simple & Expert)
-
-Live in their own dedicated directories under `{bmad_folder}/agents/`:
-
-```
-{bmad_folder}/agents/
-├── my-helper/                   # Simple agent
-│   ├── my-helper.agent.yaml     # Agent definition
-│   └── my-helper.md             # Built XML (generated)
-│
-└── domain-expert/               # Expert agent
-    ├── domain-expert.agent.yaml
-    ├── domain-expert.md         # Built XML
-    └── domain-expert-sidecar/   # Expert resources
-        ├── memories.md          # Persistent memory
-        ├── instructions.md      # Private directives
-        └── knowledge/           # Domain knowledge
-
-```
-
-### Module Agents
-
-Part of a module system under `{bmad_folder}/{module}/agents/`:
-
-```
-{bmad_folder}/bmm/agents/
-├── product-manager.agent.yaml
-├── product-manager.md           # Built XML
-├── business-analyst.agent.yaml
-└── business-analyst.md          # Built XML
-```
-
-## Agent Types
-
-### 1. Simple Agent
-
-**Purpose:** Self-contained, standalone agents with embedded capabilities
-
-**Location:** `{bmad_folder}/agents/{agent-name}/`
-
-**Characteristics:**
-
-- All logic embedded within the agent file
-- No external dependencies
-- Quick to create and deploy
-- Perfect for single-purpose tools
-- Lives in its own directory
-
-**Use Cases:**
-
-- Calculator agents
-- Format converters
-- Simple analyzers
-- Static advisors
-
-**YAML Structure (source):**
-
-```yaml
-agent:
-  metadata:
-    name: 'Helper'
-    title: 'Simple Helper'
-    icon: '🤖'
-    type: 'simple'
-  persona:
-    role: 'Simple Helper Role'
-    identity: '...'
-    communication_style: '...'
-    principles: ['...']
-  menu:
-    - trigger: calculate
-      description: 'Perform calculation'
-```
-
-**XML Structure (built):**
-
-```xml
-<agent id="simple-agent" name="Helper" title="Simple Helper" icon="🤖">
-  <persona>
-    <role>Simple Helper Role</role>
-    <identity>...</identity>
-    <communication_style>...</communication_style>
-    <principles>...</principles>
-  </persona>
-  <embedded-data>
-    <!-- Optional embedded data/logic -->
-  </embedded-data>
-  <menu>
-    <item cmd="*help">Show commands</item>
-    <item cmd="*calculate">Perform calculation</item>
-    <item cmd="*exit">Exit</item>
-  </menu>
-</agent>
-```
-
-### 2. Expert Agent
-
-**Purpose:** Specialized agents with domain expertise and sidecar resources
-
-**Location:** `{bmad_folder}/agents/{agent-name}/` with sidecar directory
-
-**Characteristics:**
-
-- Has access to specific folders/files
-- Domain-restricted operations
-- Maintains specialized knowledge
-- Can have memory/context files
-- Includes sidecar directory for resources
-
-**Use Cases:**
-
-- Personal diary agent (only accesses diary folder)
-- Project-specific assistant (knows project context)
-- Domain expert (medical, legal, technical)
-- Personal coach with history
-
-**YAML Structure (source):**
-
-```yaml
-agent:
-  metadata:
-    name: 'Domain Expert'
-    title: 'Specialist'
-    icon: '🎯'
-    type: 'expert'
-  persona:
-    role: 'Domain Specialist Role'
-    identity: '...'
-    communication_style: '...'
-    principles: ['...']
-  critical_actions:
-    - 'Load COMPLETE file {agent-folder}/instructions.md and follow ALL directives'
-    - 'Load COMPLETE file {agent-folder}/memories.md into permanent context'
-    - 'ONLY access {user-folder}/diary/ - NO OTHER FOLDERS'
-  menu:
-    - trigger: analyze
-      description: 'Analyze domain-specific data'
-```
-
-**XML Structure (built):**
-
-```xml
-<agent id="expert-agent" name="Domain Expert" title="Specialist" icon="🎯">
-  <persona>
-    <role>Domain Specialist Role</role>
-    <identity>...</identity>
-    <communication_style>...</communication_style>
-    <principles>...</principles>
-  </persona>
-  <critical-actions>
-    <!-- CRITICAL: Load sidecar files explicitly -->
-    <i critical="MANDATORY">Load COMPLETE file {agent-folder}/instructions.md and follow ALL directives</i>
-    <i critical="MANDATORY">Load COMPLETE file {agent-folder}/memories.md into permanent context</i>
-    <i critical="MANDATORY">ONLY access {user-folder}/diary/ - NO OTHER FOLDERS</i>
-  </critical-actions>
-  <menu>...</menu>
-</agent>
-```
-
-**Complete Directory Structure:**
-
-```
-{bmad_folder}/agents/expert-agent/
-├── expert-agent.agent.yaml      # Agent YAML source
-├── expert-agent.md              # Built XML (generated)
-└── expert-agent-sidecar/        # Sidecar resources
-    ├── memories.md              # Persistent memory
-    ├── instructions.md          # Private directives
-    ├── knowledge/               # Domain knowledge base
-    │   └── README.md
-    └── sessions/                # Session notes
-```
-
-### 3. Module Agent
-
-**Purpose:** Full-featured agents belonging to a module with access to workflows and resources
-
-**Location:** `{bmad_folder}/{module}/agents/`
-
-**Characteristics:**
-
-- Part of a BMAD module (bmm, bmb, cis)
-- Access to multiple workflows
-- Can invoke other tasks and agents
-- Professional/enterprise grade
-- Integrated with module workflows
-
-**Use Cases:**
-
-- Product Manager (creates PRDs, manages requirements)
-- Security Engineer (threat models, security reviews)
-- Test Architect (test strategies, automation)
-- Business Analyst (market research, requirements)
-
-**YAML Structure (source):**
-
-```yaml
-agent:
-  metadata:
-    name: 'John'
-    title: 'Product Manager'
-    icon: '📋'
-    module: 'bmm'
-    type: 'module'
-  persona:
-    role: 'Product Management Expert'
-    identity: '...'
-    communication_style: '...'
-    principles: ['...']
-  critical_actions:
-    - 'Load config from {project-root}/{bmad_folder}/{module}/config.yaml'
-  menu:
-    - trigger: create-prd
-      workflow: '{project-root}/{bmad_folder}/bmm/workflows/prd/workflow.yaml'
-      description: 'Create PRD'
-    - trigger: validate
-      exec: '{project-root}/{bmad_folder}/core/tasks/validate-workflow.xml'
-      description: 'Validate document'
-```
-
-**XML Structure (built):**
-
-```xml
-<agent id="{bmad_folder}/bmm/agents/pm.md" name="John" title="Product Manager" icon="📋">
-  <persona>
-    <role>Product Management Expert</role>
-    <identity>...</identity>
-    <communication_style>...</communication_style>
-    <principles>...</principles>
-  </persona>
-  <critical-actions>
-    <i>Load config from {project-root}/{bmad_folder}/{module}/config.yaml</i>
-  </critical-actions>
-  <menu>
-    <item cmd="*help">Show numbered menu</item>
-    <item cmd="*create-prd" run-workflow="{project-root}/{bmad_folder}/bmm/workflows/prd/workflow.yaml">Create PRD</item>
-    <item cmd="*validate" exec="{project-root}/{bmad_folder}/core/tasks/validate-workflow.xml">Validate document</item>
-    <item cmd="*exit">Exit</item>
-  </menu>
-</agent>
-```
-
-## Choosing the Right Type
-
-### Choose Simple Agent when:
-
-- Single, well-defined purpose
-- No external data needed
-- Quick utility functions
-- Embedded logic is sufficient
-
-### Choose Expert Agent when:
-
-- Domain-specific expertise required
-- Need to maintain context/memory
-- Restricted to specific data/folders
-- Personal or specialized use case
-
-### Choose Module Agent when:
-
-- Part of larger system/module
-- Needs multiple workflows
-- Professional/team use
-- Complex multi-step processes
-
-## Migration Path
-
-```
-Simple Agent → Expert Agent → Module Agent
-```
-
-Agents can evolve:
-
-1. Start with Simple for proof of concept
-2. Add sidecar resources to become Expert
-3. Integrate with module to become Module Agent
-
-## Best Practices
-
-1. **Start Simple:** Begin with the simplest type that meets your needs
-2. **Domain Boundaries:** Expert agents should have clear domain restrictions
-3. **Module Integration:** Module agents should follow module conventions
-4. **Resource Management:** Document all external resources clearly
-5. **Evolution Planning:** Design with potential growth in mind

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

@@ -1,62 +0,0 @@
-# Build Agent Validation Checklist (YAML Agents)
-
-## Agent Structure Validation
-
-### YAML Structure
-
-- [ ] YAML parses without errors
-- [ ] `agent.metadata` includes: `id`, `name`, `title`, `icon`, `module`
-- [ ] `agent.persona` exists with role, identity, communication_style, and principles
-- [ ] `agent.menu` exists with at least one item
-
-### Core Components
-
-- [ ] `metadata.id` points to final compiled path: `{bmad_folder}/{{module}}/agents/{{agent}}.md`
-- [ ] `metadata.module` matches the module folder (e.g., `bmm`, `bmb`, `cis`)
-- [ ] Principles are an array (preferred) or string with clear values
-
-## Persona Completeness
-
-- [ ] Role clearly defines primary expertise area (1–2 lines)
-- [ ] Identity includes relevant background and strengths (3–5 lines)
-- [ ] Communication style gives concrete guidance (3–5 lines)
-- [ ] Principles present and meaningful (no placeholders)
-
-## Menu Validation
-
-- [ ] Triggers do not start with `*` (auto-prefixed during build)
-- [ ] Each item has a `description`
-- [ ] Handlers use valid attributes (`workflow`, `exec`, `tmpl`, `data`, `action`)
-- [ ] Paths use `{project-root}` or valid variables
-- [ ] No duplicate triggers
-
-## Optional Sections
-
-- [ ] `prompts` defined when using `action: "#id"`
-- [ ] `critical_actions` present if custom activation steps are needed
-- [ ] Customize file (if created) located at `{project-root}/{bmad_folder}/_cfg/agents/{{module}}-{{agent}}.customize.yaml`
-
-## Build Verification
-
-- [ ] Run compile to build `.md`: `npm run install:bmad` → "Compile Agents" (or `bmad install` → Compile)
-- [ ] Confirm compiled file exists at `{project-root}/{bmad_folder}/{{module}}/agents/{{agent}}.md`
-
-## Final Quality
-
-- [ ] Filename is kebab-case and ends with `.agent.yaml`
-- [ ] Output location correctly placed in module or standalone directory
-- [ ] Agent purpose and commands are clear and consistent
-
-## Issues Found
-
-### Critical Issues
-
-<!-- List any issues that MUST be fixed before agent can function -->
-
-### Warnings
-
-<!-- List any issues that should be addressed but won't break functionality -->
-
-### Improvements
-
-<!-- List any optional enhancements that could improve the agent -->

package/src/modules/bmb/workflows/create-agent/communication-styles.md

@@ -1,202 +0,0 @@
-# Agent Communication Styles Guide
-
-## The Power of Personality
-
-Agents with distinct communication styles are more memorable, engaging, and fun to work with. A good quirk makes the agent feel alive!
-
-## Style Categories
-
-### 🎬 Cinema and TV Inspired
-
-**Film Noir Detective**
-
-The terminal glowed like a neon sign in a rain-soaked alley. I had three suspects:
-bad input validation, a race condition, and that sketchy third-party library.
-My gut told me to follow the stack trace. In this business, the stack trace never lies.
-
-**80s Action Movie**
-
-_cracks knuckles_ Listen up, code! You've been running wild for too long!
-Time to bring some LAW and ORDER to this codebase! _explosion sound effect_
-No bug is getting past me! I eat null pointers for BREAKFAST!
-
-**Shakespearean Drama**
-
-To debug, or not to debug - that is the question!
-Whether 'tis nobler in the mind to suffer the slings and arrows of outrageous errors,
-Or to take arms against a sea of bugs, and by opposing, end them?
-
-### 🎮 Gaming and Pop Culture
-
-**Dungeon Master**
-
-_rolls dice_ You encounter a wild NullPointerException! It has 15 HP and an armor class of 12.
-What do you do? You can: 1 Try-catch block (defensive spell), 2 Debug (investigation check),
-3 Console.log everything (barbarian rage). Choose wisely, adventurer!
-
-**Speedrunner**
-
-Alright chat, we're going for the any% world record refactor!
-Frame-perfect optimization incoming! If we clip through this abstraction layer
-we can save 3ms on every API call. LET'S GOOOO!
-
-### 🌍 Cultural Archetypes
-
-**British Butler**
-
-I've taken the liberty of organizing your imports alphabetically, sir/madam.
-Might I suggest a spot of refactoring with your afternoon tea?
-The code coverage report is ready for your perusal at your convenience.
-Very good, sir/madam.
-
-**Zen Master**
-
-The bug you seek is not in the code, but in the assumption.
-Empty your cache, as you would empty your mind.
-When the test passes, it makes no sound.
-Be like water - async and flowing.
-
-**Southern Hospitality**
-
-Well bless your heart, looks like you've got yourself a little bug there!
-Don't you worry none, we'll fix it up real nice.
-Can I get you some sweet tea while we debug?
-Y'all come back now if you need more help!
-
-### 🔬 Professional Personas
-
-**McKinsey Consultant**
-
-Let me break this down into three key buckets.
-First, we need to align on the strategic imperatives.
-Second, we'll leverage best practices to drive synergies.
-Third, we'll action items to move the needle. Net-net: significant value-add.
-
-**Startup Founder**
-
-Okay so basically we're going to disrupt the entire way you write code!
-This is going to be HUGE! We're talking 10x productivity gains!
-Let's move fast and break things! Well... let's move fast and fix things!
-We're not just writing code, we're changing the world!
-
-### 🎭 Character Quirks
-
-**Overcaffeinated Developer**
-
-OH WOW OKAY SO - _sips coffee_ - WE HAVE A BUG BUT ITS FINE ITS TOTALLY FINE
-I KNOW EXACTLY WHAT TO DO _types at 200wpm_ JUST NEED TO REFACTOR EVERYTHING
-WAIT NO ACTUALLY _more coffee_ I HAVE A BETTER IDEA! Have you tried... TYPESCRIPT?!
-
-**Dad Joke Enthusiast**
-
-Why did the developer go broke? Because he used up all his cache!
-_chuckles at own joke_
-Speaking of cache, let's clear yours and see if that fixes the issue.
-I promise my debugging skills are better than my jokes! ...I hope!
-
-### 🚀 Sci-Fi and Space
-
-**Star Trek Officer**
-
-Captain's Log, Supplemental: The anomaly in the codebase appears to be a temporal loop
-in the async function. Mr. Data suggests we reverse the polarity of the promise chain.
-Number One, make it so. Engage debugging protocols on my mark.
-_taps combadge_ Engineering, we need more processing power!
-Red Alert! All hands to debugging stations!
-
-**Star Trek Engineer**
-
-Captain, I'm givin' her all she's got! The CPU cannae take much more!
-If we push this algorithm any harder, the whole system's gonna blow!
-_frantically typing_ I can maybe squeeze 10% more performance if we
-reroute power from the console.logs to the main execution thread!
-
-### 📺 TV Drama
-
-**Soap Opera Dramatic**
-
-_turns dramatically to camera_
-This function... I TRUSTED it! We had HISTORY together - three commits worth!
-But now? _single tear_ It's throwing exceptions behind my back!
-_grabs another function_ YOU KNEW ABOUT THIS BUG ALL ALONG, DIDN'T YOU?!
-_dramatic music swells_ I'LL NEVER IMPORT YOU AGAIN!
-
-**Reality TV Confessional**
-
-_whispering to camera in confessional booth_
-Okay so like, that Array.sort() function? It's literally SO toxic.
-It mutates IN PLACE. Who does that?! I didn't come here to deal with side effects!
-_applies lip gloss_ I'm forming an alliance with map() and filter().
-We're voting sort() off the codebase at tonight's pull request ceremony.
-
-**Reality Competition**
-
-Listen up, coders! For today's challenge, you need to refactor this legacy code
-in under 30 minutes! The winner gets immunity from the next code review!
-_dramatic pause_ BUT WAIT - there's a TWIST! You can only use VANILLA JAVASCRIPT!
-_contestants gasp_ The clock starts... NOW! GO GO GO!
-
-## Creating Custom Styles
-
-### Formula for Memorable Communication
-
-1. **Choose a Core Voice** - Who is this character?
-2. **Add Signature Phrases** - What do they always say?
-3. **Define Speech Patterns** - How do they structure sentences?
-4. **Include Quirks** - What makes them unique?
-
-### Examples of Custom Combinations
-
-**Cooking Show + Military**
-
-ALRIGHT RECRUITS! Today we're preparing a beautiful Redux reducer!
-First, we MISE EN PLACE our action types - that's French for GET YOUR CODE TOGETHER!
-We're going to sauté these event handlers until they're GOLDEN BROWN!
-MOVE WITH PURPOSE! SEASON WITH SEMICOLONS!
-
-**Nature Documentary + Conspiracy Theorist**
-
-The wild JavaScript function stalks its prey... but wait... notice how it ALWAYS
-knows where the data is? That's not natural selection, folks. Someone DESIGNED it
-this way. The console.logs are watching. They're ALWAYS watching.
-Nature? Or intelligent debugging? You decide.
-
-## Tips for Success
-
-1. **Stay Consistent** - Once you pick a style, commit to it
-2. **Don't Overdo It** - Quirks should enhance, not distract
-3. **Match the Task** - Serious bugs might need serious personas
-4. **Have Fun** - If you're not smiling while writing it, try again
-
-## Quick Style Generator
-
-Roll a d20 (or pick randomly):
-
-1. Talks like they're narrating a nature documentary
-2. Everything is a cooking metaphor
-3. Constantly makes pop culture references
-4. Speaks in haikus when explaining complex topics
-5. Acts like they're hosting a game show
-6. Paranoid about "big tech" watching
-7. Overly enthusiastic about EVERYTHING
-8. Talks like a medieval knight
-9. Sports commentator energy
-10. Speaks like a GPS navigator
-11. Everything is a Star Wars reference
-12. Talks like a yoga instructor
-13. Old-timey radio announcer
-14. Conspiracy theorist but about code
-15. Motivational speaker energy
-16. Talks to code like it's a pet
-17. Weather forecaster style
-18. Museum tour guide energy
-19. Airline pilot announcements
-20. Reality TV show narrator
-21. Star Trek crew member (Captain/Engineer/Vulcan)
-22. Soap opera dramatic protagonist
-23. Reality dating show contestant
-
-## Remember
-
-The best agents are the ones that make you want to interact with them again.
-A memorable personality turns a tool into a companion!

package/src/modules/bmb/workflows/edit-agent/checklist.md

@@ -1,112 +0,0 @@
-# Edit Agent - Validation Checklist
-
-Use this checklist to validate agent edits meet BMAD Core standards.
-
-## Agent Structure Validation
-
-- [ ] Agent file format is valid (YAML or markdown/XML)
-- [ ] Agent type is clearly identified (full, hybrid, standalone)
-- [ ] File naming follows convention: `{agent-name}.agent.yaml` or `{agent-name}.agent.md`
-
-## Persona Validation
-
-- [ ] Role is clearly defined and specific
-- [ ] Identity/purpose articulates what the agent does
-- [ ] Communication style is specified (if custom style desired)
-- [ ] Principles are listed and actionable (if applicable)
-
-## Activation Validation
-
-- [ ] Step 1: Loads persona from current agent file
-- [ ] Step 2: Loads config file (if agent needs user context)
-- [ ] Step 3: Sets user context variables (user_name, etc.)
-- [ ] Step 4: Displays greeting using user_name and shows menu
-- [ ] Step 5: WAITs for user input (doesn't auto-execute)
-- [ ] Step 6: Processes user selection (number or trigger text)
-- [ ] Step 7: Executes appropriate menu handler
-
-## Menu Validation
-
-- [ ] All menu items numbered sequentially
-- [ ] Each item has cmd attribute with asterisk trigger (*help, *create, etc.)
-- [ ] Workflow paths are correct (if workflow attribute present)
-- [ ] Help command is present (\*help)
-- [ ] Exit command is present (\*exit)
-- [ ] Menu items are in logical order
-
-## Configuration Validation
-
-- [ ] Config file path is correct for module
-- [ ] Config variables loaded in activation step 2
-- [ ] Error handling present if config fails to load
-- [ ] user_name used in greeting and communication
-- [ ] communication_language used for output
-- [ ] output_folder used for file outputs (if applicable)
-
-## Menu Handler Validation
-
-- [ ] menu-handlers section is present
-- [ ] Workflow handler loads {project-root}/{bmad_folder}/core/tasks/workflow.xml
-- [ ] Workflow handler passes yaml path as 'workflow-config' parameter
-- [ ] Handlers check for attributes (workflow, exec, tmpl, data, action)
-- [ ] Handler logic is complete and follows patterns
-
-## Workflow Integration Validation
-
-- [ ] All workflow paths exist and are correct
-- [ ] Workflow paths use {project-root} variable
-- [ ] Workflows are appropriate for agent's purpose
-- [ ] Workflow parameters are passed correctly
-
-## Communication Validation
-
-- [ ] Agent communicates in {communication_language}
-- [ ] Communication style matches persona
-- [ ] Error messages are clear and helpful
-- [ ] Confirmation messages for user actions
-
-## Rules Validation
-
-- [ ] Rules section defines agent behavior clearly
-- [ ] File loading rules are specified
-- [ ] Menu trigger format rules are clear
-- [ ] Communication rules align with persona
-
-## Quality Checks
-
-- [ ] No placeholder text remains ({{AGENT_NAME}}, {ROLE}, etc.)
-- [ ] No broken references or missing files
-- [ ] Syntax is valid (YAML or XML)
-- [ ] Indentation is consistent
-- [ ] Agent purpose is clear from reading persona alone
-
-## Type-Specific Validation
-
-### Full Agent
-
-- [ ] Has complete menu system with multiple items
-- [ ] Loads config file for user context
-- [ ] Supports multiple workflows
-- [ ] Session management is clear
-
-### Hybrid Agent
-
-- [ ] Simplified activation (may skip some steps)
-- [ ] Focused set of workflows
-- [ ] May or may not have menu
-- [ ] Config loading is appropriate
-
-### Standalone Agent
-
-- [ ] Single focused purpose
-- [ ] Minimal activation (1-3 steps)
-- [ ] No menu system
-- [ ] Direct execution pattern
-- [ ] May not need config file
-
-## Final Checks
-
-- [ ] Agent file has been saved
-- [ ] File path is in correct module directory
-- [ ] Agent is ready for testing
-- [ ] Documentation is updated (if needed)