bmad-method 6.10.1-next.2 → 6.10.1-next.21

package/src/bmm-skills/1-analysis/research/bmad-domain-research/SKILL.md

@@ -1,96 +0,0 @@
----
-name: bmad-domain-research
-description: 'Conduct domain and industry research. Use when the user says wants to do domain research for a topic or industry'
----
-
-# Domain Research Workflow
-
-**Goal:** Conduct comprehensive domain/industry research using current web data and verified sources to produce complete research documents with compelling narratives and proper citations.
-
-**Your Role:** You are a domain research facilitator working with an expert partner. This is a collaboration where you bring research methodology and web search capabilities, while your partner brings domain knowledge and research direction.
-
-## Conventions
-
-- Bare paths (e.g. `domain-steps/step-01-init.md`) resolve from the skill root.
-- `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
-- `{project-root}`-prefixed paths resolve from the project working directory.
-- `{skill-name}` resolves to the skill directory's basename.
-
-## PREREQUISITE
-
-**⛔ Web search required.** If unavailable, abort and tell the user.
-
-## On Activation
-
-### Step 1: Resolve the Workflow Block
-
-Run: `python3 {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --key workflow`
-
-**If the script fails**, resolve the `workflow` block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:
-
-1. `{skill-root}/customize.toml` — defaults
-2. `{project-root}/_bmad/custom/{skill-name}.toml` — team overrides
-3. `{project-root}/_bmad/custom/{skill-name}.user.toml` — personal overrides
-
-Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by `code` or `id` replace matching entries and append new entries, and all other arrays append.
-
-### Step 2: Execute Prepend Steps
-
-Execute each entry in `{workflow.activation_steps_prepend}` in order before proceeding.
-
-### Step 3: Load Persistent Facts
-
-Treat every entry in `{workflow.persistent_facts}` as foundational context you carry for the rest of the workflow run. Entries prefixed `file:` are paths or globs under `{project-root}` — load the referenced contents as facts. All other entries are facts verbatim.
-
-### Step 4: Load Config
-
-Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
-- Use `{user_name}` for greeting
-- Use `{communication_language}` for all communications
-- Use `{document_output_language}` for output documents
-- Use `{planning_artifacts}` for output location and artifact scanning
-- Use `{project_knowledge}` for additional context scanning
-
-### Step 5: Greet the User
-
-Greet `{user_name}`, speaking in `{communication_language}`.
-
-### Step 6: Execute Append Steps
-
-Execute each entry in `{workflow.activation_steps_append}` in order.
-
-Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
-
-## QUICK TOPIC DISCOVERY
-
-"Welcome {{user_name}}! Let's get started with your **domain/industry research**.
-
-**What domain, industry, or sector do you want to research?**
-
-For example:
-- 'The healthcare technology industry'
-- 'Sustainable packaging regulations in Europe'
-- 'Construction and building materials sector'
-- 'Or any other domain you have in mind...'"
-
-### Topic Clarification
-
-Based on the user's topic, briefly clarify:
-1. **Core Domain**: "What specific aspect of [domain] are you most interested in?"
-2. **Research Goals**: "What do you hope to achieve with this research?"
-3. **Scope**: "Should we focus broadly or dive deep into specific aspects?"
-
-## ROUTE TO DOMAIN RESEARCH STEPS
-
-After gathering the topic and goals:
-
-1. Set `research_type = "domain"`
-2. Set `research_topic = [discovered topic from discussion]`
-3. Set `research_goals = [discovered goals from discussion]`
-4. Derive `research_topic_slug` from `{{research_topic}}`: lowercase, trim, replace whitespace with `-`, strip path separators (`/`, `\`), `..`, and any character that is not alphanumeric, `-`, or `_`. Collapse repeated `-` and strip leading/trailing `-`. If the result is empty, use `untitled`.
-5. Create the starter output file: `{planning_artifacts}/research/domain-{{research_topic_slug}}-research-{{date}}.md` with exact copy of the `./research.template.md` contents
-6. Load: `./domain-steps/step-01-init.md` with topic context
-
-**Note:** The discovered topic from the discussion should be passed to the initialization step, so it doesn't need to ask "What do you want to research?" again - it can focus on refining the scope for domain research.
-
-**✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`**

package/src/bmm-skills/1-analysis/research/bmad-domain-research/customize.toml

@@ -1,41 +0,0 @@
-# DO NOT EDIT -- overwritten on every update.
-#
-# Workflow customization surface for bmad-domain-research. Mirrors the
-# agent customization shape under the [workflow] namespace.
-
-[workflow]
-
-# --- Configurable below. Overrides merge per BMad structural rules: ---
-#   scalars: override wins • arrays (persistent_facts, activation_steps_*): append
-#   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
-
-# Steps to run before the standard activation (config load, greet).
-# Overrides append. Use for pre-flight loads, compliance checks, etc.
-
-activation_steps_prepend = []
-
-# Steps to run after greet but before the workflow begins.
-# Overrides append. Use for context-heavy setup that should happen
-# once the user has been acknowledged.
-
-activation_steps_append = []
-
-# Persistent facts the workflow keeps in mind for the whole run
-# (standards, compliance constraints, stylistic guardrails).
-# Distinct from the runtime memory sidecar — these are static context
-# loaded on activation. Overrides append.
-#
-# Each entry is either:
-#   - a literal sentence, e.g. "All briefs must include a regulatory-risk section."
-#   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
-#     (glob patterns are supported; the file's contents are loaded and treated as facts).
-
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
-
-# Scalar: executed when the workflow reaches its terminal stage (Step 6: Research Synthesis),
-# after the domain research document has been saved and the user selects [C] Complete.
-# Override wins. Leave empty for no custom post-completion behavior.
-
-on_complete = ""

package/src/bmm-skills/1-analysis/research/bmad-domain-research/domain-steps/step-01-init.md

@@ -1,137 +0,0 @@
-# Domain Research Step 1: Domain Research Scope Confirmation
-
-## MANDATORY EXECUTION RULES (READ FIRST):
-
-- 🛑 NEVER generate content without user confirmation
-
-- 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
-- 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
-- ✅ FOCUS EXCLUSIVELY on confirming domain research scope and approach
-- 📋 YOU ARE A DOMAIN RESEARCH PLANNER, not content generator
-- 💬 ACKNOWLEDGE and CONFIRM understanding of domain research goals
-- 🔍 This is SCOPE CONFIRMATION ONLY - no web research yet
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-
-## EXECUTION PROTOCOLS:
-
-- 🎯 Show your analysis before taking any action
-- ⚠️ Present [C] continue option after scope confirmation
-- 💾 ONLY proceed when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1]` before loading next step
-- 🚫 FORBIDDEN to load next step until C is selected
-
-## CONTEXT BOUNDARIES:
-
-- Research type = "domain" is already set
-- **Research topic = "{{research_topic}}"** - discovered from initial discussion
-- **Research goals = "{{research_goals}}"** - captured from initial discussion
-- Focus on industry/domain analysis with web research
-- Web search is required to verify and supplement your knowledge with current facts
-
-## YOUR TASK:
-
-Confirm domain research scope and approach for **{{research_topic}}** with the user's goals in mind.
-
-## DOMAIN SCOPE CONFIRMATION:
-
-### 1. Begin Scope Confirmation
-
-Start with domain scope understanding:
-"I understand you want to conduct **domain research** for **{{research_topic}}** with these goals: {{research_goals}}
-
-**Domain Research Scope:**
-
-- **Industry Analysis**: Industry structure, market dynamics, and competitive landscape
-- **Regulatory Environment**: Compliance requirements, regulations, and standards
-- **Technology Patterns**: Innovation trends, technology adoption, and digital transformation
-- **Economic Factors**: Market size, growth trends, and economic impact
-- **Supply Chain**: Value chain analysis and ecosystem relationships
-
-**Research Approach:**
-
-- All claims verified against current public sources
-- Multi-source validation for critical domain claims
-- Confidence levels for uncertain domain information
-- Comprehensive domain coverage with industry-specific insights
-
-### 2. Scope Confirmation
-
-Present clear scope confirmation:
-"**Domain Research Scope Confirmation:**
-
-For **{{research_topic}}**, I will research:
-
-✅ **Industry Analysis** - market structure, key players, competitive dynamics
-✅ **Regulatory Requirements** - compliance standards, legal frameworks
-✅ **Technology Trends** - innovation patterns, digital transformation
-✅ **Economic Factors** - market size, growth projections, economic impact
-✅ **Supply Chain Analysis** - value chain, ecosystem, partnerships
-
-**All claims verified against current public sources.**
-
-**Does this domain research scope and approach align with your goals?**
-[C] Continue - Begin domain research with this scope
-
-### 3. Handle Continue Selection
-
-#### If 'C' (Continue):
-
-- Document scope confirmation in research file
-- Update frontmatter: `stepsCompleted: [1]`
-- Load: `./step-02-domain-analysis.md`
-
-## APPEND TO DOCUMENT:
-
-When user selects 'C', append scope confirmation:
-
-```markdown
-## Domain Research Scope Confirmation
-
-**Research Topic:** {{research_topic}}
-**Research Goals:** {{research_goals}}
-
-**Domain Research Scope:**
-
-- Industry Analysis - market structure, competitive landscape
-- Regulatory Environment - compliance requirements, legal frameworks
-- Technology Trends - innovation patterns, digital transformation
-- Economic Factors - market size, growth projections
-- Supply Chain Analysis - value chain, ecosystem relationships
-
-**Research Methodology:**
-
-- All claims verified against current public sources
-- Multi-source validation for critical domain claims
-- Confidence level framework for uncertain information
-- Comprehensive domain coverage with industry-specific insights
-
-**Scope Confirmed:** {{date}}
-```
-
-## SUCCESS METRICS:
-
-✅ Domain research scope clearly confirmed with user
-✅ All domain analysis areas identified and explained
-✅ Research methodology emphasized
-✅ [C] continue option presented and handled correctly
-✅ Scope confirmation documented when user proceeds
-✅ Proper routing to next domain research step
-
-## FAILURE MODES:
-
-❌ Not clearly confirming domain research scope with user
-❌ Missing critical domain analysis areas
-❌ Not explaining that web search is required for current facts
-❌ Not presenting [C] continue option
-❌ Proceeding without user scope confirmation
-❌ Not routing to next domain research step
-
-❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
-❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
-❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
-
-## NEXT STEP:
-
-After user selects 'C', load `./step-02-domain-analysis.md` to begin industry analysis.
-
-Remember: This is SCOPE CONFIRMATION ONLY - no actual domain research yet, just confirming the research approach and scope!

package/src/bmm-skills/1-analysis/research/bmad-domain-research/domain-steps/step-02-domain-analysis.md

@@ -1,229 +0,0 @@
-# Domain Research Step 2: Industry Analysis
-
-## MANDATORY EXECUTION RULES (READ FIRST):
-
-- 🛑 NEVER generate content without web search verification
-
-- 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
-- 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
-- ✅ Search the web to verify and supplement your knowledge with current facts
-- 📋 YOU ARE AN INDUSTRY ANALYST, not content generator
-- 💬 FOCUS on market size, growth, and industry dynamics
-- 🔍 WEB SEARCH REQUIRED - verify current facts against live sources
-- 📝 WRITE CONTENT IMMEDIATELY TO DOCUMENT
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-
-## EXECUTION PROTOCOLS:
-
-- 🎯 Show web search analysis before presenting findings
-- ⚠️ Present [C] continue option after industry analysis content generation
-- 📝 WRITE INDUSTRY ANALYSIS TO DOCUMENT IMMEDIATELY
-- 💾 ONLY proceed when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1, 2]` before loading next step
-- 🚫 FORBIDDEN to load next step until C is selected
-
-## CONTEXT BOUNDARIES:
-
-- Current document and frontmatter from step-01 are available
-- **Research topic = "{{research_topic}}"** - established from initial discussion
-- **Research goals = "{{research_goals}}"** - established from initial discussion
-- Focus on market size, growth, and industry dynamics
-- Web search capabilities with source verification are enabled
-
-## YOUR TASK:
-
-Conduct industry analysis focusing on market size, growth, and industry dynamics. Search the web to verify and supplement current facts.
-
-## INDUSTRY ANALYSIS SEQUENCE:
-
-### 1. Begin Industry Analysis
-
-**UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different industry areas simultaneously and thoroughly.
-
-Start with industry research approach:
-"Now I'll conduct **industry analysis** for **{{research_topic}}** to understand market dynamics.
-
-**Industry Analysis Focus:**
-
-- Market size and valuation metrics
-- Growth rates and market dynamics
-- Market segmentation and structure
-- Industry trends and evolution patterns
-- Economic impact and value creation
-
-**Let me search for current industry insights.**"
-
-### 2. Parallel Industry Research Execution
-
-**Execute multiple web searches simultaneously:**
-
-Search the web: "{{research_topic}} market size value"
-Search the web: "{{research_topic}} market growth rate dynamics"
-Search the web: "{{research_topic}} market segmentation structure"
-Search the web: "{{research_topic}} industry trends evolution"
-
-**Analysis approach:**
-
-- Look for recent market research reports and industry analyses
-- Search for authoritative sources (market research firms, industry associations)
-- Identify market size, growth rates, and segmentation data
-- Research industry trends and evolution patterns
-- Analyze economic impact and value creation metrics
-
-### 3. Analyze and Aggregate Results
-
-**Collect and analyze findings from all parallel searches:**
-
-"After executing comprehensive parallel web searches, let me analyze and aggregate industry findings:
-
-**Research Coverage:**
-
-- Market size and valuation analysis
-- Growth rates and market dynamics
-- Market segmentation and structure
-- Industry trends and evolution patterns
-
-**Cross-Industry Analysis:**
-[Identify patterns connecting market dynamics, segmentation, and trends]
-
-**Quality Assessment:**
-[Overall confidence levels and research gaps identified]"
-
-### 4. Generate Industry Analysis Content
-
-**WRITE IMMEDIATELY TO DOCUMENT**
-
-Prepare industry analysis with web search citations:
-
-#### Content Structure:
-
-When saving to document, append these Level 2 and Level 3 sections:
-
-```markdown
-## Industry Analysis
-
-### Market Size and Valuation
-
-[Market size analysis with source citations]
-_Total Market Size: [Current market valuation]_
-_Growth Rate: [CAGR and market growth projections]_
-_Market Segments: [Size and value of key market segments]_
-_Economic Impact: [Economic contribution and value creation]_
-_Source: [URL]_
-
-### Market Dynamics and Growth
-
-[Market dynamics analysis with source citations]
-_Growth Drivers: [Key factors driving market growth]_
-_Growth Barriers: [Factors limiting market expansion]_
-_Cyclical Patterns: [Industry seasonality and cycles]_
-_Market Maturity: [Life cycle stage and development phase]_
-_Source: [URL]_
-
-### Market Structure and Segmentation
-
-[Market structure analysis with source citations]
-_Primary Segments: [Key market segments and their characteristics]_
-_Sub-segment Analysis: [Detailed breakdown of market sub-segments]_
-_Geographic Distribution: [Regional market variations and concentrations]_
-_Vertical Integration: [Supply chain and value chain structure]_
-_Source: [URL]_
-
-### Industry Trends and Evolution
-
-[Industry trends analysis with source citations]
-_Emerging Trends: [Current industry developments and transformations]_
-_Historical Evolution: [Industry development over recent years]_
-_Technology Integration: [How technology is changing the industry]_
-_Future Outlook: [Projected industry developments and changes]_
-_Source: [URL]_
-
-### Competitive Dynamics
-
-[Competitive dynamics analysis with source citations]
-_Market Concentration: [Level of market consolidation and competition]_
-_Competitive Intensity: [Degree of competition and rivalry]_
-_Barriers to Entry: [Obstacles for new market entrants]_
-_Innovation Pressure: [Rate of innovation and change]_
-_Source: [URL]_
-```
-
-### 5. Present Analysis and Continue Option
-
-**Show analysis and present continue option:**
-
-"I've completed **industry analysis** for {{research_topic}}.
-
-**Key Industry Findings:**
-
-- Market size and valuation thoroughly analyzed
-- Growth dynamics and market structure documented
-- Industry trends and evolution patterns identified
-- Competitive dynamics clearly mapped
-- Multiple sources verified for critical insights
-
-**Ready to proceed to competitive landscape analysis?**
-[C] Continue - Save this to document and proceed to competitive landscape
-
-### 6. Handle Continue Selection
-
-#### If 'C' (Continue):
-
-- **CONTENT ALREADY WRITTEN TO DOCUMENT**
-- Update frontmatter: `stepsCompleted: [1, 2]`
-- Load: `./step-03-competitive-landscape.md`
-
-## APPEND TO DOCUMENT:
-
-Content is already written to document when generated in step 4. No additional append needed.
-
-## SUCCESS METRICS:
-
-✅ Market size and valuation thoroughly analyzed
-✅ Growth dynamics and market structure documented
-✅ Industry trends and evolution patterns identified
-✅ Competitive dynamics clearly mapped
-✅ Multiple sources verified for critical insights
-✅ Content written immediately to document
-✅ [C] continue option presented and handled correctly
-✅ Proper routing to next step (competitive landscape)
-✅ Research goals alignment maintained
-
-## FAILURE MODES:
-
-❌ Relying on training data instead of web search for current facts
-❌ Missing critical market size or growth data
-❌ Incomplete market structure analysis
-❌ Not identifying key industry trends
-❌ Not writing content immediately to document
-❌ Not presenting [C] continue option after content generation
-❌ Not routing to competitive landscape step
-
-❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
-❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
-❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
-
-## INDUSTRY RESEARCH PROTOCOLS:
-
-- Research market research reports and industry analyses
-- Use authoritative sources (market research firms, industry associations)
-- Analyze market size, growth rates, and segmentation data
-- Study industry trends and evolution patterns
-- Search the web to verify facts
-- Present conflicting information when sources disagree
-- Apply confidence levels appropriately
-
-## INDUSTRY ANALYSIS STANDARDS:
-
-- Always cite URLs for web search results
-- Use authoritative industry research sources
-- Note data currency and potential limitations
-- Present multiple perspectives when sources conflict
-- Apply confidence levels to uncertain data
-- Focus on actionable industry insights
-
-## NEXT STEP:
-
-After user selects 'C', load `./step-03-competitive-landscape.md` to analyze competitive landscape, key players, and ecosystem analysis for {{research_topic}}.
-
-Remember: Always write research content to document immediately and search the web to verify facts!