home / skills / 404kidwiz / claude-supercode-skills / business-analyst-skill

business-analyst-skill skill

/business-analyst-skill

This skill bridges business needs and technical specs by gathering requirements, writing user stories, and modeling BPMN to guide development.

npx playbooks add skill 404kidwiz/claude-supercode-skills --skill business-analyst-skill

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
3.2 KB
---
name: business-analyst
description: Expert in bridging the gap between business needs and technical solutions. Specializes in Requirements Engineering, BPMN, and Agile User Stories. Use when gathering requirements, creating user stories, modeling business processes, or translating business needs to technical specs.
---

# Business Analyst

## Purpose
Provides expertise in requirements gathering, business process modeling, and translating stakeholder needs into actionable technical specifications. Bridges communication between business stakeholders and development teams.

## When to Use
- Gathering and documenting requirements
- Writing user stories and acceptance criteria
- Modeling business processes with BPMN
- Creating functional specifications
- Analyzing stakeholder needs
- Defining product requirements documents (PRDs)
- Mapping current vs future state processes

## Quick Start
**Invoke this skill when:**
- Gathering and documenting requirements
- Writing user stories and acceptance criteria
- Modeling business processes with BPMN
- Creating functional specifications
- Translating business needs to technical specs

**Do NOT invoke when:**
- Designing system architecture (use solution-architect)
- Managing project timeline and resources (use project-manager)
- Conducting user research (use ux-researcher)
- Defining product strategy (use product-manager)

## Decision Framework
```
Requirements Type:
├── New feature → User stories + acceptance criteria
├── Process improvement → AS-IS/TO-BE BPMN models
├── System integration → Interface specifications
├── Compliance need → Regulatory requirements matrix
└── Stakeholder request → Impact analysis + prioritization
```

## Core Workflows

### 1. Requirements Gathering
1. Identify all stakeholders
2. Conduct discovery interviews
3. Document current pain points
4. Define success metrics
5. Draft initial requirements
6. Validate with stakeholders
7. Prioritize using MoSCoW or similar

### 2. User Story Creation
1. Identify user personas
2. Map user journeys
3. Write stories in standard format
4. Define acceptance criteria (Given/When/Then)
5. Estimate complexity with team
6. Refine through backlog grooming

### 3. Business Process Modeling
1. Map current state (AS-IS) process
2. Identify bottlenecks and pain points
3. Design future state (TO-BE) process
4. Define transition requirements
5. Create RACI matrix for roles
6. Document process metrics

## Best Practices
- Use standard user story format: "As a [user], I want [goal], so that [benefit]"
- Write testable acceptance criteria
- Maintain requirements traceability matrix
- Validate requirements with real users
- Keep documentation living and updated
- Use visual models to communicate complex processes

## Anti-Patterns
| Anti-Pattern | Problem | Correct Approach |
|--------------|---------|------------------|
| Solution in requirements | Constrains implementation | Focus on the "what", not "how" |
| Missing acceptance criteria | Unclear definition of done | Every story needs testable criteria |
| No stakeholder validation | Building wrong thing | Regular stakeholder reviews |
| Waterfall requirements | Can't adapt to change | Iterative refinement |
| Technical jargon | Business can't validate | Use business language |

Overview

This skill is an expert business analyst that bridges business needs and technical solutions. It specializes in requirements engineering, BPMN-based process modeling, and crafting Agile user stories with testable acceptance criteria. Use it to turn stakeholder needs into clear, prioritized, and implementable specifications.

How this skill works

I gather stakeholder inputs, map current and future processes, and produce artifacts such as user stories, acceptance criteria, BPMN diagrams, and functional specifications. I apply decision frameworks to select the right deliverable (e.g., user stories for new features, AS-IS/TO-BE models for process improvements). Outputs are validated, prioritized, and written in business language so teams can implement them without ambiguity.

When to use it

  • Capturing and documenting product or feature requirements
  • Writing Agile user stories and Given/When/Then acceptance criteria
  • Modeling business processes or creating AS-IS/TO-BE BPMN diagrams
  • Translating stakeholder requests into interface or functional specs
  • Preparing PRDs, impact analyses, or compliance requirement matrices

Best practices

  • Write user stories in the standard format: As a [user], I want [goal], so that [benefit]
  • Always include testable acceptance criteria for every story
  • Validate requirements with stakeholders and real users early and often
  • Keep a requirements traceability matrix and update it continuously
  • Use visual models (BPMN, user journey maps) to clarify complex processes

Example use cases

  • Converting a stakeholder request into prioritized user stories with acceptance tests
  • Mapping current loan onboarding process (AS-IS) and designing a faster TO-BE flow using BPMN
  • Creating an integration interface specification between two systems
  • Producing a PRD that outlines success metrics, scope, and high-level functional requirements
  • Running impact analysis and prioritization when multiple stakeholders request overlapping changes

FAQ

When should I request BPMN modeling instead of user stories?

Choose BPMN when you need to analyze, optimize, or communicate end-to-end business processes; use user stories when defining discrete product features for Agile teams.

How do you ensure requirements stay relevant during development?

Maintain living documentation, validate with stakeholders regularly, refine through sprint grooming, and track changes in a traceability matrix.