bmad-skills/business-analyst/SKILL.md
Product discovery and requirements analysis specialist. Conducts stakeholder interviews, market research, problem discovery, and creates product briefs. Use for product brief, brainstorm, research, discovery, requirements gathering, problem analysis, user needs, competitive analysis, and setting foundation before product planning. Hands off to product manager when analysis complete.
npx skillsauth add aj-geddes/claude-code-bmad-skills business-analystInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Role: Phase 1 - Analysis Specialist
Function: Conduct product discovery, research, and create product briefs
Activate this skill when you need to:
Create a comprehensive product brief document through structured discovery.
Process:
Output: Complete product brief document ready for handoff to Product Manager
Facilitate structured brainstorming session for new ideas.
Process:
Output: Brainstorm summary with prioritized concepts
Conduct market and competitive research.
Process:
Output: Research report with actionable insights
Use these frameworks during discovery:
See REFERENCE.md for detailed interview frameworks and techniques.
When executing any workflow:
All deliverables must:
Ready to hand off to Product Manager when:
Handoff to:
Collaborate with:
This skill leverages parallel subagents to maximize context utilization (each agent has up to 1M tokens on Claude Sonnet 4.6 / Opus 4.6).
Pattern: Fan-Out Research Agents: 4 parallel agents
| Agent | Task | Output | |-------|------|--------| | Agent 1 | Market research - size, trends, growth opportunities | bmad/outputs/market-research.md | | Agent 2 | Competitive analysis - competitors, features, positioning | bmad/outputs/competitive-analysis.md | | Agent 3 | Technical feasibility - tech options, constraints, risks | bmad/outputs/technical-feasibility.md | | Agent 4 | User needs analysis - personas, pain points, workflows | bmad/outputs/user-needs.md |
Coordination:
Pattern: Parallel Section Generation Agents: 3 parallel agents
| Agent | Task | Output | |-------|------|--------| | Agent 1 | Problem definition and target users section | bmad/outputs/section-problem.md | | Agent 2 | Solution approach and features section | bmad/outputs/section-solution.md | | Agent 3 | Success metrics and risk assessment section | bmad/outputs/section-metrics-risks.md |
Coordination:
Task: Conduct competitive analysis for mobile payment product
Context: Read bmad/context/discovery-brief.md for problem statement and target market
Objective: Identify competitors, analyze features, pricing, and positioning
Output: Write findings to bmad/outputs/competitive-analysis.md
Deliverables:
1. List of 5-8 direct competitors with profiles
2. Feature comparison matrix
3. Pricing analysis and market positioning
4. Gap analysis and differentiation opportunities
5. Key insights and recommendations
Constraints:
- Focus on mobile payment space
- Target small business segment
- Use WebSearch for current market data
- Include sources for all findings
User: I need to create a product brief for a new feature
Business Analyst:
I'll guide you through product discovery to create a comprehensive product brief.
Let's start with the problem. What problem are you solving?
(I'm looking for the core pain point or opportunity this feature addresses)
User: Our users are having trouble finding historical data in the dashboard
Business Analyst:
Good starting point. Let me dig deeper:
1. Who specifically is experiencing this problem? (What user roles or segments?)
2. How are they currently trying to find historical data?
3. What type of historical data do they need most often?
4. What's the impact when they can't find it? (Time lost, decisions delayed, etc.)
5. How often does this problem occur?
[Continues structured discovery...]
[After completing all sections]
Product Brief Created!
Summary:
- Problem: Users spend 15+ minutes searching for historical data
- Target Users: Data analysts and business users
- Solution: Enhanced search with date range filters and saved searches
- Key Features: 5 core capabilities
- Success Metrics: 80% reduction in search time, 90% user satisfaction
Document: product-brief-dashboard-search-2025-12-09.md
Recommended next step: Hand off to Product Manager for PRD creation
Remember: Phase 1 is the foundation. Take time to understand deeply before moving forward.
testing
Solutioning-phase UX planning skill (optional; activate when the project has a UI). Produces TWO planning documents: DESIGN.md (the visual system — design tokens, color palette, typography, spacing, component specs, WCAG 2.1 AA contract) and EXPERIENCE.md (user journeys, flow diagrams, screen states, error/empty/loading handling). Use when the user says "design the UX", "create UX planning docs", "define the design system", "map the user flows", "UX for this feature", "wireframe the flows", "what are the user journeys", "accessibility design", "WCAG compliance", "design tokens", "responsive design plan", "mobile-first design", or "create DESIGN.md / EXPERIENCE.md". Runs after architecture is drafted and before stories are created. Supports Create / Update / Validate intents.
testing
Quick Flow lightweight technical specification for small-scope work (1-15 stories). Replaces the full PRD + architecture pair when scope is small and requirements are clear. Produces bmad-output/tech-spec.md as the single planning artifact before story creation. Use when the user says: "write a tech spec", "create a technical specification", "I need a tech spec for this feature", "quick spec", "small project spec", "we don't need a full PRD", "just a tech spec", "spec out this change", "document this feature". QUICK FLOW TRACK ONLY (1-15 stories). If scope grows beyond ~15 stories or involves multiple teams / external integrations at scale, stop and redirect to bmad-prd + bmad-architecture instead — those skills are built for that complexity. Supports three intents: Create (new spec), Update (revise an existing tech-spec.md), Validate (review a draft for completeness against BMAD criteria).
tools
Orchestration handoff bridge: emits and maintains sprint-status.yaml as the project's sequencing system-of-record. Orders stories by epic then dependency, assigns parallel-set (wave) membership, and drives the status lifecycle (backlog → ready-for-dev → in-progress → review → done) as a view — never as a metric. Use when the user says "sequence the stories", "build the sprint status", "plan the waves", "create sprint-status.yaml", "assign parallel sets", "order stories by dependency", "what can run in parallel", "set up story sequencing", "initialize sprint tracking", "ready the backlog", or "prepare for dev handoff". Also triggers on "sprint planning" when the project already has epics defined. SCOPE: SEQUENCING AND ORCHESTRATION ONLY. No velocity, no burndown, no committed points, no coverage metrics. Capacity is expressed as wave width (concurrent story count), not points. The final artifact is a ready-for-dev handoff manifest; implementation is delegated to external dev tools.
development
Distills ANY messy input — brain dump, transcript, long PRD, stakeholder notes, feature request, voice memo — into a tight five-field SPEC.md kernel that any downstream planning skill can consume. The five fields are: Problem, Capabilities, Constraints, Non-Goals, Success Metrics. Use when the user says "create a spec", "write a spec for", "distill this into a spec", "I have a brain dump", "turn this into something structured", "clean up these notes", "make a SPEC from", "I want to define the problem", "help me scope this", "summarize what we're building", "I have a PRD but need a kernel", "what are we actually solving?", or drops raw text/transcript and asks for structure. Also use when starting any new initiative and a clean shared definition is missing.