Requirements Elicitation
Key Capabilities
- Extract Requirements — Identify functional and non-functional requirements from multiple sources
- Clarify Ambiguities — Flag unclear specifications and formulate targeted questions
- Identify Constraints — Find technical, business, security, and resource limitations
- Categorize Requirements — Organize by type (functional, non-functional, security, performance)
Approach
1. Read and Understand
- Read entire specification thoroughly, including all referenced documents
- Identify the primary source (main requirement) vs. supporting documentation
- Note the scope and context of the request
2. Extract Explicit Requirements
- Capture clearly stated requirements
- Document exact specifications (API signatures, data formats, performance metrics)
- Preserve technical details verbatim
3. Identify Implicit Requirements
- Infer unstated but necessary requirements (e.g., error handling, validation, logging)
- Consider security implications based on Bitwarden security principles (P01-P06)
- Identify data classification needs (Vault Data, Protected Data, secure channels)
4. Flag Ambiguities and Gaps
- Document unclear or missing information
- Formulate specific questions to resolve ambiguities
- Identify conflicting requirements between sources
- Note assumptions being made
5. Document Constraints
- Technical constraints (APIs, platforms, compatibility)
- Security constraints (data protection, authentication, authorization)
- Resource constraints (performance, storage, bandwidth)
- Business constraints (timeline, scope, dependencies)
6. Create Acceptance Criteria
- For each requirement, define testable acceptance criteria
- Specify verification methods (commands, tests, manual checks)
- Include edge cases and error scenarios
Bitwarden-Specific Considerations
Security Requirements
Always consider and document:
- Data classification — Is this Vault Data, Protected Data, or other?
- Data states — Requirements for data at rest, in use, in transit
- Security channels — Need for secure/trusted channels?
- Security principles — Which principles (P01-P06) apply?
- Threat scenarios — What could go wrong?
Common Bitwarden Requirement Types
- Authentication/Authorization — Who can access what?
- Encryption — What data needs protection and how?
- Zero-knowledge — Server must not have access to plaintext (P01)
- Cross-platform — Works on all Bitwarden clients?
- Backwards compatibility — Maintains existing behavior?
Example
See examples/export-functionality.md for a complete worked example.
Best Practices
Do's
- ✅ Ask "what" questions, not "how" — Focus on requirements, not implementation
- ✅ Document assumptions explicitly — Make implicit knowledge visible
- ✅ Create testable acceptance criteria — Avoid vague success measures
- ✅ Consider all user types — Free users, premium, enterprise, admins
- ✅ Think about edge cases — Empty vaults, huge vaults, network failures
- ✅ Reference Bitwarden security principles — Ground security requirements in P01-P06
- ✅ Use Bitwarden vocabulary — Standard terminology for data, channels, security
Don'ts
- ❌ Avoid: Making technical implementation decisions — That's the architect's job
- ❌ Avoid: Assuming unstated requirements are obvious — Explicit is better
- ❌ Avoid: Generic acceptance criteria — "It works" is not testable
- ❌ Avoid: Ignoring security implications — Security is never optional at Bitwarden
- ❌ Avoid: Skipping constraints — They're as important as requirements
Output Format
Organize extracted requirements in structured sections:
## Functional Requirements
1. REQ-F-001: [Specific capability the system must have]
- **Acceptance Criteria**: [Testable condition]
- **Priority**: Critical | High | Medium | Low
## Non-Functional Requirements
- **Performance**: [Response time, throughput, resource usage]
- **Reliability**: [Error handling, edge cases, availability]
- **Compatibility**: [Platform support, backwards compatibility]
- **Usability**: [User experience expectations]
## Security Requirements
- **Data Classification**: [Vault Data | Protected Data | Other]
- **Security Principles**: [P01, P02, P03, P04, P05, P06 as applicable]
- **Threat Considerations**: [What could go wrong?]
## Constraints
- **Technical**: [APIs, platforms, dependencies]
- **Business**: [Timeline, scope, resources]
- **Security**: [Compliance, encryption, authentication]
## Open Questions
1. [Specific question needing stakeholder input]
2. [Ambiguity requiring clarification]
3. [Missing information that blocks complete specification]
## Assumptions
- [Assumption 1: explicit statement of what's assumed]
- [Assumption 2: should be validated with stakeholders]
1---2name: requirements-elicitation3description: Requirements Elicitation4---56# Requirements Elicitation78## Key Capabilities9101. **Extract Requirements** — Identify functional and non-functional requirements from multiple sources112. **Clarify Ambiguities** — Flag unclear specifications and formulate targeted questions123. **Identify Constraints** — Find technical, business, security, and resource limitations134. **Categorize Requirements** — Organize by type (functional, non-functional, security, performance)1415## Approach1617### 1. Read and Understand1819- Read entire specification thoroughly, including all referenced documents20- Identify the primary source (main requirement) vs. supporting documentation21- Note the scope and context of the request2223### 2. Extract Explicit Requirements2425- Capture clearly stated requirements26- Document exact specifications (API signatures, data formats, performance metrics)27- Preserve technical details verbatim2829### 3. Identify Implicit Requirements3031- Infer unstated but necessary requirements (e.g., error handling, validation, logging)32- Consider security implications based on Bitwarden security principles (P01-P06)33- Identify data classification needs (Vault Data, Protected Data, secure channels)3435### 4. Flag Ambiguities and Gaps3637- Document unclear or missing information38- Formulate specific questions to resolve ambiguities39- Identify conflicting requirements between sources40- Note assumptions being made4142### 5. Document Constraints4344- Technical constraints (APIs, platforms, compatibility)45- Security constraints (data protection, authentication, authorization)46- Resource constraints (performance, storage, bandwidth)47- Business constraints (timeline, scope, dependencies)4849### 6. Create Acceptance Criteria5051- For each requirement, define testable acceptance criteria52- Specify verification methods (commands, tests, manual checks)53- Include edge cases and error scenarios5455## Bitwarden-Specific Considerations5657### Security Requirements5859Always consider and document:6061- **Data classification** — Is this Vault Data, Protected Data, or other?62- **Data states** — Requirements for data at rest, in use, in transit63- **Security channels** — Need for secure/trusted channels?64- **Security principles** — Which principles (P01-P06) apply?65- **Threat scenarios** — What could go wrong?6667### Common Bitwarden Requirement Types6869- **Authentication/Authorization** — Who can access what?70- **Encryption** — What data needs protection and how?71- **Zero-knowledge** — Server must not have access to plaintext (P01)72- **Cross-platform** — Works on all Bitwarden clients?73- **Backwards compatibility** — Maintains existing behavior?7475## Example7677See `examples/export-functionality.md` for a complete worked example.7879## Best Practices8081### Do's8283- ✅ Ask "what" questions, not "how" — Focus on requirements, not implementation84- ✅ Document assumptions explicitly — Make implicit knowledge visible85- ✅ Create testable acceptance criteria — Avoid vague success measures86- ✅ Consider all user types — Free users, premium, enterprise, admins87- ✅ Think about edge cases — Empty vaults, huge vaults, network failures88- ✅ Reference Bitwarden security principles — Ground security requirements in P01-P0689- ✅ Use Bitwarden vocabulary — Standard terminology for data, channels, security9091### Don'ts9293- ❌ Avoid: Making technical implementation decisions — That's the architect's job94- ❌ Avoid: Assuming unstated requirements are obvious — Explicit is better95- ❌ Avoid: Generic acceptance criteria — "It works" is not testable96- ❌ Avoid: Ignoring security implications — Security is never optional at Bitwarden97- ❌ Avoid: Skipping constraints — They're as important as requirements9899## Output Format100101Organize extracted requirements in structured sections:102103```markdown104## Functional Requirements1051061. REQ-F-001: [Specific capability the system must have]107 - **Acceptance Criteria**: [Testable condition]108 - **Priority**: Critical | High | Medium | Low109110## Non-Functional Requirements111112- **Performance**: [Response time, throughput, resource usage]113- **Reliability**: [Error handling, edge cases, availability]114- **Compatibility**: [Platform support, backwards compatibility]115- **Usability**: [User experience expectations]116117## Security Requirements118119- **Data Classification**: [Vault Data | Protected Data | Other]120- **Security Principles**: [P01, P02, P03, P04, P05, P06 as applicable]121- **Threat Considerations**: [What could go wrong?]122123## Constraints124125- **Technical**: [APIs, platforms, dependencies]126- **Business**: [Timeline, scope, resources]127- **Security**: [Compliance, encryption, authentication]128129## Open Questions1301311. [Specific question needing stakeholder input]1322. [Ambiguity requiring clarification]1333. [Missing information that blocks complete specification]134135## Assumptions136137- [Assumption 1: explicit statement of what's assumed]138- [Assumption 2: should be validated with stakeholders]139```