Files
gh-adrianpuiu-claude-skills…/assets/requirements-template.md
2025-11-29 17:50:56 +08:00

2.7 KiB

Requirements Document Template

Introduction

[PROJECT NAME] is a [SYSTEM TYPE] designed for [TARGET USERS]. The system [PRIMARY PURPOSE].

System Context

Architectural Overview

  • Components: [List major system components]
  • Data Flow: [High-level data movement]
  • Integration Points: [External systems/APIs]
  • Deployment Model: [Cloud/On-premise/Hybrid]

Glossary

  • [Term]: [Definition specific to this system]
  • Component: Major system module or service
  • Integration Point: Connection to external system or API

Functional Requirements

REQ-1: [Feature Name]

User Story: As a [user role], I want [feature], so that [benefit]

Acceptance Criteria:

  1. WHEN [condition], THE system SHALL [behavior]
  2. THE system SHALL [requirement] within [time constraint]
  3. IF [error condition], THEN THE system SHALL [error handling]

Components Involved: [COMP-1, COMP-2] Data Flow: [How data moves for this requirement]

REQ-2: [Feature Name]

User Story: As a [user role], I want [feature], so that [benefit]

Acceptance Criteria:

  1. WHEN [condition], THE system SHALL [behavior]
  2. WHERE [context], THE system SHALL [behavior]
  3. THE system SHALL persist [data] with [attributes]

Components Involved: [COMP-3, COMP-4] Integration Points: [External systems used]

Non-Functional Requirements

Performance Requirements

  • Response time: THE system SHALL respond to user requests within [X] milliseconds
  • Throughput: THE system SHALL handle [X] concurrent users
  • Data processing: THE system SHALL process [X] records per second

Security Requirements

  • Authentication: THE system SHALL implement [auth method]
  • Authorization: THE system SHALL enforce role-based access control
  • Data protection: THE system SHALL encrypt sensitive data at rest and in transit

Reliability Requirements

  • Availability: THE system SHALL maintain 99.9% uptime
  • Recovery: THE system SHALL recover from failures within [X] minutes
  • Data integrity: THE system SHALL ensure ACID compliance for transactions

Scalability Requirements

  • THE system SHALL support horizontal scaling
  • THE system SHALL handle [X]% growth in users annually
  • THE system SHALL support database sharding for data volumes exceeding [X]

Constraints and Boundaries

Technical Constraints

  • Technology: [Programming languages, frameworks, databases]
  • Infrastructure: [Cloud provider, hardware limitations]

Business Constraints

  • Budget: [Cost limitations]
  • Timeline: [Delivery deadlines]
  • Compliance: [Regulatory requirements]

Scope Boundaries

  • In Scope: [What's included]
  • Out of Scope: [What's explicitly excluded]
  • Future Considerations: [Deferred features]