fix: auto semantic versioning fix

.releaserc.json

@@ -0,0 +1,17 @@
+{
+  "branches": ["main"],
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/changelog",
+    "@semantic-release/npm",
+    [
+      "@semantic-release/git",
+      {
+        "assets": ["package.json", "package-lock.json", "CHANGELOG.md"],
+        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+      }
+    ],
+    "@semantic-release/github"
+  ]
+}

docs/versioning-and-releases.md

@@ -1,38 +1,85 @@
 # How to Release a New Version
 
-## Simple steps for releasing a new version of BMAD-METHOD
+## Automated Releases (Recommended)
+
+The easiest way to release new versions is through **automatic semantic releases**. Just commit with the right message format and push - everything else happens automatically!
+
+### Commit Message Format
+
+Use these prefixes to control what type of release happens:
 
 ```bash
-# 1. Commit all changes
-git add .
-git commit -m "feat: add versioning and release automation"
-
-# 2. Bump version
-npm run version:minor  # 4.0.0 → 4.1.0
-
-# 3. Push to GitHub (when ready)
-git push && git push --tags
+fix: resolve CLI argument parsing bug      # → patch release (4.1.0 → 4.1.1)
+feat: add new agent orchestration mode     # → minor release (4.1.0 → 4.2.0)
+feat!: redesign CLI interface              # → major release (4.1.0 → 5.0.0)
 ```text
 
-## Available Commands
+### What Happens Automatically
+
+When you push commits with `fix:` or `feat:`, GitHub Actions will:
+
+1. ✅ Analyze your commit messages
+2. ✅ Bump version in `package.json`
+3. ✅ Generate changelog
+4. ✅ Create git tag
+5. ✅ **Publish to NPM automatically**
+6. ✅ Create GitHub release with notes
+
+### Your Simple Workflow
+
+```bash
+# Make your changes
+git add .
+git commit -m "feat: add team collaboration mode"
+git push
+
+# That's it! Release happens automatically 🎉
+# Users can now run: npx bmad-method (and get the new version)
+```
+
+### Commits That DON'T Trigger Releases
+
+These commit types won't create releases (use them for maintenance):
+
+```bash
+chore: update dependencies     # No release
+docs: fix typo in readme      # No release
+style: format code            # No release
+test: add unit tests          # No release
+```text
+
+### Test Your Setup
+
+```bash
+npm run release:test    # Safe to run locally - tests the config
+```
+
+---
+
+## Manual Release Methods (Exceptions Only)
+
+**⚠️ Only use these methods if you need to bypass the automatic system**
+
+### Quick Manual Version Bump
 
 ```bash
 npm run version:patch   # 4.1.0 → 4.1.1 (bug fixes)
 npm run version:minor   # 4.1.0 → 4.2.0 (new features)
 npm run version:major   # 4.1.0 → 5.0.0 (breaking changes)
-```
 
-## What the Version Bump Does
-
-1. Updates `package.json` version
-2. Creates git commit: `chore: bump version to vX.Y.Z`
-3. Creates git tag: `vX.Y.Z`
-4. Shows reminder to push
-
-## To Publish to NPM (Optional)
-
-```bash
+# Then manually publish:
 npm publish
+git push && git push --tags
 ```
 
-Then users can run: `npx bmad-method` to get the new version.
+### Manual GitHub Actions Trigger
+
+You can also trigger releases manually through GitHub Actions workflow dispatch if needed.
+
+---
+
+## Summary
+
+**For 99% of releases**: Just use `fix:` or `feat:` commit messages and push. Everything else is automatic!
+
+**Manual methods**: Only needed for special cases or if you want to bypass the automated system.

package.json

@@ -18,6 +18,8 @@
     "version:patch": "node tools/version-bump.js patch",
     "version:minor": "node tools/version-bump.js minor",
     "version:major": "node tools/version-bump.js major",
+    "release": "semantic-release",
+    "release:test": "semantic-release --dry-run --no-ci || echo 'Config test complete - authentication errors are expected locally'",
     "prepare": "husky"
   },
   "dependencies": {
@@ -43,7 +45,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/your-org/bmad-method.git"
+    "url": "https://github.com/bmadcode/BMAD-METHOD.git"
   },
   "engines": {
     "node": ">=14.0.0"
@@ -52,6 +54,9 @@
     "husky": "^9.1.7",
     "lint-staged": "^16.1.1",
     "prettier": "^3.5.3",
+    "semantic-release": "^22.0.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
     "yaml-lint": "^1.7.0"
   },
   "lint-staged": {