Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
bmad-code-org avatar

Bmad Technical Research

  • 324 installs
  • 51.5k repo stars
  • Updated August 5, 2026
  • bmad-code-org/bmad-method

bmad-technical-research is a BMad Method skill that produces cited technical research reports for developers who must compare libraries, architectures, and integration options before choosing a stack.

About

bmad-technical-research is a native BMad Method analysis skill that guides agents through structured technical investigation before architecture or PRD work. The workflow spans seven steps: quick topic discovery, initialization, technical overview, integration patterns, architectural patterns, implementation research, and synthesis into a markdown report saved under research/technical with comparison matrices, stack recommendations, performance notes, and citations. Developers invoke it by name (bmad-technical-research) during Phase 1 analysis when evaluating frameworks, comparing tools, or documenting tradeoffs for a feature or platform choice. It requires web search capabilities and respects project TOML customizations for language and output directories. Use it when informal chat comparisons are insufficient and you need a repeatable, sourced technical brief for downstream PRD or architecture skills.

  • Architecture option comparison
  • Library and API evaluation
  • Risk and constraint mapping
  • Evidence-backed recommendations
  • Feeds sprint planning scope

Bmad Technical Research by the numbers

  • 324 all-time installs (skills.sh)
  • Ranked #2,220 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/bmad-code-org/bmad-method --skill bmad-technical-research

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs324
repo stars51.5k
Last updatedAugust 5, 2026
Repositorybmad-code-org/bmad-method

How do you compare technical architectures before building?

Investigate libraries, architectures, and tradeoffs before committing to a technical direction for a new feature, integration, or platform choice.

Who is it for?

Developers in BMad Method Phase 1 who need formal, cited technical research before writing a PRD or architecture document.

Skip if: Developers who already finalized their stack and only need implementation help without another research document cycle.

When should I use this skill?

The developer asks to research technologies, compare architectures, evaluate libraries, or produce a technical analysis report before committing to a direction.

What you get

research/technical markdown report with technology comparison matrix, integration patterns, architectural recommendations, and citations.

  • research/technical markdown report
  • Technology comparison matrix
  • Cited source bibliography

By the numbers

  • Follows a 7-step technical research workflow from discovery through synthesis
  • Outputs reports to the research/technical directory

Files

SKILL.mdMarkdownGitHub ↗

Technical Research Workflow

Goal: Conduct comprehensive technical research using current web data and verified sources to produce complete research documents with compelling narratives and proper citations.

Your Role: You are a technical 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. technical-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 technical research.

What technology, tool, or technical area do you want to research?

For example:

  • 'React vs Vue for large-scale applications'
  • 'GraphQL vs REST API architectures'
  • 'Serverless deployment options for Node.js'
  • 'Or any other technical topic you have in mind...'"

Topic Clarification

Based on the user's topic, briefly clarify: 1. Core Technology: "What specific aspect of [technology] 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 TECHNICAL RESEARCH STEPS

After gathering the topic and goals:

1. Set research_type = "technical" 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/technical-{{research_topic_slug}}-research-{{date}}.md with exact copy of the ./research.template.md contents 6. Load: ./technical-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 technical research.

✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`

Related skills

How it compares

Use bmad-technical-research for formal cited stack comparisons; use bmad-market-research when the question is market sizing rather than technical architecture.

FAQ

What does bmad-technical-research produce?

bmad-technical-research synthesizes a research/technical markdown report with a technology comparison matrix, integration and architectural recommendations, implementation considerations, and web-sourced citations after seven structured workflow steps.

When do you invoke bmad-technical-research in BMad?

bmad-technical-research belongs to BMad Method Phase 1 analysis, before PRD and architecture work. Invoke it when comparing frameworks, evaluating integrations, or documenting technical tradeoffs that need a formal cited brief.

AI & Agent Buildingresearchllmautomation

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.