124 lines
4.1 KiB
Markdown
124 lines
4.1 KiB
Markdown
# BMAD JavaScript Fullstack Expansion Pack
|
|
|
|
**Optimized workflows and context engineering for modern JavaScript/TypeScript development.**
|
|
|
|
## 🚀 Quick Start
|
|
|
|
**New here? Start with: [START-HERE.md](START-HERE.md)**
|
|
|
|
## 📋 What's Inside
|
|
|
|
### 4 Core Workflows
|
|
- **[greenfield-new-project.yaml](workflows/greenfield-new-project.yaml)** - Start new projects (5-7 days)
|
|
- **[brownfield-modernize-existing.yaml](workflows/brownfield-modernize-existing.yaml)** - Modernize legacy (3-5 days)
|
|
- **[feature-addition.yaml](workflows/feature-addition.yaml)** - Add features (2hrs-10days)
|
|
- **[maintenance-fixes-updates.yaml](workflows/maintenance-fixes-updates.yaml)** - Fix/optimize (2hrs-3days)
|
|
|
|
### Advanced Tools
|
|
- **Token Tracking** - Real-time monitoring with alerts
|
|
- **Telemetry** - Usage analytics and recommendations
|
|
- **Checkpoint System** - 80%+ context compression
|
|
- **Modular Principles** - Load only what you need
|
|
|
|
### Specialized Agents
|
|
- JS Solution Architect
|
|
- React Developer
|
|
- Node Backend Developer
|
|
- API Developer
|
|
- TypeScript Expert
|
|
|
|
## 📊 Key Features
|
|
|
|
- **30% token reduction** through JIT loading
|
|
- **40% faster** development with parallel execution
|
|
- **95% faster** workflow selection (30 seconds)
|
|
- **Zero overlap** between agents
|
|
- **Systematic checkpointing** with structured metadata
|
|
|
|
## 📚 Documentation
|
|
|
|
### Essential
|
|
- **[START-HERE.md](START-HERE.md)** - Main entry point
|
|
- **[workflows/INDEX.md](workflows/INDEX.md)** - Choose workflow (30 sec)
|
|
- **[workflows/README.md](workflows/README.md)** - Workflow overview
|
|
|
|
### Guides
|
|
- **[WORKFLOW-TESTING-GUIDE.md](WORKFLOW-TESTING-GUIDE.md)** - Test workflows
|
|
- **[BMAD-COMPLETE-GUIDE.md](BMAD-COMPLETE-GUIDE.md)** - Complete guide
|
|
- **[workflows/WORKFLOW-SYSTEM.md](workflows/WORKFLOW-SYSTEM.md)** - Detailed docs
|
|
|
|
### Advanced
|
|
- **[tools/](tools/)** - Token counter, runtime tracker, telemetry
|
|
- **[data/agent-capability-matrix.md](data/agent-capability-matrix.md)** - Agent responsibilities
|
|
- **[templates/checkpoint-metadata.yaml](templates/checkpoint-metadata.yaml)** - Checkpoint format
|
|
|
|
## 🎯 Quick Decision
|
|
|
|
```
|
|
Do you have code?
|
|
├─ NO → workflows/greenfield-new-project.yaml
|
|
└─ YES → Is it modernized?
|
|
├─ NO → workflows/brownfield-modernize-existing.yaml
|
|
└─ YES → What do you need?
|
|
├─ Add features → workflows/feature-addition.yaml
|
|
└─ Fix/update → workflows/maintenance-fixes-updates.yaml
|
|
```
|
|
|
|
## 🛠️ File Structure
|
|
|
|
```
|
|
bmad-javascript-fullstack/
|
|
├── workflows/ # 4 optimized workflows
|
|
├── agents/ # Specialized AI agents
|
|
├── tools/ # Token tracking & analytics
|
|
├── data/ # Modular principles & guides
|
|
├── templates/ # Checkpoint & story templates
|
|
├── tasks/ # Reusable tasks
|
|
├── checklists/ # Quality checklists
|
|
└── README.md # This file
|
|
```
|
|
|
|
## 📈 Metrics
|
|
|
|
| Metric | Value |
|
|
|--------|-------|
|
|
| Workflows | 4 (down from 10+) |
|
|
| Token efficiency | 30% reduction |
|
|
| Selection time | 30 seconds |
|
|
| Parallel execution | 40% of tasks |
|
|
| Checkpoint compression | 80%+ |
|
|
|
|
## 🚦 Getting Started
|
|
|
|
1. **Read**: [START-HERE.md](START-HERE.md)
|
|
2. **Choose**: [workflows/INDEX.md](workflows/INDEX.md)
|
|
3. **Execute**: Follow your workflow YAML
|
|
4. **Track**: Use tools for monitoring
|
|
5. **Test**: [WORKFLOW-TESTING-GUIDE.md](WORKFLOW-TESTING-GUIDE.md)
|
|
|
|
## 💡 Pro Tips
|
|
|
|
- Start with essential-principles.md (300 tokens)
|
|
- Load guides JIT at decision points
|
|
- Create checkpoints after every phase
|
|
- Use parallel execution for speed
|
|
- Monitor tokens with runtime tracker
|
|
|
|
## 📦 Stack Recommendations
|
|
|
|
- **Frontend**: Next.js 14, Vite + React
|
|
- **Backend**: Express, Fastify, NestJS
|
|
- **Database**: PostgreSQL + Prisma
|
|
- **Auth**: NextAuth, Supabase Auth
|
|
- **Deploy**: Vercel, Railway, Fly.io
|
|
|
|
## 🔗 Quick Links
|
|
|
|
- [Workflow Selection](workflows/INDEX.md) - 30-second choice
|
|
- [Testing Guide](WORKFLOW-TESTING-GUIDE.md) - Validate workflows
|
|
- [Complete Guide](BMAD-COMPLETE-GUIDE.md) - Full documentation
|
|
- [Token Tools](tools/) - Efficiency utilities
|
|
|
|
---
|
|
|
|
**Built with BMAD™ Core | Optimized for Production** |