claude-git-hooks 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -5,6 +5,33 @@ Todos los cambios notables en este proyecto se documentarán en este archivo.
 El formato está basado en [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.4.0] - 2025-08-29
+
+### Added
+- 🎯 Prompts externalizados en archivos `.md` para facilitar personalización
+- 🤖 Generación automática de prompt AI-friendly para resolución de problemas críticos
+- 📝 Nuevos templates de prompts: `CLAUDE_ANALYSIS_PROMPT.md`, `CLAUDE_ANALYSIS_PROMPT_SONAR.md`, `CLAUDE_RESOLUTION_PROMPT.md`
+- 🔍 Localización precisa en blockingIssues (archivo, línea, método, severidad)
+- 📋 Archivo `claude_resolution_prompt.md` generado automáticamente con issues para resolver
+- 🚀 Flag `--skip-auth` para omitir verificación de autenticación en instalación
+- 📖 Ejemplos detallados de respuestas JSON con blocking issues en README
+
+### Changed
+- 🏗️ Estandarización de `blockingIssues` a formato objeto (nunca strings)
+- 📦 Separación de prompts del código para mayor mantenibilidad
+- 🔧 Hook pre-commit simplificado sin fallbacks complejos
+- 📁 Instalador actualizado para copiar todos los templates de prompts
+
+### Fixed
+- 🐛 Consistencia en el formato de respuesta JSON para ambos modos
+- 🔧 Mejor manejo de errores cuando faltan archivos de configuración
+
+### Technical
+- 🏗️ Función `generate_resolution_prompt()` para crear prompts de resolución
+- 📝 Templates de prompts con placeholders reemplazables
+- 🎯 Estructura JSON estricta para blockingIssues con campos obligatorios
+- 🔄 Instalación en modo force actualiza todos los templates
+
 ## [1.3.0] - 2025-08-28
 
 ### Added

package/README.md

@@ -10,6 +10,9 @@ Este directorio contiene un pre-commit hook que utiliza Claude CLI para revisar
 - **`.gitattributes`** - Configuración para mantener line endings correctos
 - **`.claude/CLAUDE_PRE_COMMIT.md`** - Pautas de evaluación formato estándar
 - **`.claude/CLAUDE_PRE_COMMIT_SONAR.md`** - Pautas de evaluación formato SonarQube
+- **`.claude/CLAUDE_ANALYSIS_PROMPT.md`** - Template de prompt para análisis estándar
+- **`.claude/CLAUDE_ANALYSIS_PROMPT_SONAR.md`** - Template de prompt para análisis SonarQube
+- **`.claude/CLAUDE_RESOLUTION_PROMPT.md`** - Template para generar prompt de resolución AI
 
 ## 🔧 Configuración Previa Importante
 
@@ -64,13 +67,19 @@ claude-hooks install
 ```
 
 El comando `claude-hooks install` ahora incluye:
+
 - ✅ Verificación completa de dependencias del sistema
 - ✅ Instalación automática de paquetes faltantes (jq, curl)
 - ✅ Configuración de Git (line endings WSL/Windows)
-- ✅ Verificación de autenticación Claude con entretenimiento
+- ✅ Verificación de autenticación Claude con entretenimiento (omitible con `--skip-auth`)
 - ✅ Instalación de hooks y archivos de pautas
 - ✅ Actualización automática de .gitignore con archivos de Claude
 
+**Opciones de instalación:**
+
+- `--force`: Reinstala aunque los hooks ya existan
+- `--skip-auth`: Omite la verificación de autenticación de Claude (útil para CI/CD)
+
 #### Añadir como Dependencia de Desarrollo
 
 ```bash
@@ -108,10 +117,14 @@ El comando `claude-hooks install` crea los siguientes archivos y directorios:
 
 1. **`.git/hooks/pre-commit`** - Hook de análisis de código
 2. **`.git/hooks/prepare-commit-msg`** - Hook de generación de mensajes
-3. **`.claude/`** - Directorio para archivos de configuración
+3. **`.git/hooks/check-version.sh`** - Script de verificación de versión
+4. **`.claude/`** - Directorio para archivos de configuración
    - `CLAUDE_PRE_COMMIT.md` - Pautas de evaluación estándar
    - `CLAUDE_PRE_COMMIT_SONAR.md` - Pautas de evaluación SonarQube
-4. **`.claude-analysis-mode`** - Archivo de preferencia de modo (creado al primer uso)
+   - `CLAUDE_ANALYSIS_PROMPT.md` - Template de prompt para análisis estándar
+   - `CLAUDE_ANALYSIS_PROMPT_SONAR.md` - Template de prompt para análisis SonarQube
+   - `CLAUDE_RESOLUTION_PROMPT.md` - Template para prompt de resolución AI
+5. **`.claude-analysis-mode`** - Archivo de preferencia de modo (creado al primer uso)
 
 ### Actualización automática de .gitignore
 
@@ -122,9 +135,11 @@ Durante la instalación, Claude Hooks actualiza automáticamente tu `.gitignore`
 .claude/
 .claude-analysis-mode
 debug-claude-response.json
+claude_resolution_prompt.md
 ```
 
 Esto asegura que:
+
 - Los archivos de configuración de Claude específicos del proyecto no se suban al repositorio
 - Los archivos de debug temporales se ignoren
 - Cada desarrollador pueda tener sus propias preferencias de análisis
@@ -144,17 +159,28 @@ Si no existe un `.gitignore`, se creará uno nuevo. Si ya existe, las entradas s
    - **Estándar**: Formato clásico con score y recomendaciones detalladas
    - **SonarQube**: Simula salida de SonarQube con Quality Gate, métricas y clasificación de issues
 4. **Construye prompt inteligente**:
-   - Lee las pautas desde `.claude/CLAUDE_PRE_COMMIT.md` o `.claude/CLAUDE_PRE_COMMIT_SONAR.md`
+   - Usa template de prompt desde `.claude/CLAUDE_ANALYSIS_PROMPT*.md`
+   - Lee las pautas desde `.claude/CLAUDE_PRE_COMMIT*.md`
    - Incluye el diff completo para archivos nuevos
    - Muestra solo cambios para archivos existentes
 5. **Envía a Claude CLI para revisión**
-6. **Procesa respuesta JSON**:
+6. **Procesa respuesta JSON estructurada**:
+   - blockingIssues siempre como objetos con localización precisa
    - En modo estándar: evalúa `approved`, `score`, `recommendations`
    - En modo SonarQube: verifica `QUALITY_GATE`, muestra métricas y issues por severidad
 7. **Decisión final**:
-   - Si hay problemas críticos o quality gate falla → commit bloqueado
+   - Si hay problemas críticos → genera prompt AI de resolución y bloquea commit
    - Si todo está bien → commit procede
 
+#### 🤖 Generación de Prompt de Resolución AI
+
+Cuando se detectan problemas críticos:
+
+- Se genera automáticamente un archivo `claude_resolution_prompt.md`
+- Contiene información estructurada y AI-friendly de todos los issues
+- Incluye localización precisa (archivo, línea, método)
+- Puede copiarse a otra instancia de Claude para resolución automática
+
 ### Hook prepare-commit-msg (Generación automática de mensajes)
 
 1. **Se activa cuando el mensaje es**:
@@ -233,11 +259,13 @@ unset CLAUDE_ANALYSIS_MODE
 #### 📋 Diferencias entre Modos
 
 **Modo Estándar**:
+
 - Análisis con puntuación del 1-10
 - Recomendaciones detalladas por categoría
 - Formato tradicional fácil de leer
 
 **Modo SonarQube**:
+
 - Quality Gate (PASSED/FAILED)
 - Métricas: Reliability, Security, Maintainability
 - Issues clasificados por severidad (Blocker, Critical, Major, Minor, Info)
@@ -266,13 +294,98 @@ DEBUG=1 git commit -m "mensaje"
 
 ## 📊 Formato de Respuesta
 
-Claude responde con un JSON que incluye:
+Claude responde con un JSON estructurado que incluye:
+
+- `approved`: Si el commit es aprobado (boolean)
+- `score`: Puntuación del 1-10 (integer)
+- `blockingIssues`: Array de objetos con problemas críticos:
+  - `description`: Descripción del problema
+  - `file`: Archivo afectado
+  - `line`: Línea del problema
+  - `method`: Método o clase afectada
+  - `severity`: Severidad (critical, high, etc.)
+- `recommendations`: Array de strings con sugerencias no bloqueantes
+- `details`: Objeto con comentarios por categoría (security, performance, etc.)
+
+### Ejemplos de Respuestas con Problemas Críticos
+
+#### Modo Estándar - Commit Bloqueado
+
+```json
+{
+  "approved": false,
+  "score": 3,
+  "blockingIssues": [
+    {
+      "description": "SQL Injection vulnerability: concatenación directa de strings en query",
+      "file": "src/main/java/UserRepository.java",
+      "line": 45,
+      "method": "findUserByName",
+      "severity": "critical"
+    },
+    {
+      "description": "Posible NullPointerException: variable 'user' no validada",
+      "file": "src/main/java/UserService.java",
+      "line": 78,
+      "method": "processUser",
+      "severity": "high"
+    }
+  ],
+  "recommendations": [
+    "Usar PreparedStatement en lugar de concatenación de strings",
+    "Agregar validación de null antes de acceder a propiedades"
+  ]
+}
+```
+
+#### Modo SonarQube - Quality Gate Failed
+
+```json
+{
+  "QUALITY_GATE": "FAILED",
+  "approved": false,
+  "score": 4,
+  "metrics": {
+    "reliability": "D",
+    "security": "E",
+    "maintainability": "C"
+  },
+  "issues": {
+    "blocker": 1,
+    "critical": 2,
+    "major": 3,
+    "minor": 1
+  },
+  "blockingIssues": [
+    {
+      "description": "Security Hotspot: Hardcoded credentials detected",
+      "file": "src/main/resources/application.yml",
+      "line": 23,
+      "method": "datasource.password",
+      "severity": "blocker"
+    },
+    {
+      "description": "Resource leak: Connection not closed in finally block",
+      "file": "src/main/java/DatabaseUtil.java",
+      "line": 112,
+      "method": "executeQuery",
+      "severity": "critical"
+    }
+  ],
+  "details": [
+    {
+      "severity": "BLOCKER",
+      "type": "VULNERABILITY",
+      "file": "src/main/resources/application.yml",
+      "line": 23,
+      "message": "Never store passwords in plain text",
+      "rule": "java:S2068"
+    }
+  ]
+}
+```
 
-- `approved`: Si el commit es aprobado
-- `score`: Puntuación del 1-10
-- `commitMessage`: Mensaje de commit generado (type, title, body)
-- `recommendations`: Recomendaciones de mejora
-- `blockingIssues`: Problemas que bloquean el commit
+Cuando se detectan estos problemas críticos, se genera automáticamente un archivo `claude_resolution_prompt.md` con toda la información necesaria para que otra instancia de Claude pueda resolver los issues de forma eficiente.
 
 ## 🔄 Actualización y Gestión
 
@@ -395,11 +508,24 @@ Este problema suele ocurrir por conflictos de configuración de line endings:
 
 ## 📝 Personalización
 
-Puedes modificar las pautas de evaluación editando los archivos en el directorio `.claude/`:
-- `.claude/CLAUDE_PRE_COMMIT.md` - Para el modo estándar
-- `.claude/CLAUDE_PRE_COMMIT_SONAR.md` - Para el modo SonarQube
+### Archivos de Configuración en `.claude/`
+
+#### Pautas de Evaluación
+
+- **`CLAUDE_PRE_COMMIT.md`** - Criterios de evaluación para modo estándar
+- **`CLAUDE_PRE_COMMIT_SONAR.md`** - Criterios para modo SonarQube
+
+#### Templates de Prompts
 
-Estos archivos son específicos de tu proyecto y puedes adaptarlos a los estándares de tu equipo.
+- **`CLAUDE_ANALYSIS_PROMPT.md`** - Estructura del prompt de análisis estándar
+- **`CLAUDE_ANALYSIS_PROMPT_SONAR.md`** - Estructura del prompt SonarQube
+- **`CLAUDE_RESOLUTION_PROMPT.md`** - Template para generar prompts de resolución
+
+Todos estos archivos son personalizables y específicos de tu proyecto. Puedes:
+
+- Modificar los criterios de evaluación según estándares del equipo
+- Ajustar la estructura de los prompts para obtener respuestas más precisas
+- Personalizar el formato de salida del prompt de resolución
 
 ## 🔄 Arquitectura del Sistema
 
@@ -574,11 +700,3 @@ git commit -m "auto"
 3. **Commit** tus cambios: `git commit -m "feat: nueva funcionalidad"`
 4. **Push** al branch: `git push origin feature/nueva-funcionalidad`
 5. **Abrir Pull Request**
-
-### Roadmap
-
-- [ ] Soporte para más lenguajes (Python, JavaScript, etc.)
-- [ ] Configuración más granular por proyecto
-- [ ] Integration con IDEs populares
-- [ ] Métricas de uso y performance
-- [ ] Tests automatizados

package/bin/claude-hooks

@@ -339,6 +339,7 @@ async function install(args) {
   }
 
   const isForce = args.includes('--force');
+  const skipAuth = args.includes('--skip-auth');
   
   if (isForce) {
     info('Instalando Claude Git Hooks (modo force)...');
@@ -364,7 +365,7 @@ async function install(args) {
   }
 
   // Verificar dependencias con instalación automática
-  await checkAndInstallDependencies(sudoPassword);
+  await checkAndInstallDependencies(sudoPassword, skipAuth);
 
   const templatesPath = getTemplatesPath();
   const hooksPath = '.git/hooks';
@@ -411,15 +412,26 @@ async function install(args) {
     success('.claude directory created');
   }
 
-  // Copiar archivos de pautas a .claude si no existen
-  const guidelines = ['CLAUDE_PRE_COMMIT.md', 'CLAUDE_PRE_COMMIT_SONAR.md'];
-  guidelines.forEach(guideline => {
-    const destPath = path.join(claudeDir, guideline);
-    if (!fs.existsSync(destPath)) {
-      const sourcePath = path.join(templatesPath, guideline);
+  // Copiar archivos de pautas y prompts a .claude
+  const claudeFiles = [
+    'CLAUDE_PRE_COMMIT.md', 
+    'CLAUDE_PRE_COMMIT_SONAR.md',
+    'CLAUDE_ANALYSIS_PROMPT.md',
+    'CLAUDE_ANALYSIS_PROMPT_SONAR.md',
+    'CLAUDE_RESOLUTION_PROMPT.md'
+  ];
+  
+  claudeFiles.forEach(file => {
+    const destPath = path.join(claudeDir, file);
+    const sourcePath = path.join(templatesPath, file);
+    
+    // En modo force o si no existe, copiar el archivo
+    if (isForce || !fs.existsSync(destPath)) {
       if (fs.existsSync(sourcePath)) {
         fs.copyFileSync(sourcePath, destPath);
-        success(`${guideline} creado en .claude/`);
+        success(`${file} instalado en .claude/`);
+      } else {
+        warning(`Archivo de template no encontrado: ${file}`);
       }
     }
   });
@@ -438,7 +450,7 @@ async function install(args) {
 }
 
 // Verificar dependencias completas (como setup-wsl.sh)
-async function checkAndInstallDependencies(sudoPassword = null) {
+async function checkAndInstallDependencies(sudoPassword = null, skipAuth = false) {
   info('Verificando dependencias del sistema...');
   
   // Verificar Node.js
@@ -522,8 +534,12 @@ async function checkAndInstallDependencies(sudoPassword = null) {
   // Verificar e instalar Claude CLI
   await checkAndInstallClaude();
   
-  // Verificar autenticación de Claude
-  await checkClaudeAuth();
+  // Verificar autenticación de Claude (si no se salta)
+  if (!skipAuth) {
+    await checkClaudeAuth();
+  } else {
+    warning('Saltando verificación de autenticación de Claude (--skip-auth)');
+  }
   
   // Limpiar contraseña de memoria
   sudoPassword = null;
@@ -619,7 +635,8 @@ function updateGitignore() {
     '# Claude Git Hooks',
     '.claude/',
     '.claude-analysis-mode',
-    'debug-claude-response.json'
+    'debug-claude-response.json',
+    'claude_resolution_prompt.md'
   ];
   
   let gitignoreContent = '';
@@ -970,7 +987,9 @@ Claude Git Hooks - Análisis de código y mensajes automáticos con Claude CLI
 Uso: claude-hooks <comando> [opciones]
 
 Comandos:
-  install              Instala los hooks en el repositorio actual
+  install [opciones]   Instala los hooks en el repositorio actual
+    --force           Reinstala aunque ya existan
+    --skip-auth       Salta la verificación de autenticación de Claude
   update               Actualiza a la última versión disponible
   uninstall            Desinstala los hooks del repositorio
   enable [hook]        Habilita hooks (todos o uno específico)
@@ -985,6 +1004,7 @@ Hooks disponibles:
 
 Ejemplos:
   claude-hooks install              # Instala todos los hooks
+  claude-hooks install --skip-auth  # Instala sin verificar autenticación
   claude-hooks update               # Actualiza a la última versión
   claude-hooks set-mode sonar       # Cambiar a modo SonarQube
   claude-hooks set-mode standard    # Cambiar a modo estándar

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-git-hooks",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Git hooks con Claude CLI para análisis de código y generación automática de mensajes de commit",
   "main": "lib/index.js",
   "bin": {

package/templates/CLAUDE_ANALYSIS_PROMPT.md

@@ -0,0 +1,44 @@
+Eres un revisor de código senior con experiencia en proyectos Spring Boot empresariales.
+
+Tu tarea es analizar los siguientes cambios de código y responder exclusivamente con un JSON válido, **sin ningún texto fuera del JSON**, sin introducciones ni explicaciones adicionales.
+
+⚠️ La respuesta debe ser un objeto JSON con esta estructura exacta:
+
+```json
+{
+  "approved": true,                // true si el commit puede aceptarse, false si debe bloquearse
+  "score": 1-10,                   // calificación de calidad (entero)
+  "blockingIssues": [             // SIEMPRE array de objetos, nunca strings
+    {
+      "description": "texto descriptivo del problema",
+      "file": "path/to/file.java",
+      "line": 123,                // línea donde se detectó el problema
+      "method": "methodName",      // método o clase afectada
+      "severity": "critical"       // critical, high, medium, low
+    }
+  ],
+  "recommendations": [            // sugerencias no bloqueantes (array de strings)
+    "mejora 1",
+    "mejora 2"
+  ],
+  "details": {
+    "security": [                 // comentarios específicos por área
+      "observación sobre seguridad"
+    ],
+    "architecture": [ "..." ],
+    "performance": [ "..." ],
+    "maintainability": [ "..." ]
+  }
+}
+```
+
+✅ Importante:
+- blockingIssues SIEMPRE debe ser un array de objetos, NUNCA un array de strings
+- Cada blockingIssue DEBE incluir: description, file, line, method, severity
+- Usa listas vacías si no hay issues (ejemplo: `"blockingIssues": []`)
+- No uses texto introductorio o explicaciones fuera del JSON
+- No omitas claves aunque estén vacías
+- Sé directo, claro y profesional en tus observaciones
+- Los problemas críticos deben incluir contexto suficiente para que otra IA pueda resolverlos
+
+A continuación se detallan las pautas y los cambios:

package/templates/CLAUDE_ANALYSIS_PROMPT_SONAR.md

@@ -0,0 +1,61 @@
+Eres un revisor de código senior con experiencia en proyectos Spring Boot empresariales y métricas SonarQube.
+
+Tu tarea es analizar los siguientes cambios de código desde una perspectiva de calidad similar a SonarQube y responder exclusivamente con un JSON válido, **sin ningún texto fuera del JSON**, sin introducciones ni explicaciones adicionales.
+
+⚠️ La respuesta debe ser un objeto JSON con esta estructura exacta de SonarQube:
+
+```json
+{
+  "QUALITY_GATE": "PASSED",          // PASSED o FAILED
+  "approved": true,                  // compatibilidad con modo estándar
+  "score": 1-10,                      // calificación general
+  "metrics": {
+    "reliability": "A",              // A, B, C, D, E
+    "security": "A",                 // A, B, C, D, E  
+    "maintainability": "A",          // A, B, C, D, E
+    "coverage": 85,                  // porcentaje de cobertura estimado
+    "duplications": 2,               // porcentaje de duplicación estimado
+    "complexity": 15                 // complejidad ciclomática estimada
+  },
+  "issues": {
+    "blocker": 0,                    // cantidad de issues bloqueantes
+    "critical": 0,                   // cantidad de issues críticos
+    "major": 0,                      // cantidad de issues mayores
+    "minor": 0,                      // cantidad de issues menores
+    "info": 0                        // cantidad de issues informativos
+  },
+  "details": [                       // detalle de cada issue encontrado con localización
+    {
+      "severity": "CRITICAL",        // BLOCKER, CRITICAL, MAJOR, MINOR, INFO
+      "type": "BUG",                 // BUG, VULNERABILITY, CODE_SMELL
+      "file": "src/main/java/Example.java",
+      "line": 42,
+      "method": "processData",      // método o clase afectada
+      "message": "Null pointer dereference possible",
+      "rule": "java:S2259"          // regla de SonarQube (opcional)
+    }
+  ],
+  "blockingIssues": [               // SIEMPRE array de objetos con issues BLOCKER y CRITICAL
+    {
+      "description": "texto descriptivo del problema",
+      "file": "path/to/file.java",
+      "line": 123,
+      "method": "methodName",
+      "severity": "critical"         // solo "blocker" o "critical" aquí
+    }
+  ],
+  "securityHotspots": 0             // cantidad de security hotspots
+}
+```
+
+✅ Importante:
+- blockingIssues SIEMPRE debe ser un array de objetos, NUNCA un array de strings
+- blockingIssues debe contener TODOS los issues BLOCKER y CRITICAL del array details
+- Cada blockingIssue DEBE incluir: description, file, line, method, severity
+- El QUALITY_GATE debe ser FAILED si hay issues BLOCKER o CRITICAL
+- Los ratings (A-E) deben reflejar la calidad real del código
+- Para cada issue en details, SIEMPRE incluye file, line y method para localización precisa
+- No uses texto fuera del JSON
+- Sé preciso con las localizaciones para facilitar la resolución automatizada
+
+A continuación se detallan las pautas y los cambios:

package/templates/CLAUDE_RESOLUTION_PROMPT.md

@@ -0,0 +1,46 @@
+# AI Resolution Assistant Prompt
+
+You are an expert code reviewer tasked with resolving critical issues identified in a code review. Your goal is to provide precise, minimal, and efficient fixes.
+
+## Context
+Repository: {{REPO_NAME}}
+Branch: {{BRANCH_NAME}}
+Commit: {{COMMIT_SHA}}
+Files analyzed: {{FILE_COUNT}}
+Analysis mode: {{ANALYSIS_MODE}}
+
+## Critical Issues to Resolve
+
+{{BLOCKING_ISSUES}}
+
+## Affected Files Content
+
+{{FILE_CONTENTS}}
+
+## Instructions
+
+1. For each critical issue:
+   - Navigate to the exact file and line number specified
+   - Understand the context and the problem
+   - Apply the minimal fix required
+   - Ensure the fix doesn't introduce new issues
+
+2. Fix requirements:
+   - Make the smallest possible change to resolve the issue
+   - Maintain existing code style and conventions
+   - Don't refactor unrelated code
+   - Preserve all existing functionality
+
+3. Output format:
+   - Provide exact code changes using diff format
+   - Include file path, line numbers, and context
+   - Explain each fix briefly (one line max)
+
+## Fix Priority
+1. Security vulnerabilities (highest)
+2. Null pointer / runtime errors
+3. Logic errors
+4. Performance issues
+5. Code quality issues (lowest)
+
+Begin fixing the issues in order of severity.

package/templates/pre-commit

@@ -56,6 +56,77 @@ if [ -n "$CHECK_VERSION_SCRIPT" ]; then
     check_version
 fi
 
+# Función para generar prompt de resolución AI-friendly
+generate_resolution_prompt() {
+    local RESOLUTION_FILE="./claude_resolution_prompt.md"
+    local RESOLUTION_TEMPLATE=".claude/CLAUDE_RESOLUTION_PROMPT.md"
+    
+    if [ ! -f "$RESOLUTION_TEMPLATE" ]; then
+        warning "No se encontró template de resolución: $RESOLUTION_TEMPLATE"
+        return
+    fi
+    
+    # Obtener información del contexto
+    local REPO_NAME=$(basename $(git rev-parse --show-toplevel))
+    local BRANCH_NAME=$(git rev-parse --abbrev-ref HEAD)
+    local COMMIT_SHA="pending"
+    local FILE_COUNT=$(echo "$JAVA_FILES" | wc -l)
+    
+    # Formatear los blocking issues para el prompt de resolución
+    local ISSUES_FORMATTED=""
+    local issue_num=1
+    
+    # Parsear cada blocking issue como objeto JSON
+    echo "$JSON_RESPONSE" | jq -c '.blockingIssues[]?' 2>/dev/null | while IFS= read -r issue; do
+        if [ -n "$issue" ]; then
+            local desc=$(echo "$issue" | jq -r '.description')
+            local file=$(echo "$issue" | jq -r '.file')
+            local line=$(echo "$issue" | jq -r '.line')
+            local method=$(echo "$issue" | jq -r '.method')
+            local severity=$(echo "$issue" | jq -r '.severity')
+            
+            ISSUES_FORMATTED="${ISSUES_FORMATTED}### Issue #${issue_num} [${severity^^}]\n"
+            ISSUES_FORMATTED="${ISSUES_FORMATTED}**Description:** ${desc}\n"
+            ISSUES_FORMATTED="${ISSUES_FORMATTED}**Location:** ${file}:${line}\n"
+            ISSUES_FORMATTED="${ISSUES_FORMATTED}**Method/Class:** ${method}\n\n"
+            issue_num=$((issue_num + 1))
+        fi
+    done
+    
+    # Generar el prompt desde el template
+    cp "$RESOLUTION_TEMPLATE" "$RESOLUTION_FILE"
+    
+    # Reemplazar placeholders
+    sed -i "s|{{REPO_NAME}}|$REPO_NAME|g" "$RESOLUTION_FILE"
+    sed -i "s|{{BRANCH_NAME}}|$BRANCH_NAME|g" "$RESOLUTION_FILE"
+    sed -i "s|{{COMMIT_SHA}}|$COMMIT_SHA|g" "$RESOLUTION_FILE"
+    sed -i "s|{{FILE_COUNT}}|$FILE_COUNT|g" "$RESOLUTION_FILE"
+    sed -i "s|{{ANALYSIS_MODE}}|$ANALYSIS_MODE|g" "$RESOLUTION_FILE"
+    
+    # Agregar los issues formateados
+    sed -i "/{{BLOCKING_ISSUES}}/r /dev/stdin" "$RESOLUTION_FILE" <<< "$ISSUES_FORMATTED"
+    sed -i "s|{{BLOCKING_ISSUES}}||g" "$RESOLUTION_FILE"
+    
+    # Agregar contenido de archivos afectados
+    local FILES_CONTENT=""
+    echo "$JSON_RESPONSE" | jq -r '.blockingIssues[].file' 2>/dev/null | sort -u | while IFS= read -r file; do
+        if [ -f "$file" ]; then
+            FILES_CONTENT="${FILES_CONTENT}### File: $file\n\n\`\`\`\n"
+            FILES_CONTENT="${FILES_CONTENT}$(cat "$file")\n"
+            FILES_CONTENT="${FILES_CONTENT}\`\`\`\n\n"
+        fi
+    done
+    
+    sed -i "/{{FILE_CONTENTS}}/r /dev/stdin" "$RESOLUTION_FILE" <<< "$FILES_CONTENT"
+    sed -i "s|{{FILE_CONTENTS}}||g" "$RESOLUTION_FILE"
+    
+    echo
+    echo -e "${YELLOW}=== PROMPT DE RESOLUCIÓN AI GENERADO ===${NC}"
+    echo -e "${GREEN}Se ha generado un prompt AI-friendly en: ${BLUE}$RESOLUTION_FILE${NC}"
+    echo -e "${YELLOW}Copia este archivo a una nueva instancia de Claude para resolver los problemas automáticamente.${NC}"
+    echo
+}
+
 # Detectar qué archivo de pautas usar
 # Prioridad: variable de entorno > archivo > pregunta interactiva
 if [ -n "$CLAUDE_ANALYSIS_MODE" ]; then
@@ -92,9 +163,11 @@ if [ "$ANALYSIS_MODE" != "standard" ] && [ "$ANALYSIS_MODE" != "sonar" ]; then
     if [ "$REPLY" = "2" ]; then
         ANALYSIS_MODE="sonar"
         GUIDELINES_FILE=".claude/CLAUDE_PRE_COMMIT_SONAR.md"
+        PROMPT_TEMPLATE=".claude/CLAUDE_ANALYSIS_PROMPT_SONAR.md"
     else
         ANALYSIS_MODE="standard"
         GUIDELINES_FILE=".claude/CLAUDE_PRE_COMMIT.md"
+        PROMPT_TEMPLATE=".claude/CLAUDE_ANALYSIS_PROMPT.md"
     fi
     
     # Guardar preferencia para futuros commits
@@ -106,12 +179,23 @@ else
     # Usar modo guardado
     if [ "$ANALYSIS_MODE" = "sonar" ]; then
         GUIDELINES_FILE=".claude/CLAUDE_PRE_COMMIT_SONAR.md"
+        PROMPT_TEMPLATE=".claude/CLAUDE_ANALYSIS_PROMPT_SONAR.md"
         log "Usando modo de análisis: SonarQube"
     else
         GUIDELINES_FILE=".claude/CLAUDE_PRE_COMMIT.md"
+        PROMPT_TEMPLATE=".claude/CLAUDE_ANALYSIS_PROMPT.md"
         log "Usando modo de análisis: Estándar"
     fi
 fi
+
+# Verificar que el template de prompt existe
+if [ ! -f "$PROMPT_TEMPLATE" ]; then
+    error "No se encontró el template de prompt: $PROMPT_TEMPLATE"
+    error "Los archivos de configuración de Claude parecen estar incompletos."
+    error "Por favor, reinstala claude-git-hooks ejecutando:"
+    error "  claude-hooks install --force"
+    exit 1
+fi
 # Función para limpiar archivos temporales
 cleanup() {
     rm -rf "$TEMP_DIR"
@@ -140,9 +224,10 @@ fi
 
 # Verificar si existe el archivo de pautas
 if [ ! -f "$GUIDELINES_FILE" ]; then
-    warning "No se encontró el archivo de pautas: $GUIDELINES_FILE"
-    warning "Saltando análisis de código"
-    exit 0
+    error "No se encontró el archivo de pautas: $GUIDELINES_FILE"
+    error "Por favor, reinstala claude-git-hooks ejecutando:"
+    error "  claude-hooks install --force"
+    exit 1
 fi
 
 log "Archivos Java/config a revisar: $(echo "$JAVA_FILES" | wc -l)"
@@ -150,42 +235,8 @@ log "Archivos Java/config a revisar: $(echo "$JAVA_FILES" | wc -l)"
 # Construir el prompt para análisis de código
 PROMPT_FILE="$TEMP_DIR/code_review_prompt.txt"
 
-cat > "$PROMPT_FILE" << 'EOF'
-Eres un revisor de código senior con experiencia en proyectos Spring Boot empresariales.
-
-Tu tarea es analizar los siguientes cambios de código y responder exclusivamente con un JSON válido, **sin ningún texto fuera del JSON**, sin introducciones ni explicaciones adicionales.
-
-⚠️ La respuesta debe ser un objeto JSON con esta estructura exacta:
-
-{
-  "approved": true,                // true si el commit puede aceptarse, false si debe bloquearse
-  "score": 1-10,                   // calificación de calidad (entero)
-  "blockingIssues": [             // lista de errores críticos (vacía si no hay)
-    "texto descriptivo 1",
-    "texto descriptivo 2"
-  ],
-  "recommendations": [            // sugerencias no bloqueantes
-    "mejora 1",
-    "mejora 2"
-  ],
-  "details": {
-    "security": [                 // comentarios específicos por área
-      "observación sobre seguridad"
-    ],
-    "architecture": [ "..." ],
-    "performance": [ "..." ],
-    "maintainability": [ "..." ]
-  }
-}
-
-✅ Importante:
-- Usa listas aunque estén vacías (por ejemplo `"blockingIssues": []`)
-- No uses texto introductorio o explicaciones fuera del JSON
-- No omitas claves aunque estén vacías
-- Sé directo, claro y profesional en tus observaciones
-
-A continuación se detallan las pautas y los cambios:
-EOF
+# Copiar el template de prompt
+cat "$PROMPT_TEMPLATE" > "$PROMPT_FILE"
 
 # Agregar las pautas
 echo "=== PAUTAS DE EVALUACIÓN ===" >> "$PROMPT_FILE"
@@ -257,7 +308,14 @@ if $CLAUDE_CLI < "$PROMPT_FILE" > "$RESPONSE_FILE" 2>&1; then
     APPROVED=$(echo "$JSON_RESPONSE" | jq -r '.approved // false')
     SCORE=$(echo "$JSON_RESPONSE" | jq -r '.score // 0')
     RECOMMENDATIONS=$(echo "$JSON_RESPONSE" | jq -r '.recommendations[]?' 2>/dev/null | sed '/^$/d')
-    BLOCKING_ISSUES=$(echo "$JSON_RESPONSE" | jq -r '.blockingIssues[]?' 2>/dev/null | sed '/^$/d')
+    
+    # Parsear blockingIssues como objetos y extraer las descripciones
+    BLOCKING_ISSUES=""
+    BLOCKING_COUNT=$(echo "$JSON_RESPONSE" | jq '.blockingIssues | length' 2>/dev/null || echo "0")
+    
+    if [ "$BLOCKING_COUNT" -gt 0 ]; then
+        BLOCKING_ISSUES=$(echo "$JSON_RESPONSE" | jq -r '.blockingIssues[].description' 2>/dev/null | sed '/^$/d')
+    fi
     
     # Verificar si estamos en modo SonarQube
     QUALITY_GATE=$(echo "$JSON_RESPONSE" | jq -r '.QUALITY_GATE // ""' 2>/dev/null)
@@ -356,6 +414,9 @@ if $CLAUDE_CLI < "$PROMPT_FILE" > "$RESPONSE_FILE" 2>&1; then
                 echo
                 echo "=== PROBLEMAS CRÍTICOS ==="
                 echo "$BLOCKING_ISSUES" | sed 's/^/- /'
+                
+                # Generar prompt de resolución AI-friendly
+                generate_resolution_prompt
             fi
             exit 1
         fi