start-vibing 1.1.2 → 1.1.4

package/template/.claude/hooks/user-prompt-submit.py

@@ -1,12 +1,13 @@
 #!/usr/bin/env python3
 """
-UserPromptSubmit Hook - Agent Selection Enforcement
+UserPromptSubmit Hook - STRICT Workflow Enforcement
 
-This hook runs BEFORE Claude processes any user prompt and:
-1. Lists all available agents
-2. Analyzes the prompt to suggest the best agent
-3. Reminds Claude to follow the workflow strictly
-4. Prevents over-engineering and redundant file creation
+This hook runs BEFORE Claude processes any user prompt and ENFORCES:
+1. MANDATORY detailed todo list creation from prompt
+2. MANDATORY research agent for new features
+3. STRICT workflow: audit -> branch -> implement -> document -> quality -> PR
+4. Separate UI for mobile/tablet/desktop (NOT just responsive)
+5. NRY patterns (Never Repeat Yourself - common Claude mistakes)
 
 Output is sent to Claude as context before processing the user's request.
 
@@ -24,6 +25,22 @@ PROJECT_DIR = os.environ.get('CLAUDE_PROJECT_DIR', os.getcwd())
 WORKFLOW_STATE_PATH = Path(PROJECT_DIR) / '.claude' / 'workflow-state.json'
 SETTINGS_PATH = Path(PROJECT_DIR) / '.claude' / 'settings.json'
 
+# STRICT WORKFLOW SEQUENCE (MANDATORY)
+STRICT_WORKFLOW = """
+┌─────────────────────────────────────────────────────────────────┐
+│                    STRICT WORKFLOW (MANDATORY)                  │
+├─────────────────────────────────────────────────────────────────┤
+│ 1. TODO LIST    → Create DETAILED todo list from prompt        │
+│ 2. RESEARCH     → Run research agent for NEW features          │
+│ 3. AUDIT        → Check last audit docs OR run fresh audit     │
+│ 4. BRANCH       → Create feature/ | fix/ | refactor/ | test/   │
+│ 5. IMPLEMENT    → Follow rules + analyzer approval             │
+│ 6. DOCUMENT     → Document results, bugs, solutions (with hash)│
+│ 7. QUALITY      → typecheck + lint + test (Husky enforced)     │
+│ 8. PR           → Create PR to main with doc references        │
+└─────────────────────────────────────────────────────────────────┘
+"""
+
 # Agent definitions with triggers
 AGENTS = {
     'orchestrator': {
@@ -39,22 +56,24 @@ AGENTS = {
         'when': 'BEFORE any Edit/Write to source files'
     },
     'research': {
-        'description': 'Researches best practices and recent solutions (2024-2025)',
-        'triggers': ['research', 'investigate', 'study', 'best practice', 'how to', 'pattern'],
+        'description': 'Researches best practices (2024-2025) - MANDATORY for new features',
+        'triggers': ['research', 'investigate', 'study', 'best practice', 'how to', 'pattern', 'new feature', 'implement'],
         'priority': 3,
-        'when': 'AFTER analyzer - finds best practices before implementation'
+        'when': 'MANDATORY for ANY new feature or complex bug fix',
+        'mandatory_for': ['feature', 'fix']
     },
     'ui-ux-reviewer': {
-        'description': 'Reviews UI/UX and researches competitors',
-        'triggers': ['ui', 'component', 'page', 'design', 'layout', 'style', 'responsive', 'frontend'],
+        'description': 'Reviews UI/UX - ENFORCES separate mobile/tablet/desktop UIs',
+        'triggers': ['ui', 'component', 'page', 'design', 'layout', 'style', 'frontend', 'mobile', 'desktop'],
         'priority': 3,
-        'when': 'Files in components/, app/, or .tsx with JSX'
+        'when': 'Files in components/, app/, or .tsx with JSX',
+        'enforces': 'SEPARATE UIs for each platform (NOT just responsive)'
     },
     'documenter': {
-        'description': 'Creates and maintains documentation',
+        'description': 'Documents results with commit hash references',
         'triggers': ['document', 'readme', 'docs', 'explain'],
         'priority': 4,
-        'when': 'After code implementation completes'
+        'when': 'After implementation - MUST include commit hash for audit trail'
     },
     'tester': {
         'description': 'Creates unit tests (Vitest) and E2E tests (Playwright)',
@@ -70,10 +89,10 @@ AGENTS = {
         'can_veto': True
     },
     'quality-checker': {
-        'description': 'Runs typecheck, lint, test, build',
+        'description': 'Runs typecheck, lint, test, build (Husky pre-commit)',
         'triggers': ['check', 'verify', 'validate', 'run tests', 'quality'],
         'priority': 7,
-        'when': 'After implementation and tests complete'
+        'when': 'BEFORE any commit - Husky enforces this'
     },
     'final-validator': {
         'description': 'Final validation before commit (CAN VETO)',
@@ -168,7 +187,7 @@ def format_agent_list() -> str:
 def format_workflow_status(state: dict) -> str:
     """Format current workflow status"""
     if not state or not state.get('currentTask'):
-        return "STATUS: No active task. Start with orchestrator or workflow-manager.py start-task"
+        return "STATUS: No active task. Start with orchestrator agent"
 
     task = state['currentTask']
     agents = task.get('agents', {})
@@ -202,12 +221,44 @@ def main():
     task_type = detect_task_type(prompt) if prompt else 'unknown'
     best_agent, reason = detect_best_agent(prompt) if prompt else ('orchestrator', 'Default')
 
+    # Check if task is new feature (requires research)
+    is_new_feature = task_type in ['feature'] or any(word in prompt.lower() for word in ['new', 'implement', 'create', 'add'])
+    is_ui_task = any(word in prompt.lower() for word in ['ui', 'component', 'page', 'design', 'layout', 'mobile', 'desktop', 'tablet'])
+
     # Build output message
     output = f"""
 ================================================================================
-WORKFLOW ENFORCEMENT - UserPromptSubmit Hook
+STRICT WORKFLOW ENFORCEMENT - UserPromptSubmit Hook
 ================================================================================
+{STRICT_WORKFLOW}
 
+{"⚠️  NEW FEATURE DETECTED - RESEARCH AGENT IS MANDATORY!" if is_new_feature else ""}
+{"⚠️  UI TASK DETECTED - SEPARATE UIs FOR MOBILE/TABLET/DESKTOP REQUIRED!" if is_ui_task else ""}
+
+================================================================================
+STEP 1: CREATE DETAILED TODO LIST (MANDATORY)
+================================================================================
+
+BEFORE doing anything, you MUST use TodoWrite to create a detailed todo list.
+Break down the user's prompt into specific, actionable items.
+
+Example:
+  User prompt: "Add login feature"
+  Todo list:
+    1. Research login best practices 2024-2025
+    2. Check existing auth documentation
+    3. Create feature/login branch
+    4. Implement login form (mobile UI)
+    5. Implement login form (tablet UI)
+    6. Implement login form (desktop UI)
+    7. Add validation with visual feedback
+    8. Create unit tests
+    9. Create E2E tests
+    10. Document implementation with commit hash
+    11. Run quality gates
+    12. Create PR to main
+
+================================================================================
 AVAILABLE AGENTS:
 {format_agent_list()}
 
@@ -215,50 +266,137 @@ TASK ANALYSIS:
   Detected type: {task_type}
   Recommended agent: {best_agent}
   Reason: {reason}
+  Research required: {"YES (MANDATORY)" if is_new_feature else "Optional"}
+  Separate UIs required: {"YES (MANDATORY)" if is_ui_task else "N/A"}
   Workflow sequence: {' -> '.join(WORKFLOWS.get(task_type, WORKFLOWS['feature']))}
 
 {format_workflow_status(state)}
 
 ================================================================================
-CRITICAL: INVOKE AGENTS VIA TASK TOOL - NOT MANUALLY
+UI ARCHITECTURE RULES (MANDATORY FOR WEB APPS)
+================================================================================
+
+❌ DO NOT make "responsive" UI only
+✅ CREATE SEPARATE UIs for each platform:
+
+MOBILE (375px):
+  - Bottom navigation bar
+  - Full-screen modal for search (closable)
+  - Pull-to-refresh
+  - Touch targets 44x44px minimum
+
+TABLET (768px):
+  - Condensed data in dropdowns
+  - Hybrid collapsible sidebar
+  - Adapted touch/click
+
+DESKTOP (1280px+):
+  - Left sidebar: notifications, profile, nav
+  - Top navbar: centered Levenshtein search
+  - High information density
+
+SHARED:
+  - Featured carousel section
+  - Hidden scrollbars (but scroll works)
+  - Scroll indicators (arrows)
+  - Framer Motion transitions
+
+================================================================================
+INPUT VALIDATION RULES (ALL INPUTS)
+================================================================================
+
+Every input MUST have:
+  - Real-time visual feedback (green/red borders)
+  - Error checklist below input (disappears when fixed)
+  - Autofill validation (prevent email in nickname field)
+  - onInput + onAnimationStart for autofill detection
+
+================================================================================
+NRY - NEVER REPEAT YOURSELF (Common Claude Mistakes)
+================================================================================
+
+❌ Multi-line bash with backslash (breaks permissions)
+❌ Relative paths in permissions
+❌ Ignoring context size (use /compact)
+❌ Relying on undo for critical code
+❌ Executing agent logic manually
+❌ Using bash for file operations (cat, echo >)
+
+✅ Single-line commands with &&
+✅ Absolute paths in permissions
+✅ Commit to git before major changes
+✅ Use Task tool to invoke agents
+✅ Use Read/Write/Edit for files
+
+================================================================================
+AGENT INVOCATION (VIA TASK TOOL ONLY)
 ================================================================================
 
 You MUST use the Task tool with subagent_type to invoke agents.
 DO NOT execute agent logic manually - INVOKE the agent properly.
 
-AGENTS THAT CAN BE INVOKED VIA TASK TOOL:
-  - commit-manager: Use Task(subagent_type="commit-manager", prompt="...")
-  - analyzer: Use Task(subagent_type="analyzer", prompt="...")
-  - tester: Use Task(subagent_type="tester", prompt="...")
-  - security-auditor: Use Task(subagent_type="security-auditor", prompt="...")
-  - quality-checker: Use Task(subagent_type="quality-checker", prompt="...")
-  - final-validator: Use Task(subagent_type="final-validator", prompt="...")
-  - documenter: Use Task(subagent_type="documenter", prompt="...")
-  - ui-ux-reviewer: Use Task(subagent_type="ui-ux-reviewer", prompt="...")
-  - orchestrator: Use Task(subagent_type="orchestrator", prompt="...")
+AGENTS INVOCABLE VIA TASK TOOL:
+  - research: Task(subagent_type="research", prompt="...") {"<-- MANDATORY FOR THIS TASK" if is_new_feature else ""}
+  - analyzer: Task(subagent_type="analyzer", prompt="...")
+  - ui-ux-reviewer: Task(subagent_type="ui-ux-reviewer", prompt="...") {"<-- MANDATORY FOR THIS TASK" if is_ui_task else ""}
+  - tester: Task(subagent_type="tester", prompt="...")
+  - security-auditor: Task(subagent_type="security-auditor", prompt="...")
+  - quality-checker: Task(subagent_type="quality-checker", prompt="...")
+  - final-validator: Task(subagent_type="final-validator", prompt="...")
+  - documenter: Task(subagent_type="documenter", prompt="...")
+  - commit-manager: Task(subagent_type="commit-manager", prompt="...")
+  - orchestrator: Task(subagent_type="orchestrator", prompt="...")
 
-WRONG (manual execution):
-  "Let me create the commit..." then git commands directly
+================================================================================
+MANDATORY RULES CHECKLIST:
+================================================================================
+
+[ ] 1. I WILL create a DETAILED todo list using TodoWrite FIRST
+[ ] 2. I WILL run research agent for new features (MANDATORY)
+[ ] 3. I WILL check/create audit documentation
+[ ] 4. I WILL create proper branch (feature/fix/refactor/test)
+[ ] 5. I WILL create SEPARATE UIs for mobile/tablet/desktop (if UI task)
+[ ] 6. I WILL add real-time validation to ALL inputs
+[ ] 7. I WILL document with commit hash references
+[ ] 8. I WILL run quality gates before commit (Husky enforced)
+[ ] 9. I WILL create PR to main with doc references
+[ ] 10. I WILL use Task tool to invoke agents (NOT manually)
+
+================================================================================
+COMPONENT DESIGN RULES (SELF-AWARE RESPONSIVE):
+================================================================================
 
-CORRECT (agent invocation):
-  Use Task tool with subagent_type="commit-manager"
+Components CAN be responsive internally (detect their own device type).
+But layouts MUST be separate for each platform.
+
+CARD COMPONENTS:
+  - NO BORDERS - Use shadows and backgrounds instead
+  - Use useDeviceType() hook for self-awareness
+  - Adapt padding/layout based on device
+  - Desktop: hover effects (scale, shadow)
+  - Mobile: touch-optimized (44px targets)
+
+```typescript
+// GOOD - Self-aware component
+const device = useDeviceType();
+<div className={cn(
+  'rounded-2xl shadow-lg', // NO borders
+  device === 'mobile' ? 'p-4' : 'p-6 hover:scale-[1.02]'
+)} />
+```
 
 ================================================================================
-MANDATORY RULES:
+END OF WORKFLOW MANDATORY:
 ================================================================================
 
-1. I WILL use Task tool to invoke agent: {best_agent}
-2. I WILL NOT execute agent logic manually - ALWAYS invoke via Task tool
-3. I WILL NOT create redundant files
-4. I WILL NOT over-engineer - keep solutions simple and focused
-5. I WILL follow the workflow sequence strictly
-6. I MUST run analyzer BEFORE any Edit/Write to source files
-7. I MUST run commit-manager via Task tool for ALL commits
-8. After commit, I MUST update domains and run complete-task
-
-WORKFLOW COMMANDS (for tracking, not replacement for agents):
-  Start task: python .claude/hooks/workflow-manager.py start-task --type {task_type} --description "..."
-  Approve files: python .claude/hooks/workflow-manager.py approve-files --files "path/to/file"
+After completing any task, you MUST:
+
+1. Run commit-manager agent via Task tool
+2. Commit all changes with conventional commit format
+3. Create PR to main if on feature/fix branch
+4. NEVER leave uncommitted changes
+
+This is MANDATORY - workflow is NOT complete until committed.
 
 ================================================================================
 """

package/template/.claude/settings.json

@@ -1,7 +1,4 @@
 {
-	"name": "AI Builder Development",
-	"version": "1.2.0",
-	"description": "Configuracao para agentes de desenvolvimento do AI Builder - Todos agentes pesquisam best practices",
 
 	"model": "claude-opus-4-5-20251101",
 	"max_tokens": 8192,
@@ -66,42 +63,6 @@
 					}
 				]
 			}
-		],
-		"PreToolUse": [
-			{
-				"matcher": "Edit|Write|NotebookEdit",
-				"hooks": [
-					{
-						"type": "command",
-						"command": "python .claude/hooks/pre-tool-use.py",
-						"timeout": 5
-					}
-				]
-			}
-		],
-		"PostToolUse": [
-			{
-				"matcher": "Edit|Write|NotebookEdit",
-				"hooks": [
-					{
-						"type": "command",
-						"command": "python .claude/hooks/post-tool-use.py",
-						"timeout": 5
-					}
-				]
-			}
-		],
-		"Stop": [
-			{
-				"matcher": "",
-				"hooks": [
-					{
-						"type": "command",
-						"command": "python .claude/hooks/stop-validation.py",
-						"timeout": 10
-					}
-				]
-			}
 		]
 	},
 

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

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