chore: add PR auto-review hook and update CLAUDE.md

- Add PostToolUse hook that triggers Claude review after gh pr create
- Add review-pr.sh script with checklist based on CLAUDE.md rules
- Add PR review section to CLAUDE.md with review guidelines

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: rviannaoliveira

.claude/scripts/review-pr.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# Hook: auto-review PR after gh pr create
+# Reads tool output from stdin (JSON), extracts PR URL and triggers Claude review
+
+INPUT=$(cat)
+
+COMMAND=$(echo "$INPUT" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('tool_input',{}).get('command',''))" 2>/dev/null)
+
+# Only trigger on gh pr create
+if ! echo "$COMMAND" | grep -q "gh pr create"; then
+  exit 0
+fi
+
+OUTPUT=$(echo "$INPUT" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('tool_response',''))" 2>/dev/null)
+
+PR_URL=$(echo "$OUTPUT" | grep -oE 'https://github\.com/[^ ]+/pull/[0-9]+')
+PR_NUMBER=$(echo "$PR_URL" | grep -oE '[0-9]+$')
+
+if [ -z "$PR_NUMBER" ]; then
+  exit 0
+fi
+
+echo "Iniciando review do PR #$PR_NUMBER..."
+
+claude -p "Review PR #$PR_NUMBER do repositório CraftD seguindo as regras de review do CLAUDE.md. Use 'gh pr view $PR_NUMBER --json files,body,title' para ver o PR, leia os arquivos modificados, e poste um review com 'gh pr review $PR_NUMBER --comment -b \"<seu comentário>\"' cobrindo: regras arquiteturais, completude (builder registrado, onAction coberto), testes e docs." \
+  --allowedTools "Bash(gh pr view:*),Bash(gh pr review:*),Bash(gh api:*),Read,Glob,Grep" \
+  2>/dev/null &
+
+echo "Review do PR #$PR_NUMBER iniciado em background."

.claude/settings.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/scripts/review-pr.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

CLAUDE.md

@@ -160,6 +160,18 @@ commonMain/
 - **`pr.yml`** — build e testes, dispara em todo PR
 - **`generate-tests.yml`** — gera testes unitários automaticamente via Claude API para `.kt` modificados, abre PR separado. Só roda após `pr.yml` passar. Não roda em PRs de bots.
 
+## Review de PRs
+
+Quando um PR for publicado ou quando solicitado, revisar usando `gh pr review` verificando:
+
+1. **Regras arquiteturais** — componente implementa `CraftDBuilder` (ou equivalente), sem dependência entre módulos de plataforma, `commonMain` sem deps de plataforma
+2. **Completude** — builder registrado no `CraftDBuilderManager`, `onAction`/fallback coberto, `ImageProperties` (ou equivalente) no `craftd-core`
+3. **Testes** — testes unitários presentes e com nomenclatura correta em backtick
+4. **Docs** — `docs/how-to-use/` atualizado para a plataforma afetada
+5. **Padrão de código** — prefixo `CraftD`, `Modifier` exposto, sem valores hardcoded de cor/tipografia
+
+Usar `gh pr review <número> --comment -b "<comentário>"` para comentários gerais e `gh api` para comentários em linha específicos.
+
 ---
 
 ## O que não fazer