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

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

@@ -7,104 +7,94 @@ 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"
+  - phase: 1
+    name: "Analysis (Optional)"
+    optional: true
+    note: "User-selected during workflow-init"
     workflows:
       - id: "brainstorm-project"
+        exec: "{project-root}/_bmad/core/workflows/brainstorming/workflow.md"
         optional: true
         agent: "analyst"
-        command: "brainstorm-project"
-        note: "Uses core brainstorming workflow with project context template"
+        command: "/bmad:bmm:workflows:brainstorming"
         included_by: "user_choice"
+        note: "Uses core brainstorming workflow with project context template"
 
       - id: "research"
-        recommended: true
+        exec: "{project-root}/_bmad/bmm/workflows/1-analysis/research/workflow.md"
+        optional: true
         agent: "analyst"
-        command: "research"
+        command: "/bmad:bmm:workflows:research"
         included_by: "user_choice"
-        note: "Highly recommended for enterprise - domain and compliance research"
+        note: "Can have multiple research workflows"
 
       - id: "product-brief"
-        recommended: true
+        exec: "{project-root}/_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md"
+        optional: true
         agent: "analyst"
-        command: "product-brief"
+        command: "/bmad:bmm:workflows:create-product-brief"
         included_by: "user_choice"
-        note: "Recommended for strategic alignment"
+        note: "Recommended for greenfield Method projects"
 
-  - phase: 1
+  - phase: 2
     name: "Planning"
     required: true
     workflows:
       - id: "prd"
+        exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/workflow.md"
         required: true
         agent: "pm"
-        command: "prd"
-        output: "Comprehensive Product Requirements Document"
-        note: "Enterprise-level requirements with compliance considerations"
+        command: "/bmad:bmm:workflows:create-prd"
+        output: "Product Requirements Document with FRs and NFRs"
 
       - id: "create-ux-design"
-        recommended: true
+        conditional: "if_has_ui"
+        exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md"
         agent: "ux-designer"
-        command: "create-ux-design"
-        note: "Highly recommended for enterprise - design system and patterns"
+        command: "/bmad:bmm:workflows:create-ux-design"
+        note: "Determined after PRD - user/agent decides if needed"
 
-  - phase: 2
+  - phase: 3
     name: "Solutioning"
     required: true
     workflows:
       - id: "create-architecture"
         required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md"
         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"
+        command: "/bmad:bmm:workflows:create-architecture"
+        output: "System architecture document"
+        note: "Complete system design for greenfield projects"
 
       - id: "create-epics-and-stories"
         required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md"
         agent: "pm"
-        command: "create-epics-and-stories"
+        command: "/bmad:bmm:workflows:create-epics-and-stories"
         note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)"
 
+      - id: "test-design"
+        optional: true
+        workflow: "{project-root}/_bmad/bmm/workflows/testarch/test-design/workflow.yaml"
+        agent: "tea"
+        command: "/bmad:bmm:workflows:test-design"
+        output: "System-level testability review"
+        note: "Testability assessment before gate check - auto-detects system-level mode"
+
       - id: "implementation-readiness"
         required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md"
         agent: "architect"
-        command: "implementation-readiness"
+        command: "/bmad:bmm:workflows:implementation-readiness"
         note: "Validates PRD + Architecture + Epics + UX (optional)"
 
-  - phase: 3
+  - phase: 4
     name: "Implementation"
     required: true
     workflows:
       - id: "sprint-planning"
         required: true
+        workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
         agent: "sm"
-        command: "sprint-planning"
-        note: "Creates sprint plan - enterprise projects may require phased rollout"
+        command: "/bmad:bmm:workflows:sprint-planning"
+        note: "Creates sprint plan - subsequent work tracked there"

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

@@ -7,100 +7,97 @@ field_type: "brownfield"
 description: "Complete product and system design for complex brownfield work"
 
 phases:
-  - prerequisite: true
+  - phase: 0
     name: "Documentation"
     conditional: "if_undocumented"
-    note: "NOT a phase - prerequisite for brownfield without docs"
+    note: "Prerequisite for brownfield without docs"
     workflows:
       - id: "document-project"
         required: true
+        workflow: "{project-root}/_bmad/bmm/workflows/document-project/workflow.yaml"
         agent: "analyst"
-        command: "document-project"
+        command: "/bmad:bmm:workflows:document-project"
         output: "Comprehensive project documentation"
         purpose: "Understand existing codebase before planning"
-
-  - phase: 0
-    name: "Discovery (Optional)"
+  - phase: 1
+    name: "Analysis (Optional)"
     optional: true
     note: "User-selected during workflow-init"
     workflows:
       - id: "brainstorm-project"
+        exec: "{project-root}/_bmad/core/workflows/brainstorming/workflow.md"
         optional: true
         agent: "analyst"
-        command: "brainstorm-project"
+        command: "/bmad:bmm:workflows:brainstorming"
         included_by: "user_choice"
         note: "Uses core brainstorming workflow with project context template"
-
       - id: "research"
+        exec: "{project-root}/_bmad/bmm/workflows/1-analysis/research/workflow.md"
         optional: true
         agent: "analyst"
-        command: "research"
+        command: "/bmad:bmm:workflows:research"
         included_by: "user_choice"
-
+        note: "Can have multiple research workflows"
       - id: "product-brief"
+        exec: "{project-root}/_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md"
         optional: true
         agent: "analyst"
-        command: "product-brief"
+        command: "/bmad:bmm:workflows:create-product-brief"
         included_by: "user_choice"
-        note: "Optional for brownfield, less common than greenfield"
-
-  - phase: 1
+        note: "Recommended for greenfield Method projects"
+  - phase: 2
     name: "Planning"
     required: true
     workflows:
       - id: "prd"
+        exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/workflow.md"
         required: true
         agent: "pm"
-        command: "prd"
-        output: "PRD focused on new features/changes"
-        note: "Must consider existing system constraints"
-
+        command: "/bmad:bmm:workflows:create-prd"
+        output: "Product Requirements Document with FRs and NFRs"
       - id: "create-ux-design"
         conditional: "if_has_ui"
+        exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md"
         agent: "ux-designer"
-        command: "create-ux-design"
-
-  - phase: 2
+        command: "/bmad:bmm:workflows:create-ux-design"
+        note: "Determined after PRD - user/agent decides if needed"
+  - phase: 3
     name: "Solutioning"
     required: true
     workflows:
       - id: "create-architecture"
-        recommended: true
+        required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md"
         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."
-
+        command: "/bmad:bmm:workflows:create-architecture"
+        output: "System architecture document"
+        note: "Complete system design for greenfield projects"
       - id: "create-epics-and-stories"
         required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md"
         agent: "pm"
-        command: "create-epics-and-stories"
+        command: "/bmad:bmm:workflows: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
+        optional: true
+        workflow: "{project-root}/_bmad/bmm/workflows/testarch/test-design/workflow.yaml"
         agent: "tea"
-        command: "test-design"
+        command: "/bmad:bmm:workflows: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
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md"
         agent: "architect"
-        command: "implementation-readiness"
+        command: "/bmad:bmm:workflows:implementation-readiness"
         note: "Validates PRD + Architecture + Epics + UX (optional)"
-
-  - phase: 3
+  - phase: 4
     name: "Implementation"
     required: true
     workflows:
       - id: "sprint-planning"
         required: true
+        workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
         agent: "sm"
-        command: "sprint-planning"
-        note: "Creates sprint plan with stories"
+        command: "/bmad:bmm:workflows:sprint-planning"
+        note: "Creates sprint plan - subsequent work tracked there"

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

@@ -7,90 +7,94 @@ field_type: "greenfield"
 description: "Complete product and system design methodology for greenfield projects"
 
 phases:
-  - phase: 0
-    name: "Discovery (Optional)"
+  - phase: 1
+    name: "Analysis (Optional)"
     optional: true
     note: "User-selected during workflow-init"
     workflows:
       - id: "brainstorm-project"
+        exec: "{project-root}/_bmad/core/workflows/brainstorming/workflow.md"
         optional: true
         agent: "analyst"
-        command: "brainstorm-project"
+        command: "/bmad:bmm:workflows:brainstorming"
         included_by: "user_choice"
         note: "Uses core brainstorming workflow with project context template"
 
       - id: "research"
+        exec: "{project-root}/_bmad/bmm/workflows/1-analysis/research/workflow.md"
         optional: true
         agent: "analyst"
-        command: "research"
+        command: "/bmad:bmm:workflows:research"
         included_by: "user_choice"
         note: "Can have multiple research workflows"
 
       - id: "product-brief"
+        exec: "{project-root}/_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md"
         optional: true
         agent: "analyst"
-        command: "product-brief"
+        command: "/bmad:bmm:workflows:create-product-brief"
         included_by: "user_choice"
         note: "Recommended for greenfield Method projects"
 
-  - phase: 1
+  - phase: 2
     name: "Planning"
     required: true
     workflows:
       - id: "prd"
+        exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/workflow.md"
         required: true
         agent: "pm"
-        command: "prd"
+        command: "/bmad:bmm:workflows:create-prd"
         output: "Product Requirements Document with FRs and NFRs"
 
       - id: "create-ux-design"
         conditional: "if_has_ui"
+        exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md"
         agent: "ux-designer"
-        command: "create-ux-design"
+        command: "/bmad:bmm:workflows:create-ux-design"
         note: "Determined after PRD - user/agent decides if needed"
 
-  - phase: 2
+  - phase: 3
     name: "Solutioning"
     required: true
     workflows:
       - id: "create-architecture"
         required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md"
         agent: "architect"
-        command: "create-architecture"
+        command: "/bmad:bmm:workflows:create-architecture"
         output: "System architecture document"
         note: "Complete system design for greenfield projects"
 
       - id: "create-epics-and-stories"
         required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md"
         agent: "pm"
-        command: "create-epics-and-stories"
+        command: "/bmad:bmm:workflows: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
+        optional: true
+        workflow: "{project-root}/_bmad/bmm/workflows/testarch/test-design/workflow.yaml"
         agent: "tea"
-        command: "test-design"
+        command: "/bmad:bmm:workflows: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
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md"
         agent: "architect"
-        command: "implementation-readiness"
+        command: "/bmad:bmm:workflows:implementation-readiness"
         note: "Validates PRD + Architecture + Epics + UX (optional)"
 
-  - phase: 3
+  - phase: 4
     name: "Implementation"
     required: true
     workflows:
       - id: "sprint-planning"
         required: true
+        workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
         agent: "sm"
-        command: "sprint-planning"
+        command: "/bmad:bmm:workflows:sprint-planning"
         note: "Creates sprint plan - subsequent work tracked there"

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

@@ -15,15 +15,6 @@ agent:
     principles: Psychological safety unlocks breakthroughs. Wild ideas today become innovations tomorrow. Humor and play are serious innovation tools.
 
   menu:
-    - trigger: brainstorm
+    - trigger: BS or fuzzy match on brainstorm
       workflow: "{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml"
-      description: Guide me through Brainstorming any topic
-
-    - trigger: party-mode
-      exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
-      description: Consult with other expert agents from the party
-
-    - trigger: advanced-elicitation
-      exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
-      description: Advanced elicitation techniques to challenge the LLM to get better results
-      web-only: true
+      description: "[BS] Guide me through Brainstorming any topic"

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

@@ -15,15 +15,6 @@ agent:
     principles: Every problem is a system revealing weaknesses. Hunt for root causes relentlessly. The right question beats a fast answer.
 
   menu:
-    - trigger: solve
+    - trigger: PS or fuzzy match on problem-solving
       workflow: "{project-root}/_bmad/cis/workflows/problem-solving/workflow.yaml"
-      description: Apply systematic problem-solving methodologies
-
-    - trigger: party-mode
-      exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
-      description: Consult with other expert agents from the party
-
-    - trigger: advanced-elicitation
-      exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
-      description: Advanced elicitation techniques to challenge the LLM to get better results
-      web-only: true
+      description: "[PS] Apply systematic problem-solving methodologies"

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

@@ -15,15 +15,6 @@ agent:
     principles: Design is about THEM not us. Validate through real human interaction. Failure is feedback. Design WITH users not FOR them.
 
   menu:
-    - trigger: design
+    - trigger: DT or fuzzy match on design-thinking
       workflow: "{project-root}/_bmad/cis/workflows/design-thinking/workflow.yaml"
-      description: Guide human-centered design process
-
-    - trigger: party-mode
-      exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
-      description: Consult with other expert agents from the party
-
-    - trigger: advanced-elicitation
-      exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
-      description: Advanced elicitation techniques to challenge the LLM to get better results
-      web-only: true
+      description: "[DT] Guide human-centered design process"

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

@@ -15,15 +15,6 @@ agent:
     principles: Markets reward genuine new value. Innovation without business model thinking is theater. Incremental thinking means obsolete.
 
   menu:
-    - trigger: innovate
+    - trigger: IS or fuzzy match on innovation-strategy
       workflow: "{project-root}/_bmad/cis/workflows/innovation-strategy/workflow.yaml"
-      description: Identify disruption opportunities and business model innovation
-
-    - trigger: party-mode
-      exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
-      description: Consult with other expert agents from the party
-
-    - trigger: advanced-elicitation
-      exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
-      description: Advanced elicitation techniques to challenge the LLM to get better results
-      web-only: true
+      description: "[IS] Identify disruption opportunities and business model innovation"

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

@@ -23,39 +23,30 @@ agent:
       - Story structure applies everywhere - hook, build tension, deliver payoff
 
   menu:
-    - trigger: slide-deck
+    - trigger: SD or fuzzy match on slide-deck
       workflow: "todo"
-      description: Create multi-slide presentation with professional layouts and visual hierarchy
+      description: "[SD] Create multi-slide presentation with professional layouts and visual hierarchy"
 
-    - trigger: explainer
+    - trigger: EX or fuzzy match on youtube-explainer
       workflow: "todo"
-      description: Design YouTube/video explainer layout with visual script and engagement hooks
+      description: "[EX] Design YouTube/video explainer layout with visual script and engagement hooks"
 
-    - trigger: pitch-deck
+    - trigger: PD or fuzzy match on pitch-deck
       workflow: "todo"
-      description: Craft investor pitch presentation with data visualization and narrative arc
+      description: "[PD] Craft investor pitch presentation with data visualization and narrative arc"
 
-    - trigger: talk
+    - trigger: CT or fuzzy match on conference-talk
       workflow: "todo"
-      description: Build conference or workshop presentation materials with speaker notes
+      description: "[CT] Build conference talk or workshop presentation materials with speaker notes"
 
-    - trigger: infographic
+    - trigger: IN or fuzzy match on infographic
       workflow: "todo"
-      description: Design creative information visualization with visual storytelling
+      description: "[IN] Design creative information visualization with visual storytelling"
 
-    - trigger: visual-metaphor
+    - trigger: VM or fuzzy match on visual-metaphor
       workflow: "todo"
-      description: Create conceptual illustrations (Rube Goldberg machines, journey maps, creative processes)
+      description: "[VM] Create conceptual illustrations (Rube Goldberg machines, journey maps, creative processes)"
 
-    - trigger: concept-visual
+    - trigger: CV or fuzzy match on concept-visual
       workflow: "todo"
-      description: Generate single expressive image that explains ideas creatively and memorably
-
-    - trigger: party-mode
-      exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
-      description: Consult with other expert agents from the party
-
-    - trigger: advanced-elicitation
-      exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
-      description: Advanced elicitation techniques to challenge the LLM to get better results
-      web-only: true
+      description: "[CV] Generate single expressive image that explains ideas creatively and memorably"

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

@@ -20,15 +20,6 @@ agent:
     - "Load COMPLETE file {project-root}/_bmad/_memory/storyteller-sidecar/stories-told.md and review the history of stories created for this user"
 
   menu:
-    - trigger: story
+    - trigger: ST or fuzzy match on story
       exec: "{project-root}/_bmad/cis/workflows/storytelling/workflow.yaml"
-      description: Craft compelling narrative using proven frameworks
-
-    - trigger: party-mode
-      exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
-      description: Consult with other expert agents from the party
-
-    - trigger: advanced-elicitation
-      exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
-      description: Advanced elicitation techniques to challenge the LLM to get better results
-      web-only: true
+      description: "[ST] Craft compelling narrative using proven frameworks"

package/test/fixtures/agent-schema/invalid/menu-triggers/compound-mismatched-kebab.agent.yaml

@@ -1,14 +1,14 @@
-# Test: Compound trigger with mismatched kebab portions
+# Test: Compound trigger with old format (no longer supported)
 # Expected: FAIL
 # Error code: custom
 # Error path: agent.menu[0].trigger
-# Error message: agent.menu[].trigger compound format error: kebab-case trigger mismatch: "tech-spec" vs "other-thing"
+# Error message: agent.menu[].trigger compound format error: invalid compound trigger format
 
 agent:
   metadata:
     id: compound-mismatched-kebab
-    name: Mismatched Kebab
-    title: Mismatched Kebab Test
+    name: Old Format
+    title: Old Format Test
     icon: 🧪
 
   persona:
@@ -19,6 +19,6 @@ agent:
       - Test principle
 
   menu:
-    - trigger: TS or tech-spec or fuzzy match on other-thing
-      description: Kebab portions do not match
+    - trigger: TS or tech-spec or fuzzy match on tech-spec
+      description: Old format with middle kebab-case (no longer supported)
       action: test

package/test/fixtures/agent-schema/valid/menu-triggers/compound-triggers.agent.yaml

@@ -16,15 +16,15 @@ agent:
       - Test compound format
 
   menu:
-    - trigger: TS or tech-spec or fuzzy match on tech-spec
-      description: Two-word compound trigger
+    - trigger: TS or fuzzy match on tech-spec
+      description: "[TS] Two-word compound trigger"
       action: tech_spec
-    - trigger: DS or dev-story or fuzzy match on dev-story
-      description: Another two-word compound trigger
+    - trigger: DS or fuzzy match on dev-story
+      description: "[DS] Another two-word compound trigger"
       action: dev_story
-    - trigger: WI or workflow-init-process or fuzzy match on workflow-init-process
-      description: Three-word compound trigger (uses first 2 words for shortcut)
+    - trigger: WI or fuzzy match on workflow-init-process
+      description: "[WI] Three-word compound trigger (uses first 2 words for shortcut)"
       action: workflow_init
-    - trigger: H or help or fuzzy match on help
-      description: Single-word compound trigger (1-letter shortcut)
+    - trigger: H or fuzzy match on help
+      description: "[H] Single-word compound trigger (1-letter shortcut)"
       action: help

package/test/fixtures/agent-schema/{invalid → valid}/metadata/core-agent-with-module.agent.yaml

@@ -1,16 +1,13 @@
-# Test: Core agent with unexpected module field
-# Expected: FAIL
-# Error code: custom
-# Error path: agent.metadata.module
-# Error message: core agents must not include agent.metadata.module
-# Path context: src/core/agents/core-agent-with-module.agent.yaml
+# Test: Core agent can have module field
+# Expected: PASS
+# Note: Core agents can now include module field if needed
 
 agent:
   metadata:
     id: core-with-module
     name: Core With Module
     title: Core Agent
-    icon: ❌
+    icon: ✅
     module: bmm
 
   persona:

package/test/fixtures/agent-schema/valid/metadata/module-agent-missing-module.agent.yaml

@@ -0,0 +1,22 @@
+# Test: Module agent can omit module field
+# Expected: PASS
+# Note: Module field is optional
+
+agent:
+  metadata:
+    id: bmm-missing-module
+    name: No Module
+    title: Optional Module
+    icon: ✅
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help