start-vibing 3.0.6 → 3.0.8

package/README.md

@@ -12,7 +12,7 @@ npx start-vibing
 That's it! The CLI will:
 
 1. Check for updates
-2. Set up the `.claude/` folder with agents, skills, and hooks
+2. Set up the `.claude/` folder with agents, skills, and plugins
 3. Install Claude Code if not found on your system
 4. Launch Claude Code with `--dangerously-skip-permissions`
 
@@ -53,25 +53,24 @@ 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
+├── agents/          # 6 specialized AI subagents
+│   ├── research-web.md       # Best practices research
+│   ├── documenter.md         # Domain documentation
+│   ├── domain-updater.md     # Session learnings
+│   ├── commit-manager.md     # Git workflow
+│   ├── claude-md-compactor.md # CLAUDE.md maintenance
+│   └── tester-unit.md        # Unit testing
+├── skills/          # 20 skill systems (auto-injected)
+│   ├── typescript-strict/    # TypeScript patterns
+│   ├── react-patterns/       # React 19 patterns
+│   ├── security-scan/        # OWASP validation
+│   ├── quality-gate/         # Quality checks
 │   └── ...
-├── skills/          # 8 skill systems with progressive disclosure
-│   ├── test-coverage/       # E2E testing (Playwright)
-│   ├── security-scan/       # OWASP validation + scripts
-│   ├── quality-gate/        # Quality checks + scripts
+├── config/          # Project configuration
+│   ├── project-config.json
+│   ├── domain-mapping.json
 │   └── ...
-├── hooks/           # Workflow enforcement
-│   └── stop-validator.py    # Blocks incomplete work
-└── config/          # Project configuration
-    └── project-config.json
+└── commands/        # Slash commands
 ```
 
 ### 3. Auto-launches Claude Code
@@ -82,32 +81,45 @@ After setup, automatically runs `claude --dangerously-skip-permissions` so you c
 
 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   |
+## Architecture
+
+### 6 Subagents
+
+| Agent              | Purpose                              |
+| ------------------ | ------------------------------------ |
+| research-web       | Researches best practices (2024-2026)|
+| documenter         | Maps files to domains, creates docs  |
+| domain-updater     | Records learnings in domain docs     |
+| commit-manager     | Manages git commits                  |
+| claude-md-compactor| Compacts CLAUDE.md when > 40k chars  |
+| tester-unit        | Creates unit tests with Vitest       |
+
+### 5 Plugins (auto-install)
+
+| Plugin             | Mechanism        | Purpose                    |
+| ------------------ | ---------------- | -------------------------- |
+| typescript-lsp     | LSP server       | Type diagnostics (auto)    |
+| security-guidance  | PreToolUse hook  | OWASP vulnerability scan   |
+| code-review        | /code-review cmd | Code quality analysis      |
+| commit-commands    | /commit cmd      | Git commit/push/PR flows   |
+| frontend-design    | /frontend-design | Production-grade UI design |
+
+### 20 Skills
+
+Skills are auto-injected into context when the task matches their description.
+
+| Category           | Skills                                                    |
+| ------------------ | --------------------------------------------------------- |
+| Development        | bun-runtime, typescript-strict, react-patterns, nextjs-app-router, trpc-api, zod-validation, shadcn-ui, tailwind-patterns |
+| Quality & Testing  | quality-gate, security-scan, test-coverage, final-check   |
+| Infrastructure     | docker-patterns, git-workflow, performance-patterns, debugging-patterns |
+| Documentation      | codebase-knowledge, docs-tracker, research-cache, ui-ux-audit |
 
 ### Smart Copy Behavior
 
 When you run `start-vibing` in an existing project:
 
-- **ALWAYS overwrites:** Agent files, hooks, settings.json
+- **ALWAYS overwrites:** Agent files, settings.json
 - **PRESERVES:** Your custom domains, cached research
 - **MERGES:** New skills with existing ones
 
@@ -118,6 +130,7 @@ Use `--force` to overwrite everything.
 | Flag                | Description                              |
 | ------------------- | ---------------------------------------- |
 | `--force`           | Overwrite all files                      |
+| `--new`             | Start fresh session (skip resume)        |
 | `--no-claude`       | Skip Claude Code installation and launch |
 | `--no-update-check` | Skip checking for updates                |
 | `--help`, `-h`      | Show help message                        |
@@ -130,7 +143,7 @@ Use `--force` to overwrite everything.
 edit .claude/config/project-config.json
 
 # 2. Claude Code is already running!
-# The agents will guide you through the workflow
+# The agents and skills will guide you through the workflow
 ```
 
 ### Configuration
@@ -139,17 +152,17 @@ 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"
-	}
+  "stack": {
+    "runtime": "bun",
+    "language": "typescript",
+    "database": "mongodb"
+  },
+  "commands": {
+    "typecheck": "bun run typecheck",
+    "lint": "bun run lint",
+    "test": "bun run test",
+    "build": "bun run build"
+  }
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "start-vibing",
-	"version": "3.0.6",
+	"version": "3.0.8",
 	"description": "Setup Claude Code agents, skills, and hooks in your project. Smart copy that preserves your custom domains and configurations.",
 	"type": "module",
 	"bin": {