start-vibing 1.1.2 → 1.1.3

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

@@ -1,277 +1,68 @@
 #!/usr/bin/env python3
 """
-UserPromptSubmit Hook - Agent Selection 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
-
-Output is sent to Claude as context before processing the user's request.
-
-Based on official Claude Code documentation:
-https://code.claude.com/docs/en/hooks.md
+UserPromptSubmit Hook - Lightweight workflow guidance.
+Provides brief context to Claude without verbose output.
 """
 
 import json
 import sys
-import os
-import re
-from pathlib import Path
-
-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'
-
-# Agent definitions with triggers
-AGENTS = {
-    'orchestrator': {
-        'description': 'Coordinates entire development flow',
-        'triggers': ['implement feature', 'build', 'create', 'fix and test', 'full workflow', 'multi-step'],
-        'priority': 1,
-        'when': 'Task requires >2 agents or touches >3 files'
-    },
-    'analyzer': {
-        'description': 'Analyzes impact before code modification',
-        'triggers': ['implement', 'add feature', 'fix bug', 'refactor', 'change', 'modify', 'update code'],
-        'priority': 2,
-        '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'],
-        'priority': 3,
-        'when': 'AFTER analyzer - finds best practices before implementation'
-    },
-    'ui-ux-reviewer': {
-        'description': 'Reviews UI/UX and researches competitors',
-        'triggers': ['ui', 'component', 'page', 'design', 'layout', 'style', 'responsive', 'frontend'],
-        'priority': 3,
-        'when': 'Files in components/, app/, or .tsx with JSX'
-    },
-    'documenter': {
-        'description': 'Creates and maintains documentation',
-        'triggers': ['document', 'readme', 'docs', 'explain'],
-        'priority': 4,
-        'when': 'After code implementation completes'
-    },
-    'tester': {
-        'description': 'Creates unit tests (Vitest) and E2E tests (Playwright)',
-        'triggers': ['test', 'coverage', 'spec', 'e2e'],
-        'priority': 5,
-        'when': 'After any code implementation'
-    },
-    'security-auditor': {
-        'description': 'Audits security (CAN VETO)',
-        'triggers': ['auth', 'session', 'password', 'token', 'api', 'database', 'user data', 'security'],
-        'priority': 6,
-        'when': 'Code touches auth/, api/, server/, or sensitive data',
-        'can_veto': True
-    },
-    'quality-checker': {
-        'description': 'Runs typecheck, lint, test, build',
-        'triggers': ['check', 'verify', 'validate', 'run tests', 'quality'],
-        'priority': 7,
-        'when': 'After implementation and tests complete'
-    },
-    'final-validator': {
-        'description': 'Final validation before commit (CAN VETO)',
-        'triggers': ['final', 'commit ready', 'approve'],
-        'priority': 8,
-        'when': 'Before any commit operation',
-        'can_veto': True
-    },
-    'commit-manager': {
-        'description': 'Creates conventional commits and completes workflow',
-        'triggers': ['commit', 'save changes', 'push', 'finalize', 'git'],
-        'priority': 10,
-        'when': 'FINAL step - after domain-updater, runs complete-task'
-    },
-    'domain-updater': {
-        'description': 'Updates domain knowledge with session learnings',
-        'triggers': ['update domain', 'document learnings', 'session end'],
-        'priority': 9,
-        'when': 'BEFORE commit-manager - updates domains so git stays clean'
-    }
-}
-
-# Workflow sequences (research after analyzer, domain-updater BEFORE commit-manager for clean git)
-WORKFLOWS = {
-    'feature': ['analyzer', 'research', 'ui-ux-reviewer', 'documenter', 'tester', 'security-auditor', 'quality-checker', 'final-validator', 'domain-updater', 'commit-manager'],
-    'fix': ['analyzer', 'research', 'tester', 'security-auditor', 'quality-checker', 'final-validator', 'domain-updater', 'commit-manager'],
-    'refactor': ['analyzer', 'tester', 'quality-checker', 'final-validator', 'domain-updater', 'commit-manager'],
-    'config': ['quality-checker', 'domain-updater', 'commit-manager']
-}
-
-
-def load_workflow_state():
-    """Load current workflow state"""
-    if not WORKFLOW_STATE_PATH.exists():
-        return None
-    try:
-        with open(WORKFLOW_STATE_PATH) as f:
-            return json.load(f)
-    except (json.JSONDecodeError, IOError):
-        return None
-
 
 def detect_task_type(prompt: str) -> str:
-    """Detect task type from prompt"""
-    prompt_lower = prompt.lower()
-
-    if any(word in prompt_lower for word in ['bug', 'fix', 'error', 'broken', 'not working', 'issue']):
+    """Detect task type from prompt."""
+    p = prompt.lower()
+    if any(w in p for w in ['bug', 'fix', 'error', 'broken', 'issue']):
         return 'fix'
-    elif any(word in prompt_lower for word in ['refactor', 'restructure', 'reorganize', 'clean up']):
+    if any(w in p for w in ['refactor', 'restructure', 'clean up']):
         return 'refactor'
-    elif any(word in prompt_lower for word in ['config', 'setting', 'env', 'package.json', 'tsconfig']):
+    if any(w in p for w in ['config', 'setting', '.env', 'package.json']):
         return 'config'
-    else:
-        return 'feature'
-
-
-def detect_best_agent(prompt: str) -> tuple[str, str]:
-    """Detect best agent for the task"""
-    prompt_lower = prompt.lower()
-
-    # Check for multi-step tasks first
-    multi_step_indicators = ['and then', 'after that', 'also', 'implement', 'build', 'create feature']
-    if any(indicator in prompt_lower for indicator in multi_step_indicators):
-        return 'orchestrator', 'Multi-step task detected - orchestrator will coordinate all agents'
-
-    # Check each agent's triggers
-    matches = []
-    for agent_name, agent_info in AGENTS.items():
-        for trigger in agent_info['triggers']:
-            if trigger in prompt_lower:
-                matches.append((agent_name, agent_info['priority'], trigger))
-
-    if matches:
-        # Sort by priority (lower is better)
-        matches.sort(key=lambda x: x[1])
-        best = matches[0]
-        return best[0], f"Matched trigger '{best[2]}'"
-
-    # Default to orchestrator for unknown tasks
-    return 'orchestrator', 'No specific trigger matched - orchestrator will analyze'
-
-
-def format_agent_list() -> str:
-    """Format agent list for display"""
-    lines = []
-    for name, info in sorted(AGENTS.items(), key=lambda x: x[1]['priority']):
-        veto = ' [CAN VETO]' if info.get('can_veto') else ''
-        lines.append(f"  - {name}: {info['description']}{veto}")
-    return '\n'.join(lines)
-
-
-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"
-
-    task = state['currentTask']
-    agents = task.get('agents', {})
-
-    executed = [name for name, status in agents.items() if status.get('executed')]
-    pending = [name for name, status in agents.items() if not status.get('executed')]
-
-    return f"""STATUS: Task active
-  ID: {task.get('id', 'unknown')}
-  Type: {task.get('type', 'unknown')}
-  Description: {task.get('description', 'unknown')}
-  Executed: {', '.join(executed) if executed else 'none'}
-  Pending: {', '.join(pending) if pending else 'none'}
-  Approved files: {len(task.get('approvedFiles', []))}"""
-
+    return 'feature'
+
+def get_workflow(task_type: str) -> list:
+    """Get workflow for task type."""
+    workflows = {
+        'feature': ['commit-manager:branch', 'analyzer', 'research', 'implement', 'tester', 'quality-checker', 'domain-updater', 'commit-manager:commit'],
+        'fix': ['commit-manager:branch', 'analyzer', 'implement', 'tester', 'quality-checker', 'domain-updater', 'commit-manager:commit'],
+        'refactor': ['commit-manager:branch', 'analyzer', 'implement', 'tester', 'quality-checker', 'domain-updater', 'commit-manager:commit'],
+        'config': ['quality-checker', 'commit-manager:commit']
+    }
+    return workflows.get(task_type, workflows['feature'])
 
 def main():
-    # Read hook input from stdin
     try:
         hook_input = json.load(sys.stdin)
     except json.JSONDecodeError:
-        hook_input = {}
-
-    # Get user prompt (may not be available in all hook contexts)
-    prompt = hook_input.get('user_prompt', hook_input.get('prompt', ''))
-
-    # Load current state
-    state = load_workflow_state()
-
-    # Detect task type and best agent
-    task_type = detect_task_type(prompt) if prompt else 'unknown'
-    best_agent, reason = detect_best_agent(prompt) if prompt else ('orchestrator', 'Default')
+        sys.exit(0)
 
-    # Build output message
-    output = f"""
-================================================================================
-WORKFLOW ENFORCEMENT - UserPromptSubmit Hook
-================================================================================
+    prompt = hook_input.get('prompt', '')
+    if not prompt:
+        sys.exit(0)
 
-AVAILABLE AGENTS:
-{format_agent_list()}
+    task_type = detect_task_type(prompt)
+    workflow = get_workflow(task_type)
 
-TASK ANALYSIS:
-  Detected type: {task_type}
-  Recommended agent: {best_agent}
-  Reason: {reason}
-  Workflow sequence: {' -> '.join(WORKFLOWS.get(task_type, WORKFLOWS['feature']))}
+    # Compact context for Claude
+    context = f"""Task: {task_type}
+Workflow: {' → '.join(workflow)}
 
-{format_workflow_status(state)}
+Rules:
+- START: commit-manager creates feature branch
+- IMPLEMENT: follow workflow sequence
+- UPDATE: domain-updater before commit
+- END: commit-manager commits and merges to main
 
-================================================================================
-CRITICAL: INVOKE AGENTS VIA TASK TOOL - NOT MANUALLY
-================================================================================
+Agents: analyzer, research, tester, quality-checker, security-auditor, documenter, ui-ux-reviewer, domain-updater, commit-manager"""
 
-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="...")
-
-WRONG (manual execution):
-  "Let me create the commit..." then git commands directly
-
-CORRECT (agent invocation):
-  Use Task tool with subagent_type="commit-manager"
-
-================================================================================
-MANDATORY RULES:
-================================================================================
-
-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"
-
-================================================================================
-"""
-
-    # Return as JSON with decision to continue
     result = {
         "continue": True,
-        "systemMessage": output
+        "hookSpecificOutput": {
+            "hookEventName": "UserPromptSubmit",
+            "additionalContext": context
+        }
     }
 
     print(json.dumps(result))
     sys.exit(0)
 
-
 if __name__ == '__main__':
     main()

package/template/.claude/settings.json

@@ -1,269 +1,41 @@
 {
-	"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,
-	"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
-					}
-				]
-			}
-		],
-		"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
-					}
-				]
-			}
-		]
-	},
-
-	"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
-		}
-	}
+  "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
 }