start-vibing 2.0.11 → 2.0.13

package/README.md

@@ -1,177 +1,177 @@
-# start-vibing
-
-> One command to set up Claude Code with a complete AI development workflow.
-
-## Quick Start
-
-```bash
-# Just run this in any project
-npx start-vibing
-```
-
-That's it! The CLI will:
-
-1. Check for updates
-2. Set up the `.claude/` folder with agents, skills, and hooks
-3. Install Claude Code if not found on your system
-4. Launch Claude Code with `--dangerously-skip-permissions`
-
-## Installation
-
-### Recommended: Install Globally
-
-```bash
-npm install -g start-vibing
-```
-
-Then just run `start-vibing` in any project.
-
-### Or use npx/bunx
-
-```bash
-npx start-vibing    # npm
-bunx start-vibing   # bun (faster)
-```
-
-## What It Does
-
-### 1. Auto-installs Claude Code
-
-If Claude Code is not found on your system, it automatically installs using official methods:
-
-| Platform             | Installation Command                              |
-| -------------------- | ------------------------------------------------- |
-| macOS/Linux          | `curl -fsSL https://claude.ai/install.sh \| bash` |
-| Windows (PowerShell) | `irm https://claude.ai/install.ps1 \| iex`        |
-| Windows (CMD)        | Downloads and runs `install.cmd`                  |
-
-### 2. Sets Up Complete Workflow
-
-Creates a `.claude/` folder with:
-
-```
-.claude/
-├── agents/          # 14 specialized AI agents
-│   ├── orchestrator.md      # Coordinates workflow
-│   ├── analyzer.md          # Analyzes change impact
-│   ├── research.md          # Researches best practices
-│   ├── code-reviewer.md     # Reviews code quality
-│   ├── tester.md            # Creates tests
-│   ├── security-auditor.md  # Security audit (VETO power)
-│   ├── performance.md       # Performance optimization
-│   ├── debugger.md          # Bug tracing
-│   └── ...
-├── skills/          # 8 skill systems with progressive disclosure
-│   ├── test-coverage/       # E2E testing (Playwright)
-│   ├── security-scan/       # OWASP validation + scripts
-│   ├── quality-gate/        # Quality checks + scripts
-│   └── ...
-├── hooks/           # Workflow enforcement
-│   └── stop-validator.py    # Blocks incomplete work
-└── config/          # Project configuration
-    └── project-config.json
-```
-
-### 3. Auto-launches Claude Code
-
-After setup, automatically runs `claude --dangerously-skip-permissions` so you can start working immediately.
-
-### 4. Self-updates
-
-Checks for updates on every run (cached for 1 hour) and notifies you when a new version is available.
-
-## Features
-
-### 14 Specialized Agents
-
-| Agent            | Purpose                     | VETO |
-| ---------------- | --------------------------- | ---- |
-| orchestrator     | Coordinates entire workflow | No   |
-| analyzer         | Analyzes change impact      | No   |
-| research         | Best practices research     | No   |
-| code-reviewer    | Reviews code quality        | No   |
-| documenter       | Documentation updates       | No   |
-| tester           | Unit + E2E tests            | No   |
-| security-auditor | Security audit              | Yes  |
-| ui-ux-reviewer   | UI/UX review                | No   |
-| quality-checker  | Quality gates               | No   |
-| performance      | Performance optimization    | No   |
-| debugger         | Bug tracing                 | No   |
-| final-validator  | Final validation            | Yes  |
-| domain-updater   | Domain knowledge            | No   |
-| commit-manager   | Git commits                 | No   |
-
-### Smart Copy Behavior
-
-When you run `start-vibing` in an existing project:
-
-- **ALWAYS overwrites:** Agent files, hooks, settings.json
-- **PRESERVES:** Your custom domains, cached research
-- **MERGES:** New skills with existing ones
-
-Use `--force` to overwrite everything.
-
-## CLI Options
-
-| Flag                | Description                              |
-| ------------------- | ---------------------------------------- |
-| `--force`           | Overwrite all files                      |
-| `--no-claude`       | Skip Claude Code installation and launch |
-| `--no-update-check` | Skip checking for updates                |
-| `--help`, `-h`      | Show help message                        |
-| `--version`, `-v`   | Show version                             |
-
-## After Setup
-
-```bash
-# 1. Configure your project
-edit .claude/config/project-config.json
-
-# 2. Claude Code is already running!
-# The agents will guide you through the workflow
-```
-
-### Configuration
-
-Edit `.claude/config/project-config.json`:
-
-```json
-{
-	"stack": {
-		"runtime": "bun",
-		"language": "typescript",
-		"database": "mongodb"
-	},
-	"commands": {
-		"typecheck": "bun run typecheck",
-		"lint": "bun run lint",
-		"test": "bun run test",
-		"build": "bun run build"
-	}
-}
-```
-
-## Requirements
-
-- Node.js >= 18 or Bun
-- Internet connection (for Claude Code installation if needed)
-
-## Platforms
-
-| Platform             | Status          |
-| -------------------- | --------------- |
-| macOS                | Fully supported |
-| Linux                | Fully supported |
-| Windows (PowerShell) | Fully supported |
-| Windows (CMD)        | Fully supported |
-| Windows (WSL)        | Fully supported |
-
-## License
-
-MIT
-
-## Links
-
-- [Claude Code Documentation](https://docs.anthropic.com/claude-code)
-- [GitHub Repository](https://github.com/LimaTechnologies/ai-development)
-- [Report Issues](https://github.com/LimaTechnologies/ai-development/issues)
+# start-vibing
+
+> One command to set up Claude Code with a complete AI development workflow.
+
+## Quick Start
+
+```bash
+# Just run this in any project
+npx start-vibing
+```
+
+That's it! The CLI will:
+
+1. Check for updates
+2. Set up the `.claude/` folder with agents, skills, and hooks
+3. Install Claude Code if not found on your system
+4. Launch Claude Code with `--dangerously-skip-permissions`
+
+## Installation
+
+### Recommended: Install Globally
+
+```bash
+npm install -g start-vibing
+```
+
+Then just run `start-vibing` in any project.
+
+### Or use npx/bunx
+
+```bash
+npx start-vibing    # npm
+bunx start-vibing   # bun (faster)
+```
+
+## What It Does
+
+### 1. Auto-installs Claude Code
+
+If Claude Code is not found on your system, it automatically installs using official methods:
+
+| Platform             | Installation Command                              |
+| -------------------- | ------------------------------------------------- |
+| macOS/Linux          | `curl -fsSL https://claude.ai/install.sh \| bash` |
+| Windows (PowerShell) | `irm https://claude.ai/install.ps1 \| iex`        |
+| Windows (CMD)        | Downloads and runs `install.cmd`                  |
+
+### 2. Sets Up Complete Workflow
+
+Creates a `.claude/` folder with:
+
+```
+.claude/
+├── agents/          # 14 specialized AI agents
+│   ├── orchestrator.md      # Coordinates workflow
+│   ├── analyzer.md          # Analyzes change impact
+│   ├── research.md          # Researches best practices
+│   ├── code-reviewer.md     # Reviews code quality
+│   ├── tester.md            # Creates tests
+│   ├── security-auditor.md  # Security audit (VETO power)
+│   ├── performance.md       # Performance optimization
+│   ├── debugger.md          # Bug tracing
+│   └── ...
+├── skills/          # 8 skill systems with progressive disclosure
+│   ├── test-coverage/       # E2E testing (Playwright)
+│   ├── security-scan/       # OWASP validation + scripts
+│   ├── quality-gate/        # Quality checks + scripts
+│   └── ...
+├── hooks/           # Workflow enforcement
+│   └── stop-validator.py    # Blocks incomplete work
+└── config/          # Project configuration
+    └── project-config.json
+```
+
+### 3. Auto-launches Claude Code
+
+After setup, automatically runs `claude --dangerously-skip-permissions` so you can start working immediately.
+
+### 4. Self-updates
+
+Checks for updates on every run (cached for 1 hour) and notifies you when a new version is available.
+
+## Features
+
+### 14 Specialized Agents
+
+| Agent            | Purpose                     | VETO |
+| ---------------- | --------------------------- | ---- |
+| orchestrator     | Coordinates entire workflow | No   |
+| analyzer         | Analyzes change impact      | No   |
+| research         | Best practices research     | No   |
+| code-reviewer    | Reviews code quality        | No   |
+| documenter       | Documentation updates       | No   |
+| tester           | Unit + E2E tests            | No   |
+| security-auditor | Security audit              | Yes  |
+| ui-ux-reviewer   | UI/UX review                | No   |
+| quality-checker  | Quality gates               | No   |
+| performance      | Performance optimization    | No   |
+| debugger         | Bug tracing                 | No   |
+| final-validator  | Final validation            | Yes  |
+| domain-updater   | Domain knowledge            | No   |
+| commit-manager   | Git commits                 | No   |
+
+### Smart Copy Behavior
+
+When you run `start-vibing` in an existing project:
+
+- **ALWAYS overwrites:** Agent files, hooks, settings.json
+- **PRESERVES:** Your custom domains, cached research
+- **MERGES:** New skills with existing ones
+
+Use `--force` to overwrite everything.
+
+## CLI Options
+
+| Flag                | Description                              |
+| ------------------- | ---------------------------------------- |
+| `--force`           | Overwrite all files                      |
+| `--no-claude`       | Skip Claude Code installation and launch |
+| `--no-update-check` | Skip checking for updates                |
+| `--help`, `-h`      | Show help message                        |
+| `--version`, `-v`   | Show version                             |
+
+## After Setup
+
+```bash
+# 1. Configure your project
+edit .claude/config/project-config.json
+
+# 2. Claude Code is already running!
+# The agents will guide you through the workflow
+```
+
+### Configuration
+
+Edit `.claude/config/project-config.json`:
+
+```json
+{
+	"stack": {
+		"runtime": "bun",
+		"language": "typescript",
+		"database": "mongodb"
+	},
+	"commands": {
+		"typecheck": "bun run typecheck",
+		"lint": "bun run lint",
+		"test": "bun run test",
+		"build": "bun run build"
+	}
+}
+```
+
+## Requirements
+
+- Node.js >= 18 or Bun
+- Internet connection (for Claude Code installation if needed)
+
+## Platforms
+
+| Platform             | Status          |
+| -------------------- | --------------- |
+| macOS                | Fully supported |
+| Linux                | Fully supported |
+| Windows (PowerShell) | Fully supported |
+| Windows (CMD)        | Fully supported |
+| Windows (WSL)        | Fully supported |
+
+## License
+
+MIT
+
+## Links
+
+- [Claude Code Documentation](https://docs.anthropic.com/claude-code)
+- [GitHub Repository](https://github.com/LimaTechnologies/ai-development)
+- [Report Issues](https://github.com/LimaTechnologies/ai-development/issues)

package/dist/cli.js

@@ -12,7 +12,14 @@ import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 var __filename2 = fileURLToPath(import.meta.url);
 var __dirname2 = dirname(__filename2);
-var ALWAYS_OVERWRITE = ["agents/", "hooks/", "settings.json", "CLAUDE.md", "commands/"];
+var ALWAYS_OVERWRITE = [
+  "agents/",
+  "hooks/",
+  "settings.json",
+  "commands/",
+  "CLAUDE.md",
+  "README.md"
+];
 var NEVER_OVERWRITE = [
   "skills/codebase-knowledge/domains/",
   "skills/research-cache/cache/",
@@ -103,9 +110,19 @@ async function copyClaudeSetup(targetDir, options = {}) {
   }
   const claudeMdTemplate = join(templateDir, "CLAUDE.md");
   const claudeMdDest = join(targetDir, "CLAUDE.md");
+  const claudeTemplateDest = join(destDir, "CLAUDE.template.md");
   if (existsSync(claudeMdTemplate)) {
-    if (!existsSync(claudeMdDest) || options.force) {
+    if (!existsSync(claudeMdDest)) {
+      copyFileSync(claudeMdTemplate, claudeMdDest);
+      console.log("  \u2713 Created CLAUDE.md from template");
+    } else if (options.force) {
       copyFileSync(claudeMdTemplate, claudeMdDest);
+      console.log("  \u2713 Overwrote CLAUDE.md (force mode)");
+    } else {
+      copyFileSync(claudeMdTemplate, claudeTemplateDest);
+      console.log("  \u2713 Preserved your CLAUDE.md");
+      console.log("  \u2713 Created .claude/CLAUDE.template.md for smart merge");
+      console.log("  \u2192 The stop hook will help merge new rules on first run");
     }
   }
   return result;

package/package.json

@@ -1,42 +1,42 @@
-{
-	"name": "start-vibing",
-	"version": "2.0.11",
-	"description": "Setup Claude Code agents, skills, and hooks in your project. Smart copy that preserves your custom domains and configurations.",
-	"type": "module",
-	"bin": {
-		"start-vibing": "./dist/cli.js"
-	},
-	"files": [
-		"dist",
-		"template"
-	],
-	"scripts": {
-		"build": "bun build ./src/cli.ts --outdir ./dist --target node",
-		"dev": "bun run ./src/cli.ts",
-		"prepublishOnly": "bun run build"
-	},
-	"keywords": [
-		"claude",
-		"claude-code",
-		"ai",
-		"agents",
-		"skills",
-		"hooks",
-		"automation",
-		"workflow",
-		"cli"
-	],
-	"author": "joaov",
-	"license": "MIT",
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/joaov/start-vibing"
-	},
-	"engines": {
-		"node": ">=18.0.0"
-	},
-	"devDependencies": {
-		"@types/node": "^20.0.0",
-		"typescript": "^5.0.0"
-	}
-}
+{
+	"name": "start-vibing",
+	"version": "2.0.13",
+	"description": "Setup Claude Code agents, skills, and hooks in your project. Smart copy that preserves your custom domains and configurations.",
+	"type": "module",
+	"bin": {
+		"start-vibing": "./dist/cli.js"
+	},
+	"files": [
+		"dist",
+		"template"
+	],
+	"scripts": {
+		"build": "bun build ./src/cli.ts --outdir ./dist --target node",
+		"dev": "bun run ./src/cli.ts",
+		"prepublishOnly": "bun run build"
+	},
+	"keywords": [
+		"claude",
+		"claude-code",
+		"ai",
+		"agents",
+		"skills",
+		"hooks",
+		"automation",
+		"workflow",
+		"cli"
+	],
+	"author": "joaov",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/joaov/start-vibing"
+	},
+	"engines": {
+		"node": ">=18.0.0"
+	},
+	"devDependencies": {
+		"@types/node": "^20.0.0",
+		"typescript": "^5.0.0"
+	}
+}