feat: v6.0.0-alpha.0 - the future is now

docs/installers-bundlers/web-bundler-usage.md

@@ -0,0 +1,54 @@
+# Web Bundler Usage
+
+ALPHA NOTE: Bundling of individual agents might work, team bundling is being reworked and will come with Beta release soon.
+
+The web bundler creates self-contained XML bundles for BMAD agents, packaging all dependencies for web deployment.
+
+## Quick Start
+
+```bash
+# Bundle all agents from all modules
+npm run bundle
+
+# Clean and rebundle (removes old bundles first)
+npm run rebundle
+```
+
+## Custom Output Directory
+
+```bash
+# Bundle to custom directory
+node tools/cli/bundlers/bundle-web.js all --output ./my-bundles
+
+# Rebundle to custom directory (auto-cleans first)
+node tools/cli/bundlers/bundle-web.js rebundle --output /absolute/path/to/custom/directory
+
+# Bundle specific module to custom directory
+node tools/cli/bundlers/bundle-web.js module bmm --output ./custom-folder
+
+# Bundle specific agent to custom directory
+node tools/cli/bundlers/bundle-web.js agent bmm analyst -o ./custom-folder
+```
+
+## Output
+
+Bundles are generated in `web-bundles/` directory by default when run from the root of the clones project:
+
+```
+web-bundles/
+├── [module-name]/
+│   └── agents/
+│       └── [agent-name].xml
+```
+
+## Skipping Agents
+
+Agents with `bundle="false"` attribute are automatically skipped during bundling.
+
+## Bundle Contents
+
+Each bundle includes:
+
+- Agent definition with web activation
+- All resolved dependencies
+- Manifests for agent/team discovery