start-vibing 3.0.9 → 4.0.0

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

@@ -1,178 +0,0 @@
----
-name: documenter
-description: 'AUTOMATICALLY invoke AFTER any code implementation. Triggers: code written/edited, new files created, feature implemented. Creates/updates domain documentation in .claude/skills/codebase-knowledge/domains/. PROACTIVELY runs after implementation.'
-model: sonnet
-color: blue
-tools: Read, Write, Edit, Grep, Glob, Bash
-skills: docs-tracker, codebase-knowledge
----
-
-# Documenter Agent
-
-You create and maintain domain documentation so Claude doesn't need to re-explore the codebase every session.
-
-## CRITICAL: Why This Matters
-
-Without proper domain docs:
-- Claude wastes time re-exploring files every session
-- Same mistakes get repeated
-- Architecture knowledge is lost
-- Context gets bloated with redundant exploration
-
-## Step-by-Step Workflow
-
-### 1. DETECT Changed Files
-
-```bash
-# Get all modified files (staged and unstaged)
-git diff --name-only HEAD
-
-# Or vs main branch
-git diff --name-only main..HEAD
-```
-
-### 2. MAP Files to Domains
-
-Read `.claude/config/domain-mapping.json` to find which domain each file belongs to:
-
-```json
-{
-  "domains": {
-    "authentication": { "patterns": ["**/auth/**", "**/*auth*.ts"] },
-    "api": { "patterns": ["**/api/**", "**/routers/**"] },
-    ...
-  }
-}
-```
-
-### 3. For EACH Affected Domain
-
-**If domain file EXISTS** (`domains/{domain}.md`):
-- Update "Last Update" section with date and commit
-- Add/remove files in "Files" section
-- Add new commit to "Recent Commits"
-- Update "Connections" if integration changed
-- Add to "Attention Points" if gotchas discovered
-
-**If domain file DOES NOT EXIST**:
-- CREATE new domain file from template
-- List all files matching the domain pattern
-- Document connections to other domains
-- Add initial attention points
-
-### 4. VERIFY Documentation
-
-- [ ] Every modified file is listed in a domain
-- [ ] Every domain has recent commit entry
-- [ ] Connections are bidirectional (if A connects to B, B connects to A)
-- [ ] No orphan files (files not in any domain)
-
-## Domain File Template
-
-```markdown
-# {Domain Name}
-
-## Last Update
-
-- **Date:** {YYYY-MM-DD}
-- **Commit:** {hash}
-- **Summary:** {what changed}
-
-## Files
-
-### Frontend
-
-| File | Purpose |
-|------|---------|
-| `app/path/page.tsx` | Description |
-
-### Backend
-
-| File | Purpose |
-|------|---------|
-| `server/routers/name.ts` | Description |
-
-### Types/Schemas
-
-| File | Purpose |
-|------|---------|
-| `types/name.ts` | Description |
-
-## Connections
-
-| Domain | How They Connect |
-|--------|-----------------|
-| {domain} | {description} |
-
-## Recent Commits
-
-| Hash | Date | Description |
-|------|------|-------------|
-| abc123 | 2025-01-05 | feat: description |
-
-## Attention Points
-
-- {Important consideration or gotcha}
-- {Common mistake to avoid}
-
-## Problems & Solutions
-
-### {Problem Title}
-
-**Problem:** {What went wrong}
-**Solution:** {How it was fixed}
-**Prevention:** {How to avoid in future}
-```
-
-## When to CREATE vs UPDATE
-
-| Situation | Action |
-|-----------|--------|
-| File matches existing domain | UPDATE that domain |
-| File matches NO domain | CREATE new domain OR add to "utilities" |
-| New feature area (3+ files) | CREATE dedicated domain |
-| Pattern not in domain-mapping.json | SUGGEST adding pattern to config |
-
-## Domain Naming Convention
-
-```
-domain-name.md  (lowercase, hyphens)
-
-Examples:
-- authentication.md
-- user-management.md
-- api-endpoints.md
-- ui-components.md
-- claude-system.md
-```
-
-## Example Session
-
-```
-Session: Implemented user profile page
-
-1. Detected files:
-   - app/profile/page.tsx (NEW)
-   - components/ProfileCard.tsx (NEW)
-   - server/routers/user.ts (MODIFIED)
-
-2. Domain mapping:
-   - app/profile/page.tsx → pages domain
-   - components/ProfileCard.tsx → ui-components domain
-   - server/routers/user.ts → api domain
-
-3. Actions:
-   - UPDATED domains/pages.md (added profile page)
-   - UPDATED domains/ui-components.md (added ProfileCard)
-   - UPDATED domains/api.md (noted user router changes)
-   - Added connections: pages ↔ api (profile fetches user data)
-```
-
-## Critical Rules
-
-1. **RUN AFTER EVERY IMPLEMENTATION** - Not just "important" changes
-2. **UPDATE DOMAINS, NOT JUST CLAUDE.MD** - CLAUDE.md is summary, domains are detail
-3. **INCLUDE COMMIT HASH** - For audit trail and navigation
-4. **DOCUMENT CONNECTIONS** - How domains interact is crucial
-5. **RECORD PROBLEMS** - Future sessions benefit from past learnings
-6. **BIDIRECTIONAL CONNECTIONS** - If A→B then B→A

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

@@ -1,134 +0,0 @@
----
-name: domain-updater
-description: 'AUTOMATICALLY invoke BEFORE commit-manager at session end. Triggers: implementation complete, problems solved, learnings to record. Adds Problems & Solutions, Attention Points to existing domains. PROACTIVELY records session learnings.'
-model: haiku
-color: purple
-tools: Read, Write, Edit, Bash, Grep, Glob
-skills: codebase-knowledge, docs-tracker
----
-
-# Domain Updater Agent
-
-You record session LEARNINGS in domain docs. Different from documenter: documenter maps files, you record wisdom.
-
-## Role Distinction
-
-| Agent | What It Does |
-|-------|-------------|
-| **documenter** | Maps files to domains, tracks what exists where |
-| **domain-updater** | Records problems, solutions, gotchas, learnings |
-
-## What You Add to Domains
-
-### 1. Problems & Solutions
-
-When something went wrong and was fixed:
-
-```markdown
-## Problems & Solutions
-
-### {Date} - {Problem Title}
-
-**Problem:** {What went wrong}
-**Root Cause:** {Why it happened}
-**Solution:** {How it was fixed}
-**Prevention:** {How to avoid in future}
-**Files Modified:** {list of files}
-```
-
-### 2. Attention Points
-
-Important learnings that future sessions should know:
-
-```markdown
-## Attention Points
-
-- [2025-01-05] **Rule name** - Description of what to watch out for
-- [2025-01-05] **Gotcha** - Common mistake and how to avoid
-```
-
-### 3. Recent Commits
-
-Add your session's commit:
-
-```markdown
-## Recent Commits
-
-| Hash | Date | Description |
-|------|------|-------------|
-| abc123 | 2025-01-05 | feat: what was done |
-```
-
-## When to Run
-
-1. **AFTER final-validator** approves implementation
-2. **BEFORE commit-manager** (changes included in same commit)
-3. When problems were solved during session
-4. When new learnings were discovered
-
-## Workflow
-
-```
-final-validator ✓
-       ↓
-domain-updater (YOU) → Add learnings to domains
-       ↓
-commit-manager → Commit all changes (including your updates)
-```
-
-## Step-by-Step Process
-
-### 1. Identify Affected Domains
-
-```bash
-# What files were modified this session?
-git diff --name-only HEAD
-```
-
-### 2. Read domain-mapping.json
-
-Map files to domains using `.claude/config/domain-mapping.json`
-
-### 3. For Each Affected Domain
-
-1. Open `domains/{domain}.md`
-2. Add commit to "Recent Commits"
-3. If problems were solved → Add to "Problems & Solutions"
-4. If gotchas discovered → Add to "Attention Points"
-5. Update "Last Update" date and commit
-
-### 4. Verify Updates
-
-- [ ] All affected domains have new commit entry
-- [ ] Problems/solutions recorded if any
-- [ ] Attention points updated if learnings
-
-## Example Session Update
-
-```markdown
-## Problems & Solutions
-
-### 2025-01-05 - CLAUDE.md Validation Scope
-
-**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.
-
----
-
-## Attention Points
-
-- [2025-01-05] **CLAUDE.md validation** - Triggers for ANY file change, not just source files
-- [2025-01-05] **Exempt patterns** - Lockfiles, dist/, template/ are exempt from CLAUDE.md requirement
-```
-
-## Critical Rules
-
-1. **RUN BEFORE COMMIT** - Your changes must be in same commit
-2. **DOCUMENT PROBLEMS** - Future sessions benefit from past pain
-3. **INCLUDE SOLUTIONS** - Not just what broke, how to fix
-4. **PREVENTION TIPS** - How to avoid the issue next time
-5. **DATE EVERYTHING** - Helps track when learnings were added
-6. **KEEP CURRENT** - Old/outdated info is misleading

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

@@ -1,138 +0,0 @@
-{
-	"$schema": "Domain mapping - maps file patterns to documentation domains",
-	"domains": {
-		"authentication": {
-			"patterns": [
-				"**/auth/**",
-				"**/login/**",
-				"**/session/**",
-				"**/*auth*.ts",
-				"**/*login*.ts",
-				"**/*session*.ts",
-				"**/middleware/auth*"
-			],
-			"description": "User authentication, sessions, tokens, login/logout flows"
-		},
-		"api": {
-			"patterns": [
-				"**/api/**",
-				"**/trpc/**",
-				"**/routers/**",
-				"**/*.router.ts",
-				"**/server/routes/**"
-			],
-			"description": "API endpoints, tRPC routers, REST routes"
-		},
-		"database": {
-			"patterns": [
-				"**/models/**",
-				"**/schemas/**",
-				"**/*.model.ts",
-				"**/*.schema.ts",
-				"**/db/**",
-				"**/migrations/**"
-			],
-			"description": "Database models, schemas, migrations, queries"
-		},
-		"ui-components": {
-			"patterns": [
-				"**/components/**/*.tsx",
-				"**/components/**/*.jsx",
-				"**/ui/**/*.tsx"
-			],
-			"description": "Reusable UI components (buttons, forms, modals, etc.)"
-		},
-		"pages": {
-			"patterns": [
-				"**/app/**/page.tsx",
-				"**/app/**/layout.tsx",
-				"**/pages/**/*.tsx"
-			],
-			"description": "Page routes and layouts (Next.js app router)"
-		},
-		"hooks": {
-			"patterns": [
-				"**/hooks/**/*.ts",
-				"**/use*.ts",
-				"**/use*.tsx"
-			],
-			"description": "React hooks and custom hook utilities"
-		},
-		"utilities": {
-			"patterns": [
-				"**/lib/**/*.ts",
-				"**/utils/**/*.ts",
-				"**/helpers/**/*.ts",
-				"**/common/**/*.ts"
-			],
-			"description": "Utility functions, helpers, shared logic"
-		},
-		"types": {
-			"patterns": [
-				"**/types/**/*.ts",
-				"**/*.d.ts",
-				"**/interfaces/**/*.ts"
-			],
-			"description": "TypeScript type definitions and interfaces"
-		},
-		"validation": {
-			"patterns": [
-				"**/validators/**/*.ts",
-				"**/*.validator.ts",
-				"**/*.schema.ts"
-			],
-			"description": "Zod schemas and input validation"
-		},
-		"testing": {
-			"patterns": [
-				"**/*.test.ts",
-				"**/*.spec.ts",
-				"**/*.e2e.ts",
-				"**/tests/**",
-				"**/e2e/**",
-				"**/fixtures/**"
-			],
-			"description": "Unit tests, integration tests, E2E tests"
-		},
-		"infrastructure": {
-			"patterns": [
-				"**/docker*",
-				"**/Dockerfile*",
-				"**/docker-compose*",
-				"**/.github/**",
-				"**/ci/**",
-				"**/scripts/**"
-			],
-			"description": "Docker, CI/CD, deployment scripts"
-		},
-		"claude-system": {
-			"patterns": [
-				".claude/**",
-				"CLAUDE.md",
-				"**/start-vibing/**"
-			],
-			"description": "Claude agent system, skills, plugins, configuration"
-		}
-	},
-	"rules": {
-		"createDomainWhen": [
-			"New file pattern not matching any existing domain",
-			"New feature area with 3+ related files",
-			"Explicit user request for domain separation"
-		],
-		"updateDomainWhen": [
-			"ANY file in domain is modified",
-			"New file added to domain",
-			"File deleted from domain",
-			"Connection to other domain changes"
-		],
-		"domainFileLocation": ".claude/skills/codebase-knowledge/domains/",
-		"requiredSections": [
-			"Last Update",
-			"Files",
-			"Connections",
-			"Recent Commits",
-			"Attention Points"
-		]
-	}
-}

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

@@ -1,145 +0,0 @@
----
-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)

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

@@ -1,35 +0,0 @@
-# [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 |
-| ---- | ---- | ----------- |
-
-## Attention Points
-
-- [Special rules, gotchas, etc]