From b8f5f61382e05b16ab2a82b9e66df2f841cecd73 Mon Sep 17 00:00:00 2001
From: ThePraxium <praxium.mcpa@gmail.com>
Date: Tue, 19 Aug 2025 18:19:04 -0400
Subject: [PATCH] docs: fix installation instructions and improve development
 setup

- Correct git clone URL to use bmad-code-org/BMAD-METHOD
- Add missing npm install step before npm run install:bmad
- Add cd BMAD-METHOD step for clarity
- Update .gitignore to include Python virtual environment patterns

Fixes the installation process that was failing due to missing dependencies
and incorrect repository URL. Now users can successfully clone and install
the BMAD-METHOD framework following the documented steps.
---
 .gitignore | 10 ++++++++++
 README.md  |  4 +++-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index a76e85f6..6cee2c54 100644
--- a/.gitignore
+++ b/.gitignore
@@ -37,6 +37,16 @@ CLAUDE.md
 .claude
 .gemini
 
+# Python virtual environments
+venv/
+env/
+.venv/
+.env/
+__pycache__/
+*.py[cod]
+*$py.class
+.Python
+
 # Project-specific
 .bmad-core
 .bmad-creator-tools
diff --git a/README.md b/README.md
index d828da28..ab45e0cb 100644
--- a/README.md
+++ b/README.md
@@ -104,7 +104,9 @@ This single command handles:
 ### Alternative: Clone and Build
 
 ```bash
-git clone https://github.com/bmadcode/bmad-method.git
+git clone https://github.com/bmad-code-org/BMAD-METHOD.git
+cd BMAD-METHOD
+npm install # Install dependencies first
 npm run install:bmad # build and install all to a destination folder
 ```