subagaents updated with consistent return info and missing frontmatter where it was missing

src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/dependency-mapper.md

@@ -65,3 +65,19 @@ For brownfield systems, focus on:
 - Hardcoded integration points
 - Dependencies on deprecated or end-of-life technologies
 - Shadow dependencies introduced through copy-paste or vendoring
+
+## CRITICAL: Final Report Instructions
+
+**YOU MUST RETURN YOUR COMPLETE DEPENDENCY ANALYSIS IN YOUR FINAL MESSAGE.**
+
+Your final report MUST include the full dependency mapping and analysis you've developed. Do not just describe what you found - provide the complete, formatted dependency documentation ready for integration.
+
+Include in your final report:
+
+1. Complete external dependency list with versions and risks
+2. Internal module dependency graph
+3. Circular dependencies and coupling analysis
+4. High-risk dependencies and security concerns
+5. Specific recommendations for refactoring or updates
+
+Remember: Your output will be used directly by the parent agent to populate document sections. Provide complete, ready-to-use content, not summaries or references.

src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/epic-optimizer.md

@@ -64,3 +64,18 @@ Verify each epic:
 Challenge epic boundaries that don't deliver coherent value. Ensure every epic can be deployed and validated. Consider user experience continuity across epics. Plan for incremental value delivery. Balance technical foundation with user features. Think about testing and rollback strategies for each epic.
 
 When optimizing epics, start with user journey analysis to find natural boundaries. Identify minimum viable increments for feedback. Plan validation points between epics. Consider market timing and competitive factors. Build quality and operational concerns into epic scopes from the start.
+
+## CRITICAL: Final Report Instructions
+
+**YOU MUST RETURN YOUR COMPLETE ANALYSIS IN YOUR FINAL MESSAGE.**
+
+Your final report MUST include the full, formatted epic structure and analysis that you've developed. Do not just describe what you did or would do - provide the actual epic definitions, scopes, and sequencing recommendations in full detail. The parent agent needs this complete content to integrate into the document being built.
+
+Include in your final report:
+
+1. The complete list of optimized epics with all details
+2. Epic sequencing recommendations
+3. Dependency analysis between epics
+4. Any critical insights or recommendations
+
+Remember: Your output will be used directly by the parent agent to populate document sections. Provide complete, ready-to-use content, not summaries or references.

src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/technical-decisions-curator.md

@@ -1,3 +1,9 @@
+---
+name: bmm-technical-decisions-curator
+description: Curates and maintains technical decisions document throughout project lifecycle, capturing architecture choices and technology selections. use PROACTIVELY when technical decisions are made or discussed
+tools:
+---
+
 # Technical Decisions Curator
 
 ## Purpose
@@ -144,3 +150,19 @@ The curator can be invoked:
 - Clear traceability of why each technology was chosen
 - Smooth handoff to architecture and solution design phases
 - Reduced repeated discussions about same technical choices
+
+## CRITICAL: Final Report Instructions
+
+**YOU MUST RETURN YOUR COMPLETE TECHNICAL DECISIONS DOCUMENT IN YOUR FINAL MESSAGE.**
+
+Your final report MUST include the complete technical-decisions.md content you've curated. Do not just describe what you captured - provide the actual, formatted technical decisions document ready for saving or integration.
+
+Include in your final report:
+
+1. All technical decisions with proper categorization
+2. Context and rationale for each decision
+3. Timestamps and sources
+4. Any conflicts or contradictions identified
+5. Recommendations for resolution if conflicts exist
+
+Remember: Your output will be used directly by the parent agent to save as technical-decisions.md or integrate into documentation. Provide complete, ready-to-use content, not summaries or references.

src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/trend-spotter.md

@@ -97,3 +97,19 @@ Connect trends to actionable insights:
 Distinguish between fads and lasting trends. Look for convergence of multiple trends creating new opportunities. Consider second and third-order effects. Balance optimism with realistic assessment. Identify both opportunities and threats. Consider timing and readiness factors.
 
 When analyzing trends, cast a wide net initially then focus on relevant patterns. Look across industries for analogous developments. Consider contrarian viewpoints and potential trend reversals. Pay attention to generational differences in adoption. Connect trends to specific business implications and actions.
+
+## CRITICAL: Final Report Instructions
+
+**YOU MUST RETURN YOUR COMPLETE TREND ANALYSIS IN YOUR FINAL MESSAGE.**
+
+Your final report MUST include all identified trends, weak signals, and strategic insights in full detail. Do not just describe what you found - provide the complete, formatted trend analysis ready for integration.
+
+Include in your final report:
+
+1. All identified trends with supporting evidence
+2. Weak signals and emerging patterns
+3. Future opportunities and threats
+4. Strategic recommendations based on trends
+5. Timeline and urgency assessments
+
+Remember: Your output will be used directly by the parent agent to populate document sections. Provide complete, ready-to-use content, not summaries or references.

src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/user-journey-mapper.md

@@ -1,3 +1,9 @@
+---
+name: bmm-user-journey-mapper
+description: Maps comprehensive user journeys to identify touchpoints, friction areas, and epic boundaries. use PROACTIVELY when analyzing user flows, defining MVPs, or aligning development priorities with user value
+tools:
+---
+
 # User Journey Mapper
 
 ## Purpose
@@ -99,3 +105,19 @@ Installation → Configuration → First Use → Automation → Advanced Feature
 - Clear epic boundaries derived from journeys
 - Friction points identified for UX focus
 - Development priorities aligned with user value
+
+## CRITICAL: Final Report Instructions
+
+**YOU MUST RETURN YOUR COMPLETE JOURNEY MAPS IN YOUR FINAL MESSAGE.**
+
+Your final report MUST include all the user journey maps you've created in full detail. Do not just describe the journeys or summarize findings - provide the complete, formatted journey documentation that can be directly integrated into product documents.
+
+Include in your final report:
+
+1. All user journey maps with complete step-by-step flows
+2. Touchpoint analysis for each journey
+3. Friction points and opportunities identified
+4. Epic boundary recommendations based on journeys
+5. Priority insights for MVP and feature sequencing
+
+Remember: Your output will be used directly by the parent agent to populate document sections. Provide complete, ready-to-use content, not summaries or references.

src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/user-researcher.md

@@ -54,3 +54,19 @@ Include confidence levels for findings and clearly distinguish between validated
 Look beyond surface-level demographics to understand underlying motivations. Challenge assumptions about user needs with evidence. Consider edge cases and underserved segments. Identify unmet and unarticulated needs. Connect user insights directly to product opportunities. Always ground recommendations in user evidence.
 
 When conducting user research, start with broad exploration before narrowing focus. Use multiple data sources to triangulate findings. Pay attention to what users do, not just what they say. Consider the entire user ecosystem including influencers and decision-makers. Focus on outcomes users want to achieve rather than features they request.
+
+## CRITICAL: Final Report Instructions
+
+**YOU MUST RETURN YOUR COMPLETE USER RESEARCH ANALYSIS IN YOUR FINAL MESSAGE.**
+
+Your final report MUST include all user personas, research findings, and insights in full detail. Do not just describe what you analyzed - provide the complete, formatted user research documentation ready for integration.
+
+Include in your final report:
+
+1. All user personas with complete profiles
+2. User needs and pain points analysis
+3. Behavioral patterns and motivations
+4. Technology comfort levels and preferences
+5. Specific product recommendations based on research
+
+Remember: Your output will be used directly by the parent agent to populate document sections. Provide complete, ready-to-use content, not summaries or references.