Crear un Solution Design con IA

Utilice el Skill de Cobre para que su propio equipo técnico produzca un Solution Design Document de su integración — Local Payments, Cross Border, FX, Stablecoins, balances y funcionalidades operativas.

El skill lee la documentación de API y la especificación OpenAPI de Cobre en vivo, y escribe un diseño en Markdown que puede compartir con ingeniería.

El archivo que instala es un wrapper. En cada ejecución descarga el workflow, las reglas de producto, las plantillas y la ontología de validación vigentes desde el contenido alojado del skill de Cobre. No necesita un zip nuevo cuando Cobre actualiza esas reglas — solo cuando su KAM le envía un wrapper nuevo.

El mismo archivo .skill funciona en Claude Code, Cursor, Codex, Copilot, Gemini CLI y otros agentes de código compatibles con Agent Skills. No se ejecuta en una interfaz de chat que no pueda ejecutar scripts ni descargar documentación.

Use un wrapper vigente y deje que se actualice solo. El zip que le envió su KAM no es el conjunto completo de reglas. Cada ejecución descarga el contenido más reciente del skill por HTTPS y luego lee la especificación OpenAPI en vivo a través del MCP de Cobre Docs.

Antes de comenzar a trabajar en un Solution Design:

Solicite a su Key Account Manager (KAM) el archivo cobre-create-solution-design.skill.

Conecte el MCP de Cobre Docs y actualícelo en el mismo chat. El skill no generará un diseño solo a partir de las páginas publicadas.

No conserve un fork privado del skill. Si el resultado no coincide con docs.cobre.com, confíe en la documentación publicada y pregunte a su KAM si necesita un wrapper nuevo.

Qué produce el skill

Un Solution Design en Markdown que cubre los productos que describa: arquitectura, balances, counterparties, mapeo de API por riel, webhooks, conciliación y decisiones abiertas.

Ejemplos de request, response y webhook tomados de la especificación OpenAPI en vivo — no parafraseados de memoria.

El documento está escrito para el kickoff de ingeniería. Los términos comerciales, precios, spreads de FX, requisitos de KYC y límites por cuenta no se obtienen de la documentación pública; el diseño lo indicará en lugar de inventar cifras.

La conversación, el intake y el documento pueden estar en inglés, español o chino simplificado. El skill pregunta primero qué idioma usar.

Consulte Ejemplo

Prerrequisitos

Requisito	Por qué
Un agente de código con acceso a shell (Claude Code, Cursor, Codex, Copilot, Gemini CLI o similar)	El skill debe descargar el contenido alojado, actualizar la especificación OpenAPI y ejecutar `validate_spec.py`.
MCP de Cobre Docs	Obligatorio. Los endpoints, esquemas, ejemplos y enums provienen de una especificación OpenAPI actualizada. Consulte Construir con AI.
`cobre-create-solution-design.skill` de su KAM	Scripts locales y validador.
Python 3, curl, HTTPS	Descargar las páginas alojadas y validar el diseño.

1. Solicite el skill a su KAM

Pida a su Key Account Manager el archivo cobre-create-solution-design.skill.

Cobre no publica el zip para descarga en autoservicio. Si aún tiene create-solution-design-self-service.skill, elimínelo e instale el wrapper vigente.

2. Instálelo en su agente

La carpeta dentro del zip debe llamarse cobre-create-solution-design/ y debe contener exactamente un SKILL.md en su raíz. Elimine primero cualquier copia anterior.

Agente	Instalación
Claude Code	Importe el `.skill` en Settings → Skills, o descomprímalo en `~/.claude/skills/`
Cursor	Importe el `.skill` en la configuración de Skills, o descomprímalo en `~/.cursor/skills/` o `.cursor/skills/`
Codex	Descomprímalo en `~/.agents/skills/` o `.agents/skills/`
Copilot / VS Code / Gemini CLI	Descomprímalo en la carpeta de skills de ese producto de modo que `SKILL.md` quede en la raíz del skill

Reemplace cualquier copia anterior

Descripción: Elimine cobre-create-solution-design y create-solution-design-self-service de la carpeta de skills que va a usar; luego importe o descomprima el archivo que le envió su KAM.

Qué esperar después de la acción: Solo hay una copia del skill en disco.

Confirme que el skill se carga

Descripción: Inicie una conversación nueva con el agente y solicite un Solution Design de Cobre (consulte Cómo usarlo).

Qué esperar después de la acción: El asistente descarga el contenido alojado del skill y sigue el intake, en lugar de inventar una integración de memoria.

Si instaló este skill antes, elimine la copia anterior antes de instalar la nueva.

3. Conecte la documentación de Cobre en vivo

El skill no escribirá un Solution Design de memoria ni solo a partir de llms.txt.

Siga Construir con AI y agregue el MCP de documentación pública de Cobre (site-id=760877). No se requiere token. Luego, en el mismo chat, pida:

Actualice MCP y recargue la última especificación de la API.

MCP almacena la especificación OpenAPI en caché local. Una actualización en esta ejecución es obligatoria. Si la actualización falla o MCP no está conectado, el skill se detiene.

El contenido alojado del skill (workflow y reglas de producto) es independiente de la especificación OpenAPI del producto. El wrapper descarga lo primero; MCP suministra lo segundo.

Cómo usarlo

Trabaje en modo agente para que el asistente pueda ejecutar scripts y llamar a MCP.

Inicie una conversación nueva

Descripción: Solicite un Solution Design. No necesita los nombres de producto de Cobre — describa cómo su negocio mueve dinero.

Ejemplos de prompts:

Cree un Solution Design para nuestra integración con Cobre.

Somos un PSP en México y Colombia. Necesitamos payouts SPEI, cobros, FX y on-ramp de USDC. Genere un Solution Design.

Qué esperar después de la acción: El asistente pregunta el idioma (inglés, español o chino simplificado).

Deje que el skill se actualice

Descripción: Apruebe la descarga del contenido alojado del skill y la actualización OpenAPI de MCP cuando el agente lo solicite.

Qué esperar después de la acción: El intake y la validación usan el ruleset vigente y la especificación actual — no lo que hubiera dentro del zip del mes pasado.

Responda el intake

Descripción: El skill formula una pantalla de alcance breve y luego un máximo de dos rondas de intake. Responda con sus propias palabras. «No lo sé» es una respuesta válida — el diseño listará las opciones, qué cuesta cada una y qué elección asume mientras tanto.

Qué esperar después de la acción: El asistente tiene lo suficiente para escribir el Markdown. No necesita credenciales de sandbox; la habilitación de cuentas aparece como decisiones en el diseño.

Revise el Markdown

Descripción: El skill escribe un archivo Markdown. Ese archivo es el entregable. Pida ediciones hasta que quede correcto.

Qué esperar después de la acción: Un documento orientado al cliente. En el chat puede aparecer un informe de ejecución (fuentes usadas, vacíos). Conserve ese informe de forma interna — no pegue advertencias de MCP ni de caché en el archivo que comparte.

Contenido típico del Markdown:

Objetivo y alcance

Arquitectura y principios de diseño

Modelo operativo (balances, counterparties, flujo de fondos)

Mapeo de API por proceso — primero payouts, luego payins, luego Cross Border / Stablecoins cuando estén en alcance

Eventos, webhooks y sincronización de estados

Conciliación e informes

Códigos y catálogos necesarios para sus geografías

Decisiones y compensaciones (incluidas elecciones irreversibles como el modelo de balance)

Mantenga el skill actualizado

Hay dos capas que se mantienen vigentes de formas distintas:

Capa	Cómo se actualiza
Contenido alojado del skill (intake, reglas de producto, plantillas, ontología)	Se descarga en cada ejecución. No necesita un zip nuevo.
Especificación OpenAPI	Actualización de MCP en esta ejecución. Consulte Gestión de cambios de API y producto.
Wrapper (script de descarga, validador)	Pida a su KAM un `cobre-create-solution-design.skill` nuevo solo cuando se lo envíen, o cuando la descarga falle después de un aviso de Cobre.

Si el resultado del skill y docs.cobre.com no coinciden, trate la documentación publicada como correcta.

Guías relacionadas

Cómo integrar con Cobre — recorrido del cliente desde preventa hasta go-live

Explorar ejemplos de flujos de API — recorridos interactivos de secuencias de la API de Cobre

Generar código con MCP — prompts para PMs y desarrolladores para andamiar código a partir de la especificación en vivo

Construir con AI — conectar el MCP de Cobre Docs en su IDE

Conectar la documentación de Cobre a la IA — use llms.txt para respuestas fundamentadas en la documentación

Gestión de cambios de API y producto — cómo Cobre le notifica cuando cambian las APIs

Ejemplo

Solution Design — integración de NorteLedger MX con Cobre

Crear un Solution Design con IA

Qué produce el skill#

Prerrequisitos#

1. Solicite el skill a su KAM#

2. Instálelo en su agente#

3. Conecte la documentación de Cobre en vivo#

Cómo usarlo#

Mantenga el skill actualizado#

Guías relacionadas#

Ejemplo#

Qué produce el skill

Prerrequisitos

1. Solicite el skill a su KAM

2. Instálelo en su agente

3. Conecte la documentación de Cobre en vivo

Cómo usarlo

Mantenga el skill actualizado

Guías relacionadas

Ejemplo