start-vibing 1.1.3 → 1.1.4

package/template/.claude/settings.json

@@ -1,41 +1,230 @@
 {
-  "permissions": {
-    "allow": [
-      "Bash(bun run typecheck:*)",
-      "Bash(bun run lint:*)",
-      "Bash(bun run test:*)",
-      "Bash(bun run build)",
-      "Bash(git add:*)",
-      "Bash(git commit:*)",
-      "Bash(git status)",
-      "Bash(git diff:*)",
-      "Bash(git log:*)",
-      "Bash(python .claude/hooks/*)",
-      "Bash(cat:*)",
-      "Bash(bunx:*)",
-      "Bash(docker compose:*)"
-    ],
-    "deny": [
-      "Bash(rm -rf /)",
-      "Bash(sudo:*)",
-      "Bash(chmod 777:*)"
-    ]
-  },
-
-  "hooks": {
-    "UserPromptSubmit": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "python .claude/hooks/user-prompt-submit.py",
-            "timeout": 10
-          }
-        ]
-      }
-    ]
-  },
-
-  "disableAllHooks": false
+
+	"model": "claude-opus-4-5-20251101",
+	"max_tokens": 8192,
+	"max_turns": 100,
+
+	"context": {
+		"compaction_threshold": 0.85,
+		"enable_compaction": true,
+		"enable_semantic_search": true,
+		"memory_files": [".claude/CLAUDE.md", "claude.md"]
+	},
+
+	"permissions": {
+		"mode": "strict",
+		"allowed_tools": [
+			"file_read",
+			"file_write",
+			"file_edit",
+			"bash_grep",
+			"bash_find",
+			"bash_ls",
+			"bash_bun",
+			"bash_git",
+			"web_search"
+		],
+		"disallowed_tools": [
+			"bash_rm_rf",
+			"bash_sudo",
+			"bash_chmod",
+			"bash_chown",
+			"file_delete_recursive"
+		],
+		"allowed_directories": [
+			".",
+			"app",
+			"components",
+			"lib",
+			"server",
+			"tests",
+			"docs",
+			"types",
+			".claude"
+		],
+		"protected_files": [".env", ".env.local", ".env.production", "bun.lockb"],
+		"allow": [
+			"Bash(bun run typecheck:*)",
+			"Bash(git add:*)",
+			"Bash(git commit:*)",
+			"Bash(python .claude/hooks/*)"
+		]
+	},
+
+	"hooks": {
+		"UserPromptSubmit": [
+			{
+				"matcher": "",
+				"hooks": [
+					{
+						"type": "command",
+						"command": "python .claude/hooks/user-prompt-submit.py",
+						"timeout": 10
+					}
+				]
+			}
+		]
+	},
+
+	"agents": {
+		"orchestrator": {
+			"file": "agents/orchestrator.md",
+			"description": "Coordena todo o fluxo de desenvolvimento",
+			"priority": 1
+		},
+		"analyzer": {
+			"file": "agents/analyzer.md",
+			"description": "Analisa impacto de mudancas",
+			"priority": 2
+		},
+		"research": {
+			"file": "agents/research.md",
+			"description": "Pesquisa best practices e solucoes recentes (2024-2025) antes da implementacao",
+			"priority": 3
+		},
+		"documenter": {
+			"file": "agents/documenter.md",
+			"description": "Cria e mantem documentacao",
+			"priority": 3
+		},
+		"tester": {
+			"file": "agents/tester.md",
+			"description": "Cria e executa testes",
+			"priority": 4
+		},
+		"security-auditor": {
+			"file": "agents/security-auditor.md",
+			"description": "Audita seguranca do codigo",
+			"priority": 5,
+			"can_veto": true
+		},
+		"ui-ux-reviewer": {
+			"file": "agents/ui-ux-reviewer.md",
+			"description": "Revisa UI/UX e pesquisa competidores",
+			"priority": 6
+		},
+		"quality-checker": {
+			"file": "agents/quality-checker.md",
+			"description": "Verifica qualidade (typecheck, lint, build)",
+			"priority": 7
+		},
+		"final-validator": {
+			"file": "agents/final-validator.md",
+			"description": "Validacao final antes do commit",
+			"priority": 8,
+			"can_veto": true
+		},
+		"commit-manager": {
+			"file": "agents/commit-manager.md",
+			"description": "Manages commits and workflow state tracking",
+			"priority": 9
+		},
+		"domain-updater": {
+			"file": "agents/domain-updater.md",
+			"description": "Updates domain documentation with session learnings and problems solved. FINAL step after commit.",
+			"priority": 10
+		}
+	},
+
+	"workflow": {
+		"default_flow": [
+			"analyzer",
+			"research",
+			"ui-ux-reviewer",
+			"documenter",
+			"tester",
+			"security-auditor",
+			"quality-checker",
+			"final-validator",
+			"domain-updater",
+			"commit-manager"
+		],
+		"bug_fix_flow": [
+			"analyzer",
+			"research",
+			"tester",
+			"security-auditor",
+			"quality-checker",
+			"final-validator",
+			"domain-updater",
+			"commit-manager"
+		],
+		"refactor_flow": [
+			"analyzer",
+			"tester",
+			"security-auditor",
+			"quality-checker",
+			"final-validator",
+			"domain-updater",
+			"commit-manager"
+		],
+		"config_flow": ["quality-checker", "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,
+			"e2e_for_ui_features": 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
+		},
+		"test_e2e": {
+			"command": "bun run test:e2e",
+			"required": "when_ui_changes",
+			"blocking": true
+		},
+		"build": {
+			"command": "bun run build",
+			"required": true,
+			"blocking": true
+		}
+	}
 }

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

@@ -1,71 +1,145 @@
 ---
 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.
+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
+# Codebase Knowledge - Domain Mapping System
 
-## When to Use
+## Purpose
 
-- Before implementing: understand affected domains
-- When exploring: find related files
-- After implementing: update domain knowledge
+This skill provides cached knowledge about project domains:
 
-## Domain Files
+- **Maps** files by domain/feature area
+- **Tracks** connections between components
+- **Records** recent commits per area
+- **Caches** architecture decisions
 
-Location: `.claude/skills/codebase-knowledge/domains/`
-
-Each domain file tracks:
-- Files in that area
-- Connections to other domains
-- Recent commits
-- Attention points (gotchas)
+---
 
-## Workflow
+## How It Works
 
-### Before Implementation
+### Domain Files Location
 
-```bash
-# 1. Read domain file
-cat .claude/skills/codebase-knowledge/domains/[domain].md
-
-# 2. Check recent changes
-git log --oneline -5 -- [domain files]
+```
+.claude/skills/codebase-knowledge/domains/
+├── [domain-name].md    # One file per domain
+└── ...
 ```
 
-### After Implementation
-
-Update domain file with:
-- New/modified files
-- New commit in "Recent Commits"
-- Updated connections if changed
-
-## Domain File Template
+### Domain File Template
 
 ```markdown
 # [Domain Name]
 
 ## Last Update
+
 - **Date:** YYYY-MM-DD
 - **Commit:** [hash]
 
 ## Files
-- `path/to/file.ts` - Description
+
+### 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 |
-|------|------|-------------|
+
+| Hash   | Date       | Description       |
+| ------ | ---------- | ----------------- |
+| abc123 | YYYY-MM-DD | feat: description |
 
 ## Attention Points
-- [Gotchas and special rules]
+
+- [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
 
-1. **Read before implementing** - check cached knowledge
-2. **Update after implementing** - keep cache current
-3. **Verify connections** - changes may affect other domains
+### 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)