business-documentation

name	business-documentation
description	Master business documentation including BRD, FRD, specifications, and technical documentation for clear communication and requirements management.

Business Documentation

Create comprehensive business documentation including BRDs, FRDs, and specifications that clearly communicate requirements and enable successful project delivery.

When to Use This Skill

• Documenting project requirements
• Creating specifications
• Communicating with stakeholders
• Supporting development teams
• Facilitating testing
• Ensuring traceability
• Obtaining approvals
• Providing reference materials

Core Documents

1. Business Requirements Document (BRD)

Structure:

## 1. Executive Summary
- Project overview
- Business objectives
- Expected benefits

## 2. Business Context
- Current situation
- Problems/opportunities
- Strategic alignment

## 3. Scope
- In scope
- Out of scope
- Assumptions
- Constraints

## 4. Business Requirements
- Functional requirements (high-level)
- Non-functional requirements
- Business rules
- Compliance requirements

## 5. Stakeholders
- Key stakeholders
- Roles and responsibilities
- Communication plan

## 6. Success Criteria
- Metrics and KPIs
- Acceptance criteria
- Definition of done

## 7. Risks and Dependencies
- Key risks
- Mitigation strategies
- Dependencies

## 8. Timeline and Budget
- High-level schedule
- Budget estimate
- Resource requirements

2. Functional Requirements Document (FRD)

Structure:

## 1. Introduction
- Purpose
- Scope
- Definitions

## 2. System Overview
- Architecture diagram
- System components
- Integration points

## 3. Functional Requirements
**FR-001: User Authentication**
- **Description:** System shall authenticate users
- **Priority:** High
- **Inputs:** Username, password
- **Processing:** Validate credentials, create session
- **Outputs:** Authentication token, user profile
- **Business Rules:** BR-001, BR-002
- **Acceptance Criteria:**
  - Valid credentials grant access
  - Invalid credentials show error
  - Account locks after 3 failed attempts

## 4. Non-Functional Requirements
**NFR-001: Performance**
- Response time < 2 seconds
- Support 1000 concurrent users

## 5. Data Requirements
- Data models
- Data dictionary
- Data validation rules

## 6. Interface Requirements
- User interfaces
- API specifications
- Integration interfaces

## 7. Appendices
- Glossary
- References
- Traceability matrix

Best Practices

1. Clear structure - Organized, easy to navigate
2. Consistent format - Templates and standards
3. Plain language - Avoid jargon, be precise
4. Visual aids - Diagrams, tables, examples
5. Unique IDs - Requirements traceability
6. Version control - Track changes
7. Stakeholder review - Validate accuracy
8. Living document - Update as needed

Resources

• BABOK Guide: Documentation standards
• IEEE 830: Software requirements specification