start-vibing 1.1.2 → 1.1.3

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

@@ -1,145 +1,71 @@
----
-name: codebase-knowledge
-description: Provides cached knowledge about project domains. Maps files by domain, tracks connections between components, records recent commits. Use before implementing to understand affected areas.
-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: Maps project files by domain and tracks architecture. Activates when exploring codebase, understanding file structure, checking what files exist, or before implementing any feature to understand affected areas.
+allowed-tools: Read, Glob, Grep
+---
+
+# Codebase Knowledge
+
+## When to Use
+
+- Before implementing: understand affected domains
+- When exploring: find related files
+- After implementing: update domain knowledge
+
+## Domain Files
+
+Location: `.claude/skills/codebase-knowledge/domains/`
+
+Each domain file tracks:
+- Files in that area
+- Connections to other domains
+- Recent commits
+- Attention points (gotchas)
+
+## Workflow
+
+### Before Implementation
+
+```bash
+# 1. Read domain file
+cat .claude/skills/codebase-knowledge/domains/[domain].md
+
+# 2. Check recent changes
+git log --oneline -5 -- [domain files]
+```
+
+### After Implementation
+
+Update domain file with:
+- New/modified files
+- New commit in "Recent Commits"
+- Updated connections if changed
+
+## Domain File Template
+
+```markdown
+# [Domain Name]
+
+## Last Update
+- **Date:** YYYY-MM-DD
+- **Commit:** [hash]
+
+## Files
+- `path/to/file.ts` - Description
+
+## Connections
+- **[other-domain]:** How they connect
+
+## Recent Commits
+| Hash | Date | Description |
+|------|------|-------------|
+
+## Attention Points
+- [Gotchas and special rules]
+```
+
+## Rules
+
+1. **Read before implementing** - check cached knowledge
+2. **Update after implementing** - keep cache current
+3. **Verify connections** - changes may affect other domains

package/template/.claude/skills/codebase-knowledge/domains/claude-system.md

@@ -1,321 +1,54 @@
-# Claude System
-
-## Last Update
-
-- **Date:** 2024-12-19
-- **Commit:** pending
-- **Session:** Created start-vibing npm package for easy Claude setup
-
-## Files
-
-### Agents
-
-- `.claude/agents/analyzer.md` - Analyzes change impact, approves files
-- `.claude/agents/research.md` - **NEW** Researches best practices (2024-2025) before implementation
-- `.claude/agents/commit-manager.md` - Manages git commits, runs complete-task
-- `.claude/agents/documenter.md` - Creates/updates documentation
-- `.claude/agents/domain-updater.md` - Updates domain knowledge after sessions
-- `.claude/agents/final-validator.md` - Final validation with VETO power
-- `.claude/agents/orchestrator.md` - Coordinates entire workflow
-- `.claude/agents/quality-checker.md` - Runs quality gates
-- `.claude/agents/security-auditor.md` - Security audit with VETO power
-- `.claude/agents/tester.md` - Creates unit and E2E tests
-- `.claude/agents/ui-ux-reviewer.md` - Reviews UI/UX patterns
-
-### Hooks
-
-- `.claude/hooks/pre-tool-use.py` - Blocks unapproved file modifications
-- `.claude/hooks/post-tool-use.py` - Tracks file modifications
-- `.claude/hooks/stop-validation.py` - Blocks incomplete workflows
-- `.claude/hooks/user-prompt-submit.py` - Runs on user prompt
-- `.claude/hooks/workflow-manager.py` - CLI for state tracking
-
-### Skills
-
-- `.claude/skills/codebase-knowledge/` - Domain mapping system
-- `.claude/skills/research-cache/` - **NEW** Best practices research cache
-- `.claude/skills/docs-tracker/` - Documentation tracking
-- `.claude/skills/final-check/` - Final validation rules
-- `.claude/skills/quality-gate/` - Quality gate definitions
-- `.claude/skills/security-scan/` - Security audit rules
-- `.claude/skills/test-coverage/` - Test coverage tracking
-- `.claude/skills/ui-ux-audit/` - UI/UX audit rules
-
-### Configuration
-
-- `.claude/settings.json` - Agent registration, flows, rules
-- `.claude/workflow-state.json` - Current task state
-- `.claude/CLAUDE.md` - System documentation
-
-### Config Files (NEW - 2024-12-19)
-
-- `.claude/config/project-config.json` - Stack, structure, commands
-- `.claude/config/domain-mapping.json` - File patterns to domains
-- `.claude/config/quality-gates.json` - Quality check commands
-- `.claude/config/testing-config.json` - Test framework config
-- `.claude/config/security-rules.json` - Security audit rules
-- `.claude/config/README.md` - Config documentation
-
-### Root Files
-
-- `CLAUDE.md` - Development rules (generalist)
-- `PROJECT.md` - Project-specific details (your project)
-
-## Connections
-
-- **All domains:** domain-updater reads/updates domain files after sessions
-- **Infrastructure:** Hooks enforce workflow rules project-wide
-
-## Recent Commits
-
-| Hash | Date | Description |
-| ---- | ---- | ----------- |
-| de8cda9 | 2024-12-18 | feat(hooks): add domain-updater agent and enhance Task tool guidance |
-| e9b4ad3 | 2024-12-18 | fix(claude-system): move complete-task from commit-manager to domain-updater |
-| 251dfad | 2024-12-18 | feat(claude-system): add domain-updater agent as final workflow step |
-
-## Problems & Solutions
-
-### 2024-12-18 - Hook Blocking File Edits
-
-**Problem:**
-Tried to write files without starting a task first. PreToolUse hook blocked with "No active task in workflow-state.json"
-
-**Root Cause:**
-The pre-tool-use hook requires:
-1. Active task started via workflow-manager.py
-2. Analyzer executed
-3. Files approved for modification
-
-**Solution:**
-Run these commands before editing:
-```bash
-python .claude/hooks/workflow-manager.py start-task --type feature --description "..."
-python .claude/hooks/workflow-manager.py approve-files --files "path/to/file"
-python .claude/hooks/workflow-manager.py agent-executed --agent analyzer --result approved
-```
-
-**Prevention:**
-Always follow the workflow: start-task → approve-files → analyzer → implement
-
----
-
-### 2024-12-18 - Stop Hook Counting .claude/ as Source Files
-
-**Problem:**
-Stop hook blocked with "Modified 2 source file(s) but no tests created" for .claude/ config files
-
-**Root Cause:**
-The source file filter didn't exclude `.claude/` directory - only excluded test, spec, .md, and docs/
-
-**Solution:**
-Added `.claude/` to the exclusion list in stop-validation.py line 68
-
-**Prevention:**
-Config files in `.claude/` don't need unit tests - they're configuration, not source code
-
----
-
-### 2024-12-18 - complete-task Running Before domain-updater
-
-**Problem:**
-commit-manager ran `complete-task` which archived the workflow, then domain-updater couldn't edit files (no active task)
-
-**Root Cause:**
-Workflow order was wrong - complete-task was in commit-manager, but should run AFTER domain-updater
-
-**Solution:**
-- Removed `complete-task` from commit-manager
-- Added Step 6 to domain-updater with `complete-task`
-- New flow: commit-manager → domain-updater → complete-task
-
-**Prevention:**
-~~domain-updater is now responsible for `complete-task`~~ - OUTDATED: See workflow order fix below
-
----
-
-### 2024-12-18 - Workflow Order for Clean Git (FINAL FIX)
-
-**Problem:**
-Git tree stayed dirty after commit because domain updates happened AFTER the commit
-
-**Root Cause:**
-Old flow: commit-manager → domain-updater → complete-task
-This meant domain files were modified AFTER the commit, leaving uncommitted changes
-
-**Solution:**
-New flow: domain-updater → commit-manager → complete-task
-- domain-updater now runs BEFORE commit-manager
-- commit-manager is the FINAL agent (runs complete-task)
-- All changes are included in the commit
-- Git tree is clean after session ends
-
-**Prevention:**
-- domain-updater priority: 9 (runs after final-validator)
-- commit-manager priority: 10 (FINAL step)
-- Stop hook enforces both must run before session ends
-
----
-
-### 2024-12-18 - domain-updater Not Available as Subagent
-
-**Problem:**
-Tried to invoke domain-updater via Task tool but got "Agent type 'domain-updater' not found"
-
-**Root Cause:**
-Agents defined in `.claude/agents/*.md` are instructions for Claude to follow, not subagent_types in Claude Code system
-
-**Solution:**
-Execute domain-updater logic manually or use documenter agent which has similar capabilities
-
-**Prevention:**
-To make an agent invokable via Task tool, it needs to be registered in Claude Code's internal system (separate from .claude/agents/)
-
-## Attention Points
-
-- [2024-12-18] **Workflow is enforced by hooks** - Cannot skip steps, hooks will block
-- [2024-12-18] **domain-updater is MANDATORY** - Stop hook blocks if not executed
-- [2024-12-18] **10 agents total** - domain-updater added as final step (priority 10)
-- [2024-12-18] **Config files (.claude/*) don't require tests** - Excluded from source file checks
-- [2024-12-18] ~~**domain-updater runs complete-task**~~ - OUTDATED: commit-manager now runs complete-task
-- [2024-12-18] **.claude/agents/ vs subagent_type** - Agents in .claude/agents/ are instructions, not Claude Code subagents
-- [2024-12-18] **Never bypass workflow manually** - Follow the agents properly, don't mark as executed without running
-- [2024-12-18] **Use Task tool for agents** - UserPromptSubmit now reminds to use Task(subagent_type="agent-name") instead of manual execution
-- [2024-12-18] **Workflow order fixed** - domain-updater runs BEFORE commit-manager (not after) for clean git
-- [2024-12-18] **commit-manager is FINAL** - It runs complete-task, not domain-updater
-- [2024-12-18] **Stop hook enforces commit** - Blocks if domain-updater ran but commit-manager didn't
-- [2024-12-18] **Research agent added** - Mandatory for features/fixes, runs after analyzer
-- [2024-12-18] **11 agents total** - research added (priority 3)
-- [2024-12-18] **workflow-state.json in .gitignore** - Transient state, not tracked in git
-- [2024-12-19] **Config files for project specifics** - Agents read from `.claude/config/*.json` instead of hardcoding
-- [2024-12-19] **CLAUDE.md < 300 lines** - Best practice from Anthropic, ideally < 60 lines
-- [2024-12-19] **PROJECT.md for project details** - Separate from generic CLAUDE.md
-- [2024-12-19] **Pre-tool-use wildcard issue** - Pattern `.claude/config/*` doesn't match absolute paths, use specific files
-- [2024-12-19] **Tester agent v3.0** - Complete Playwright E2E architecture with fixture-based cleanup
-- [2024-12-19] **E2E cleanup is MANDATORY** - Track all created IDs, delete ONLY tracked data after tests
-- [2024-12-19] **Multi-viewport testing** - Desktop (1280x800), Tablet (768x1024), iPhone SE (375x667) required
-- [2024-12-19] **DB validation in E2E** - Always verify database state after UI actions
-- [2024-12-19] **Real auth only** - Never mock authentication in E2E tests
-- [2024-12-19] **data-testid required** - All interactive elements must have data-testid attributes
-- [2024-12-19] **SKILL.md YAML frontmatter** - ALL skills MUST have `---` frontmatter with name, description
-- [2024-12-19] **Skill name format** - max 64 chars, lowercase, letters/numbers/hyphens only
-- [2024-12-19] **Skill description** - max 1024 chars, describes WHAT skill does and WHEN to use it
-- [2024-12-19] **allowed-tools optional** - Comma-separated tool names to restrict skill capabilities
-- [2024-12-19] **Hooks config correct** - settings.json hooks format is valid, uses command type with python scripts
-- [2024-12-19] **start-vibing npm package** - CLI para copiar .claude para qualquer projeto
-- [2024-12-19] **npx/bunx CLI** - package.json bin field aponta para dist/cli.js com shebang
-- [2024-12-19] **Smart copy** - Preserva domains e cache, sobrescreve agents e hooks
-
-## Problems & Solutions (2024-12-19)
-
-### 2024-12-19 - CLAUDE.md Too Long and Specific
-
-**Problem:**
-CLAUDE.md had 594 lines, 95% project-specific. Too long for Claude to follow consistently.
-
-**Root Cause:**
-Project-specific details (workers, docker config, path aliases examples) mixed with universal rules.
-
-**Solution:**
-1. Reduced CLAUDE.md to 115 lines (universal rules only)
-2. Created `PROJECT.md` with project-specific details
-3. Created `.claude/config/` with JSON configs for project specifics
-4. Updated agents to read from config files
-
-**Prevention:**
-- Keep CLAUDE.md under 300 lines (ideally < 60)
-- Put project specifics in PROJECT.md
-- Use `.claude/config/` for things agents need to adapt to
-
----
-
-### 2024-12-19 - Pre-Tool-Use Wildcard Pattern Not Working
-
-**Problem:**
-Approved files with pattern `.claude/config/*` but hook still blocked edits to `.claude/config/project-config.json`
-
-**Root Cause:**
-Hook checks `file_path.startswith(approved[:-1])` but file_path is absolute path `C:/Users/.../` while approved is relative `.claude/config/*`
-
-**Solution:**
-Approve each file individually instead of using wildcard patterns
-
-**Prevention:**
-When using approve-files, list specific files rather than wildcards if path matching issues occur
-
----
-
-### 2024-12-19 - E2E Test Data Pollution
-
-**Problem:**
-E2E tests created data in the database but didn't clean up, causing test pollution and confusion with real data.
-
-**Root Cause:**
-Tests were creating users, items, etc. but not tracking or deleting them after completion.
-
-**Solution:**
-Implemented fixture-based cleanup pattern:
-1. `createdIds` fixture tracks all created document IDs by collection
-2. `trackCreated(collection, id)` function to register created data
-3. Auto-cleanup runs after each test, even on failure
-4. Only deletes tracked IDs, never affects real data
-
-**Prevention:**
-- Always use `trackCreated()` immediately after creating data
-- Use the custom `test` from fixtures, not base Playwright `test`
-- Verify cleanup is working with DB inspection
-
----
-
-### 2024-12-19 - Tester Agent Missing E2E Architecture
-
-**Problem:**
-Tester agent didn't have comprehensive E2E testing patterns for Playwright.
-
-**Root Cause:**
-Previous version focused on unit tests, lacked E2E architecture.
-
-**Solution:**
-Rewrote tester.md with complete Playwright architecture:
-- Fixture-based cleanup pattern
-- Multi-viewport testing (desktop, tablet, mobile)
-- Database validation after UI actions
-- API testing (REST and tRPC)
-- Real authentication flows
-- Storage state for session reuse
-- Security testing (forbidden requests, rate limiting)
-
-**Prevention:**
-- Always test all viewports
-- Always verify DB state, don't trust UI alone
-- Use real auth, never mock it
-
----
-
-### 2024-12-19 - Skills Missing YAML Frontmatter
-
-**Problem:**
-All SKILL.md files started with `# Title` instead of YAML frontmatter, making them undiscoverable by Claude Code.
-
-**Root Cause:**
-Skills were created as plain markdown without the required YAML frontmatter that Claude Code uses to discover and load skills.
-
-**Solution:**
-Added YAML frontmatter to all 8 SKILL.md files:
-```yaml
----
-name: skill-name-lowercase
-description: What skill does and when to use it
-allowed-tools: Tool1, Tool2  # optional
----
-```
-
-**Fixed Files:**
-- quality-gate, security-scan, codebase-knowledge, docs-tracker
-- final-check, ui-ux-audit, research-cache, test-coverage
-
-**Prevention:**
-- Quality-checker now validates SKILL.md format
-- All new skills MUST start with YAML frontmatter
-- name: lowercase-with-hyphens, max 64 chars
-- description: non-empty, max 1024 chars
+# Claude System
+
+## Last Update
+
+- **Date:** 2025-12-24
+- **Session:** Clean template - removed project-specific content
+
+## Files
+
+### Agents
+
+- `.claude/agents/analyzer.md` - Analyzes change impact, approves files
+- `.claude/agents/research.md` - Researches best practices before implementation
+- `.claude/agents/commit-manager.md` - Manages git commits
+- `.claude/agents/documenter.md` - Creates/updates documentation
+- `.claude/agents/domain-updater.md` - Updates domain knowledge after sessions
+- `.claude/agents/final-validator.md` - Final validation with VETO power
+- `.claude/agents/orchestrator.md` - Coordinates entire workflow
+- `.claude/agents/quality-checker.md` - Runs quality gates
+- `.claude/agents/security-auditor.md` - Security audit with VETO power
+- `.claude/agents/tester.md` - Creates unit and E2E tests
+- `.claude/agents/ui-ux-reviewer.md` - Reviews UI/UX patterns
+
+### Skills
+
+- `.claude/skills/codebase-knowledge/` - Domain mapping system
+- `.claude/skills/research-cache/` - Best practices research cache
+- `.claude/skills/docs-tracker/` - Documentation tracking
+- `.claude/skills/final-check/` - Final validation rules
+- `.claude/skills/quality-gate/` - Quality gate definitions
+- `.claude/skills/security-scan/` - Security audit rules
+- `.claude/skills/test-coverage/` - Test coverage tracking
+- `.claude/skills/ui-ux-audit/` - UI/UX audit rules
+- `.claude/skills/workflow-state/` - Task state tracking
+
+### Configuration
+
+- `.claude/config/project-config.json` - Stack, structure, commands
+- `.claude/config/domain-mapping.json` - File patterns to domains
+- `.claude/config/quality-gates.json` - Quality check commands
+- `.claude/config/testing-config.json` - Test framework config
+- `.claude/config/security-rules.json` - Security audit rules
+
+## Connections
+
+- **All domains:** domain-updater reads/updates domain files after sessions
+- **Infrastructure:** Hooks enforce workflow rules project-wide
+
+## Attention Points
+
+- **Config files for project specifics** - Agents read from `.claude/config/*.json` instead of hardcoding
+- **CLAUDE.md < 300 lines** - Best practice from Anthropic
+- **SKILL.md YAML frontmatter** - ALL skills MUST have `---` frontmatter with name, description
+- **Skill name format** - max 64 chars, lowercase, letters/numbers/hyphens only