Files
agentic-dev/.claude/hooks/generator-first-nudge.sh
2026-07-12 08:15:46 +00:00

44 lines
1.6 KiB
Bash
Executable File

#!/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