Mobo4/bmad-prompt

BMAD Prompt Engineering MCP Server

A comprehensive Model Context Protocol (MCP) server that enforces BMAD-first workflow by transforming raw prompts into business-aligned, strategic prompts with built-in quality assurance and agent recommendations.

🎯 What is BMAD-First Workflow?

BMAD (Business Method Analysis & Design) is a strategic framework that ensures every task begins with comprehensive business analysis before implementation. This MCP server enforces BMAD methodology by:

1. Strategic Analysis First - Understanding the true business objective
2. Stakeholder Impact Assessment - Identifying who benefits and who's affected
3. Business Value Identification - Defining measurable outcomes
4. Success Metrics Definition - Establishing clear success criteria
5. Risk Assessment - Identifying and mitigating potential issues
6. Agent Delegation - Recommending optimal specialized agents

🚀 Quick Start

NPX Usage (Recommended)

# Transform any raw prompt into BMAD-structured format
npx bmad-prompt transform "Create user authentication system"

# Interactive mode for guided prompt engineering
npx bmad-prompt interactive

# Validate existing prompts against BMAD standards
npx bmad-prompt validate "Your existing prompt here"

# Get specialized agent recommendations
npx bmad-prompt suggest "Your BMAD prompt" --complexity complex

# View comprehensive examples
npx bmad-prompt example

Local Installation

npm install -g bmad-prompt-engineer
bmad-prompt --help

📋 Features

🔄 Prompt Transformation

• Converts raw prompts into BMAD-structured strategic prompts
• Analyzes business context and stakeholder impact
• Generates success metrics and risk assessments
• Provides actionable next steps

✅ Prompt Validation

• Validates prompts against BMAD compliance standards
• Provides detailed scoring and improvement recommendations
• Identifies missing strategic elements
• Ensures business alignment before execution

🤖 Agent Recommendations

• Suggests optimal specialized agents based on task analysis
• Provides execution sequences for complex multi-agent workflows
• Adjusts recommendations based on task complexity
• Integrates with existing agent ecosystems

⚡ AI Consensus Priority Setting

• Determines appropriate quality thresholds for AI Consensus System
• Analyzes business impact and risk levels
• Provides priority-based execution recommendations
• Ensures quality standards match business criticality

🛠️ MCP Server Integration

Claude Desktop Configuration

Add to your Claude Desktop config.json:

{
  "mcpServers": {
    "bmad-prompt-engineer": {
      "command": "npx",
      "args": ["bmad-prompt-engineer"],
      "env": {}
    }
  }
}

Available MCP Tools

transform_prompt

Transforms raw prompts into BMAD-structured strategic prompts.

Parameters:

• raw_prompt (required): The raw prompt to transform
• context (optional): Additional business context
• urgency (optional): Urgency level (low, medium, high, critical)

validate_prompt

Validates prompts against BMAD standards.

Parameters:

• prompt (required): The prompt to validate

suggest_agents

Recommends specialized agents for BMAD-structured prompts.

Parameters:

• bmad_prompt (required): BMAD-structured prompt
• task_complexity (optional): Task complexity level

set_priority

Determines AI Consensus priority based on BMAD analysis.

Parameters:

• bmad_analysis (required): BMAD strategic analysis
• business_impact (optional): Business impact level
• risk_level (optional): Risk assessment level

📖 Usage Examples

Basic Transformation

npx bmad-prompt transform "Build a dashboard" --context "Healthcare analytics platform" --urgency high

Output:

BMAD Analyst, provide comprehensive strategic analysis for: Build a dashboard

Include:
1. True objective analysis (what we're really achieving)
2. Stakeholder impact assessment (Customers, Management, IT Department)
3. Business value identification (Customer Experience, Operational Efficiency)
4. Success metrics definition (how we know we succeeded)
5. Risk assessment and mitigation strategies
6. Optimal agent delegation sequence with reasoning

Context: Healthcare analytics platform
Task Category: technical_implementation
Priority Level: high

This analysis should drive purposeful, value-driven execution aligned with business objectives.

Validation Example

npx bmad-prompt validate "Just create a login form"

Output:

❌ NEEDS IMPROVEMENT (17%)

Missing BMAD Elements:
• Strategic Analysis
• Stakeholder Focus
• Business Value
• Success Metrics
• Risk Assessment

Recommendations:
• Add clear objective statement and strategic context
• Identify key stakeholders and their interests
• Define specific business value and expected outcomes

Agent Suggestions

npx bmad-prompt suggest "BMAD analysis for healthcare authentication system" --complexity complex

Output:

Primary Agents:
• healthcare-security-specialist
• fhir-hl7-integration-specialist
• security-guardian
• sql-express-database-expert

Supporting Agents:
• performance-optimization-engineer
• test-commander
• audit-log-sanitizer

Execution Sequence:
1. healthcare-security-specialist
2. security-guardian
3. sql-express-database-expert
4. test-commander

🏗️ Project Structure

prompt-engineer-mcp/
├── src/
│   └── index.js              # Main MCP server implementation
├── bin/
│   └── cli.js               # Command-line interface
├── tests/
│   └── test-server.js       # Comprehensive test suite
├── examples/
│   └── prompt-examples.md   # Detailed usage examples
├── package.json             # NPM configuration
└── README.md               # This file

🧪 Testing

Run the comprehensive test suite:

npm test

Test specific functionality:

# Test transformation
node tests/test-server.js

# Test CLI interface
npx bmad-prompt example

🔧 Development

Local Development Setup

git clone <repository-url>
cd prompt-engineer-mcp
npm install
npm run dev

Running as MCP Server

npm start

Building for Distribution

npm run build

📊 Quality Thresholds

The server automatically sets AI Consensus quality thresholds based on BMAD analysis:

• Critical Priority: 95% threshold (Security, compliance, revenue-critical)
• Important Priority: 85% threshold (Customer-facing, strategic initiatives)
• Normal Priority: 75% threshold (Internal tools, optimization)

🔗 Integration with AI Consensus System

After BMAD transformation, use with AI Consensus System:

# 1. Transform with BMAD
npx bmad-prompt transform "Your task" --urgency high

# 2. Use transformed prompt in AI Consensus
cd /path/to/ai-consensus-system
python3 run.py demo --task "BMAD Analyst, provide..." --priority important

# 3. Implement with validated approach

🎨 Agent Ecosystem Integration

Compatible with the following agent systems:

• Personal Agents (~/.claude/agents/)
• Project Agents (/project/.claude/agents/)
• UI-Registered Agents (/claude-config/agents/)

Automatically recommends agents based on:

• Task domain (Healthcare, Finance, Technology, etc.)
• Complexity level (Simple, Moderate, Complex, Enterprise)
• Business context and requirements
• Security and compliance needs

📝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Run tests (npm test)
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the file for details.

🙏 Acknowledgments

• Built with @modelcontextprotocol/sdk
• Implements BMAD (Business Method Analysis & Design) framework
• Integrates with AI Consensus System for quality validation
• Compatible with Claude Desktop MCP protocol

🆘 Support

• 📖
• 🐛 Issue Tracker
• 💬 Discussions

🔄 Version History

• v1.0.0 - Initial release with full BMAD workflow enforcement
  • Complete MCP server implementation
  • Command-line interface with interactive mode
  • Comprehensive test suite
  • Agent recommendation system
  • AI Consensus priority integration

Made with ❤️ by Claude AI - Enforcing strategic thinking in every prompt