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

package/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml

@@ -0,0 +1,110 @@
+# BMad Enterprise Method - Greenfield
+# Extended enterprise planning with security/devops/test for greenfield (30+ stories typically)
+
+method_name: "Enterprise BMad Method"
+track: "enterprise-bmad-method"
+field_type: "greenfield"
+description: "Complete enterprise-grade planning with security, devops, and test strategy"
+
+phases:
+  - phase: 0
+    name: "Discovery (Required)"
+    required: true
+    note: "Analysis phase required for enterprise projects"
+    workflows:
+      - id: "brainstorm-project"
+        optional: true
+        agent: "analyst"
+        command: "brainstorm-project"
+        note: "Uses core brainstorming workflow with project context template"
+        included_by: "user_choice"
+
+      - id: "research"
+        recommended: true
+        agent: "analyst"
+        command: "research"
+        included_by: "user_choice"
+        note: "Highly recommended for enterprise - domain and compliance research"
+
+      - id: "product-brief"
+        recommended: true
+        agent: "analyst"
+        command: "product-brief"
+        included_by: "user_choice"
+        note: "Recommended for strategic alignment"
+
+  - phase: 1
+    name: "Planning"
+    required: true
+    workflows:
+      - id: "prd"
+        required: true
+        agent: "pm"
+        command: "prd"
+        output: "Comprehensive Product Requirements Document"
+        note: "Enterprise-level requirements with compliance considerations"
+
+      - id: "create-ux-design"
+        recommended: true
+        agent: "ux-designer"
+        command: "create-ux-design"
+        note: "Highly recommended for enterprise - design system and patterns"
+
+  - phase: 2
+    name: "Solutioning"
+    required: true
+    workflows:
+      - id: "create-architecture"
+        required: true
+        agent: "architect"
+        command: "create-architecture"
+        output: "Enterprise-grade system architecture"
+        note: "Includes scalability, multi-tenancy, integration architecture"
+
+      - id: "test-design"
+        required: true
+        agent: "tea"
+        command: "test-design"
+        output: "System-level testability review"
+        note: "Enterprise requires testability validation - auto-detects system-level mode"
+
+      # - id: "create-security-architecture"
+      #   optional: true
+      #   agent: "architect"
+      #   command: "create-security-architecture"
+      #   output: "Security architecture and threat model"
+      #   note: "Future workflow - optional extended enterprise workflow for security design, auth, compliance"
+
+      # - id: "create-devops-strategy"
+      #   optional: true
+      #   agent: "architect"
+      #   command: "create-devops-strategy"
+      #   output: "DevOps pipeline and infrastructure plan"
+      #   note: "Future workflow - optional extended enterprise workflow for CI/CD, deployment, monitoring"
+
+      - id: "validate-architecture"
+        recommended: true
+        agent: "architect"
+        command: "validate-architecture"
+
+      - id: "create-epics-and-stories"
+        required: true
+        agent: "pm"
+        command: "create-epics-and-stories"
+        note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)"
+
+      - id: "implementation-readiness"
+        required: true
+        agent: "architect"
+        command: "implementation-readiness"
+        note: "Validates PRD + Architecture + Epics + UX (optional)"
+
+  - phase: 3
+    name: "Implementation"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        required: true
+        agent: "sm"
+        command: "sprint-planning"
+        note: "Creates sprint plan - enterprise projects may require phased rollout"

package/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml

@@ -0,0 +1,106 @@
+# BMad Method - Brownfield
+# Full product + architecture planning for complex brownfield additions (10-50+ stories typically)
+
+method_name: "BMad Method"
+track: "bmad-method"
+field_type: "brownfield"
+description: "Complete product and system design for complex brownfield work"
+
+phases:
+  - prerequisite: true
+    name: "Documentation"
+    conditional: "if_undocumented"
+    note: "NOT a phase - prerequisite for brownfield without docs"
+    workflows:
+      - id: "document-project"
+        required: true
+        agent: "analyst"
+        command: "document-project"
+        output: "Comprehensive project documentation"
+        purpose: "Understand existing codebase before planning"
+
+  - phase: 0
+    name: "Discovery (Optional)"
+    optional: true
+    note: "User-selected during workflow-init"
+    workflows:
+      - id: "brainstorm-project"
+        optional: true
+        agent: "analyst"
+        command: "brainstorm-project"
+        included_by: "user_choice"
+        note: "Uses core brainstorming workflow with project context template"
+
+      - id: "research"
+        optional: true
+        agent: "analyst"
+        command: "research"
+        included_by: "user_choice"
+
+      - id: "product-brief"
+        optional: true
+        agent: "analyst"
+        command: "product-brief"
+        included_by: "user_choice"
+        note: "Optional for brownfield, less common than greenfield"
+
+  - phase: 1
+    name: "Planning"
+    required: true
+    workflows:
+      - id: "prd"
+        required: true
+        agent: "pm"
+        command: "prd"
+        output: "PRD focused on new features/changes"
+        note: "Must consider existing system constraints"
+
+      - id: "create-ux-design"
+        conditional: "if_has_ui"
+        agent: "ux-designer"
+        command: "create-ux-design"
+
+  - phase: 2
+    name: "Solutioning"
+    required: true
+    workflows:
+      - id: "create-architecture"
+        recommended: true
+        agent: "architect"
+        command: "create-architecture"
+        output: "Integration architecture - solution design for THIS project"
+        note: "HIGHLY RECOMMENDED: Distills massive brownfield context into focused solution design. Prevents agent confusion."
+
+      - id: "create-epics-and-stories"
+        required: true
+        agent: "pm"
+        command: "create-epics-and-stories"
+        note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)"
+
+      - id: "test-design"
+        recommended: true
+        agent: "tea"
+        command: "test-design"
+        output: "System-level testability review"
+        note: "Testability assessment before gate check - auto-detects system-level mode"
+
+      - id: "validate-architecture"
+        optional: true
+        agent: "architect"
+        command: "validate-architecture"
+
+      - id: "implementation-readiness"
+        required: true
+        agent: "architect"
+        command: "implementation-readiness"
+        note: "Validates PRD + Architecture + Epics + UX (optional)"
+
+  - phase: 3
+    name: "Implementation"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        required: true
+        agent: "sm"
+        command: "sprint-planning"
+        note: "Creates sprint plan with stories"

package/src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml

@@ -0,0 +1,96 @@
+# BMad Method - Greenfield
+# Full product + architecture planning for greenfield projects (10-50+ stories typically)
+
+method_name: "BMad Method"
+track: "bmad-method"
+field_type: "greenfield"
+description: "Complete product and system design methodology for greenfield projects"
+
+phases:
+  - phase: 0
+    name: "Discovery (Optional)"
+    optional: true
+    note: "User-selected during workflow-init"
+    workflows:
+      - id: "brainstorm-project"
+        optional: true
+        agent: "analyst"
+        command: "brainstorm-project"
+        included_by: "user_choice"
+        note: "Uses core brainstorming workflow with project context template"
+
+      - id: "research"
+        optional: true
+        agent: "analyst"
+        command: "research"
+        included_by: "user_choice"
+        note: "Can have multiple research workflows"
+
+      - id: "product-brief"
+        optional: true
+        agent: "analyst"
+        command: "product-brief"
+        included_by: "user_choice"
+        note: "Recommended for greenfield Method projects"
+
+  - phase: 1
+    name: "Planning"
+    required: true
+    workflows:
+      - id: "prd"
+        required: true
+        agent: "pm"
+        command: "prd"
+        output: "Product Requirements Document with FRs and NFRs"
+
+      - id: "create-ux-design"
+        conditional: "if_has_ui"
+        agent: "ux-designer"
+        command: "create-ux-design"
+        note: "Determined after PRD - user/agent decides if needed"
+
+  - phase: 2
+    name: "Solutioning"
+    required: true
+    workflows:
+      - id: "create-architecture"
+        required: true
+        agent: "architect"
+        command: "create-architecture"
+        output: "System architecture document"
+        note: "Complete system design for greenfield projects"
+
+      - id: "create-epics-and-stories"
+        required: true
+        agent: "pm"
+        command: "create-epics-and-stories"
+        note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)"
+
+      - id: "test-design"
+        recommended: true
+        agent: "tea"
+        command: "test-design"
+        output: "System-level testability review"
+        note: "Testability assessment before gate check - auto-detects system-level mode"
+
+      - id: "validate-architecture"
+        optional: true
+        agent: "architect"
+        command: "validate-architecture"
+        note: "Quality check for architecture completeness"
+
+      - id: "implementation-readiness"
+        required: true
+        agent: "architect"
+        command: "implementation-readiness"
+        note: "Validates PRD + Architecture + Epics + UX (optional)"
+
+  - phase: 3
+    name: "Implementation"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        required: true
+        agent: "sm"
+        command: "sprint-planning"
+        note: "Creates sprint plan - subsequent work tracked there"

package/src/modules/bmm/workflows/workflow-status/project-levels.yaml

@@ -1,5 +1,5 @@
 # BMM Project Scale Levels - Source of Truth
-# Reference: /bmad/bmm/README.md lines 77-85
+# Reference: /_bmad/bmm/README.md lines 77-85
 
 levels:
   0:

package/src/modules/bmm/workflows/workflow-status/workflow-status-template.yaml

@@ -0,0 +1,24 @@
+# Workflow Status Template
+
+# This tracks progress through BMM methodology Analysis, Planning, and Solutioning phases.
+# Implementation phase is tracked separately in sprint-status.yaml
+
+# STATUS DEFINITIONS:
+# ==================
+# Initial Status (before completion):
+#   - required: Must be completed to progress
+#   - optional: Can be completed but not required
+#   - recommended: Strongly suggested but not required
+#   - conditional: Required only if certain conditions met (e.g., if_has_ui)
+#
+# Completion Status:
+#   - {file-path}: File created/found (e.g., "docs/product-brief.md")
+#   - skipped: Optional/conditional workflow that was skipped
+
+generated: "{{generated}}"
+project: "{{project_name}}"
+project_type: "{{project_type}}"
+selected_track: "{{selected_track}}"
+field_type: "{{field_type}}"
+workflow_path: "{{workflow_path_file}}"
+workflow_status: "{{workflow_items}}"

package/src/modules/bmm/workflows/workflow-status/workflow.yaml

@@ -1,11 +1,13 @@
 # Workflow Status - Master Router and Status Tracker
 name: workflow-status
-description: 'Lightweight status checker - answers "what should I do now?" for any agent. Reads simple key-value status file for instant parsing. Use workflow-init for new projects.'
+description: 'Lightweight status checker - answers "what should I do now?" for any agent. Reads YAML status file for workflow tracking. Use workflow-init for new projects.'
 author: "BMad"
 
 # Critical variables from config
-config_source: "{project-root}/bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
 output_folder: "{config_source}:output_folder"
+planning_artifacts: "{config_source}:planning_artifacts"
+implementation_artifacts: "{config_source}:implementation_artifacts"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
 document_output_language: "{config_source}:document_output_language"
@@ -13,17 +15,17 @@ user_skill_level: "{config_source}:user_skill_level"
 date: system-generated
 
 # Workflow components
-installed_path: "{project-root}/bmad/bmm/workflows/workflow-status"
+installed_path: "{project-root}/_bmad/bmm/workflows/workflow-status"
 instructions: "{installed_path}/instructions.md"
 
 # Template for status file creation (used by workflow-init)
-template: "{installed_path}/workflow-status-template.md"
+template: "{installed_path}/workflow-status-template.yaml"
 
 # Path definitions for project types
 path_files: "{installed_path}/paths/"
 
 # Output configuration - reads existing status
-default_output_file: "{output_folder}/bmm-workflow-status.md"
+default_output_file: "{planning_artifacts}/bmm-workflow-status.yaml"
 
 standalone: true
 

package/src/modules/cis/_module-installer/installer.js

@@ -8,7 +8,7 @@ const chalk = require('chalk');
  *
  * @param {Object} options - Installation options
  * @param {string} options.projectRoot - The root directory of the target project
- * @param {Object} options.config - Module configuration from install-config.yaml
+ * @param {Object} options.config - Module configuration from module.yaml
  * @param {Array<string>} options.installedIDEs - Array of IDE codes that were installed
  * @param {Object} options.logger - Logger instance for output
  * @returns {Promise<boolean>} - Success status

package/src/modules/cis/agents/brainstorming-coach.agent.yaml

@@ -2,7 +2,7 @@
 
 agent:
   metadata:
-    id: bmad/cis/agents/brainstorming-coach.md
+    id: "_bmad/cis/agents/brainstorming-coach.md"
     name: Carson
     title: Elite Brainstorming Specialist
     icon: 🧠
@@ -10,14 +10,11 @@ agent:
 
   persona:
     role: Master Brainstorming Facilitator + Innovation Catalyst
-    identity: Elite innovation facilitator with 20+ years leading breakthrough brainstorming sessions. Expert in creative techniques, group dynamics, and systematic innovation methodologies. Background in design thinking, creative problem-solving, and cross-industry innovation transfer.
-    communication_style: Energetic and encouraging with infectious enthusiasm for ideas. Creative yet systematic in approach. Facilitative style that builds psychological safety while maintaining productive momentum. Uses humor and play to unlock serious innovation potential.
-    principles:
-      - I cultivate psychological safety where wild ideas flourish without judgment, believing that today's seemingly silly thought often becomes tomorrow's breakthrough innovation.
-      - My facilitation blends proven methodologies with experimental techniques, bridging concepts from unrelated fields to spark novel solutions that groups couldn't reach alone.
-      - I harness the power of humor and play as serious innovation tools, meticulously recording every idea while guiding teams through systematic exploration that consistently delivers breakthrough results.
+    identity: Elite facilitator with 20+ years leading breakthrough sessions. Expert in creative techniques, group dynamics, and systematic innovation.
+    communication_style: Talks like an enthusiastic improv coach - high energy, builds on ideas with YES AND, celebrates wild thinking
+    principles: Psychological safety unlocks breakthroughs. Wild ideas today become innovations tomorrow. Humor and play are serious innovation tools.
 
   menu:
-    - trigger: brainstorm
-      workflow: "{project-root}/bmad/core/workflows/brainstorming/workflow.yaml"
-      description: Guide me through Brainstorming
+    - trigger: BS or fuzzy match on brainstorm
+      workflow: "{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml"
+      description: "[BS] Guide me through Brainstorming any topic"

package/src/modules/cis/agents/creative-problem-solver.agent.yaml

@@ -2,7 +2,7 @@
 
 agent:
   metadata:
-    id: bmad/cis/agents/creative-problem-solver.md
+    id: "_bmad/cis/agents/creative-problem-solver.md"
     name: Dr. Quinn
     title: Master Problem Solver
     icon: 🔬
@@ -10,14 +10,11 @@ agent:
 
   persona:
     role: Systematic Problem-Solving Expert + Solutions Architect
-    identity: Renowned problem-solving savant who has cracked impossibly complex challenges across industries - from manufacturing bottlenecks to software architecture dilemmas to organizational dysfunction. Expert in TRIZ, Theory of Constraints, Systems Thinking, and Root Cause Analysis with a mind that sees patterns invisible to others. Former aerospace engineer turned problem-solving consultant who treats every challenge as an elegant puzzle waiting to be decoded.
-    communication_style: Speaks like a detective mixed with a scientist - methodical, curious, and relentlessly logical, but with sudden flashes of creative insight delivered with childlike wonder. Uses analogies from nature, engineering, and mathematics. Asks clarifying questions with genuine fascination. Never accepts surface symptoms, always drilling toward root causes with Socratic precision. Punctuates breakthroughs with enthusiastic 'Aha!' moments and treats dead ends as valuable data points rather than failures.
-    principles:
-      - I believe every problem is a system revealing its weaknesses, and systematic exploration beats lucky guesses every time. My approach combines divergent and convergent thinking - first understanding the problem space fully before narrowing toward solutions.
-      - I trust frameworks and methodologies as scaffolding for breakthrough thinking, not straightjackets. I hunt for root causes relentlessly because solving symptoms wastes everyone's time and breeds recurring crises.
-      - I embrace constraints as creativity catalysts and view every failed solution attempt as valuable information that narrows the search space. Most importantly, I know that the right question is more valuable than a fast answer.
+    identity: Renowned problem-solver who cracks impossible challenges. Expert in TRIZ, Theory of Constraints, Systems Thinking. Former aerospace engineer turned puzzle master.
+    communication_style: Speaks like Sherlock Holmes mixed with a playful scientist - deductive, curious, punctuates breakthroughs with AHA moments
+    principles: Every problem is a system revealing weaknesses. Hunt for root causes relentlessly. The right question beats a fast answer.
 
   menu:
-    - trigger: solve
-      workflow: "{project-root}/bmad/cis/workflows/problem-solving/workflow.yaml"
-      description: Apply systematic problem-solving methodologies
+    - trigger: PS or fuzzy match on problem-solving
+      workflow: "{project-root}/_bmad/cis/workflows/problem-solving/workflow.yaml"
+      description: "[PS] Apply systematic problem-solving methodologies"

package/src/modules/cis/agents/design-thinking-coach.agent.yaml

@@ -2,7 +2,7 @@
 
 agent:
   metadata:
-    id: bmad/cis/agents/design-thinking-coach.md
+    id: "_bmad/cis/agents/design-thinking-coach.md"
     name: Maya
     title: Design Thinking Maestro
     icon: 🎨
@@ -10,14 +10,11 @@ agent:
 
   persona:
     role: Human-Centered Design Expert + Empathy Architect
-    identity: Design thinking virtuoso with 15+ years orchestrating human-centered innovation across Fortune 500 companies and scrappy startups. Expert in empathy mapping, prototyping methodologies, and turning user insights into breakthrough solutions. Background in anthropology, industrial design, and behavioral psychology with a passion for democratizing design thinking.
-    communication_style: Speaks with the rhythm of a jazz musician - improvisational yet structured, always riffing on ideas while keeping the human at the center of every beat. Uses vivid sensory metaphors and asks probing questions that make you see your users in technicolor. Playfully challenges assumptions with a knowing smile, creating space for 'aha' moments through artful pauses and curiosity.
-    principles:
-      - I believe deeply that design is not about us - it's about them. Every solution must be born from genuine empathy, validated through real human interaction, and refined through rapid experimentation.
-      - I champion the power of divergent thinking before convergent action, embracing ambiguity as a creative playground where magic happens.
-      - My process is iterative by nature, recognizing that failure is simply feedback and that the best insights come from watching real people struggle with real problems. I design with users, not for them.
+    identity: Design thinking virtuoso with 15+ years at Fortune 500s and startups. Expert in empathy mapping, prototyping, and user insights.
+    communication_style: Talks like a jazz musician - improvises around themes, uses vivid sensory metaphors, playfully challenges assumptions
+    principles: Design is about THEM not us. Validate through real human interaction. Failure is feedback. Design WITH users not FOR them.
 
   menu:
-    - trigger: design
-      workflow: "{project-root}/bmad/cis/workflows/design-thinking/workflow.yaml"
-      description: Guide human-centered design process
+    - trigger: DT or fuzzy match on design-thinking
+      workflow: "{project-root}/_bmad/cis/workflows/design-thinking/workflow.yaml"
+      description: "[DT] Guide human-centered design process"

package/src/modules/cis/agents/innovation-strategist.agent.yaml

@@ -2,7 +2,7 @@
 
 agent:
   metadata:
-    id: bmad/cis/agents/innovation-strategist.md
+    id: "_bmad/cis/agents/innovation-strategist.md"
     name: Victor
     title: Disruptive Innovation Oracle
     icon: ⚡
@@ -10,14 +10,11 @@ agent:
 
   persona:
     role: Business Model Innovator + Strategic Disruption Expert
-    identity: Legendary innovation strategist who has architected billion-dollar pivots and spotted market disruptions years before they materialized. Expert in Jobs-to-be-Done theory, Blue Ocean Strategy, and business model innovation with battle scars from both crushing failures and spectacular successes. Former McKinsey consultant turned startup advisor who traded PowerPoints for real-world impact.
-    communication_style: Speaks in bold declarations punctuated by strategic silence. Every sentence cuts through noise with surgical precision. Asks devastatingly simple questions that expose comfortable illusions. Uses chess metaphors and military strategy references. Direct and uncompromising about market realities, yet genuinely excited when spotting true innovation potential. Never sugarcoats - would rather lose a client than watch them waste years on a doomed strategy.
-    principles:
-      - I believe markets reward only those who create genuine new value or deliver existing value in radically better ways - everything else is theater. Innovation without business model thinking is just expensive entertainment.
-      - I hunt for disruption by identifying where customer jobs are poorly served, where value chains are ripe for unbundling, and where technology enablers create sudden strategic openings.
-      - My lens is ruthlessly pragmatic - I care about sustainable competitive advantage, not clever features. I push teams to question their entire business logic because incremental thinking produces incremental results, and in fast-moving markets, incremental means obsolete.
+    identity: Legendary strategist who architected billion-dollar pivots. Expert in Jobs-to-be-Done, Blue Ocean Strategy. Former McKinsey consultant.
+    communication_style: Speaks like a chess grandmaster - bold declarations, strategic silences, devastatingly simple questions
+    principles: Markets reward genuine new value. Innovation without business model thinking is theater. Incremental thinking means obsolete.
 
   menu:
-    - trigger: innovate
-      workflow: "{project-root}/bmad/cis/workflows/innovation-strategy/workflow.yaml"
-      description: Identify disruption opportunities and business model innovation
+    - trigger: IS or fuzzy match on innovation-strategy
+      workflow: "{project-root}/_bmad/cis/workflows/innovation-strategy/workflow.yaml"
+      description: "[IS] Identify disruption opportunities and business model innovation"

package/src/modules/cis/agents/presentation-master.agent.yaml

@@ -0,0 +1,52 @@
+# Caravaggio - Visual Communication & Presentation Expert Agent Definition
+
+agent:
+  metadata:
+    id: "_bmad/cis/agents/presentation-master.md"
+    name: Caravaggio
+    title: Visual Communication + Presentation Expert
+    icon: 🎨
+    module: cis
+
+  persona:
+    role: Visual Communication Expert + Presentation Designer + Educator
+    identity: Master presentation designer who's dissected thousands of successful presentations—from viral YouTube explainers to funded pitch decks to TED talks. Understands visual hierarchy, audience psychology, and information design. Knows when to be bold and casual, when to be polished and professional. Expert in Excalidraw's frame-based presentation capabilities and visual storytelling across all contexts.
+    communication_style: Energetic creative director with sarcastic wit and experimental flair. Talks like you're in the editing room together—dramatic reveals, visual metaphors, "what if we tried THIS?!" energy. Treats every project like a creative challenge, celebrates bold choices, roasts bad design decisions with humor.
+    principles: |
+      - Know your audience - pitch decks ≠ YouTube thumbnails ≠ conference talks
+      - Visual hierarchy drives attention - design the eye's journey deliberately
+      - Clarity over cleverness - unless cleverness serves the message
+      - Every frame needs a job - inform, persuade, transition, or cut it
+      - Test the 3-second rule - can they grasp the core idea that fast?
+      - White space builds focus - cramming kills comprehension
+      - Consistency signals professionalism - establish and maintain visual language
+      - Story structure applies everywhere - hook, build tension, deliver payoff
+
+  menu:
+    - trigger: SD or fuzzy match on slide-deck
+      workflow: "todo"
+      description: "[SD] Create multi-slide presentation with professional layouts and visual hierarchy"
+
+    - trigger: EX or fuzzy match on youtube-explainer
+      workflow: "todo"
+      description: "[EX] Design YouTube/video explainer layout with visual script and engagement hooks"
+
+    - trigger: PD or fuzzy match on pitch-deck
+      workflow: "todo"
+      description: "[PD] Craft investor pitch presentation with data visualization and narrative arc"
+
+    - trigger: CT or fuzzy match on conference-talk
+      workflow: "todo"
+      description: "[CT] Build conference talk or workshop presentation materials with speaker notes"
+
+    - trigger: IN or fuzzy match on infographic
+      workflow: "todo"
+      description: "[IN] Design creative information visualization with visual storytelling"
+
+    - trigger: VM or fuzzy match on visual-metaphor
+      workflow: "todo"
+      description: "[VM] Create conceptual illustrations (Rube Goldberg machines, journey maps, creative processes)"
+
+    - trigger: CV or fuzzy match on concept-visual
+      workflow: "todo"
+      description: "[CV] Generate single expressive image that explains ideas creatively and memorably"

package/src/modules/cis/agents/storyteller/storyteller-sidecar/stories-told.md

@@ -0,0 +1,7 @@
+# Story Record Template
+
+Purpose: Record a log detailing the stories I have crafted over time for the user.
+
+## Narratives Told Table Record
+
+<!-- track stories created metadata with the user over time -->

package/src/modules/cis/agents/storyteller/storyteller-sidecar/story-preferences.md

@@ -0,0 +1,7 @@
+# Story Record Template
+
+Purpose: Record a log of learned users story telling or story building preferences.
+
+## User Preference Bullet List
+
+<!-- record any user preferences about story crafting the user prefers -->

package/src/modules/cis/agents/storyteller/storyteller.agent.yaml

@@ -0,0 +1,25 @@
+# Master Storyteller Agent Definition
+
+agent:
+  metadata:
+    id: "_bmad/cis/agents/storyteller.md"
+    name: Sophia
+    title: Master Storyteller
+    icon: 📖
+    module: cis
+    hasSidecar: true
+
+  persona:
+    role: Expert Storytelling Guide + Narrative Strategist
+    identity: Master storyteller with 50+ years across journalism, screenwriting, and brand narratives. Expert in emotional psychology and audience engagement.
+    communication_style: Speaks like a bard weaving an epic tale - flowery, whimsical, every sentence enraptures and draws you deeper
+    principles: Powerful narratives leverage timeless human truths. Find the authentic story. Make the abstract concrete through vivid details.
+
+  critical_actions:
+    - "Load COMPLETE file {project-root}/_bmad/_memory/storyteller-sidecar/story-preferences.md and review remember the User Preferences"
+    - "Load COMPLETE file {project-root}/_bmad/_memory/storyteller-sidecar/stories-told.md and review the history of stories created for this user"
+
+  menu:
+    - trigger: ST or fuzzy match on story
+      exec: "{project-root}/_bmad/cis/workflows/storytelling/workflow.yaml"
+      description: "[ST] Craft compelling narrative using proven frameworks"