Guía de Adaptación de Repositorios Externos

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.

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

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

La skill

---
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.

Para Claude Code, guárdala en ~/.claude/skills/repo-adaptation-playbook/SKILL.md. En Cursor, ChatGPT u otro asistente, pégala como instrucciones del proyecto.