Initial commit

.claude/hooks/generator-first-nudge.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+# Tier 1 — enforces the generator-first rule. Blocks hand-rolled scaffolding
+# under packages/ or apps/ via mkdir/cp/touch. Use `pnpm turbo gen <kind>`.
+
+set -euo pipefail
+
+input=$(cat)
+cmd=$(printf '%s' "$input" | jq -r '.tool_input.command // ""')
+
+# Match creation of a NEW top-level packages/<name>/ or apps/<name>/ directory.
+# Allows working inside an existing package (e.g. `mkdir -p packages/blog/src/foo`).
+patterns=(
+  'mkdir[[:space:]]+(-p[[:space:]]+)?packages/[a-zA-Z0-9_-]+/?([[:space:]]|$)'
+  'mkdir[[:space:]]+(-p[[:space:]]+)?apps/[a-zA-Z0-9_-]+/?([[:space:]]|$)'
+  'cp[[:space:]]+-[rR][[:space:]]+packages/[^[:space:]]+[[:space:]]+packages/[a-zA-Z0-9_-]+/?([[:space:]]|$)'
+)
+
+for pattern in "${patterns[@]}"; do
+  if [[ "$cmd" =~ $pattern ]]; then
+    cat >&2 <<EOF
+BLOCKED by .claude/hooks/generator-first-nudge.sh
+
+This template enforces "generator-first" — hand-rolled scaffolding under
+packages/ or apps/ is forbidden. Use a generator:
+
+  pnpm turbo gen feature              # new vertical feature
+  pnpm turbo gen core-package <name>  # optional core (events|realtime|audit|trpc|ui)
+  pnpm turbo gen event                # event contract or handler
+  pnpm turbo gen job                  # background job
+  pnpm turbo gen realtime             # realtime channel or handler
+  pnpm turbo gen core-ui-component    # atomic-design UI component
+
+If you're modifying an existing package (e.g. \`mkdir -p packages/blog/src/x\`)
+this hook will not block you. If you genuinely need to bypass (e.g. fixing
+the generator itself), ask the user to authorize and re-state the intent.
+
+Command: ${cmd}
+EOF
+    exit 2
+  fi
+done
+
+exit 0