refactor: standardize formatting and improve readability across core documents (#211)

### CHANGES

- Add newlines and spacing for improved readability
- Standardize instructional text for consistency
- Renumber lists within tasks for better clarity
- Add language identifiers to various code blocks
- Update placeholder text for improved consistency
- Adjust descriptions and wording in multiple files
- Update VS Code settings and dictionary words

.bmad-core/templates/market-research-tmpl.md

@@ -9,13 +9,17 @@
 ## Research Objectives & Methodology
 
 ### Research Objectives
+
 {{List the primary objectives of this market research:
+
 - What decisions will this research inform?
 - What specific questions need to be answered?
 - What are the success criteria for this research?}}
 
 ### Research Methodology
+
 {{Describe the research approach:
+
 - Data sources used (primary/secondary)
 - Analysis frameworks applied
 - Data collection timeframe
@@ -24,7 +28,9 @@
 ## Market Overview
 
 ### Market Definition
+
 {{Define the market being analyzed:
+
 - Product/service category
 - Geographic scope
 - Customer segments included
@@ -33,17 +39,21 @@
 ### Market Size & Growth
 
 [[LLM: Guide through TAM, SAM, SOM calculations with clear assumptions. Use one or more approaches:
+
 - Top-down: Start with industry data, narrow down
 - Bottom-up: Build from customer/unit economics
 - Value theory: Based on value provided vs. alternatives]]
 
 #### Total Addressable Market (TAM)
+
 {{Calculate and explain the total market opportunity}}
 
 #### Serviceable Addressable Market (SAM)
+
 {{Define the portion of TAM you can realistically reach}}
 
 #### Serviceable Obtainable Market (SOM)
+
 {{Estimate the portion you can realistically capture}}
 
 ### Market Trends & Drivers
@@ -51,15 +61,19 @@
 [[LLM: Analyze key trends shaping the market using appropriate frameworks like PESTEL]]
 
 #### Key Market Trends
+
 {{List and explain 3-5 major trends:
+
 - Trend 1: Description and impact
 - Trend 2: Description and impact
 - etc.}}
 
 #### Growth Drivers
+
 {{Identify primary factors driving market growth}}
 
 #### Market Inhibitors
+
 {{Identify factors constraining market growth}}
 
 ## Customer Analysis
@@ -69,6 +83,7 @@
 [[LLM: For each segment, create detailed profiles including demographics/firmographics, psychographics, behaviors, needs, and willingness to pay]]
 
 #### Segment 1: {{Segment Name}}
+
 - **Description:** {{Brief overview}}
 - **Size:** {{Number of customers/market value}}
 - **Characteristics:** {{Key demographics/firmographics}}
@@ -83,12 +98,15 @@
 [[LLM: Uncover what customers are really trying to accomplish]]
 
 #### Functional Jobs
+
 {{List practical tasks and objectives customers need to complete}}
 
 #### Emotional Jobs
+
 {{Describe feelings and perceptions customers seek}}
 
 #### Social Jobs
+
 {{Explain how customers want to be perceived by others}}
 
 ### Customer Journey Mapping
@@ -96,6 +114,7 @@
 [[LLM: Map the end-to-end customer experience for primary segments]]
 
 {{For primary customer segment:
+
 1. **Awareness:** How they discover solutions
 2. **Consideration:** Evaluation criteria and process
 3. **Purchase:** Decision triggers and barriers
@@ -106,13 +125,17 @@
 ## Competitive Landscape
 
 ### Market Structure
+
 {{Describe the overall competitive environment:
+
 - Number of competitors
 - Market concentration
 - Competitive intensity}}
 
 ### Major Players Analysis
+
 {{For top 3-5 competitors:
+
 - Company name and brief description
 - Market share estimate
 - Key strengths and weaknesses
@@ -120,7 +143,9 @@
 - Pricing strategy}}
 
 ### Competitive Positioning
+
 {{Analyze how competitors are positioned:
+
 - Value propositions
 - Differentiation strategies
 - Market gaps and opportunities}}
@@ -132,22 +157,29 @@
 [[LLM: Analyze each force with specific evidence and implications]]
 
 #### Supplier Power: {{Low/Medium/High}}
+
 {{Analysis and implications}}
 
 #### Buyer Power: {{Low/Medium/High}}
+
 {{Analysis and implications}}
 
 #### Competitive Rivalry: {{Low/Medium/High}}
+
 {{Analysis and implications}}
 
 #### Threat of New Entry: {{Low/Medium/High}}
+
 {{Analysis and implications}}
 
 #### Threat of Substitutes: {{Low/Medium/High}}
+
 {{Analysis and implications}}
 
 ### Technology Adoption Lifecycle Stage
+
 {{Identify where the market is in the adoption curve:
+
 - Current stage and evidence
 - Implications for strategy
 - Expected progression timeline}}
@@ -159,6 +191,7 @@
 [[LLM: Identify specific opportunities based on the analysis]]
 
 #### Opportunity 1: {{Name}}
+
 - **Description:** {{What is the opportunity?}}
 - **Size/Potential:** {{Quantify if possible}}
 - **Requirements:** {{What's needed to capture it?}}
@@ -169,21 +202,27 @@
 ### Strategic Recommendations
 
 #### Go-to-Market Strategy
+
 {{Recommend approach for market entry/expansion:
+
 - Target segment prioritization
 - Positioning strategy
 - Channel strategy
 - Partnership opportunities}}
 
 #### Pricing Strategy
+
 {{Based on willingness to pay analysis and competitive landscape:
+
 - Recommended pricing model
 - Price points/ranges
 - Value metric
 - Competitive positioning}}
 
 #### Risk Mitigation
+
 {{Key risks and mitigation strategies:
+
 - Market risks
 - Competitive risks
 - Execution risks
@@ -192,20 +231,23 @@
 ## Appendices
 
 ### A. Data Sources
+
 {{List all sources used in the research}}
 
 ### B. Detailed Calculations
+
 {{Include any complex calculations or models}}
 
 ### C. Additional Analysis
+
 {{Any supplementary analysis not included in main body}}
 
 ---
 
 [[LLM: After completing the document, offer advanced elicitation with these custom options for market research:
 
-**Market Research Elicitation Actions**
-0. Expand market sizing calculations with sensitivity analysis
+**Market Research Elicitation Actions** 0. Expand market sizing calculations with sensitivity analysis
+
 1. Deep dive into a specific customer segment
 2. Analyze an emerging market trend in detail
 3. Compare this market to an analogous market
@@ -216,4 +258,4 @@
 8. If only we had considered [X market factor]...
 9. Proceed to next section
 
-These replace the standard elicitation options when working on market research documents.]]
+These replace the standard elicitation options when working on market research documents.]]