User Research Plan
Research
Comprehensive plan outlining research objectives, methodologies, participant criteria, timeline, and success metrics for user research activities within a sprint or epic.
Example Content:
"Sprint 2 Research Plan: Validate navigation redesign through 8 moderated usability tests with existing users, focusing on task completion rates and time-to-find for key features. Success criteria: >80% task completion, < 30s average search time."
Repository:
/research/plans/sprint-{number}/
User Personas
Research
Detailed profiles of target users based on research data, including demographics, goals, pain points, behaviors, and technology usage patterns. Used to guide design decisions.
Example Persona:
"Sarah, 32, Marketing Manager - Tech-savvy early adopter who values efficiency. Uses mobile-first, struggles with complex workflows. Goal: Complete tasks quickly during commute. Pain point: Too many steps to access frequently used features."
Repository:
/research/personas/current/
Customer Journey Maps
Research
Visual representation of user interactions across touchpoints, including emotions, pain points, and opportunities for improvement throughout the user experience.
Example Journey Stage:
"Onboarding Stage: User feels excited but overwhelmed. Touchpoints: Landing page, signup form, welcome email. Pain point: Too much information at once. Opportunity: Progressive disclosure and guided tour."
Repository:
/research/journey-maps/
Wireframes
Design
Low to high-fidelity structural blueprints showing layout, content hierarchy, and basic functionality without visual design elements. Used for early concept validation.
Example Use Case:
"Mobile checkout wireframes showing progressive form completion, trust signals placement, and error state handling. Includes annotations for interaction behavior and responsive breakpoints."
Repository:
/design/wireframes/sprint-{number}/
Design System
Design
Comprehensive collection of reusable components, patterns, and guidelines that ensure consistency across all product interfaces. Includes tokens, components, and usage guidelines.
Example Components:
"Button component with variants (primary, secondary, danger), states (default, hover, disabled), sizes (small, medium, large), and accessibility specifications including color contrast ratios and keyboard navigation."
Repository:
/design/system/components/
Interactive Prototypes
Design
Clickable, functional representations of user interfaces that simulate user interactions and flows. Used for testing and stakeholder communication.
Example Implementation:
"High-fidelity Figma prototype with realistic data, micro-interactions, and error states. Includes user flow from landing page through signup completion with branching paths for different user types."
Repository:
/design/prototypes/interactive/
Style Guide
Design
Visual and behavioral guidelines for consistent user interface design, including typography, color palettes, spacing, and component usage rules.
Example Guidelines:
"Primary font: Inter 16px for body text, line-height 1.5. Color palette: Primary blue #1e3a8a (4.5:1 contrast ratio), Error red #ef4444. Spacing scale: 4px, 8px, 16px, 24px, 32px, 48px."
Repository:
/design/guidelines/style/
Test Plans
Testing
Comprehensive testing strategies outlining scope, objectives, test environments, and success criteria for quality assurance activities across different phases of development.
Example Content:
"Sprint 3 Testing Plan: Cross-browser compatibility testing for checkout flow across Chrome, Firefox, Safari, and Edge. Mobile testing on iOS/Android. Accessibility testing with screen readers. Pass criteria: 100% functionality across all environments."
Repository:
/testing/plans/sprint-{number}/
Test Cases
Testing
Detailed step-by-step instructions for testing specific functionality, including preconditions, test steps, expected results, and pass/fail criteria.
Example Test Case:
"TC-001: Login Validation - Precondition: User on login page. Steps: 1) Enter valid email 2) Enter invalid password 3) Click login. Expected: Error message 'Invalid password' displays, user remains on login page, password field clears."
Repository:
/testing/cases/feature-{name}/
Bug Reports
Testing
Detailed documentation of defects found during testing, including reproduction steps, severity classification, environment details, and screenshots or videos.
Example Bug Report:
"BUG-045: Navigation menu overlaps content on tablet landscape (768x1024). Severity: Medium. Reproduction: Open site on iPad, rotate to landscape, scroll down. Expected: Menu stays in header. Actual: Menu covers page content."
Repository:
/testing/bugs/sprint-{number}/
QA Checklist
Testing
Standardized checklist ensuring all quality criteria are met before release, covering functionality, usability, accessibility, performance, and cross-platform compatibility.
Example Checklist Items:
"โ All links functional โ Forms validate correctly โ Images have alt text โ Mobile responsive โ Load time <3 seconds โ Cross-browser tested โ Error states handled โ No console errors โ Keyboard navigation works"
Repository:
/testing/checklists/release/
Testing Reports
Testing
Comprehensive summaries of testing activities, results, and quality metrics including test coverage, pass/fail rates, and recommendations for improvement.
Example Report Summary:
"Sprint 3 Testing Report: 47/50 test cases passed (94% success rate). 3 medium-priority bugs identified and resolved. Accessibility score: 98% WCAG AA compliance. Performance: Average load time 2.1s. Ready for production release."
Repository:
/testing/reports/sprint-{number}/
Usability Testing Reports
Testing
Detailed analysis of user testing sessions including findings, recommendations, and prioritized action items. Contains both quantitative metrics and qualitative insights.
Example Finding:
"6/8 users failed to locate the search function within 30 seconds. Primary issue: Search icon not recognizable (hamburger icon confusion). Recommendation: Replace with magnifying glass icon and add 'Search' label."
Repository:
/testing/usability/reports/
User Stories
Management
Brief descriptions of features from the user's perspective, including acceptance criteria and story points. Foundation for sprint planning and development prioritization.
Example Story:
"As a mobile user, I need one-tap access to my order history so that I can quickly reorder items while on the go. Acceptance Criteria: Order history accessible from main navigation, shows last 10 orders, includes reorder button."
Repository:
/management/backlog/stories/
Sprint Backlog
Management
Collection of user stories, tasks, and deliverables committed to for a specific sprint, including story points, assignments, and acceptance criteria.
Example Sprint Contents:
"Sprint 3 Backlog: Navigation redesign (8 pts), Mobile wireframes (5 pts), Usability testing setup (3 pts), Component library updates (2 pts). Total: 18 points. Duration: 2 weeks."
Repository:
/management/sprints/current/
Content Strategy
Documentation
Strategic framework for content creation, governance, and optimization aligned with user needs and business goals. Includes content audits and editorial guidelines.
Example Strategy:
"Voice: Friendly but professional. Tone adapts to context - encouraging in onboarding, urgent for errors, supportive in help content. Content hierarchy: Task-oriented headings, scannable bullets, progressive disclosure for complex topics."
Repository:
/content/strategy/current/
Accessibility Audit
Testing
Comprehensive evaluation of interface accessibility against WCAG guidelines, including automated and manual testing results with remediation recommendations.
Example Finding:
"WCAG 2.1 AA Violation: Form error messages not programmatically associated with inputs. Impact: Screen reader users cannot identify which fields have errors. Solution: Implement aria-describedby attributes."
Repository:
/testing/accessibility/audits/