docs(packages): add npx installation examples to basic and research READMEs

- Update basic README with npx method
- Update research README with npx method
- Add comparison: CLI global vs npx
- Show both methods in installation section
- Pro tips for choosing best approach
- Consistency across all READMEs

Now all 4 main READMEs document npx workflow!

Author: cleberhensel

.changeset/update-packages-readme-npx.md

@@ -0,0 +1,13 @@
+---
+"@vibe-devtools/basic": patch
+"@vibe-devtools/research": patch
+---
+
+Update installation documentation to include npx examples
+
+- Add npx installation method alongside global CLI
+- Provide clear comparison: global vs npx
+- Show both methods in installation section
+- Add pro tips for choosing best method
+- Consistent with CLI and monorepo README updates
+

apps/cli/src/installers/npm-installer.ts

@@ -24,7 +24,7 @@ export interface InstallResult {
 
 function parseNpmSource(source: string): { packageName: string; version?: string } {
     const parts = source.split('@');
-    
+
     if (source.startsWith('@')) {
         if (parts.length === 3) {
             return {
@@ -37,7 +37,7 @@ function parseNpmSource(source: string): { packageName: string; version?: string
             version: undefined
         };
     }
-    
+
     return {
         packageName: parts[0],
         version: parts[1]
@@ -47,58 +47,58 @@ function parseNpmSource(source: string): { packageName: string; version?: string
 export async function installFromNpm(source: string): Promise<InstallResult> {
     const { packageName, version } = parseNpmSource(source);
     const packageSpec = version ? `${packageName}@${version}` : packageName;
-    
+
     const cacheDir = path.join(getVibesHome(), 'cache', 'npm');
     await fs.mkdir(cacheDir, { recursive: true });
-    
+
     const tempDir = path.join(cacheDir, `temp-${Date.now()}`);
     await fs.mkdir(tempDir, { recursive: true });
-    
+
     try {
         const { stdout } = await execAsync(
             `npm pack ${packageSpec} --json`,
             { cwd: tempDir }
         );
-        
+
         const packResult = JSON.parse(stdout);
         const tarballFilename = packResult[0].filename;
-        
+
         const extractDir = path.join(tempDir, 'extracted');
         await fs.mkdir(extractDir, { recursive: true });
-        
+
         await execAsync(
             `tar -xzf ${tarballFilename} -C extracted`,
             { cwd: tempDir }
         );
-        
+
         const packageDir = path.join(extractDir, 'package');
         const vibeJsonPath = path.join(packageDir, 'vibe.json');
-        
+
         if (!existsSync(vibeJsonPath)) {
             throw new Error(`Package ${packageName} is not a valid vibe (missing vibe.json)`);
         }
-        
+
         const vibeJsonContent = await fs.readFile(vibeJsonPath, 'utf-8');
         const manifest = JSON.parse(vibeJsonContent) as VibeManifest;
-        
+
         const installedPath = getVibePackageDir(manifest.name, manifest.version);
-        
+
         if (existsSync(installedPath)) {
             await fs.rm(installedPath, { recursive: true, force: true });
         }
-        
+
         await fs.mkdir(path.dirname(installedPath), { recursive: true });
         await fs.cp(packageDir, installedPath, { recursive: true });
-        
+
         await fs.rm(tempDir, { recursive: true, force: true });
-        
+
         return {
             manifest,
             installedPath
         };
-        
+
     } catch (error) {
-        await fs.rm(tempDir, { recursive: true, force: true }).catch(() => {});
+        await fs.rm(tempDir, { recursive: true, force: true }).catch(() => { });
         throw new Error(`Failed to install from npm: ${(error as Error).message}`);
     }
 }

packages/basic/README.md

@@ -125,18 +125,33 @@ Cursor/Copilot/Gemini
 
 ## 📦 Instalação
 
-### Pré-requisito
+### Método 1: Via CLI Instalada (Recomendado)
 
 ```bash
+# 1. Instalar CLI globalmente
 npm install -g vibe-devtools
+
+# 2. Instalar basic
+vdt install @vibe-devtools/basic
+
+# 3. Pronto!
 ```
 
-### Instalar Basic
+### Método 2: Via npx (Zero Instalação) ⭐
 
 ```bash
-vdt install @vibe-devtools/basic
+# Instalar diretamente sem ter a CLI
+npx vibe-devtools install @vibe-devtools/basic
+
+# Pronto! Sem pré-requisito de CLI global.
 ```
 
+### 🔥 Qual Escolher?
+
+- **CLI Global**: Se vai usar vários vibes frequentemente
+- **npx**: Para experimentar ou instalação única
+- **Pro tip**: Use npx para testar, depois instale CLI se gostar
+
 ---
 
 ## ✨ O Que Você Ganha

packages/research/README.md

@@ -117,18 +117,33 @@ Este vibe foi criado usando **@vibe-devtools/basic**:
 
 ## 📦 Instalação
 
-### Pré-requisito
+### Método 1: Via CLI Instalada (Recomendado)
 
 ```bash
+# 1. Instalar CLI globalmente
 npm install -g vibe-devtools
+
+# 2. Instalar research
+vdt install @vibe-devtools/research
+
+# 3. Pronto!
 ```
 
-### Instalar Research
+### Método 2: Via npx (Zero Instalação) ⭐
 
 ```bash
-vdt install @vibe-devtools/research
+# Instalar diretamente sem ter a CLI
+npx vibe-devtools install @vibe-devtools/research
+
+# Pronto! Sem pré-requisito de CLI global.
 ```
 
+### 🔥 Qual Escolher?
+
+- **CLI Global**: Se vai fazer várias pesquisas (recomendado)
+- **npx**: Para testar pipelines ou uso esporádico
+- **Pro tip**: Use npx para experimentar, depois instale CLI se gostar
+
 ---
 
 ## ✨ O Que Você Ganha