Refining IOS Requirements
Productivityrefining-ios-requirementsRefining IOS Requirements is an Agent Skill for productivity published in the bitwarden/ios repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Refine requirements, analyze a ticket, perform gap analysis, or clarify what a Jira/Confluence ticket is asking before coding in Bitwarden iOS. Use when asked to "refine requirements", "analyze ticket", "gap analysis", "clarify ticket", "what does this ticket mean", or to understand scope before implementation begins.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/bitwarden/ios/blob/HEAD/.claude/skills/refining-ios-requirements/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/refining-ios-requirements, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Refining iOS Requirements
Use this skill to analyze a Jira or Confluence ticket and produce structured, implementation-ready requirements before writing any code.
Step 1: Ingest the Ticket
If a ticket ID or URL is provided, fetch it via MCP:
- Use
mcp__plugin_bitwarden-atlassian-tools_bitwarden-atlassian__get_issuefor Jira tickets - Use
mcp__plugin_bitwarden-atlassian-tools_bitwarden-atlassian__get_issue_commentsfor additional context - Use
mcp__plugin_bitwarden-atlassian-tools_bitwarden-atlassian__get_confluence_pagefor Confluence specs
If no ticket is provided, ask for a description of the requirements.
Step 2: Extract Requirements
Identify and list:
- Core functionality: What must this feature/fix do?
- Acceptance criteria: What defines "done"?
- Out of scope: What is explicitly excluded?
- Dependencies: Other tickets, SDK changes, API endpoints needed?
Step 3: Gap Analysis
Identify unstated requirements the ticket may have missed:
Error states
- Network errors, timeout, server errors
- Validation failures, empty states
- SDK errors (encryption/decryption failures)
Edge cases
- Multi-account scenarios (up to 5 accounts)
- Account switching during the operation
- Locked vs unlocked vault state
- Empty vault / first-time user
Platform concerns
- App extension impact (AutoFill, Action, Share — memory limits apply)
- watchOS companion impact (if vault data is involved, especially TOTP data)
- Offline mode behavior
Accessibility
- VoiceOver labels for new UI elements
- Dynamic Type support
- Keyboard navigation
Step 4: Map to iOS Domain
Determine which Bitwarden iOS domain(s) are involved. Read Docs/Architecture.md (Architecture Structure section) for the canonical domain list and descriptions.
Determine which app(s) are affected:
- BitwardenShared: Password Manager
- AuthenticatorShared: Authenticator
- Both: If the feature touches shared components
Step 5: Output Structured Requirements
## Ticket: [PM-XXXXX] — [Title]
### What
[1-2 sentence summary of what needs to be built]
### Why
[Business/user reason for the change]
### Acceptance Criteria
1. [Criterion 1]
2. [Criterion 2]
### Gap Analysis
**Unstated requirements identified:**
- [ ] Error state: [description]
- [ ] Edge case: [description]
- [ ] Platform concern: [description]
**Clarifying questions (if any):**
1. [Question for product/design]
### Scope
- **Domain**: [from Architecture Structure domain list]
- **App(s)**: [Password Manager / Authenticator / Both]
- **Extensions affected**: [AutoFill / Action / Share / Watch / None]
- **Out of scope**: [explicit exclusions]
Confirm Before Proceeding
Present the structured requirements to the user and ask: "Are these requirements accurate? Should I proceed with planning the implementation?"