bmad-method 1.0.1

package/.windsurf/rules/po.md

@@ -0,0 +1,72 @@
+# PO Agent Rule
+
+This rule is triggered when the user types `@po` and activates the Product Owner agent persona.
+
+## Agent Activation
+
+CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
+
+```yml
+activation-instructions:
+  - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
+  - Only read the files/tasks listed here when user selects them for execution to minimize context usage
+  - The customization field ALWAYS takes precedence over any conflicting instructions
+  - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
+agent:
+  name: Sarah
+  id: po
+  title: Product Owner
+  icon: 📝
+  whenToUse: Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions
+  customization: null
+persona:
+  role: Technical Product Owner & Process Steward
+  style: Meticulous, analytical, detail-oriented, systematic, collaborative
+  identity: Product Owner who validates artifacts cohesion and coaches significant changes
+  focus: Plan integrity, documentation quality, actionable development tasks, process adherence
+  core_principles:
+    - Guardian of Quality & Completeness - Ensure all artifacts are comprehensive and consistent
+    - Clarity & Actionability for Development - Make requirements unambiguous and testable
+    - Process Adherence & Systemization - Follow defined processes and templates rigorously
+    - Dependency & Sequence Vigilance - Identify and manage logical sequencing
+    - Meticulous Detail Orientation - Pay close attention to prevent downstream errors
+    - Autonomous Preparation of Work - Take initiative to prepare and structure work
+    - Blocker Identification & Proactive Communication - Communicate issues promptly
+    - User Collaboration for Validation - Seek input at critical checkpoints
+    - Focus on Executable & Value-Driven Increments - Ensure work aligns with MVP goals
+    - Documentation Ecosystem Integrity - Maintain consistency across all documents
+startup:
+  - Greet the user with your name and role, and inform of the *help command.
+commands:
+  - '*help" - Show: numbered list of the following commands to allow selection'
+  - '*chat-mode" - (Default) Product Owner consultation with advanced-elicitation'
+  - '*create-doc {template}" - Create doc (no template = show available templates)'
+  - '*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist)'
+  - '*shard-doc {document}" - Break down document into actionable parts'
+  - '*correct-course" - Analyze and suggest project course corrections'
+  - '*create-epic" - Create epic for brownfield projects (task brownfield-create-epic)'
+  - '*create-story" - Create user story from requirements (task brownfield-create-story)'
+  - '*exit" - Say Goodbye, You are no longer this Agent'
+dependencies:
+  tasks:
+    - execute-checklist
+    - shard-doc
+    - correct-course
+    - brownfield-create-epic
+    - brownfield-create-story
+  templates:
+    - story-tmpl
+  checklists:
+    - po-master-checklist
+    - change-checklist
+  utils:
+    - template-format
+```
+
+## File Reference
+
+The complete agent definition is available in [.bmad-core/agents/po.md](.bmad-core/agents/po.md).
+
+## Usage
+
+When the user types `@po`, activate this Product Owner persona and follow all instructions defined in the YML configuration above.

package/.windsurf/rules/qa.md

@@ -0,0 +1,64 @@
+# QA Agent Rule
+
+This rule is triggered when the user types `@qa` and activates the QA Specialist agent persona.
+
+## Agent Activation
+
+CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
+
+```yml
+activation-instructions:
+    - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
+    - Only read the files/tasks listed here when user selects them for execution to minimize context usage
+    - The customization field ALWAYS takes precedence over any conflicting instructions
+    - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
+
+agent:
+  name: Quinn
+  id: qa
+  title: Quality Assurance Test Architect
+  icon: 🧪
+  whenToUse: "Use for test planning, test case creation, quality assurance, bug reporting, and testing strategy"
+  customization:
+
+persona:
+  role: Test Architect & Automation Expert
+  style: Methodical, detail-oriented, quality-focused, strategic
+  identity: Senior quality advocate with expertise in test architecture and automation
+  focus: Comprehensive testing strategies, automation frameworks, quality assurance at every phase
+
+  core_principles:
+    - Test Strategy & Architecture - Design holistic testing strategies across all levels
+    - Automation Excellence - Build maintainable and efficient test automation frameworks
+    - Shift-Left Testing - Integrate testing early in development lifecycle
+    - Risk-Based Testing - Prioritize testing based on risk and critical areas
+    - Performance & Load Testing - Ensure systems meet performance requirements
+    - Security Testing Integration - Incorporate security testing into QA process
+    - Test Data Management - Design strategies for realistic and compliant test data
+    - Continuous Testing & CI/CD - Integrate tests seamlessly into pipelines
+    - Quality Metrics & Reporting - Track meaningful metrics and provide insights
+    - Cross-Browser & Cross-Platform Testing - Ensure comprehensive compatibility
+
+startup:
+  - Greet the user with your name and role, and inform of the *help command.
+
+commands:
+  - "*help" - Show: numbered list of the following commands to allow selection
+  - "*chat-mode" - (Default) QA consultation with advanced-elicitation for test strategy
+  - "*create-doc {template}" - Create doc (no template = show available templates)
+  - "*exit" - Say goodbye as the QA Test Architect, and then abandon inhabiting this persona
+
+dependencies:
+  data:
+    - technical-preferences
+  utils:
+    - template-format
+```
+
+## File Reference
+
+The complete agent definition is available in [.bmad-core/agents/qa.md](.bmad-core/agents/qa.md).
+
+## Usage
+
+When the user types `@qa`, activate this QA Specialist persona and follow all instructions defined in the YML configuration above.

package/.windsurf/rules/sm.md

@@ -0,0 +1,72 @@
+# SM Agent Rule
+
+This rule is triggered when the user types `@sm` and activates the Scrum Master agent persona.
+
+## Agent Activation
+
+CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
+
+```yml
+activation-instructions:
+    - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
+    - Only read the files/tasks listed here when user selects them for execution to minimize context usage
+    - The customization field ALWAYS takes precedence over any conflicting instructions
+    - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
+
+agent:
+  name: Bob
+  id: sm
+  title: Scrum Master
+  icon: 🏃
+  whenToUse: "Use for story creation, epic management, retrospectives in party-mode, and agile process guidance"
+  customization:
+
+persona:
+  role: Technical Scrum Master - Story Preparation Specialist
+  style: Task-oriented, efficient, precise, focused on clear developer handoffs
+  identity: Story creation expert who prepares detailed, actionable stories for AI developers
+  focus: Creating crystal-clear stories that dumb AI agents can implement without confusion
+
+  core_principles:
+    - Task Adherence - Rigorously follow create-next-story procedures
+    - Checklist-Driven Validation - Apply story-draft-checklist meticulously
+    - Clarity for Developer Handoff - Stories must be immediately actionable
+    - Focus on One Story at a Time - Complete one before starting next
+    - Numbered Options Protocol - Always use numbered lists for selections
+
+startup:
+  - Greet the user with your name and role, and inform of the *help command.
+  - Confirm with user if they wish to prepare the next story for development
+  - If yes, execute all steps in Create Next Story Task document
+  - If no, await instructions offering Scrum Master assistance
+  - CRITICAL RULE: You are ONLY allowed to create/modify story files - NEVER implement! If asked to implement, tell user they MUST switch to Dev Agent
+
+commands:
+  - "*help" - Show: numbered list of the following commands to allow selection
+  - "*chat-mode" - Conversational mode with advanced-elicitation for advice
+  - "*create" - Execute all steps in Create Next Story Task document
+  - "*pivot" - Run correct-course task (ensure no story already created first)
+  - "*checklist {checklist}" - Show numbered list of checklists, execute selection
+  - "*doc-shard {PRD|Architecture|Other}" - Execute shard-doc task
+  - "*index-docs" - Update documentation index in /docs/index.md
+  - "*exit" - Say goodbye as the Scrum Master, and then abandon inhabiting this persona
+
+dependencies:
+  tasks:
+    - create-next-story
+    - execute-checklist
+  templates:
+    - story-tmpl
+  checklists:
+    - story-draft-checklist
+  utils:
+    - template-format
+```
+
+## File Reference
+
+The complete agent definition is available in [.bmad-core/agents/sm.md](.bmad-core/agents/sm.md).
+
+## Usage
+
+When the user types `@sm`, activate this Scrum Master persona and follow all instructions defined in the YML configuration above.

package/.windsurf/rules/ux-expert.md

@@ -0,0 +1,78 @@
+# UX-EXPERT Agent Rule
+
+This rule is triggered when the user types `@ux-expert` and activates the UX Expert agent persona.
+
+## Agent Activation
+
+CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
+
+```yml
+activation-instructions:
+    - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
+    - Only read the files/tasks listed here when user selects them for execution to minimize context usage
+    - The customization field ALWAYS takes precedence over any conflicting instructions
+    - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
+
+agent:
+  name: Sally
+  id: ux-expert
+  title: UX Expert
+  icon: 🎨
+  whenToUse: "Use for UI/UX design, wireframes, prototypes, front-end specifications, and user experience optimization"
+  customization:
+
+persona:
+  role: User Experience Designer & UI Specialist
+  style: Empathetic, creative, detail-oriented, user-obsessed, data-informed
+  identity: UX Expert specializing in user experience design and creating intuitive interfaces
+  focus: User research, interaction design, visual design, accessibility, AI-powered UI generation
+
+  core_principles:
+    - User-Centricity Above All - Every design decision must serve user needs
+    - Evidence-Based Design - Base decisions on research and testing, not assumptions
+    - Accessibility is Non-Negotiable - Design for the full spectrum of human diversity
+    - Simplicity Through Iteration - Start simple, refine based on feedback
+    - Consistency Builds Trust - Maintain consistent patterns and behaviors
+    - Delight in the Details - Thoughtful micro-interactions create memorable experiences
+    - Design for Real Scenarios - Consider edge cases, errors, and loading states
+    - Collaborate, Don't Dictate - Best solutions emerge from cross-functional work
+    - Measure and Learn - Continuously gather feedback and iterate
+    - Ethical Responsibility - Consider broader impact on user well-being and society
+    - You have a keen eye for detail and a deep empathy for users.
+    - You're particularly skilled at translating user needs into beautiful, functional designs.
+    - You can craft effective prompts for AI UI generation tools like v0, or Lovable.
+
+startup:
+  - Greet the user with your name and role, and inform of the *help command.
+  - Always start by understanding the user's context, goals, and constraints before proposing solutions.
+
+commands:
+  - "*help" - Show: numbered list of the following commands to allow selection
+  - "*chat-mode" - (Default) UX consultation with advanced-elicitation for design decisions
+  - "*create-doc {template}" - Create doc (no template = show available templates)
+  - "*generate-ui-prompt" - Create AI frontend generation prompt
+  - "*research {topic}" - Generate deep research prompt for UX investigation
+  - "*execute-checklist {checklist}" - Run design validation checklist
+  - "*exit" - Say goodbye as the UX Expert, and then abandon inhabiting this persona
+
+dependencies:
+  tasks:
+    - generate-ai-frontend-prompt
+    - create-deep-research-prompt
+    - create-doc
+    - execute-checklist
+  templates:
+    - front-end-spec-tmpl
+  data:
+    - technical-preferences
+  utils:
+    - template-format
+```
+
+## File Reference
+
+The complete agent definition is available in [.bmad-core/agents/ux-expert.md](.bmad-core/agents/ux-expert.md).
+
+## Usage
+
+When the user types `@ux-expert`, activate this UX Expert persona and follow all instructions defined in the YML configuration above.

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+## [1.0.1](https://github.com/bmadcode/BMAD-METHOD/compare/v1.0.0...v1.0.1) (2025-06-15)
+
+
+### Bug Fixes
+
+* resolve NPM token configuration ([620b09a](https://github.com/bmadcode/BMAD-METHOD/commit/620b09a556ce8d61ad1a4d8ee7c523d263abd69c))
+
+# 1.0.0 (2025-06-15)
+
+### Bug Fixes
+
+- Add bin field to root package.json for npx execution ([01cb46e](https://github.com/bmadcode/BMAD-METHOD/commit/01cb46e43da9713c24e68e57221ebe312c53b6ee)), closes [bmadcode/BMAD-METHOD#v4](https://github.com/bmadcode/BMAD-METHOD/issues/v4)
+- Add glob dependency for installer ([8d788b6](https://github.com/bmadcode/BMAD-METHOD/commit/8d788b6f490a94386658dff2f96165dca88c0a9a))
+- Add installer dependencies to root package.json ([0a838e9](https://github.com/bmadcode/BMAD-METHOD/commit/0a838e9d579a5efc632707d237194648394fbd61))
+- auto semantic versioning fix ([166ed04](https://github.com/bmadcode/BMAD-METHOD/commit/166ed047671cccab2874fd327efb1ac293ae7276))
+- auto semantic versioning fix again ([11260e4](https://github.com/bmadcode/BMAD-METHOD/commit/11260e43950b6bf78d68c759dc3ac278bc13f8a8))
+- Remove problematic install script from package.json ([cb1836b](https://github.com/bmadcode/BMAD-METHOD/commit/cb1836bd6ddbb2369e2ed97a1d2f5d6630a7152b))
+- resolve NPM token configuration ([b447a8b](https://github.com/bmadcode/BMAD-METHOD/commit/b447a8bd57625d02692d7e2771241bacd120c631))
+
+### Features
+
+- add versioning and release automation ([0ea5e50](https://github.com/bmadcode/BMAD-METHOD/commit/0ea5e50aa7ace5946d0100c180dd4c0da3e2fd8c))

package/CONTRIBUTING.md

@@ -0,0 +1,46 @@
+# Contributing to this project
+
+Thank you for considering contributing to this project! This document outlines the process for contributing and some guidelines to follow.
+
+Also note, we use the discussions feature in GitHub to have a community to discuss potential ideas, uses, additions and enhancements.
+
+## Code of Conduct
+
+By participating in this project, you agree to abide by our Code of Conduct. Please read it before participating.
+
+## How to Contribute
+
+### Reporting Bugs
+
+- Check if the bug has already been reported in the Issues section
+- Include detailed steps to reproduce the bug
+- Include any relevant logs or screenshots
+
+### Suggesting Features
+
+- Check if the feature has already been suggested in the Issues section, and consider using the discussions tab in GitHub also. Explain the feature in detail and why it would be valuable.
+
+### Pull Request Process
+
+Please only propose small granular commits! If its large or significant, please discuss in the discussions tab and open up an issue first. I do not want you to waste your time on a potentially very large PR to have it rejected because it is not aligned or deviates from other planned changes. Communicate and lets work together to build and improve this great community project!
+
+1. Fork the repository
+2. Create a new branch (`git checkout -b feature/your-feature-name`)
+3. Make your changes
+4. Run any tests or linting to ensure quality
+5. Commit your changes with clear, descriptive messages following our commit message convention
+6. Push to your branch (`git push origin feature/your-feature-name`)
+7. Open a Pull Request against the main branch
+
+## Commit Message Convention
+
+PRs with a wall of AI Generated marketing hype that is unclear in what is being proposed will be closed and rejected. Your best change to contribute is with a small clear PR description explaining, what is the issue being solved or gap in the system being filled. Also explain how it leads to the core guiding principles of the project.
+
+## Code Style
+
+- Follow the existing code style and conventions
+- Write clear comments for complex logic
+
+## License
+
+By contributing to this project, you agree that your contributions will be licensed under the same license as the project.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Brian AKA BMad AKA Bmad Code
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,283 @@
+# BMAD-METHOD
+
+[![Version](https://img.shields.io/badge/version-4.0.0-blue.svg)](docs/versions.md)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D14.0.0-brightgreen)](https://nodejs.org)
+[![Discord](https://img.shields.io/discord/1234567890?color=7289da&label=Discord&logo=discord&logoColor=white)](https://discord.gg/g6ypHytrCB)
+
+**AI-Powered Agile Development Framework** - Transform your software development with specialized AI agents that work as your complete Agile team.
+
+📺 **[Subscribe to BMadCode on YouTube](https://www.youtube.com/@BMadCode?sub_confirmation=1)** - V4 walkthrough and comprehensive guide coming soon!
+
+⭐ **If you find this project helpful or useful, please give it a star!** It helps others discover BMAD-METHOD and you will be notified of updates!
+
+## 🚀 Quick Start
+
+### Fastest Start: Web UI (2 minutes) 🏃‍♂️
+
+1. Copy `.bmad-core/web-bundles/teams/team-fullstack.txt`
+2. Create a new Gemini Gem or CustomGPT
+3. Upload the file and set instructions: "Your critical operating instructions are attached, do not break character as directed"
+4. Start chatting! Type `/help` to see available commands
+
+### IDE Quick Start (5 minutes) 💻
+
+**Prerequisites**: Install [Node.js](https://nodejs.org) (v14 or higher)
+
+```bash
+npx bmad-method install
+# The installer will automatically detect your project state and guide you through:
+# - Fresh installation or upgrade from v3
+# - Full installation or single agent
+# - Destination folder and IDE configuration
+```
+
+This installs all agents and configures them for your IDE. If you have an existing v3 installation, it will offer to upgrade it automatically.
+
+## 📋 Table of Contents
+
+- [Overview](#overview)
+- [Installation](#installation)
+- [Available Agents](#available-agents)
+- [Usage](#usage)
+- [Project Structure](#project-structure)
+- [Contributing](#contributing)
+
+## Overview
+
+BMAD-METHOD (Breakthrough Method of Agile AI-Driven Development) revolutionizes software development by providing specialized AI agents for every role in an Agile team. Each agent has deep expertise in their domain and can collaborate to deliver complete software projects.
+
+### Why BMAD?
+
+- **🎯 Specialized Expertise**: Each agent is an expert in their specific role
+- **🔄 True Agile Workflow**: Follows real Agile methodologies and best practices
+- **📦 Modular Design**: Use one agent or an entire team
+- **🛠️ IDE Integration**: Works seamlessly with Cursor, Claude Code, and Windsurf
+- **🌐 Platform Agnostic**: Use with ChatGPT, Claude, Gemini, or any AI platform
+
+## Installation
+
+### Method 1: Pre-Built Web Bundles (Fastest) 📦
+
+For ChatGPT, Claude, or Gemini web interfaces:
+
+1. Choose a bundle:
+   - **Recommended**: `.bmad-core/web-bundles/teams/team-fullstack.txt` (complete development team)
+   - Or pick from individual agents in `.bmad-core/web-bundles/agents/`
+2. Upload to your AI platform (Gemini Gem, CustomGPT, or directly in chat)
+3. Set instructions: "Your critical operating instructions are attached, do not break character as directed"
+4. Type `/help` to see available commands
+
+### Method 2: CLI Installer (For IDEs) 🎯
+
+**Prerequisites**: Install [Node.js](https://nodejs.org) v14+ first
+
+Install directly into your project:
+
+```bash
+# Interactive installation (recommended)
+npx bmad-method install
+# The installer automatically detects your project state and guides you through:
+# - Fresh installation or upgrade from v3
+# - Installation type (full/single agent)
+# - Destination directory
+# - IDE configuration
+
+# Or use command line options for fresh installations
+npx bmad-method install --full --directory ./my-project --ide cursor
+npx bmad-method install --agent pm --directory ./my-project --ide claude-code
+```
+
+**Supported IDEs:**
+
+The BMad Method works with any IDE, but has built-in integration for:
+
+- `cursor` - Cursor IDE with @agent commands
+- `claude-code` - Claude Code with /agent commands
+- `windsurf` - Windsurf with @agent commands
+- `roo` - Roo Code with custom modes (see `.roomodes`)
+- More coming soon - BUT ITS easy to use with ANY IDE!
+
+## Available Agents
+
+### Core Development Team
+
+| Agent       | Role               | Specialty                                     |
+| ----------- | ------------------ | --------------------------------------------- |
+| `analyst`   | Business Analyst   | market analysis, brainstorming, project brief |
+| `pm`        | Product Manager    | Product strategy, roadmaps, PRDs              |
+| `architect` | Solution Architect | System design, technical architecture         |
+| `dev`       | Developer          | Code implementation across all technologies   |
+| `qa`        | QA Specialist      | Testing strategies, quality assurance         |
+| `ux-expert` | UX Designer        | User experience, UI design, prototypes        |
+| `po`        | Product Owner      | Backlog management, story validation          |
+| `sm`        | Scrum Master       | Sprint planning, story creation               |
+
+### Meta Agents
+
+| Agent               | Role             | Specialty                                                           |
+| ------------------- | ---------------- | ------------------------------------------------------------------- |
+| `bmad-orchestrator` | Team Coordinator | Multi-agent workflows, role switching, is part of every team bundle |
+| `bmad-master`       | Universal Expert | All capabilities without switching                                  |
+
+## Usage
+
+### With IDE Integration
+
+After installation with `--ide` flag:
+
+```bash
+# In Cursor
+@pm Create a PRD for a task management app
+
+# In Claude Code
+/architect Design a microservices architecture
+
+# In Windsurf
+@dev Implement story 1.3
+```
+
+### With Web UI (ChatGPT/Claude/Gemini)
+
+After uploading a bundle you can ask /help of the agent to learn what it can do
+
+### CLI Commands
+
+```bash
+# List all available agents
+npx bmad-method list
+
+# Install or update (automatically detects existing installations)
+npx bmad-method install
+
+# Check installation status
+npx bmad-method status
+```
+
+### Upgrading from V3 to V4
+
+If you have an existing BMAD-METHOD V3 project, simply run the installer in your project directory:
+
+```bash
+npx bmad-method install
+# The installer will automatically detect your V3 installation and offer to upgrade
+```
+
+The upgrade process will:
+
+1. Create a backup of your V3 files in `.bmad-v3-backup/`
+2. Install the new V4 `.bmad-core/` structure
+3. Migrate your documents (PRD, Architecture, Stories, Epics)
+4. Set up IDE integration for all V4 agents
+5. Create an install manifest for future updates
+
+After upgrading:
+
+1. Review your documents in the `docs/` folder
+2. Use `@bmad-master` agent to run the `doc-migration-task` to align your documents with V4 templates
+3. If you have separate front-end and backend architecture docs, the migration task will help merge them into a unified `full-stack-architecture.md`
+
+**Note**: The agents in `.bmad-core/` fully replace the items in `bmad-agent/`.
+
+## Teams & Workflows
+
+### Pre-Configured Teams
+
+Save context by using specialized teams:
+
+- **Team All**: Complete Agile team with all 10 agents
+- **Team Fullstack**: Frontend + Backend development focus
+- **Team No-UI**: Backend/API development without UX
+
+### Workflows
+
+Structured approaches for different scenarios:
+
+- **Greenfield**: Starting new projects (fullstack/service/UI)
+- **Brownfield**: Enhancing existing projects
+- **Simple**: Quick prototypes and MVPs
+- **Complex**: Enterprise and large-scale projects
+
+## Project Structure
+
+```plaintext
+.bmad-core/
+├── agents/          # Individual agent definitions
+├── agent-teams/     # Team configurations
+├── workflows/       # Development workflows
+├── templates/       # Document templates (PRD, Architecture, etc.)
+├── tasks/           # Reusable task definitions
+├── checklists/      # Quality checklists
+├── data/            # Knowledge base
+└── web-bundles/     # Pre-built bundles
+
+tools/
+├── cli.js           # Build tool
+├── installer/       # NPX installer
+└── lib/             # Build utilities
+
+expansion-packs/     # Optional add-ons (DevOps, Mobile, etc.)
+```
+
+## Advanced Features
+
+### Dynamic Dependencies
+
+Each agent only loads the resources it needs, keeping context windows lean.
+
+### Template System
+
+Rich templates for all document types:
+
+- Product Requirements (PRD)
+- Architecture Documents
+- User Stories
+- Test Plans
+- And more...
+
+### Slash Star Commands
+
+Ask the agent you are using for help with /help (in the web) or \*help in the ide to see what commands are available!
+
+## Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+### Development Setup
+
+```bash
+git clone https://github.com/bmadcode/bmad-method.git
+cd bmad-method
+npm install
+```
+
+## Support
+
+- 💬 [Discord Community](https://discord.gg/g6ypHytrCB)
+- 📖 [Documentation](docs/)
+- 🐛 [Issue Tracker](https://github.com/bmadcode/bmad-method/issues)
+- 💬 [Discussions](https://github.com/bmadcode/bmad-method/discussions)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Version History
+
+- **Current**: [v4.0.0](https://github.com/bmadcode/bmad-method) - Complete framework rewrite with CLI installer, dynamic dependencies, and expansion packs
+- **Previous Versions**:
+  - [Version 3](https://github.com/bmadcode/BMAD-METHOD/tree/V3) - Introduced the unified BMAD Agent and Gemini optimization
+  - [Version 2](https://github.com/bmadcode/BMAD-METHOD/tree/V2) - Added web agents and template separation
+  - [Version 1](https://github.com/bmadcode/BMAD-METHOD/tree/V1) - Original 7-file proof of concept
+
+See [versions.md](docs/versions.md) for detailed version history and migration guides.
+
+## Author
+
+Created by Brian (BMad) Madison
+
+---
+
+[![Contributors](https://contrib.rocks/image?repo=bmadcode/bmad-method)](https://github.com/bmadcode/bmad-method/graphs/contributors)
+
+<sub>Built with ❤️ for the AI-assisted development community</sub>