Breakthrough Method for Agile Ai Driven Development
Go to file
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
.github update doc 2025-11-14 07:10:01 -06:00
.husky chore: added CC PR review (#871) 2025-11-05 14:14:31 -06:00
.vscode feat: Add ide-only and web-only menu item filtering for platform-specific commands 2025-11-15 19:39:53 -06:00
docs feat: add Marketing Ops module - complete marketing operations suite 2025-11-20 12:36:05 +00:00
src feat: add UX Writer module - interface copy specialist with Four Quality Standards 2025-11-20 15:18:13 +00:00
test Major Enhancements: 2025-11-09 17:39:05 -06:00
tools feat: add empty IDE selection warning and promote Antigravity to recommended 2025-11-19 22:12:45 -06:00
.gitignore Chore/update gitignore (#945) 2025-11-19 20:41:08 -06:00
.npmrc feat: v6.0.0-alpha.0 - the future is now 2025-09-28 23:17:07 -05:00
.nvmrc feat: v6.0.0-alpha.0 - the future is now 2025-09-28 23:17:07 -05:00
.prettierignore Summary of changes: 2025-11-14 20:43:15 -06:00
CHANGELOG.md feat: add Marketing Ops module - complete marketing operations suite 2025-11-20 12:36:05 +00:00
CONTRIBUTING.md release: bump to v6.0.0-alpha.6 2025-11-04 22:28:28 -06:00
LICENSE feat: v6.0.0-alpha.0 - the future is now 2025-09-28 23:17:07 -05:00
README.md feat: add Marketing Ops module - complete marketing operations suite 2025-11-20 12:36:05 +00:00
eslint.config.mjs Summary of changes: 2025-11-14 20:43:15 -06:00
package-lock.json chore: bump version to 6.0.0-alpha.12 and add yaml dependency 2025-11-19 00:36:31 -06:00
package.json chore: bump version to 6.0.0-alpha.12 and add yaml dependency 2025-11-19 00:36:31 -06:00
prettier.config.mjs feat: v6.0.0-alpha.0 - the future is now 2025-09-28 23:17:07 -05:00

README.md

BMad Method & BMad Core

Stable Version Alpha Version License: MIT Node.js Version Discord

AI-Driven Agile Development That Scales From Bug Fixes to Enterprise

Build More, Architect Dreams (BMAD) with 31+ specialized AI agents and 73+ guided workflows that adapt to your project's complexity—from quick bug fixes to enterprise platforms to content creation and marketing operations.

🚀 v6 is a MASSIVE upgrade from v4! Complete architectural overhaul, scale-adaptive intelligence, visual workflows, and the powerful BMad Core framework. v4 users: this changes everything. See what's new →

📌 v6 Alpha Status: Near-beta quality with vastly improved stability. Documentation is being finalized. New videos coming soon to BMadCode YouTube.

🎯 Why BMad Method?

Unlike generic AI coding assistants, BMad Method provides structured, battle-tested workflows powered by specialized agents who understand agile development. Each agent has deep domain expertise—from product management to architecture to testing—working together seamlessly.

Key Benefits:

  • Scale-Adaptive Intelligence - Automatically adjusts planning depth from bug fixes to enterprise systems
  • Complete Development Lifecycle - Analysis → Planning → Architecture → Implementation
  • Specialized Expertise - 27+ agents with specific roles (PM, Architect, Developer, UX Designer, Content Creator, etc.)
  • Proven Methodologies - Built on agile best practices with AI amplification
  • Advanced Voice & Style System - AI content that authentically matches your unique writing style
  • IDE Integration - Works with Claude Code, Cursor, Windsurf, VS Code

🏗️ The Power of BMad Core

BMad Method is actually a sophisticated module built on top of BMad Core (Collaboration Optimized Reflection Engine). This revolutionary architecture means:

  • BMad Core provides the universal framework for human-AI collaboration
  • BMad Method leverages Core to deliver agile development workflows
  • BMad Builder lets YOU create custom modules as powerful as BMad Method itself

With BMad Builder, you can architect both simple agents and vastly complex domain-specific modules (legal, medical, finance, education, creative) that will soon be sharable in an official community marketplace. Imagine building and sharing your own specialized AI team!

📊 See It In Action

BMad Method Workflow

Complete BMad Method workflow showing all phases, agents, and decision points

🚀 Get Started in 3 Steps

1. Install BMad Method

# Install v6 Alpha (recommended)
npx bmad-method@alpha install

# Or stable v4 for production
npx bmad-method install

2. Initialize Your Project

Load any agent in your IDE and run:

*workflow-init

This analyzes your project and recommends the right workflow track.

3. Choose Your Track

BMad Method adapts to your needs with three intelligent tracks:

Track Use For Planning Time to Start
Quick Flow Bug fixes, small features Tech spec only < 5 minutes
📋 BMad Method Products, platforms PRD + Architecture + UX < 15 minutes
🏢 Enterprise Compliance, scale Full governance suite < 30 minutes

Not sure? Run *workflow-init and let BMad analyze your project goal.

🔄 How It Works: 4-Phase Methodology

BMad Method guides you through a proven development lifecycle:

  1. 📊 Analysis (Optional) - Brainstorm, research, and explore solutions
  2. 📝 Planning - Create PRDs, tech specs, or game design documents
  3. 🏗️ Solutioning - Design architecture, UX, and technical approach
  4. Implementation - Story-driven development with continuous validation

Each phase has specialized workflows and agents working together to deliver exceptional results.

🤖 Meet Your Team

12 Specialized Agents working in concert:

Development Architecture Product Leadership
Developer Architect PM Scrum Master
UX Designer Test Architect Analyst BMad Master
Tech Writer Game Architect Game Designer Game Developer

Each agent brings deep expertise and can be customized to match your team's style.

📦 What's Included

Core Modules

  • BMad Method (BMM) - Complete agile development framework

  • BMad Builder (BMB) - Create custom agents and workflows

    • Build anything from simple agents to complex modules
    • Create domain-specific solutions (legal, medical, finance, education)
    • Share your creations in the upcoming community marketplace
    • → Builder Guide
  • Creative Intelligence Suite (CIS) - Innovation & problem-solving

  • Content Creator - Advanced content creation with voice matching

    • 8 specialized content creation agents
    • 8 workflows including advanced voice profiling system
    • Multi-platform content creation (Blog, LinkedIn, Newsletter, Twitter)
    • Custom voice profiles and style guides
    • → Content Creation Suite
  • Marketing Ops - Complete marketing operations suite

    • 4 specialized marketing agents (Brand Marketer, Media Buyer, Marketing Analyst, Creative Designer)
    • 13 comprehensive workflows for strategy, campaigns, analytics, and creative
    • 20 specialized tasks for research, optimization, and analysis
    • Professional-grade marketing deliverables with AI assistance
    • → Marketing Operations Suite

Key Features

  • 🎨 Customizable Agents - Modify personalities, expertise, and communication styles
  • 🌐 Multi-Language Support - Separate settings for communication and code output
  • 📄 Document Sharding - 90% token savings for large projects
  • 🔄 Update-Safe - Your customizations persist through updates
  • 🚀 Web Bundles - Use in ChatGPT, Claude Projects, or Gemini Gems

📚 Documentation

For v4 Users

💬 Community & Support

🛠️ Development

For contributors working on the BMad codebase:

# Run all quality checks
npm test

# Development commands
npm run lint          # Check code style
npm run format:fix    # Auto-format code
npm run bundle        # Build web bundles

See CONTRIBUTING.md for full development guidelines.

What's New in v6

v6 represents a complete architectural revolution from v4:

🚀 Major Upgrades

  • BMad Core Framework - Modular architecture enabling custom domain solutions
  • Scale-Adaptive Intelligence - Automatic adjustment from bug fixes to enterprise
  • Visual Workflows - Beautiful SVG diagrams showing complete methodology
  • BMad Builder Module - Create and share your own AI agent teams
  • 50+ Workflows - Up from 20 in v4, covering every development scenario
  • 19 Specialized Agents - Enhanced with customizable personalities and expertise
  • Update-Safe Customization - Your configs persist through all updates
  • Web Bundles - Use agents in ChatGPT, Claude, and Gemini
  • Multi-Language Support - Separate settings for communication and code
  • Document Sharding - 90% token savings for large projects

🔄 For v4 Users

📄 License

MIT License - See LICENSE for details.

Trademarks: BMAD™ and BMAD-METHOD™ are trademarks of BMad Code, LLC.


Contributors

Built with ❤️ for the human-AI collaboration community