docs: updating docs references

Author: dionmaicon

README.md

@@ -38,14 +38,12 @@ npm install -g packdev
 
 3. **Switch to development mode**:
    ```bash
-   packdev init
-   npm install
+   packdev init  # Automatically runs npm/yarn/pnpm install
    ```
 
 4. **Restore production versions**:
    ```bash
-   packdev finish
-   npm install
+   packdev finish  # Automatically runs npm/yarn/pnpm install
    ```
 
 📖 **[Full Quick Start Guide →](docs/QUICK-START.md)**
@@ -77,17 +75,40 @@ Develop a library alongside your app:
 ```bash
 # In your app directory
 packdev add my-utils ../my-utils
-packdev init
-npm install
+packdev init  # Automatically installs dependencies
 
 # Make changes to ../my-utils
 # Test immediately in your app
 # Changes reflect instantly (no rebuild needed for JS)
 
-packdev finish  # When ready for production
+packdev finish  # Automatically restores and reinstalls
 ```
 
-### Example 2: Git Auto-Commit Safety Hook
+### Example 2: Clean Git Branch Switching
+
+Avoid merge conflicts and "uncommitted changes" when switching branches:
+
+```bash
+# Working with local dependencies
+packdev init  # Development mode active
+
+# Need to switch branches?
+packdev finish  # Clean package.json instantly
+
+# Switch freely without conflicts
+git checkout main  # ✅ No blocking warnings
+git checkout feature/other-work  # ✅ Clean switching
+
+# Back to your branch
+git checkout feature/your-work
+packdev init  # Resume local development
+```
+
+**Benefits**: No package.json conflicts, clean git status, fast context switching
+
+📖 **[Git Workflows →](docs/WORKFLOW.md#git-branch-switching)**
+
+### Example 3: Git Auto-Commit Safety Hook
 
 Prevent accidentally committing local development configurations:
 
@@ -108,7 +129,7 @@ git commit -m "WIP: testing something"
 
 📖 **[Git Hooks Documentation →](docs/GITHUB-HOOKS.md)**
 
-### Example 3: CI/CD Testing with Multiple Variants
+### Example 4: CI/CD Testing with Multiple Variants
 
 Test your app against different package versions in CI:
 
@@ -159,8 +180,8 @@ jobs:
           # Apply configuration
           packdev init
 
-      - name: Install dependencies
-        run: npm install
+      - name: Install dependencies (handled by packdev init)
+        run: echo "Dependencies installed by packdev init"
 
       - name: Run tests
         run: npm test

docs/QUICK-START.md

@@ -64,13 +64,12 @@ packdev list
 
 ### 2. Start Development
 ```bash
-packdev init
-npm install  # Now uses local packages and git repositories
+packdev init  # Automatically installs dependencies
 ```
 
 ### 3. Finish Development
 ```bash
-packdev finish
+packdev finish  # Automatically restores and reinstalls dependencies
 git commit -m "implement new features"
 ```
 
@@ -89,24 +88,45 @@ packdev setup-hooks
 | `create-config` | Setup project | `packdev create-config` |
 | `add <pkg> <path>` | Track package | `packdev add axios ../my-axios` |
 | `add <pkg> <git-url>` | Track git repo | `packdev add ui git@github.com:org/ui.git#dev` |
-| `init` | Start development | `packdev init` |
-| `finish` | End development | `packdev finish` |
+| `init` | Start development (auto-installs) | `packdev init` |
+| `finish` | End development (auto-installs) | `packdev finish` |
 | `status` | Check current state | `packdev status` |
 
+**Note**: `init` and `finish` automatically run `npm install` (or `yarn`/`pnpm`). Use `--no-install` flag to skip this.
+
 ## 💡 Common Scenarios
 
+### Branch Switching Without Conflicts
+```bash
+# Working with local dependencies
+packdev init  # Development mode active
+
+# Need to switch branches?
+packdev finish  # Clean package.json instantly
+
+# Switch freely without conflicts
+git checkout main  # ✅ No "uncommitted changes" warnings
+git checkout feature/other  # ✅ Clean switching
+
+# Resume work
+git checkout your-branch
+packdev init  # Back to local development
+```
+
+**Why this helps**: No package.json merge conflicts, clean git status, fast context switching between branches
+
 ### Testing Local and Git Changes
 ```bash
 # Test local changes
 packdev add @myorg/utils ../shared-utils
-packdev init
+packdev init  # Automatically installs dependencies
 # Test your changes locally
 
 # Test git repository features
 packdev add ui-components https://github.com/myorg/ui.git#experiment
-packdev init
+packdev init  # Automatically installs with git dependency
 # Test experimental branch
-packdev finish
+packdev finish  # Automatically restores and reinstalls
 ```
 
 ### Team Collaboration  
@@ -117,14 +137,14 @@ git commit -m "add local dev config"
 
 # Team members use same setup
 git pull
-packdev init
+packdev init  # Automatically installs for team member
 ```
 
 ### Multiple Projects
 ```bash
 # Same local package in multiple projects
-cd project-a && packdev add shared ../shared && packdev init
-cd project-b && packdev add shared ../shared && packdev init
+cd project-a && packdev add shared ../shared && packdev init  # Auto-installs
+cd project-b && packdev add shared ../shared && packdev init  # Auto-installs
 # Both projects now use local ../shared
 ```
 

docs/README.md

@@ -84,11 +84,10 @@ Welcome to the comprehensive documentation for `packdev` - the TypeScript-based
 ### Daily Development
 ```bash
 # Morning
-packdev init
-npm install
+packdev init  # Automatically installs dependencies
 
 # Evening  
-packdev finish
+packdev finish  # Automatically restores and reinstalls
 git commit -m "implement feature X"
 ```
 📖 **Read**: [Workflow Guide](./WORKFLOW.md) - Daily Development Cycle