start-vibing 2.0.1 → 2.0.3

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

@@ -0,0 +1,298 @@
+#!/usr/bin/env bun
+/**
+ * UserPromptSubmit Hook - TypeScript version (fallback when Python not available)
+ *
+ * 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)
+ */
+
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+
+const PROJECT_DIR = process.env['CLAUDE_PROJECT_DIR'] || process.cwd();
+const WORKFLOW_STATE_PATH = join(PROJECT_DIR, '.claude', 'workflow-state.json');
+
+const STRICT_WORKFLOW = `
+┌─────────────────────────────────────────────────────────────────┐
+│                    STRICT WORKFLOW (MANDATORY)                  │
+├─────────────────────────────────────────────────────────────────┤
+│ 0. INIT TASK    → Run commit-manager to REGISTER task start    │
+│ 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 ALL modified files (MANDATORY)      │
+│ 7. QUALITY      → typecheck + lint + test (Husky enforced)     │
+│ 8. FINISH       → commit-manager creates PR with task summary  │
+└─────────────────────────────────────────────────────────────────┘
+
+⚠️  STOP HOOK ACTIVE - Task completion will be BLOCKED if:
+    - Working directly on main branch (must use feature/fix branch)
+    - Source files not documented (must run documenter agent)
+    - Documenter agent not executed for code changes
+`;
+
+interface AgentInfo {
+  description: string;
+  triggers: string[];
+  priority: number;
+  when: string;
+  can_veto?: boolean;
+  mandatory_for?: string[];
+  enforces?: string;
+}
+
+const AGENTS: Record<string, AgentInfo> = {
+  '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 (2024-2025) - MANDATORY for new features',
+    triggers: ['research', 'investigate', 'study', 'best practice', 'how to', 'pattern', 'new feature', 'implement'],
+    priority: 3,
+    when: 'MANDATORY for ANY new feature or complex bug fix',
+    mandatory_for: ['feature', 'fix']
+  },
+  'ui-ux-reviewer': {
+    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',
+    enforces: 'SEPARATE UIs for each platform (NOT just responsive)'
+  },
+  'documenter': {
+    description: 'Documents results with commit hash references',
+    triggers: ['document', 'readme', 'docs', 'explain'],
+    priority: 4,
+    when: 'After implementation - MUST include commit hash for audit trail'
+  },
+  '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 (Husky pre-commit)',
+    triggers: ['check', 'verify', 'validate', 'run tests', 'quality'],
+    priority: 7,
+    when: 'BEFORE any commit - Husky enforces this'
+  },
+  'final-validator': {
+    description: 'Final validation before commit (CAN VETO)',
+    triggers: ['final', 'commit ready', 'approve'],
+    priority: 8,
+    when: 'Before any commit operation',
+    can_veto: true
+  },
+  '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'
+  },
+  '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'
+  }
+};
+
+const WORKFLOWS: Record<string, string[]> = {
+  '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']
+};
+
+interface WorkflowState {
+  currentTask?: {
+    id?: string;
+    type?: string;
+    description?: string;
+    agents?: Record<string, { executed?: boolean }>;
+    approvedFiles?: string[];
+  };
+}
+
+function loadWorkflowState(): WorkflowState | null {
+  if (!existsSync(WORKFLOW_STATE_PATH)) return null;
+  try {
+    return JSON.parse(readFileSync(WORKFLOW_STATE_PATH, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function detectTaskType(prompt: string): string {
+  const promptLower = prompt.toLowerCase();
+
+  if (['bug', 'fix', 'error', 'broken', 'not working', 'issue'].some(w => promptLower.includes(w))) {
+    return 'fix';
+  } else if (['refactor', 'restructure', 'reorganize', 'clean up'].some(w => promptLower.includes(w))) {
+    return 'refactor';
+  } else if (['config', 'setting', 'env', 'package.json', 'tsconfig'].some(w => promptLower.includes(w))) {
+    return 'config';
+  }
+  return 'feature';
+}
+
+function detectBestAgent(prompt: string): [string, string] {
+  const promptLower = prompt.toLowerCase();
+
+  const multiStepIndicators = ['and then', 'after that', 'also', 'implement', 'build', 'create feature'];
+  if (multiStepIndicators.some(ind => promptLower.includes(ind))) {
+    return ['orchestrator', 'Multi-step task detected - orchestrator will coordinate all agents'];
+  }
+
+  const matches: Array<[string, number, string]> = [];
+  for (const [agentName, agentInfo] of Object.entries(AGENTS)) {
+    for (const trigger of agentInfo.triggers) {
+      if (promptLower.includes(trigger)) {
+        matches.push([agentName, agentInfo.priority, trigger]);
+      }
+    }
+  }
+
+  if (matches.length > 0) {
+    matches.sort((a, b) => a[1] - b[1]);
+    const best = matches[0];
+    return [best[0], `Matched trigger '${best[2]}'`];
+  }
+
+  return ['orchestrator', 'No specific trigger matched - orchestrator will analyze'];
+}
+
+function formatAgentList(): string {
+  const sorted = Object.entries(AGENTS).sort((a, b) => a[1].priority - b[1].priority);
+  return sorted.map(([name, info]) => {
+    const veto = info.can_veto ? ' [CAN VETO]' : '';
+    return `  - ${name}: ${info.description}${veto}`;
+  }).join('\n');
+}
+
+function formatWorkflowStatus(state: WorkflowState | null): string {
+  if (!state || !state.currentTask) {
+    return 'STATUS: No active task. Start with orchestrator agent';
+  }
+
+  const task = state.currentTask;
+  const agents = task.agents || {};
+
+  const executed = Object.entries(agents).filter(([, s]) => s.executed).map(([n]) => n);
+  const pending = Object.entries(agents).filter(([, s]) => !s.executed).map(([n]) => n);
+
+  return `STATUS: Task active
+  ID: ${task.id || 'unknown'}
+  Type: ${task.type || 'unknown'}
+  Description: ${task.description || 'unknown'}
+  Executed: ${executed.length > 0 ? executed.join(', ') : 'none'}
+  Pending: ${pending.length > 0 ? pending.join(', ') : 'none'}
+  Approved files: ${(task.approvedFiles || []).length}`;
+}
+
+async function readStdinWithTimeout(timeoutMs: number): Promise<string> {
+  return new Promise((resolve) => {
+    const timeout = setTimeout(() => resolve('{}'), timeoutMs);
+
+    Bun.stdin.text().then((text) => {
+      clearTimeout(timeout);
+      resolve(text || '{}');
+    }).catch(() => {
+      clearTimeout(timeout);
+      resolve('{}');
+    });
+  });
+}
+
+async function main(): Promise<void> {
+  let hookInput: { user_prompt?: string; prompt?: string } = {};
+  try {
+    const stdin = await readStdinWithTimeout(1000);
+    if (stdin && stdin.trim()) {
+      hookInput = JSON.parse(stdin);
+    }
+  } catch {
+    hookInput = {};
+  }
+
+  const prompt = hookInput.user_prompt || hookInput.prompt || '';
+  const state = loadWorkflowState();
+  const taskType = prompt ? detectTaskType(prompt) : 'unknown';
+  const [bestAgent, reason] = prompt ? detectBestAgent(prompt) : ['orchestrator', 'Default'];
+
+  const isNewFeature = taskType === 'feature' || ['new', 'implement', 'create', 'add'].some(w => prompt.toLowerCase().includes(w));
+  const isUiTask = ['ui', 'component', 'page', 'design', 'layout', 'mobile', 'desktop', 'tablet'].some(w => prompt.toLowerCase().includes(w));
+
+  const output = `
+================================================================================
+STRICT WORKFLOW ENFORCEMENT - UserPromptSubmit Hook
+================================================================================
+${STRICT_WORKFLOW}
+
+${isNewFeature ? '⚠️  NEW FEATURE DETECTED - RESEARCH AGENT IS MANDATORY!' : ''}
+${isUiTask ? '⚠️  UI TASK DETECTED - SEPARATE UIs FOR MOBILE/TABLET/DESKTOP REQUIRED!' : ''}
+
+================================================================================
+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.
+
+================================================================================
+AVAILABLE AGENTS:
+${formatAgentList()}
+
+TASK ANALYSIS:
+  Detected type: ${taskType}
+  Recommended agent: ${bestAgent}
+  Reason: ${reason}
+  Research required: ${isNewFeature ? 'YES (MANDATORY)' : 'Optional'}
+  Separate UIs required: ${isUiTask ? 'YES (MANDATORY)' : 'N/A'}
+  Workflow sequence: ${(WORKFLOWS[taskType] || WORKFLOWS['feature']).join(' -> ')}
+
+${formatWorkflowStatus(state)}
+
+================================================================================
+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.
+
+================================================================================
+`;
+
+  const result = { continue: true, systemMessage: output };
+  console.log(JSON.stringify(result));
+  process.exit(0);
+}
+
+main().catch((err) => {
+  console.error('Hook error:', err);
+  const result = { continue: true, systemMessage: 'Hook error occurred, continuing...' };
+  console.log(JSON.stringify(result));
+  process.exit(0);
+});

package/template/.claude/settings.json

@@ -47,7 +47,8 @@
 			"Bash(bun run typecheck:*)",
 			"Bash(git add:*)",
 			"Bash(git commit:*)",
-			"Bash(python .claude/hooks/*)"
+			"Bash(python .claude/hooks/*)",
+			"Bash(bun .claude/hooks/*)"
 		]
 	},
 
@@ -58,7 +59,7 @@
 				"hooks": [
 					{
 						"type": "command",
-						"command": "python .claude/hooks/user-prompt-submit.py",
+						"command": "bun .claude/hooks/run-hook.ts user-prompt-submit",
 						"timeout": 10
 					}
 				]
@@ -69,7 +70,7 @@
 				"hooks": [
 					{
 						"type": "command",
-						"command": "python .claude/hooks/stop-validator.py",
+						"command": "bun .claude/hooks/run-hook.ts stop-validator",
 						"timeout": 30
 					}
 				]