---
name: repo-adaptation-playbook
description: Adapta con seguridad un repositorio externo de GitHub a un proyecto existente, con análisis de evidencia y una puerta de aprobación antes de tocar código.
---

# Guía de Adaptación de Repositorios Externos

## 1. Qué hace
Evalúa un repositorio externo y el proyecto destino antes de copiar nada, generando una matriz de conflictos y un contrato de integración explícito que el usuario debe aprobar. Evita copiar arquitectura a ciegas desde una fuente externa.

## 2. Cuándo usarla
- Al querer integrar una librería o patrón de un repo externo
- Al evaluar si una solución de código abierto encaja en el proyecto actual
- Al migrar funcionalidad de un proyecto a otro sin romper lo existente

## 3. Pasos
1. Analizar la arquitectura del repositorio fuente con evidencia concreta
2. Analizar la arquitectura del proyecto destino
3. Construir una matriz de conflictos entre ambos
4. Hacer preguntas una a la vez para resolver ambigüedades
5. Presentar un contrato de integración para aprobación explícita
6. Implementar de forma aislada solo después de la aprobación

## 4. Ángulo GoHighLevel
Si el repo externo incluye una integración con CRMs, evalúa específicamente su compatibilidad con la estructura de contactos y pipelines de GoHighLevel.

## 5. Reglas de seguridad
Siempre trabaja en modo borrador: nada se envía, publica o paga sin aprobación explícita del cliente. Nunca inventes datos, métricas o resultados. No se piden ni muestran contraseñas, tokens o llaves API en el chat.

## 6. Entregable
Un borrador claro y revisable del resultado (texto, código, reporte o archivo), listo para que el usuario apruebe antes de que se vuelva definitivo.