xtremobile/.instructions.md

🚀 XtremFlow BMAD Master Configuration

VS Code Copilot Agent Instructions

This project uses the BMad Method Framework with the BMAD Master Agent to guide development with specialized AI agents. The Master Agent orchestrates PM, Architect, Developer, QA, Security Expert, and other specialists through proven workflows.

---

🎯 BMAD Master Agent (Active)

⚡ Quick Invocation

@bmad-master [your request]

Example Commands

@bmad-master I'm ready to start Phase 1. How do we begin?
@bmad-master Show me the implementation plan for this week
@bmad-master I'm stuck on JWT, help me out
@bmad-master What should I do next?

Result: Orchestrated guidance with all necessary agents coordinated

---

📋 Quick Start with BMAD Master

Invoke BMad Help Anytime

bmad-help

Ask questions like:

• "What's next after the architecture phase?"
• "I need to set up logging, what's the best approach?"
• "How do I handle database migrations?"

---

🎯 XtremFlow Development Roadmap (Using BMad Agents)

Phase 1: Infrastructure & Security (Week 1)

Use these BMad Agents in sequence:

1️⃣ PM Agent - Define Requirements

Stakeholder: I need to improve logging, error handling, and authentication
Task: Use BMAD PM to create user stories and prioritize backlog

2️⃣ Architect Agent - Design Solution

Context: Implementing Logging Service + JWT Auth
Task: Use BMAD Architect to design the system architecture
Reference: IMPROVEMENT_PLAN.md → Section 1

3️⃣ Developer Agent - Implement

Task: Implement Logging Service (LoggingService class)
Reference: IMPLEMENTATION_GUIDE.md → Section 1
Use Developer agent to write production-grade code

4️⃣ QA Agent - Test

Task: Create unit tests for LoggingService
Use QA agent to design comprehensive test coverage

---

🔧 XtremFlow Specific Workflows

Workflow 1: Implement Logging System (Day 1)

File: _bmad/bmm/1-analysis/ → Create logging-system-analysis.md

Steps:

1. Analyze current logging (print statements)
2. Plan logger package integration
3. Solution LoggingService architecture
4. Implement with code generation

Start with: bmad-help I need to implement professional logging

---

Workflow 2: Security Hardening (Day 2-4)

File: _bmad/bmm/1-analysis/ → Create security-hardening.md

1. Analyze current auth (password hashing, tokens)
2. Plan JWT + bcrypt implementation
3. Solution auth flow redesign
4. Implement AuthHandler updates

Start with: bmad-help How do I secure password hashing and implement JWT?

---

Workflow 3: Database Reliability (Day 4-5)

File: _bmad/bmm/1-analysis/ → Create database-reliability.md

1. Analyze database schema
2. Plan migrations system
3. Solution backup & recovery strategy
4. Implement migration runner

Start with: bmad-help I need database migrations and automatic backups

---

📍 Accessing BMad Agents

In VS Code Claude Code/Copilot:

Option 1: Direct Agent Invocation

@pm I need help defining requirements for logging system
@architect Design me a logging architecture for Dart backend
@developer Write the LoggingService implementation
@qa Create unit tests for logging

Option 2: Use BMad Skills

• #bmad-help - Get contextual help
• #bmad-analysis - Deep dive analysis
• #bmad-plan - Create implementation plans
• #bmad-code-review - Review code quality

Option 3: Workflow Mode Ask Claude to invoke the full BMad workflow:

"Let's use the BMad method to improve logging.
Start with analysis phase, then planning, then design, then implementation"

---

📂 BMad Output Structure

All BMad artifacts are stored in:

_bmad-output/
├── planning-artifacts/
│   ├── logging-system-plan.md
│   ├── security-hardening-plan.md
│   └── database-reliability-plan.md
├── implementation-artifacts/
│   ├── {component}-implementation.md
│   └── {component}-testing-strategy.md
└── docs/                    # Project knowledge repo
    ├── IMPROVEMENT_PLAN.md  # ✅ Already created
    ├── IMPLEMENTATION_GUIDE.md  # ✅ Already created
    └── PROBLEMS_AND_SOLUTIONS.md  # ✅ Already created

---

🎯 Recommended Agent Workflows by Task

Task	Primary Agent	Secondary	Output
Analyze problema areas	Analyst	PM	Analysis report
Create implementation plan	PM	Architect	User stories, roadmap
Design architecture	Architect	Tech Lead	Architecture diagrams
Write code	Developer	QA	Production code
Create tests	QA	Developer	Test coverage report
Code review	Code Reviewer	Developer	Review feedback
Documentation	Tech Writer	Developer	API docs, guides

---

💡 Example: Implement Logging (Using BMad)

Step 1: Analysis Phase

@analyst Analyze current logging in XtremFlow backend

→ Creates: _bmad-output/planning-artifacts/logging-analysis.md

Step 2: Planning Phase

@pm Create a detailed plan for implementing logger package in XtremFlow
Reference: IMPLEMENTATION_GUIDE.md Section 1

→ Creates: _bmad-output/planning-artifacts/logging-plan.md

Step 3: Architecture Phase

@architect Design the LoggingService architecture for Dart backend
Include: File handler, console handler, request ID tracing

→ Creates: _bmad-output/implementation-artifacts/logging-architecture.md

Step 4: Implementation Phase

@developer Implement LoggingService based on:
- Plan: _bmad-output/planning-artifacts/logging-plan.md
- Architecture: _bmad-output/implementation-artifacts/logging-architecture.md
- Reference: IMPLEMENTATION_GUIDE.md Section 1.2

Generate production-ready code with full documentation

→ Creates: Code files + logging-service.dart

Step 5: Testing Phase

@qa Create comprehensive tests for LoggingService
Include: File writing, log levels, rotation, error handling

→ Creates: test/unit/logging_service_test.dart

---

🔄 BMad Method Phases Explained

1️⃣ Analysis (_bmad/bmm/1-analysis/)

• Understand current state
• Identify problems
• Gather requirements
• Output: Analysis documents

2️⃣ Planning (_bmad/bmm/1-analysis/)

• Define user stories
• Create roadmap
• Estimate effort
• Output: Planning artifacts

3️⃣ Solutioning (_bmad/bmm/3-solutioning/)

• Design architecture
• Evaluate options
• Create technical specs
• Output: Solution designs

4️⃣ Implementation (_bmad/bmm/4-implementation/)

• Write code
• Create tests
• Document features
• Output: Code + tests

---

🛠️ Integration with XtremFlow

Current Status

• ✅ IMPROVEMENT_PLAN.md created
• ✅ IMPLEMENTATION_GUIDE.md created
• ✅ PROBLEMS_AND_SOLUTIONS.md created
• ✅ BMAD Framework installed

Next Steps Using BMad

1. Invoke @pm to create user stories from IMPROVEMENT_PLAN.md
2. Invoke @architect to review and enhance architecture designs
3. Invoke @developer to implement each task
4. Invoke @qa to create test strategies
5. Use bmad-help for contextual guidance at each step

---

📚 Useful References

BMad Documentation: https://docs.bmad-method.org/ BMad Discord: https://discord.gg/gk8jAdXWmj This Project's Plans:

• IMPROVEMENT_PLAN.md - Complete 5-level improvement roadmap
• IMPLEMENTATION_GUIDE.md - Code-level implementation details
• PROBLEMS_AND_SOLUTIONS.md - 26 identified issues with solutions

---

🎓 Tips for Working with BMad Agents

✅ Be Specific: Provide context, reference files, and requirements ✅ Sequential Phases: Follow analysis → planning → solutioning → implementation ✅ Use References: Point agents to IMPROVEMENT_PLAN.md and other docs ✅ Request Artifacts: Ask agents to create documents in _bmad-output/ ✅ Iterative: Use bmad-help between steps to validate progress ✅ Party Mode: Bring multiple agents into one session for collaboration

---

🚀 Getting Started Right Now

Option A: Quick Start

In VS Code, invoke Copilot and type:
"bmad-help I want to improve XtremFlow backend"

Option B: Structured Workflow

1. @pm: "Create implementation plan from IMPROVEMENT_PLAN.md"
2. @architect: "Design Phase 1 infrastructure improvements"
3. @developer: "Implement logging system (Section 1.1)"
4. @qa: "Create tests for logging service"

Option C: Guided Learning

"Let me follow the full BMad Method workflow for improving XtremFlow.
Start by asking me clarifying questions about priorities."

---

BMad Framework v6.2.1 installed XtremFlow configuration created: 2026-03-25