| 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
- Clear structure - Organized, easy to navigate
- Consistent format - Templates and standards
- Plain language - Avoid jargon, be precise
- Visual aids - Diagrams, tables, examples
- Unique IDs - Requirements traceability
- Version control - Track changes
- Stakeholder review - Validate accuracy
- Living document - Update as needed
Resources
- BABOK Guide: Documentation standards
- IEEE 830: Software requirements specification