start-vibing 3.0.6 → 3.0.8

package/template/.claude/agents/claude-md-compactor.md

@@ -1,6 +1,6 @@
 ---
 name: claude-md-compactor
-description: "AUTOMATICALLY invoke when CLAUDE.md exceeds 40k chars. Triggers: stop hook CLAUDE_MD_SIZE_EXCEEDED, 'compact CLAUDE.md'. Compacts while preserving critical knowledge per Anthropic best practices."
+description: "AUTOMATICALLY invoke when CLAUDE.md exceeds 40k chars. Triggers: 'compact CLAUDE.md', file size check. Compacts while preserving critical knowledge per Anthropic best practices."
 model: sonnet
 color: orange
 tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch
@@ -200,16 +200,4 @@ After compaction:
 1. Show before/after character count
 2. List removed sections
 3. Confirm all critical sections preserved
-4. Verify file validates with stop hook
-
----
-
-## Integration
-
-The stop hook will:
-
-1. Detect CLAUDE.md > 40k chars
-2. Block with message suggesting this agent
-3. Agent compacts file
-4. Stop hook re-validates
-5. Task completes if under limit
+4. Verify file is under 40k chars

package/template/.claude/agents/documenter.md

@@ -146,13 +146,6 @@ Examples:
 - claude-system.md
 ```
 
-## Integration with Stop Hook
-
-The Stop hook will BLOCK if:
-1. Source files modified but no domain updated
-2. Domain file missing required sections
-3. Recent commit not recorded
-
 ## Example Session
 
 ```

package/template/.claude/agents/domain-updater.md

@@ -108,19 +108,14 @@ Map files to domains using `.claude/config/domain-mapping.json`
 ```markdown
 ## Problems & Solutions
 
-### 2025-01-05 - Stop Hook Not Blocking CLAUDE.md Updates
+### 2025-01-05 - CLAUDE.md Validation Scope
 
-**Problem:** Stop hook passed without requiring CLAUDE.md update when only config files changed.
-
-**Root Cause:** Validation only checked source files (.ts, .tsx), not all file types.
+**Problem:** CLAUDE.md validation only checked source files (.ts, .tsx), not all file types.
 
 **Solution:** Changed to check ALL files with EXEMPT_PATTERNS for auto-generated files.
 
 **Prevention:** When adding file validation, consider ALL file types, not just source code.
 
-**Files Modified:**
-- `.claude/hooks/stop-validator.ts`
-
 ---
 
 ## Attention Points

package/template/.claude/config/README.md

@@ -1,6 +1,6 @@
 # Project Configuration
 
-This directory contains project-specific configuration files that agents read to adapt their behavior to your project.
+This directory contains project-specific configuration files that agents and skills read to adapt their behavior to your project.
 
 ## Files
 
@@ -12,13 +12,15 @@ This directory contains project-specific configuration files that agents read to
 | `testing-config.json` | Testing framework and conventions                       |
 | `security-rules.json` | Security audit rules                                    |
 
-## How Agents Use These
+## How Agents and Skills Use These
 
-1. **analyzer** - Reads `project-config.json` for structure, `domain-mapping.json` for domains
-2. **tester** - Reads `testing-config.json` for frameworks and conventions
-3. **security-auditor** - Reads `security-rules.json` for security patterns
-4. **quality-checker** - Reads `quality-gates.json` for commands
-5. **domain-updater** - Reads `domain-mapping.json` for file-to-domain mapping
+1. **domain-updater** agent - Reads `domain-mapping.json` for file-to-domain mapping
+2. **documenter** agent - Reads `domain-mapping.json` and `project-config.json`
+3. **tester-unit** agent - Reads `testing-config.json` for frameworks and conventions
+4. **commit-manager** agent - Reads `project-config.json` for commit conventions
+5. **quality-gate** skill - Reads `quality-gates.json` for commands
+6. **security-scan** skill - Reads `security-rules.json` for security patterns
+7. **codebase-knowledge** skill - Reads `domain-mapping.json` for domain structure
 
 ## Customizing for Your Project
 
@@ -27,4 +29,4 @@ This directory contains project-specific configuration files that agents read to
 3. Update `testing-config.json` with your test conventions
 4. Update `security-rules.json` with your auth framework
 
-The agents will automatically adapt to your configuration.
+The agents and skills will automatically adapt to your configuration.

package/template/.claude/config/domain-mapping.json

@@ -111,7 +111,7 @@
 				"CLAUDE.md",
 				"**/start-vibing/**"
 			],
-			"description": "Claude agent system, hooks, skills, configuration"
+			"description": "Claude agent system, skills, plugins, configuration"
 		}
 	},
 	"rules": {

package/template/.claude/settings.json

@@ -27,13 +27,6 @@
 		"frontend-design@claude-plugins-official": true
 	},
 
-	"context": {
-		"compaction_threshold": 0.85,
-		"enable_compaction": true,
-		"enable_semantic_search": true,
-		"memory_files": [".claude/CLAUDE.md", "claude.md"]
-	},
-
 	"permissions": {
 		"mode": "strict",
 		"allowed_tools": [
@@ -70,130 +63,8 @@
 			"Bash(bun run typecheck:*)",
 			"Bash(git add:*)",
 			"Bash(git commit:*)",
-			"Bash(python .claude/hooks/*)",
-			"Bash(bun .claude/hooks/*)",
 			"Bash(bun .claude/scripts/*)",
 			"Bash(claude mcp:*)"
 		]
-	},
-
-	"hooks": {
-		"UserPromptSubmit": [
-			{
-				"matcher": "",
-				"hooks": [
-					{
-						"type": "command",
-						"command": "npx tsx .claude/hooks/run-hook.ts user-prompt-submit",
-						"timeout": 10
-					}
-				]
-			}
-		],
-		"Stop": [
-			{
-				"hooks": [
-					{
-						"type": "command",
-						"command": "npx tsx .claude/hooks/run-hook.ts stop-validator",
-						"timeout": 30
-					}
-				]
-			}
-		]
-	},
-
-	"agents": {
-		"research-web": {
-			"description": "Researches best practices and recent solutions (2024-2026) before implementation"
-		},
-		"documenter": {
-			"description": "Creates and maintains documentation for modified files"
-		},
-		"domain-updater": {
-			"description": "Updates domain docs with session learnings. Runs before commit"
-		},
-		"commit-manager": {
-			"description": "Manages commits and workflow state tracking"
-		},
-		"claude-md-compactor": {
-			"description": "Compacts CLAUDE.md when it exceeds 40k chars"
-		},
-		"tester-unit": {
-			"description": "Creates unit tests with Vitest for new functions and utilities"
-		}
-	},
-
-	"workflow": {
-		"default_flow": [
-			"research-web",
-			"tester-unit",
-			"documenter",
-			"domain-updater",
-			"commit-manager"
-		],
-		"config_flow": ["domain-updater", "commit-manager"]
-	},
-
-	"rules": {
-		"research": {
-			"required_before_implementation": true,
-			"sources_must_be_recent": "2024-2025",
-			"must_document_findings": true,
-			"must_cite_sources": true
-		},
-		"typescript": {
-			"strict": true,
-			"no_any": true,
-			"explicit_return_types": true
-		},
-		"security": {
-			"user_id_from_session_only": true,
-			"sanitize_all_responses": true,
-			"zod_validation_required": true,
-			"explicit_select_required": true,
-			"owasp_validation_required": true,
-			"cve_check_required": true
-		},
-		"ux": {
-			"skeleton_required_for_async": true,
-			"touch_friendly_min_size": "44px",
-			"competitor_research_required": true,
-			"wcag_compliance_required": true
-		},
-		"testing": {
-			"unit_tests_required": true,
-			"playwright_mcp_for_browser_tests": true,
-			"data_testid_required": true,
-			"edge_cases_research_required": true
-		},
-		"documentation": {
-			"flow_docs_required": true,
-			"competitor_research_for_ui": true,
-			"research_must_be_documented": true
-		}
-	},
-
-	"quality_gates": {
-		"typecheck": {
-			"command": "bun run typecheck",
-			"required": true,
-			"blocking": true
-		},
-		"lint": {
-			"command": "bun run lint",
-			"required": true,
-			"blocking": true
-		},
-		"test": {
-			"command": "bun run test",
-			"required": true,
-			"blocking": true
-		},
-		"build": {
-			"command": "bun run build",
-			"required": true,
-			"blocking": true
-		}
 	}
 }

package/template/.claude/skills/codebase-knowledge/SKILL.md

@@ -1,145 +1,145 @@
----
-name: codebase-knowledge
-description: "ALWAYS invoke BEFORE implementing any feature. Maps files by domain, tracks connections. Do NOT write code without checking affected areas first."
-allowed-tools: Read, Glob, Grep
----
-
-# Codebase Knowledge - Domain Mapping System
-
-## Purpose
-
-This skill provides cached knowledge about project domains:
-
-- **Maps** files by domain/feature area
-- **Tracks** connections between components
-- **Records** recent commits per area
-- **Caches** architecture decisions
-
----
-
-## How It Works
-
-### Domain Files Location
-
-```
-.claude/skills/codebase-knowledge/domains/
-├── [domain-name].md    # One file per domain
-└── ...
-```
-
-### Domain File Template
-
-```markdown
-# [Domain Name]
-
-## Last Update
-
-- **Date:** YYYY-MM-DD
-- **Commit:** [hash]
-
-## Files
-
-### Frontend
-
-- `app/[path]/page.tsx` - Description
-- `components/[path]/*.tsx` - Description
-
-### Backend
-
-- `server/trpc/routers/[name].router.ts` - Router
-- `server/db/models/[name].model.ts` - Model
-
-### Types/Schemas
-
-- `lib/validators/[name].ts` - Zod schemas
-
-## Connections
-
-- **[other-domain]:** How they connect
-
-## Recent Commits
-
-| Hash   | Date       | Description       |
-| ------ | ---------- | ----------------- |
-| abc123 | YYYY-MM-DD | feat: description |
-
-## Attention Points
-
-- [Special rules, gotchas, etc]
-```
-
----
-
-## Workflow
-
-### BEFORE Implementation
-
-1. **Identify** which domain is affected
-2. **Read** `domains/[domain].md` file
-3. **Check** affected files listed
-4. **Verify** recent commits for context
-5. **Note** connections with other domains
-
-### AFTER Implementation
-
-1. **Update** the domain file
-2. **Add** new commit to "Recent Commits"
-3. **Add/remove** files if changed
-4. **Update** connections if affected
-
----
-
-## Commands
-
-### Check Recent Commits by Domain
-
-```bash
-git log --oneline -10 -- [list of domain files]
-```
-
-### Check Uncommitted Changes
-
-```bash
-git diff --name-status main..HEAD
-```
-
-### Create New Domain File
-
-```bash
-# Copy template
-cp .claude/skills/codebase-knowledge/TEMPLATE.md .claude/skills/codebase-knowledge/domains/[name].md
-```
-
----
-
-## Rules
-
-### MANDATORY
-
-1. **READ domain before implementing** - Always check cached knowledge
-2. **UPDATE after implementing** - Keep cache current
-3. **VERIFY connections** - Changes may affect other domains
-4. **RECORD commits** - Maintain history
-
-### FORBIDDEN
-
-1. **Ignore cached knowledge** - It exists to accelerate development
-2. **Leave outdated** - Old docs are worse than none
-3. **Modify without recording** - Every commit should be noted
-
----
-
-## Integration with Agents
-
-The **analyzer** agent MUST use this skill:
-
-1. Check which domain is affected
-2. Read domain file for context
-3. Report affected files and connections
-4. Update domain after implementation
-
----
-
-## Version
-
-- **v2.0.0** - Generic template (no project-specific domains)
+---
+name: codebase-knowledge
+description: "ALWAYS invoke BEFORE implementing any feature. Maps files by domain, tracks connections. Do NOT write code without checking affected areas first."
+allowed-tools: Read, Glob, Grep
+---
+
+# Codebase Knowledge - Domain Mapping System
+
+## Purpose
+
+This skill provides cached knowledge about project domains:
+
+- **Maps** files by domain/feature area
+- **Tracks** connections between components
+- **Records** recent commits per area
+- **Caches** architecture decisions
+
+---
+
+## How It Works
+
+### Domain Files Location
+
+```
+.claude/skills/codebase-knowledge/domains/
+├── [domain-name].md    # One file per domain
+└── ...
+```
+
+### Domain File Template
+
+```markdown
+# [Domain Name]
+
+## Last Update
+
+- **Date:** YYYY-MM-DD
+- **Commit:** [hash]
+
+## Files
+
+### Frontend
+
+- `app/[path]/page.tsx` - Description
+- `components/[path]/*.tsx` - Description
+
+### Backend
+
+- `server/trpc/routers/[name].router.ts` - Router
+- `server/db/models/[name].model.ts` - Model
+
+### Types/Schemas
+
+- `lib/validators/[name].ts` - Zod schemas
+
+## Connections
+
+- **[other-domain]:** How they connect
+
+## Recent Commits
+
+| Hash   | Date       | Description       |
+| ------ | ---------- | ----------------- |
+| abc123 | YYYY-MM-DD | feat: description |
+
+## Attention Points
+
+- [Special rules, gotchas, etc]
+```
+
+---
+
+## Workflow
+
+### BEFORE Implementation
+
+1. **Identify** which domain is affected
+2. **Read** `domains/[domain].md` file
+3. **Check** affected files listed
+4. **Verify** recent commits for context
+5. **Note** connections with other domains
+
+### AFTER Implementation
+
+1. **Update** the domain file
+2. **Add** new commit to "Recent Commits"
+3. **Add/remove** files if changed
+4. **Update** connections if affected
+
+---
+
+## Commands
+
+### Check Recent Commits by Domain
+
+```bash
+git log --oneline -10 -- [list of domain files]
+```
+
+### Check Uncommitted Changes
+
+```bash
+git diff --name-status main..HEAD
+```
+
+### Create New Domain File
+
+```bash
+# Copy template
+cp .claude/skills/codebase-knowledge/TEMPLATE.md .claude/skills/codebase-knowledge/domains/[name].md
+```
+
+---
+
+## Rules
+
+### MANDATORY
+
+1. **READ domain before implementing** - Always check cached knowledge
+2. **UPDATE after implementing** - Keep cache current
+3. **VERIFY connections** - Changes may affect other domains
+4. **RECORD commits** - Maintain history
+
+### FORBIDDEN
+
+1. **Ignore cached knowledge** - It exists to accelerate development
+2. **Leave outdated** - Old docs are worse than none
+3. **Modify without recording** - Every commit should be noted
+
+---
+
+## Integration with Agents
+
+The **analyzer** agent MUST use this skill:
+
+1. Check which domain is affected
+2. Read domain file for context
+3. Report affected files and connections
+4. Update domain after implementation
+
+---
+
+## Version
+
+- **v2.0.0** - Generic template (no project-specific domains)