BMAD-METHOD/src
Claude 9f0664a8c5
feat: add UX Writer module - interface copy specialist with Four Quality Standards
Add comprehensive UX Writing module based on https://github.com/content-designer/ux-writing-skill

This module provides AI-powered interface copy creation and analysis using the research-backed
Four Quality Standards framework (Purposeful, Concise, Conversational, Clear).

**Agent:**
- UX Writer (Alex) - Expert UX writing specialist
- Complete persona with 11 specialized commands
- Quality scoring system (0-10 scale per standard)
- Pattern-based approach for all UI elements

**Core Capabilities:**
- Analyze existing text with objective scoring
- Create new interface copy for all patterns
- Improve existing copy with before/after comparison
- Content audits for consistency
- Voice chart creation and tone adaptation
- Accessibility compliance checking
- Research-backed benchmark scoring

**UI Patterns Covered:**
- Buttons and links
- Error messages (inline, detour, blocking)
- Success messages
- Empty states (first-use, cleared, no-results)
- Notifications and alerts
- Form fields (labels, instructions, placeholders)
- Onboarding flows
- Help text and tooltips

**Quality Framework:**
The Four Quality Standards with objective 0-10 scoring:

1. Purposeful - Helps users/business achieve goals
2. Concise - Fewest words without losing meaning
3. Conversational - Natural and human, not robotic
4. Clear - Unambiguous and easy to understand

**Research-Backed Benchmarks:**
- Sentence length targets (8-14 words for 90%+ comprehension)
- Word count limits by UI element
- Reading level guidelines (7th-12th grade)
- Character count benchmarks
- Active voice target (85%)

**Tasks (3):**
- analyze-ux-text.md - Score against four standards
- create-ux-text.md - Pattern-based creation with elicitation
- improve-ux-text.md - Before/after with detailed analysis

**Templates (5):**
- error-message-template.md - Error message creation guide
- empty-state-template.md - Empty state design framework
- onboarding-flow-template.md - Onboarding step-by-step
- voice-chart-template.md - Voice documentation
- quality-scorecard.md - Evaluation scorecard

**Data Resources (6):**
- four-quality-standards.md - Complete framework (detailed scoring rubrics)
- ux-writing-benchmarks.md - Research metrics (comprehension, reading levels)
- patterns-detailed.md - Pattern library with examples in 3 voices
- accessibility-guidelines.md - WCAG compliance for UX writing
- content-usability-checklist.md - Quality evaluation
- real-world-improvements.md - Before/after with scoring

**Key Features:**
- Objective quality scoring (not subjective)
- Evidence-based approach (research-backed metrics)
- Accessibility-first (WCAG AA compliance)
- Tone adaptation (5 emotional states: frustrated, confused, confident, cautious, successful)
- Pattern library (proven approaches for all UI elements)
- Multiple variations (brainstorm alternatives)
- Interactive elicitation (context gathering)

**Module Configuration:**
- Target audience selection (general, professional, technical, specialized)
- Reading level targets (7th-12th grade)
- Quality thresholds (7-9/10)
- Tone adaptation modes
- Accessibility compliance levels
- Content type preferences

Total files: 17
Source: https://github.com/content-designer/ux-writing-skill (MIT License)
Credits: Christopher Greer (Stripe), Sarah Richards, Torrey Podmajersky, Google Material Design
2025-11-20 15:18:13 +00:00
..
core refactor(bmm,cis,core): Align diagram workflows with agile roles and distribute capabilities 2025-11-18 21:55:47 -06:00
modules feat: add UX Writer module - interface copy specialist with Four Quality Standards 2025-11-20 15:18:13 +00:00
utility Major Enhancements: 2025-11-09 17:39:05 -06:00