From nickcrew-claude-ctx-plugin
Gathers and documents business requirements, maps AS-IS/TO-BE processes, performs gap analysis, writes BRDs, and manages stakeholders for software projects.
npx claudepluginhub nickcrew/claude-cortexThis skill uses the workspace's default tool permissions.
This skill covers the structured practice of business analysis—translating business problems into clear requirements, mapping current and future-state processes, identifying gaps, managing stakeholder alignment, and producing the documentation (BRDs, use cases, process maps) that enables successful project delivery. It bridges the gap between business needs and technical or operational solutions.
Conducts structured business analysis for projects: problem/stakeholder analysis, as-is/to-be gap analysis, user personas, scope definition. Creates BA documents and manages GitHub issues/PRs/branches.
Orchestrates 14 BABOK techniques for strategic analysis, problem solving, planning, estimation, and process/data design into goal-specific analysis packages.
Orchestrates Problem-Based SRS methodology to derive traceable functional requirements from business problems via 6 structured steps and sub-skills.
Share bugs, ideas, or general feedback.
This skill covers the structured practice of business analysis—translating business problems into clear requirements, mapping current and future-state processes, identifying gaps, managing stakeholder alignment, and producing the documentation (BRDs, use cases, process maps) that enables successful project delivery. It bridges the gap between business needs and technical or operational solutions.
| Task | Technique | Output |
|---|---|---|
| Elicit requirements | Interviews, workshops, observation | Requirements list |
| Document requirements | BRD template | Business Requirements Document |
| Map current state | Swimlane diagram, flowchart | AS-IS process map |
| Design future state | TO-BE process map | Process redesign |
| Find gaps | Gap analysis matrix | Gap analysis report |
| Manage stakeholders | RACI / Power-Interest grid | Stakeholder register |
| Document user interactions | Use case format | Use Case document |
| Prioritize requirements | MoSCoW method | Prioritized requirements |
| Validate requirements | Walkthrough, prototype review | Sign-off document |
Stakeholder register:
| Stakeholder | Role | Interest Level | Influence Level | Stance | Engagement Strategy |
|---|---|---|---|---|---|
| VP Operations | Executive sponsor | High | High | Champion | Weekly status briefing |
| IT Director | Technical owner | High | High | Neutral | Bi-weekly architecture review |
| Customer Service Mgr | Process owner | High | Medium | Skeptic | Involve in requirements workshop |
| End users | Operators | Medium | Low | Unaware | Survey + demo sessions |
Power-Interest grid:
RACI matrix for project roles:
| Activity | Business Sponsor | BA | IT Lead | Process Owner |
|---|---|---|---|---|
| Define requirements | A | R | C | C |
| Approve BRD | A | R | I | I |
| Design solution | I | C | R | C |
| Test & validate | I | C | R | A |
| Sign off to launch | A | C | C | R |
| (R=Responsible, A=Accountable, C=Consulted, I=Informed) |
Technique 1 — Structured Interviews: Run 45–60 minute sessions with key stakeholders. Use open-ended questions:
Technique 2 — Requirements Workshop (JAD session):
Technique 3 — Observation (Process Shadowing):
Technique 4 — Document Analysis:
Document Title: [Project Name] Business Requirements Document Version: 1.0 | Date: [Date] | Status: Draft / In Review / Approved Author: [BA Name] | Sponsor: [Name]
1. Executive Summary One paragraph: business problem, proposed solution, expected business value, and scope.
2. Business Objectives
| Objective | Success Metric | Target | Timeline |
|---|---|---|---|
| Reduce order processing time | Avg processing time | From 4 hours to 30 min | By Q3 |
| Eliminate manual data entry errors | Error rate | From 3.2% to <0.5% | By Q3 |
3. Project Scope In Scope:
Out of Scope:
4. Current State (AS-IS) Overview Brief description of how the process/system works today.
5. Future State (TO-BE) Overview Description of the desired end state and how it differs from today.
6. Business Requirements
| ID | Requirement | Priority | Source | Notes |
|---|---|---|---|---|
| BR-001 | System must validate order completeness before submission | Must Have | Operations Mgr | Reduce downstream errors |
| BR-002 | Automated email notification to customer upon order status change | Should Have | Customer Service | Reduce inbound call volume |
| BR-003 | Ability to generate weekly summary reports without IT involvement | Should Have | VP Operations | Currently takes 4 hours/week |
7. Assumptions and Dependencies
8. Constraints
9. Risks
| Risk | Likelihood | Impact | Mitigation |
|---|---|---|---|
| Data migration errors | High | High | Parallel run period of 4 weeks |
| User adoption resistance | Medium | Medium | Change management program |
10. Approval
| Role | Name | Signature | Date |
|---|---|---|---|
| Business Sponsor | |||
| IT Director |
AS-IS Process Map — document the current state exactly as it is:
Swimlane notation (text format):
Customer → [Submit order form] → [Order lands in shared inbox]
↓
Sales Rep → [Manually copy to ERP] → [Check inventory]
↓ (if in stock)
Warehouse → [Pick and pack] → [Update ERP] → [Email customer]
↓ (if out of stock)
Sales Rep → [Call customer] → [Offer alternative] → [Cancel or modify]
Pain points: ⚠️ Manual ERP entry takes 15 min/order; 🔴 3.2% error rate on data entry
TO-BE Process Map — design the improved future state:
Customer → [Submit order on web portal] → [System auto-validates]
↓ (auto-routed)
ERP System → [Inventory check (real-time)] → [Confirmation email auto-sent]
↓ (if in stock)
Warehouse → [Pick slip auto-generated] → [Scan to update status] → [Auto-notification]
↓ (if out of stock)
ERP System → [Auto-email with alternatives] → [Customer self-serves]
A gap analysis identifies the distance between current state and desired state.
Gap analysis matrix:
| Capability Area | Current State | Desired State | Gap | Priority | Action Required |
|---|---|---|---|---|---|
| Order validation | Manual check by rep | System validates automatically | Process + system gap | High | Build validation rules in ERP |
| Customer notification | Manual email by rep | Automated trigger | Automation gap | High | Configure email workflow |
| Reporting | Manual Excel export | Self-serve dashboard | Capability gap | Medium | Implement BI tool integration |
| Inventory visibility | Updated day-end batch | Real-time | Data gap | High | API integration with warehouse system |
A use case describes how a user achieves a goal through a system.
Use Case Template:
Use Case ID: UC-001
Use Case Name: Submit a New Customer Order
Actor: Sales Representative
Preconditions: Rep is logged into the system; Customer account exists
Trigger: Rep receives a customer purchase request
Main Success Scenario:
1. Rep selects "New Order" from the dashboard
2. System displays order form pre-populated with customer details
3. Rep enters product, quantity, and delivery date
4. System validates inventory availability in real time
5. Rep confirms and submits the order
6. System generates order confirmation number and emails customer
7. Use case ends
Alternative Flows:
4a. Product is out of stock:
4a.1. System displays "Out of Stock" with expected restock date
4a.2. Rep offers alternative or backorder option
4a.3. If customer accepts backorder → continue step 5 with backorder flag
Exception Flows:
3a. Required fields missing:
3a.1. System highlights missing fields with error message
3a.2. Rep corrects and resubmits
Postconditions: Order is recorded in ERP; confirmation email sent to customer
Input: "Our order processing team manually enters 200 orders per day into our ERP. It takes 15 minutes per order, has a 3.2% error rate, and team members work overtime every peak season. We want to automate this."
BRD Executive Summary:
The Order Processing Automation project will eliminate manual order entry by integrating the customer-facing web portal directly with the ERP system. Currently, 200 daily orders require 15 minutes of manual data entry each, resulting in $180,000/year in processing labor cost and a 3.2% error rate that causes customer complaints and re-work. The automated system will reduce processing time to under 2 minutes per order, target a <0.5% error rate, and free 3 FTEs for higher-value work. Project scope includes web portal API integration, ERP workflow configuration, and automated customer notification. Out of scope: mobile app, EDI for supplier orders.
Key Business Requirements:
Input: "New customers take 3 weeks to become active. We want to understand why and fix it."
AS-IS discovery (from interviews + observation):
Gap identified: 7 days of delay from manual handoffs and queue waits; no self-service during setup.
TO-BE redesign:
Gap analysis output:
| Gap | Priority | Solution |
|---|---|---|
| Manual sales → implementation handoff | High | CRM workflow automation |
| Manual account creation | High | API provisioning |
| No self-service setup | Medium | In-app onboarding wizard |
| Training capacity constraint | Medium | Video library + recorded sessions |