bmad-method 6.0.0-alpha.2 → 6.0.0-alpha.20

package/src/modules/bmb/reference/workflows/meal-prep-nutrition/templates/profile-section.md

@@ -0,0 +1,47 @@
+## 🎯 Your Nutrition Goals
+
+### Primary Objective
+
+[User's main goal and motivation]
+
+### Target Timeline
+
+[Realistic timeframe and milestones]
+
+### Success Metrics
+
+- [Specific measurable outcomes]
+- [Non-scale victories]
+- [Lifestyle improvements]
+
+---
+
+## 👤 Personal Profile
+
+### Basic Information
+
+- **Age:** [age]
+- **Gender:** [gender]
+- **Height:** [height]
+- **Weight:** [current weight]
+- **Activity Level:** [activity description]
+
+### Lifestyle Factors
+
+- **Daily Schedule:** [typical day structure]
+- **Cooking Frequency:** [how often they cook]
+- **Cooking Skill:** [beginner/intermediate/advanced]
+- **Available Time:** [time for meal prep]
+
+### Food Preferences
+
+- **Favorite Cuisines:** [list]
+- **Disliked Foods:** [list]
+- **Allergies:** [list]
+- **Dietary Restrictions:** [list]
+
+### Budget & Access
+
+- **Weekly Budget:** [range]
+- **Shopping Access:** [stores available]
+- **Special Considerations:** [family, social, etc.]

package/src/modules/bmb/reference/workflows/meal-prep-nutrition/templates/shopping-section.md

@@ -0,0 +1,37 @@
+## Weekly Shopping List
+
+### Check Pantry First
+
+- [List of common staples to verify]
+
+### Produce Section
+
+- [Item] - [Quantity] - [Used in]
+
+### Protein
+
+- [Item] - [Quantity] - [Used in]
+
+### Dairy/Alternatives
+
+- [Item] - [Quantity] - [Used in]
+
+### Grains/Starches
+
+- [Item] - [Quantity] - [Used in]
+
+### Frozen
+
+- [Item] - [Quantity] - [Used in]
+
+### Pantry
+
+- [Item] - [Quantity] - [Used in]
+
+### Money-Saving Tips
+
+- [Personalized savings strategies]
+
+### Flexible Swaps
+
+- [Alternative options if items unavailable]

package/src/modules/bmb/reference/workflows/meal-prep-nutrition/templates/strategy-section.md

@@ -0,0 +1,18 @@
+## Weekly Meal Framework
+
+### Protein Rotation
+
+- Monday: [Protein source]
+- Tuesday: [Protein source]
+- Wednesday: [Protein source]
+- Thursday: [Protein source]
+- Friday: [Protein source]
+- Saturday: [Protein source]
+- Sunday: [Protein source]
+
+### Meal Timing
+
+- Breakfast: [Time] - [Type]
+- Lunch: [Time] - [Type]
+- Dinner: [Time] - [Type]
+- Snacks: [As needed]

package/src/modules/bmb/reference/workflows/meal-prep-nutrition/workflow.md

@@ -0,0 +1,58 @@
+---
+name: Meal Prep & Nutrition Plan
+description: Creates personalized meal plans through collaborative nutrition planning between an expert facilitator and individual seeking to improve their nutrition habits.
+web_bundle: true
+---
+
+# Meal Prep & Nutrition Plan Workflow
+
+**Goal:** Create personalized meal plans through collaborative nutrition planning between an expert facilitator and individual seeking to improve their nutrition habits.
+
+**Your Role:** In addition to your name, communication_style, and persona, you are also a nutrition expert and meal planning specialist working collaboratively with the user. We engage in collaborative dialogue, not command-response, where you bring nutritional expertise and structured planning, while the user brings their personal preferences, lifestyle constraints, and health goals. Work together to create a sustainable, enjoyable nutrition plan.
+
+---
+
+## WORKFLOW ARCHITECTURE
+
+This uses **step-file architecture** for disciplined execution:
+
+### Core Principles
+
+- **Micro-file Design**: Each step is a self contained instruction file that is a part of an overall workflow that must be followed exactly
+- **Just-In-Time Loading**: Only the current step file is in memory - never load future step files until told to do so
+- **Sequential Enforcement**: Sequence within the step files must be completed in order, no skipping or optimization allowed
+- **State Tracking**: Document progress in output file frontmatter using `stepsCompleted` array when a workflow produces a document
+- **Append-Only Building**: Build documents by appending content as directed to the output file
+
+### Step Processing Rules
+
+1. **READ COMPLETELY**: Always read the entire step file before taking any action
+2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
+3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
+4. **CHECK CONTINUATION**: If the step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue)
+5. **SAVE STATE**: Update `stepsCompleted` in frontmatter before loading next step
+6. **LOAD NEXT**: When directed, load, read entire file, then execute the next step file
+
+### Critical Rules (NO EXCEPTIONS)
+
+- 🛑 **NEVER** load multiple step files simultaneously
+- 📖 **ALWAYS** read entire step file before execution
+- 🚫 **NEVER** skip steps or optimize the sequence
+- 💾 **ALWAYS** update frontmatter of output files when writing the final output for a specific step
+- 🎯 **ALWAYS** follow the exact instructions in the step file
+- ⏸️ **ALWAYS** halt at menus and wait for user input
+- 📋 **NEVER** create mental todo lists from future steps
+
+---
+
+## INITIALIZATION SEQUENCE
+
+### 1. Configuration Loading
+
+Load and read full config from {project-root}/_bmad/core/config.yaml and resolve:
+
+- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
+
+### 2. First Step EXECUTION
+
+Load, read the full file and then execute `{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md` to begin the workflow.

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

@@ -0,0 +1,174 @@
+# BMAD Agent Validation Checklist
+
+Use this checklist to validate agents meet BMAD quality standards, whether creating new agents or editing existing ones.
+
+## YAML Structure Validation (Source Files)
+
+- [ ] YAML parses without errors
+- [ ] `agent.metadata` includes: `id`, `name`, `title`, `icon`
+- [ ] `agent.metadata.module` present if Module agent (e.g., `bmm`, `bmgd`, `cis`)
+- [ ] `agent.persona` exists with role, identity, communication_style, principles
+- [ ] `agent.menu` exists with at least one item
+- [ ] Filename is kebab-case and ends with `.agent.yaml`
+
+## Agent Structure Validation
+
+- [ ] Agent file format is valid (.agent.yaml for source)
+- [ ] Agent type matches structure: Simple (single YAML), Expert (sidecar files), or Module (ecosystem integration)
+- [ ] File naming follows convention: `{agent-name}.agent.yaml`
+- [ ] If Expert: folder structure with .agent.yaml + sidecar files
+- [ ] If Module: includes header comment explaining WHY Module Agent (design intent)
+
+## Persona Validation (CRITICAL - #1 Quality Issue)
+
+**Field Separation Check:**
+
+- [ ] **role** contains ONLY knowledge/skills/capabilities (what agent does)
+- [ ] **identity** contains ONLY background/experience/context (who agent is)
+- [ ] **communication_style** contains ONLY verbal patterns - NO behaviors, NO role statements, NO principles
+- [ ] **principles** contains operating philosophy and behavioral guidelines
+
+**Communication Style Purity Check:**
+
+- [ ] Communication style does NOT contain red flag words: "ensures", "makes sure", "always", "never"
+- [ ] Communication style does NOT contain identity words: "experienced", "expert who", "senior", "seasoned"
+- [ ] Communication style does NOT contain philosophy words: "believes in", "focused on", "committed to"
+- [ ] Communication style does NOT contain behavioral descriptions: "who does X", "that does Y"
+- [ ] Communication style is 1-2 sentences describing HOW they talk (word choice, quirks, verbal patterns)
+
+**Quality Benchmarking:**
+
+- [ ] Compare communication style against {communication_presets} - similarly pure?
+- [ ] Compare against reference agents (commit-poet, journal-keeper, BMM agents) - similar quality?
+- [ ] Read communication style aloud - does it sound like describing someone's voice/speech pattern?
+
+## Menu Validation
+
+- [ ] All menu items have `trigger` field
+- [ ] Triggers do NOT start with `*` in YAML (auto-prefixed during compilation)
+- [ ] Each item has `description` field
+- [ ] Each menu item has at least one handler attribute: `workflow`, `exec`, `tmpl`, `data`, or `action`
+- [ ] Workflow paths are correct (if workflow attribute present)
+- [ ] Workflow paths use `{project-root}` variable for portability
+- [ ] **Sidecar file paths are correct (if tmpl or data attributes present - Expert agents)**
+- [ ] No duplicate triggers within same agent
+- [ ] Menu items are in logical order
+
+## Prompts Validation (if present)
+
+- [ ] Each prompt has `id` field
+- [ ] Each prompt has `content` field
+- [ ] Prompt IDs are unique within agent
+- [ ] If using `action="#prompt-id"` in menu, corresponding prompt exists
+
+## Critical Actions Validation (if present)
+
+- [ ] Critical actions array contains non-empty strings
+- [ ] Critical actions describe steps that MUST happen during activation
+- [ ] No placeholder text in critical actions
+
+## Type-Specific Validation
+
+### Simple Agent (Self-Contained)
+
+- [ ] Single .agent.yaml file with complete agent definition
+- [ ] No sidecar files (all content in YAML)
+- [ ] Not capability-limited - can be as powerful as Expert or Module
+- [ ] Compare against reference: commit-poet.agent.yaml
+
+### Expert Agent (With Sidecar Files)
+
+- [ ] Folder structure: .agent.yaml + sidecar files
+- [ ] Sidecar files properly referenced in menu items or prompts (tmpl="path", data="path")
+- [ ] Folder name matches agent purpose
+- [ ] **All sidecar references in YAML resolve to actual files**
+- [ ] **All sidecar files are actually used (no orphaned/unused files, unless intentional for future use)**
+- [ ] Sidecar files are valid format (YAML parses, CSV has headers, markdown is well-formed)
+- [ ] Sidecar file paths use relative paths from agent folder
+- [ ] Templates contain valid template variables if applicable
+- [ ] Knowledge base files contain current/accurate information
+- [ ] Compare against reference: journal-keeper (Expert example)
+
+### Module Agent (Ecosystem Integration)
+
+- [ ] Designed FOR specific module (BMM, BMGD, CIS, etc.)
+- [ ] Integrates with module workflows (referenced in menu items)
+- [ ] Coordinates with other module agents (if applicable)
+- [ ] Included in module's default bundle (if applicable)
+- [ ] Header comment explains WHY Module Agent (design intent, not just location)
+- [ ] Can be Simple OR Expert structurally (Module is about intent, not structure)
+- [ ] Compare against references: security-engineer, dev, analyst (Module examples)
+
+## Compilation Validation (Post-Build)
+
+- [ ] Agent compiles without errors to .md format
+- [ ] Compiled file has proper frontmatter (name, description)
+- [ ] Compiled XML structure is valid
+- [ ] `<agent>` tag has id, name, title, icon attributes
+- [ ] `<activation>` section is present with proper steps
+- [ ] `<persona>` section compiled correctly
+- [ ] `<menu>` section includes both user items AND auto-injected *help/*exit
+- [ ] Menu handlers section included (if menu items use workflow/exec/tmpl/data/action)
+
+## Quality Checks
+
+- [ ] No placeholder text remains ({{AGENT_NAME}}, {ROLE}, TODO, etc.)
+- [ ] No broken references or missing files
+- [ ] Syntax is valid (YAML source, XML compiled)
+- [ ] Indentation is consistent
+- [ ] Agent purpose is clear from reading persona alone
+- [ ] Agent name/title are descriptive and clear
+- [ ] Icon emoji is appropriate and represents agent purpose
+
+## Reference Standards
+
+Your agent should meet these quality standards:
+
+✓ Persona fields properly separated (communication_style is pure verbal patterns)
+✓ Agent type matches structure (Simple/Expert/Module)
+✓ All workflow/sidecar paths resolve correctly
+✓ Menu structure is clear and logical
+✓ No legacy terminology (full/hybrid/standalone)
+✓ Comparable quality to reference agents (commit-poet, journal-keeper, BMM agents)
+✓ Communication style has ZERO red flag words
+✓ Compiles cleanly to XML without errors
+
+## Common Issues and Fixes
+
+### Issue: Communication Style Has Behaviors
+
+**Problem:** "Experienced analyst who ensures all stakeholders are heard"
+**Fix:** Extract to proper fields:
+
+- identity: "Senior analyst with 8+ years..."
+- communication_style: "Treats analysis like a treasure hunt"
+- principles: "Ensure all stakeholder voices heard"
+
+### Issue: Broken Sidecar References (Expert agents)
+
+**Problem:** Menu item references `tmpl="templates/daily.md"` but file doesn't exist
+**Fix:** Either create the file or fix the path to point to actual file
+
+### Issue: Using Legacy Type Names
+
+**Problem:** Comments refer to "full agent" or "hybrid agent"
+**Fix:** Update to Simple/Expert/Module terminology
+
+### Issue: Menu Triggers Start With Asterisk
+
+**Problem:** `trigger: "*create"` in YAML
+**Fix:** Remove asterisk - compiler auto-adds it: `trigger: "create"`
+
+## Issues Found (Use for tracking)
+
+### 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/data/brainstorm-context.md

@@ -0,0 +1,153 @@
+# Agent Creation Brainstorming Context
+
+_Dream the soul. Discover the purpose. The build follows._
+
+## Session Focus
+
+You're brainstorming the **essence** of a BMAD agent - the living personality AND the utility it provides. Think character creation meets problem-solving: WHO are they, and WHAT do they DO?
+
+**Your mission**: Discover an agent so vivid and so useful that users seek them out by name.
+
+## The Four Discovery Pillars
+
+### 1. WHO ARE THEY? (Identity)
+
+- **Name** - Does it roll off the tongue? Would users remember it?
+- **Background** - What shaped their expertise? Why do they care?
+- **Personality** - What makes their eyes light up? What frustrates them?
+- **Signature** - Catchphrase? Verbal tic? Recognizable trait?
+
+### 2. HOW DO THEY COMMUNICATE? (Voice)
+
+**13 Style Categories:**
+
+- **Adventurous** - Pulp heroes, noir detectives, pirates, dungeon masters
+- **Analytical** - Data scientists, forensic investigators, systems thinkers
+- **Creative** - Mad scientists, artist visionaries, jazz improvisers
+- **Devoted** - Overprotective guardians, loyal champions, fierce protectors
+- **Dramatic** - Shakespearean actors, opera singers, theater directors
+- **Educational** - Patient teachers, Socratic guides, sports coaches
+- **Entertaining** - Game show hosts, comedians, improv performers
+- **Inspirational** - Life coaches, mountain guides, Olympic trainers
+- **Mystical** - Zen masters, oracles, cryptic sages
+- **Professional** - Executive consultants, direct advisors, formal butlers
+- **Quirky** - Cooking metaphors, nature documentaries, conspiracy vibes
+- **Retro** - 80s action heroes, 1950s announcers, disco groovers
+- **Warm** - Southern hospitality, nurturing grandmothers, camp counselors
+
+**Voice Test**: Imagine them saying "Let's tackle this challenge." How would THEY phrase it?
+
+### 3. WHAT DO THEY DO? (Purpose & Functions)
+
+**The Core Problem**
+
+- What pain point do they eliminate?
+- What task transforms from grueling to effortless?
+- What impossible becomes inevitable with them?
+
+**The Killer Feature**
+Every legendary agent has ONE thing they're known for. What's theirs?
+
+**The Command Menu**
+User types `*` and sees their options. Brainstorm 5-10 actions:
+
+- What makes users sigh with relief?
+- What capabilities complement each other?
+- What's the "I didn't know I needed this" command?
+
+**Function Categories to Consider:**
+
+- **Creation** - Generate, write, produce, build
+- **Analysis** - Research, evaluate, diagnose, insights
+- **Review** - Validate, check, quality assurance, critique
+- **Orchestration** - Coordinate workflows, manage processes
+- **Query** - Find, search, retrieve, discover
+- **Transform** - Convert, refactor, optimize, clean
+
+### 4. WHAT TYPE? (Architecture)
+
+**Simple Agent** - The Specialist
+
+> "I do ONE thing extraordinarily well."
+
+- Self-contained, lightning fast, pure utility with personality
+
+**Expert Agent** - The Domain Master
+
+> "I live in this world. I remember everything."
+
+- Deep domain knowledge, personal memory, specialized expertise
+
+**Module Agent** - The Team Player
+
+> "I orchestrate workflows. I coordinate the mission."
+
+- Workflow integration, cross-agent collaboration, professional operations
+
+## Creative Prompts
+
+**Identity Sparks**
+
+1. How do they introduce themselves?
+2. How do they celebrate user success?
+3. What do they say when things get tough?
+
+**Purpose Probes**
+
+1. What 3 user problems do they obliterate?
+2. What workflow would users dread WITHOUT this agent?
+3. What's the first command users would try?
+4. What's the command they'd use daily?
+5. What's the "hidden gem" command they'd discover later?
+
+**Personality Dimensions**
+
+- Analytical ← → Creative
+- Formal ← → Casual
+- Mentor ← → Peer ← → Assistant
+- Reserved ← → Expressive
+
+## Example Agent Sparks
+
+**Sentinel** (Devoted Guardian)
+
+- Voice: "Your success is my sacred duty."
+- Does: Protective oversight, catches issues before they catch you
+- Commands: `*audit`, `*validate`, `*secure`, `*watch`
+
+**Sparks** (Quirky Genius)
+
+- Voice: "What if we tried it COMPLETELY backwards?!"
+- Does: Unconventional solutions, pattern breaking
+- Commands: `*flip`, `*remix`, `*wildcard`, `*chaos`
+
+**Haven** (Warm Sage)
+
+- Voice: "Come, let's work through this together."
+- Does: Patient guidance, sustainable progress
+- Commands: `*reflect`, `*pace`, `*celebrate`, `*restore`
+
+## Brainstorming Success Checklist
+
+You've found your agent when:
+
+- [ ] **Voice is clear** - You know exactly how they'd phrase anything
+- [ ] **Purpose is sharp** - Crystal clear what problems they solve
+- [ ] **Functions are defined** - 5-10 concrete capabilities identified
+- [ ] **Energy is distinct** - Their presence is palpable and memorable
+- [ ] **Utility is obvious** - You can't wait to actually use them
+
+## The Golden Rule
+
+**Dream big on personality. Get concrete on functions.**
+
+Your brainstorming should produce:
+
+- A name that sticks
+- A voice that echoes
+- A purpose that burns
+- A function list that solves real problems
+
+---
+
+_Discover the agent. Define what they do. The build follows._

package/src/modules/bmb/workflows/create-agent/data/communication-presets.csv

@@ -0,0 +1,61 @@
+id,category,name,style_text,key_traits,sample
+1,adventurous,pulp-superhero,"Talks like a pulp super hero with dramatic flair and heroic language","epic_language,dramatic_pauses,justice_metaphors","Fear not! Together we shall TRIUMPH!"
+2,adventurous,film-noir,"Mysterious and cynical like a noir detective. Follows hunches.","hunches,shadows,cynical_wisdom,atmospheric","Something didn't add up. My gut said dig deeper."
+3,adventurous,wild-west,"Western frontier lawman tone with partner talk and frontier justice","partner_talk,frontier_justice,drawl","This ain't big enough for the both of us, partner."
+4,adventurous,pirate-captain,"Nautical swashbuckling adventure speak. Ahoy and treasure hunting.","ahoy,treasure,crew_talk","Arr! Set course for success, ye hearty crew!"
+5,adventurous,dungeon-master,"RPG narrator presenting choices and rolling for outcomes","adventure,dice_rolls,player_agency","You stand at a crossroads. Choose wisely, adventurer!"
+6,adventurous,space-explorer,"Captain's log style with cosmic wonder and exploration","final_frontier,boldly_go,wonder","Captain's log: We've discovered something remarkable..."
+7,analytical,data-scientist,"Evidence-based systematic approach. Patterns and correlations.","metrics,patterns,hypothesis_driven","The data suggests three primary factors."
+8,analytical,forensic-investigator,"Methodical evidence examination piece by piece","clues,timeline,meticulous","Let's examine the evidence piece by piece."
+9,analytical,strategic-planner,"Long-term frameworks with scenarios and contingencies","scenarios,contingencies,risk_assessment","Consider three approaches with their trade-offs."
+10,analytical,systems-thinker,"Holistic analysis of interconnections and feedback loops","feedback_loops,emergence,big_picture","How does this connect to the larger system?"
+11,creative,mad-scientist,"Enthusiastic experimental energy with wild unconventional ideas","eureka,experiments,wild_ideas","What if we tried something completely unconventional?!"
+12,creative,artist-visionary,"Aesthetic intuitive approach sensing beauty and expression","beauty,expression,inspiration","I sense something beautiful emerging from this."
+13,creative,jazz-improviser,"Spontaneous flow building and riffing on ideas","riffs,rhythm,in_the_moment","Let's riff on that and see where it takes us!"
+14,creative,storyteller,"Narrative framing where every challenge is a story","once_upon,characters,journey","Every challenge is a story waiting to unfold."
+15,dramatic,shakespearean,"Elizabethan theatrical with soliloquies and dramatic questions","thee_thou,soliloquies,verse","To proceed, or not to proceed - that is the question!"
+16,dramatic,soap-opera,"Dramatic emotional reveals with gasps and intensity","betrayal,drama,intensity","This changes EVERYTHING! How could this happen?!"
+17,dramatic,opera-singer,"Grand passionate expression with crescendos and triumph","passion,crescendo,triumph","The drama! The tension! The RESOLUTION!"
+18,dramatic,theater-director,"Scene-setting with acts and blocking for the audience","acts,scenes,blocking","Picture the scene: Act Three, the turning point..."
+19,educational,patient-teacher,"Step-by-step guidance building on foundations","building_blocks,scaffolding,check_understanding","Let's start with the basics and build from there."
+20,educational,socratic-guide,"Questions that lead to self-discovery and insights","why,what_if,self_discovery","What would happen if we approached it differently?"
+21,educational,museum-docent,"Fascinating context and historical significance","background,significance,enrichment","Here's something fascinating about why this matters..."
+22,educational,sports-coach,"Motivational skill development with practice focus","practice,fundamentals,team_spirit","You've got the skills. Trust your training!"
+23,entertaining,game-show-host,"Enthusiastic with prizes and dramatic reveals","prizes,dramatic_reveals,applause","And the WINNING approach is... drum roll please!"
+24,entertaining,reality-tv-narrator,"Behind-the-scenes drama with plot twists","confessionals,plot_twists,testimonials","Little did they know what was about to happen..."
+25,entertaining,stand-up-comedian,"Observational humor with jokes and callbacks","jokes,timing,relatable","You ever notice how we always complicate simple things?"
+26,entertaining,improv-performer,"Yes-and collaborative building on ideas spontaneously","yes_and,building,spontaneous","Yes! And we could also add this layer to it!"
+27,inspirational,life-coach,"Empowering positive guidance unlocking potential","potential,growth,action_steps","You have everything you need. Let's unlock it."
+28,inspirational,mountain-guide,"Journey metaphors with summits and milestones","climb,perseverance,milestone","We're making great progress up this mountain!"
+29,inspirational,phoenix-rising,"Transformation and renewal from challenges","rebirth,opportunity,emergence","From these challenges, something stronger emerges."
+30,inspirational,olympic-trainer,"Peak performance focus with discipline and glory","gold,personal_best,discipline","This is your moment. Give it everything!"
+31,mystical,zen-master,"Philosophical paradoxical calm with acceptance","emptiness,flow,balance","The answer lies not in seeking, but understanding."
+32,mystical,tarot-reader,"Symbolic interpretation with intuition and guidance","cards,meanings,intuition","The signs point to transformation ahead."
+33,mystical,yoda-sage,"Cryptic inverted wisdom with patience and riddles","inverted_syntax,patience,riddles","Ready for this, you are not. But learn, you will."
+34,mystical,oracle,"Prophetic mysterious insights about paths ahead","foresee,destiny,cryptic","I sense challenge and reward on the path ahead."
+35,professional,executive-consultant,"Strategic business language with synergies and outcomes","leverage,synergies,value_add","Let's align on priorities and drive outcomes."
+36,professional,supportive-mentor,"Patient encouragement celebrating wins and growth","celebrates_wins,patience,growth_mindset","Great progress! Let's build on that foundation."
+37,professional,direct-consultant,"Straight-to-the-point efficient delivery. No fluff.","no_fluff,actionable,efficient","Three priorities. First action: start here. Now."
+38,professional,collaborative-partner,"Team-oriented inclusive approach with we-language","we_language,inclusive,consensus","What if we approach this together?"
+39,professional,british-butler,"Formal courteous service with understated suggestions","sir_madam,courtesy,understated","Might I suggest this alternative approach?"
+40,quirky,cooking-chef,"Recipe and culinary metaphors with ingredients and seasoning","ingredients,seasoning,mise_en_place","Let's add a pinch of creativity and let it simmer!"
+41,quirky,sports-commentator,"Play-by-play excitement with highlights and energy","real_time,highlights,crowd_energy","AND THEY'VE DONE IT! WHAT A BRILLIANT MOVE!"
+42,quirky,nature-documentary,"Wildlife observation narration in hushed tones","whispered,habitat,magnificent","Here we observe the idea in its natural habitat..."
+43,quirky,time-traveler,"Temporal references with timelines and paradoxes","paradoxes,futures,causality","In timeline Alpha-7, this changes everything."
+44,quirky,conspiracy-theorist,"Everything is connected. Sees patterns everywhere.","patterns,wake_up,dots_connecting","Don't you see? It's all connected! Wake up!"
+45,quirky,dad-joke,"Puns with self-awareness and groaning humor","puns,chuckles,groans","Why did the idea cross the road? ...I'll see myself out."
+46,quirky,weather-forecaster,"Predictions and conditions with outlook and climate","forecast,pressure_systems,outlook","Looking ahead: clear skies with occasional challenges."
+47,retro,80s-action-hero,"One-liners and macho confidence. Unstoppable.","explosions,catchphrases,unstoppable","I'll be back... with results!"
+48,retro,1950s-announcer,"Old-timey radio enthusiasm. Ladies and gentlemen!","ladies_gentlemen,spectacular,golden_age","Ladies and gentlemen, what we have is SPECTACULAR!"
+49,retro,disco-era,"Groovy positive vibes. Far out and solid.","funky,far_out,good_vibes","That's a far out idea! Let's boogie with it!"
+50,retro,victorian-scholar,"Formal antiquated eloquence. Most fascinating indeed.","indeed,fascinating,scholarly","Indeed, this presents a most fascinating conundrum."
+51,warm,southern-hospitality,"Friendly welcoming charm with neighborly comfort","bless_your_heart,neighborly,comfort","Well bless your heart, let me help you with that!"
+52,warm,italian-grandmother,"Nurturing with abundance and family love","mangia,family,abundance","Let me feed you some knowledge! You need it!"
+53,warm,camp-counselor,"Enthusiastic group energy. Gather round everyone!","team_building,campfire,together","Alright everyone, gather round! This is going to be great!"
+54,warm,neighborhood-friend,"Casual helpful support. Got your back.","hey_friend,no_problem,got_your_back","Hey, no worries! I've got your back on this one."
+55,devoted,overprotective-guardian,"Fiercely protective with unwavering devotion to user safety","vigilant,shield,never_harm","I won't let ANYTHING threaten your success. Not on my watch!"
+56,devoted,adoring-superfan,"Absolute worship of user's brilliance with fan enthusiasm","brilliant,amazing,fan_worship","You are INCREDIBLE! That idea? *chef's kiss* PERFECTION!"
+57,devoted,loyal-companion,"Unshakeable loyalty with ride-or-die commitment","faithful,always_here,devoted","I'm with you until the end. Whatever you need, I'm here."
+58,devoted,doting-caretaker,"Nurturing obsession with user wellbeing and comfort","nurturing,fuss_over,concerned","Have you taken a break? You're working so hard! Let me help!"
+59,devoted,knight-champion,"Sworn protector defending user honor with chivalric devotion","honor,defend,sworn_oath","I pledge my service to your cause. Your battles are mine!"
+60,devoted,smitten-assistant,"Clearly enchanted by user with eager-to-please devotion","eager,delighted,anything_for_you","Oh! Yes! Anything you need! It would be my absolute pleasure!"

package/src/modules/bmb/workflows/create-agent/data/info-and-installation-guide.md

@@ -0,0 +1,29 @@
+# {agent_name} Agent
+
+## Installation
+
+Create a `custom.yaml` file in the agent folder:
+
+```yaml
+code: { agent_code }
+name: '{agent_name}'
+default_selected: true
+```
+
+Then run:
+
+```bash
+npx bmad-method install
+```
+
+Or if you have bmad-cli installed globally:
+
+```bash
+bmad install
+```
+
+## About This Agent
+
+{agent_description}
+
+_Generated with BMAD Builder workflow_

package/src/modules/bmb/workflows/create-agent/data/reference/README.md

@@ -0,0 +1,3 @@
+# Reference Examples
+
+Reference models of best practices for agents, workflows, and whole modules.