| name | spec-requirements |
| description | Generate comprehensive requirements definition documents with technology selection and improvement suggestions |
Spec Requirements
Generate comprehensive requirements definition documents with technology selection, improvement suggestions, and EARS format acceptance criteria.
Usage
/spec:requirements <system_name> [options]
Options
| Option | Short | Description | Example |
|---|
--mode | -m | Mode (new-creation/reverse-engineering) | -m reverse-engineering |
--backlog | -b | Enable product backlog format | --backlog |
--epic | -e | Epic name for backlog structure | -e "User Management Epic" |
--story-points | | Include story point estimation | --story-points |
--app | -a | Application name | -a "Web Store" |
--function | -f | Function/feature name | -f "Authentication" |
--output | -o | Output file path | -o specs.md |
--tech | -t | Technology stack | -t "react,nodejs,postgresql" |
--priority | -p | Priority level (low/medium/high/critical) | -p high |
--scope | -s | Scope type (mvp/full/enterprise) | -s mvp |
--suggest | | Include improvement suggestions | --suggest |
--examples | | Include implementation examples | --examples |
--template | | Template type | --template agile |
--hearing | | Interactive clarification mode | --hearing |
Templates
| Template | Description |
|---|
standard | General purpose with EARS format |
agile | User story format with acceptance criteria |
waterfall | Detailed specification document |
product-backlog | Full backlog with epics, features, stories |
Tool Priorities
ALWAYS prioritize mcp__serena__ tools:
File Operations (Serena MCP First)
mcp__serena__find_file → Read (fallback)
mcp__serena__search_for_pattern → Grep (fallback)
mcp__serena__list_dir → LS (fallback)
Code Analysis (Serena MCP)
mcp__serena__get_symbols_overview
mcp__serena__find_referencing_symbols
Context7 Integration
For technology documentation:
- Frontend: React, Vue, Angular
- Backend: Node.js, Express, FastAPI
- Database: PostgreSQL, MongoDB, Redis
Modes
New Creation Mode (Default)
Generate requirements from specifications and user input.
Reverse Engineering Mode
Analyze existing codebase to extract requirements:
- Component Discovery (controllers, services, models)
- Feature Extraction (user-facing functionality)
- User Story Generation (features to stories)
EARS Format
Acceptance criteria use EARS (Easy Approach to Requirements Syntax):
- WHEN [event] THEN [system] SHALL [response]
- IF [precondition] THEN [system] SHALL [response]
- WHILE [condition] THE SYSTEM SHALL [behavior]
- WHERE [context] THE SYSTEM SHALL [behavior]
Examples
/spec:requirements "E-commerce Platform" -a "Web Store" -t "react,nodejs"
/spec:requirements "Social Media App" -s mvp --suggest
/spec:requirements "Mobile App" --hearing
/spec:requirements "User Management" -m reverse-engineering -b -e "Auth Epic"
/spec:requirements "CRM System" -s enterprise -t "react,nodejs,postgresql" --examples
Output Structure
- Header Information: Timestamp, system name, priority, scope
- Functional Requirements: Core features, user scenarios (EARS format)
- Non-Functional Requirements: Performance, security, availability
- Technical Specifications: Architecture, tech stack, integrations
- Additional Sections: Examples, suggestions (if enabled)