skills/spjoshis/claude-code-plugins/business-documentation

business-documentation

SKILL.md

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
Weekly Installs
2
GitHub Stars
3
First Seen
Feb 21, 2026
Installed on
opencode2
gemini-cli2
claude-code2
github-copilot2
codex2
kimi-cli2