Fawndel BMAD Framework

Initialize OSS Research Analyst with preferred tech stack in any project.

Quick Start

For Future Projects

# Using bun (recommended - matches our tech stack)
bunx fawndel-bmad install

# Or using npx
npx fawndel-bmad install

What Gets Installed

• OSS Research Analyst Agent - Enhanced with your preferred tech stack evaluation
• Tech Stack Preferences - Bun, TypeScript, React/Next.js, Supabase, Tailwind, etc.
• Evaluation Framework - Standardized reports for OSS project assessment
• BMAD System - Full agent orchestration platform

Commands

# Install framework in current project
fawndel-bmad install

# Install framework only (skip BMAD system)
fawndel-bmad install --skip-bmad

# Force overwrite existing configuration
fawndel-bmad install --force

# Check installation status
fawndel-bmad status

Tech Stack Integration

The analyst agent prioritizes projects that align with:

Foundation

• Bun - Runtime + package manager
• TypeScript - Language (web + mobile)

Mobile (React Native)

• Expo - React Native framework with routing
• NativeWind - Tailwind for React Native
• React Native Paper - UI component library
• Phosphor React Native - Icons

Web

• Next.js 14 (App Router) - Full-stack React framework
• Tailwind CSS - Styling
• TailAdmin - Admin dashboard components
• Phosphor React - Icons

Shared (Web + Mobile)

• Zustand - State management
• TanStack Query - Data fetching/caching
• React Hook Form - Form handling
• Zod - Validation schemas
• Supabase JS Client - Backend API client

Backend

• Supabase - Database (Postgres), Auth, Storage, APIs

Deployment

• Vercel - Web hosting
• EAS (Expo Application Services) - Mobile app builds/deployment

OSS Research Features

Agent Commands

• evaluate-oss - Single project evaluation with tech stack alignment
• compare-oss - Multi-project comparison with matrix analysis
• oss-due-diligence - Comprehensive enterprise adoption workflow

Evaluation Framework

• Technical Fit (40%) - Weighted toward tech stack alignment
• Community Health (25%) - Activity, responsiveness, documentation
• Maintainability (20%) - Code quality, testing, CI/CD
• Customization Potential (15%) - Extension points, integration ease

Report Formats

• Evaluation Reports - Detailed scoring with migration estimates
• Comparison Reports - Matrix analysis with final recommendations
• Tech Stack Alignment - Explicit assessment of fit with preferred tools

Development

Building the Installer

# Install dependencies
bun install

# Build for distribution
bun run build

# Development with watch mode
bun run dev

Publishing

# Build and publish to npm
npm publish

# Or with bun
bun publish

Project Structure

fawndel-BMAD/
├── _cfg/                    # Framework configuration
│   └── agents/
│       └── bmm-analyst.customize.yaml  # OSS Research customization
├── src/                     # Installer source code
│   ├── index.ts            # CLI entry point
│   └── installer.ts        # Installation logic
├── dist/                   # Built installer
├── package.json           # Package configuration
└── README.md             # This file

License

MIT