ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity
BMAD-METHOD/bmad-system/QUICK_START_CLAUDE_CODE.md

5.7 KiB
Raw Blame History

Quick Start: Using Enhanced BMAD System with Claude Code

🚀 5-Minute Setup with Claude Code

This guide helps you immediately start using the Enhanced BMAD System within your Claude Code sessions.

Prerequisites Setup

Before starting a Claude Code session, you need BMAD files in your project:

Step 1: Copy BMAD Files to Your Project

# For new projects
mkdir my-project && cd my-project
mkdir .bmad

# For existing projects  
# (in your project root)
mkdir .bmad

# Copy essential BMAD files
cp BMAD-METHOD/bmad-system/README.md .bmad/
cp BMAD-METHOD/bmad-system/QUICK_START_CLAUDE_CODE.md .bmad/
cp BMAD-METHOD/bmad-system/USE_CASES_AND_EXAMPLES.md .bmad/
cp BMAD-METHOD/bmad-system/ARCHITECTURE_OVERVIEW.md .bmad/

Step 2: Initialize in Claude Code

Open your project in Claude Code and start with this prompt:

I have the Enhanced BMAD System installed in my project's .bmad/ directory.

Please:
1. Read .bmad/README.md to understand the BMAD system
2. Configure BMAD for collaborative autonomous development
3. Enable learning and optimization features
4. Help me with my project using BMAD intelligence

Project type: [describe your project]

Step 2: Configure Your Development Mode

Tell Claude Code how you want to work:

For Guided Development:

Configure BMAD for guided development. I want:
- Code suggestions and improvements
- Architecture recommendations  
- Best practice enforcement
- Safety checks on all changes

For Autonomous Features:

Configure BMAD for supervised autonomous development:
- Implement routine features autonomously
- Require approval for critical changes
- Auto-generate tests and documentation
- Optimize code performance automatically

Step 3: Common BMAD Commands in Claude Code

Start a New Project

Using BMAD autonomous development:
- Create a new React/Node.js application
- Design the architecture based on these requirements: [your requirements]
- Implement the initial structure with best practices
- Set up testing and CI/CD

Analyze and Improve Existing Code

Using BMAD code intelligence:
- Analyze this codebase for issues and improvements
- Identify technical debt and modernization opportunities
- Create a prioritized improvement plan
- Start implementing the top priority improvements

Enable Self-Learning

Configure BMAD to learn from this session:
- Learn my coding style and preferences
- Adapt suggestions based on my feedback
- Improve automation based on successful patterns
- Remember project-specific decisions

Multi-LLM Orchestration

Configure BMAD multi-LLM orchestration:
- Use Claude for complex reasoning and architecture
- Switch to GPT-4 for rapid code generation
- Leverage specialized models for specific tasks
- Optimize for best quality/speed balance

📋 Quick Reference Card

Development Levels

  • Guided: AI assists, you drive
  • Collaborative: AI partners with you
  • Supervised: AI works, you approve
  • Full: AI handles everything within constraints

Key BMAD Capabilities

  • Autonomous Development: Self-directed feature implementation
  • Code Intelligence: Deep understanding and optimization
  • Self-Improvement: Learns and adapts from usage
  • Enterprise Features: Governance, security, compliance
  • Cost Optimization: Efficient resource usage

Essential Commands

bmad init                    # Initialize BMAD
bmad develop --autonomous    # Start autonomous development
bmad analyze --deep         # Deep code analysis
bmad optimize --all         # Optimize everything
bmad learn --adaptive       # Enable learning
bmad monitor --real-time    # Monitor performance

🎯 Example Workflows

Workflow 1: Building a Feature

Using BMAD autonomous development:
1. Analyze the user story: "Add user authentication"
2. Design the implementation approach
3. Generate the code with tests
4. Review and optimize the implementation
5. Ensure security best practices
6. Deploy with monitoring

Workflow 2: Code Review and Optimization

Using BMAD code intelligence:
1. Analyze pull request #123
2. Identify potential issues and improvements
3. Check security vulnerabilities
4. Verify compliance with coding standards
5. Suggest optimizations
6. Auto-fix simple issues

Workflow 3: Learning from Patterns

Configure BMAD learning:
1. Analyze my last 10 commits
2. Learn my coding patterns and preferences
3. Adapt future suggestions accordingly
4. Identify areas where I could improve
5. Create personalized best practices

💡 Pro Tips

  1. Start Small: Begin with guided mode and increase autonomy gradually
  2. Set Clear Constraints: Define what BMAD can and cannot do autonomously
  3. Review Learning: Periodically review what BMAD has learned
  4. Use Multi-LLM: Leverage different models for their strengths
  5. Monitor Performance: Keep track of improvements and optimizations

🚨 Safety and Best Practices

Always configure safety constraints:

Configure BMAD safety:
- No direct production changes
- Require approval for database modifications
- Enforce security scanning on all code
- Maintain audit trail of all actions
- Enable rollback capabilities

🎉 You're Ready!

You can now use the Enhanced BMAD System in your Claude Code sessions. Start with simple commands and gradually explore more advanced features as you become comfortable.

Remember: BMAD is designed to enhance, not replace, your development skills. Use it as a powerful ally in creating better software faster!

Need help? Just ask: "How can BMAD help me with [your specific need]?"