De las decisiones de diseño a ADR en Confluence: guía práctica de SuperIntern MCP + Confluence

Las revisiones de diseño terminan con una decisión, pero pocos equipos dejan escrito en Confluence por qué eligieron esa opción y por qué perdieron las demás. Seis meses después, quienes conocían los motivos ya no están, y el equipo vuelve a abrir el mismo debate desde cero.

Si conectas SuperIntern MCP y Confluence a un agente de IA (Claude, ChatGPT), el agente lee la transcripción de la reunión y redacta un registro de decisión de arquitectura (ADR) con las opciones consideradas y el razonamiento. Cada punto va respaldado por una cita. Tú revisas el borrador, lo apruebas y se guarda como página de Confluence.

ChatGPT también tiene una app oficial de Atlassian, pero la documentación de Atlassian no confirma que pueda crear ni actualizar páginas de Confluence. La sección de configuración explica qué funciona hoy en ChatGPT.

⚠️ Este artículo ha sido elaborado de forma independiente a partir de información pública y comentarios de usuarios disponibles en octubre de 2026.

Índice

• Qué vamos a montar: antes / después
• Cómo funciona: tres papeles
• Configuración
• Uso 1: Redactar el ADR en cuanto termina la revisión de diseño
• Uso 2: Detectar cada semana las decisiones que nunca llegaron a ser ADR
• Uso 3: Encontrar durante la reunión decisiones pasadas relacionadas
• Consejos para el día a día
• Más allá de Confluence: el mismo patrón con otras herramientas
• Preguntas frecuentes

Qué vamos a montar: antes / después

Antes: Una revisión de diseño llega a una conclusión, y el acta dice "adoptar una cola" y nada más. Quien debía escribir el ADR está ocupado entregando trabajo, así que la comparación de opciones y los motivos para descartar las demás quedan solo en la cabeza de la gente. Cuando una persona nueva del equipo pregunta por qué el sistema funciona así, nadie sabe responder.

Después: Cuando termina la reunión, le pides al agente que escriba un ADR a partir de la revisión de diseño de hoy. El agente lee la transcripción de SuperIntern y redacta el contexto, las opciones consideradas, la decisión, el razonamiento y el trabajo de seguimiento, cada uno con la cita que lo respalda. Lo apruebas y la página se crea bajo tu página padre de ADR. Una vez por semana, haces que el agente relea las reuniones de la semana y busque decisiones que no llegaron a ningún ADR.

Las reuniones que quieras consultar tienen que estar grabadas en SuperIntern. SuperIntern es un asistente de reuniones de escritorio que guarda la transcripción y el acta con IA sin invitar a ningún bot a la llamada, así que sirve para revisiones de diseño internas sin ninguna configuración en la propia reunión.

En este artículo usamos como ejemplo el siguiente equipo:

Cómo funciona: tres papeles

MCP (Model Context Protocol) es un estándar abierto para conectar asistentes de IA con herramientas externas de forma segura. SuperIntern MCP da a tu agente acceso de solo lectura a los datos de las reuniones. Encontrarás más detalles en nuestra guía de configuración de MCP.

Del lado de Confluence se encarga el servidor MCP oficial de Atlassian (Atlassian Rovo MCP Server). Puede buscar, leer, crear y actualizar páginas de Confluence y añadir comentarios, y la misma conexión cubre también Jira.

Quien escribe en Confluence es el agente, no SuperIntern. El agente no puede modificar nada en SuperIntern y solo lee las reuniones que tú ya puedes ver. En Confluence, solo puede escribir en los espacios que tú puedes editar.

Configuración

Hay que conectar dos cosas: SuperIntern y Confluence. Elige el agente que ya uses. En Claude, ambas se añaden desde el directorio de conectores y todos los prompts de este artículo funcionan tal cual. En ChatGPT, buscar y leer páginas (uso 3) funciona sin más; para crear y actualizar páginas (usos 1 y 2), comprueba primero si tu configuración lo permite.

1. Conectar SuperIntern

• Claude: Abre Configuración (Settings), entra en Conectores (Connectors) dentro de Personalizar (Customize), busca "SuperIntern" y selecciónalo. También puedes abrir directamente SuperIntern en la lista de conectores de Claude. Añadir conectores está disponible en los planes de pago de Claude.
• ChatGPT: Abre Plugins en la barra lateral, busca "superintern", abre SuperIntern y pulsa Instalar plugin. La página del plugin de SuperIntern te lleva directamente. La aplicación Codex se conecta de la misma manera.

En ambos casos se abre la página de inicio de sesión de SuperIntern; inicia sesión y concede el acceso. Los requisitos del lado de SuperIntern (los espacios de trabajo personales necesitan el plan Plus o superior; en Enterprise un administrador debe activar el acceso MCP) y la configuración en Claude Code, Cursor y otros clientes están en nuestra guía de configuración de MCP.

2. Conectar Confluence

• Claude: En la misma búsqueda de Conectores (Connectors), escribe "Atlassian", añade el conector oficial "Atlassian MCP" de Atlassian e inicia sesión con tu cuenta de Atlassian. Puede buscar, leer, crear y actualizar incidencias de Jira y páginas de Confluence.
• ChatGPT: Busca "Atlassian" en Plugins, conecta la app oficial "Atlassian Rovo" de Atlassian e inicia sesión con tu cuenta de Atlassian. El anuncio de Atlassian menciona resumir y leer páginas de Confluence, y crear y actualizar incidencias de Jira. Si tu agente no puede crear la página de Confluence, pídele el borrador y pégalo tú mismo en Confluence.
• Claude Code: Ejecuta claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp e inicia sesión en Atlassian desde /mcp dentro de Claude Code.

Al iniciar sesión eliges a qué sitio de Atlassian conectarte. Tus permisos de Atlassian se mantienen, así que para crear una página necesitas permiso de creación en ese espacio. Las conexiones desde Claude y ChatGPT están permitidas por defecto, pero un administrador de la organización de Atlassian puede restringir el servidor MCP, y en ese caso la conexión falla. En los planes Team y Enterprise de Claude, el propietario de la organización debe añadir el conector antes de que los miembros puedan usarlo.

Con las dos conectadas, comprueba que el agente ve ambos lados:

Enumera las reuniones de SuperIntern de esta semana en el proyecto "Ingeniería"
y las páginas hijas de "Decisiones de arquitectura (ADR)" en el espacio de Confluence "Ingeniería".

Si vuelven las dos listas, ya está todo listo.

Uso 1: Redactar el ADR en cuanto termina la revisión de diseño

Donde más se nota es justo después de una revisión de diseño. En el prompt importan dos cosas: detallar las secciones del ADR y pedir también los motivos de las opciones descartadas.

Lee la transcripción y el acta con IA de la "Revisión de diseño del envío de notificaciones" de hoy
y redacta un ADR para colgarlo de la página padre "Decisiones de arquitectura (ADR)"
en el espacio de Confluence "Ingeniería".
- Usa el siguiente número después de los ADR existentes
- Secciones: Contexto / Opciones consideradas (tabla: ventajas, inconvenientes, propuesta de) / Decisión /
  Justificación / Trabajo de seguimiento / Preguntas abiertas
- Para cada opción descartada, incluye por qué se descartó, con la cita
- Marca como "Abierto" lo que la reunión no resolvió
Enséñame primero el borrador. Cuando lo apruebe, crea la página.

El agente comprueba primero los números de ADR existentes y luego devuelve el borrador:

Este es el borrador de "ADR-014 Enviar notificaciones mediante una cola":

Contexto: Las notificaciones salen en un proceso por lotes cada 5 minutos, y el envío tarda hasta 15 minutos. Marta: "Recibimos unos 20 tickets a la semana diciendo que las confirmaciones de reserva llegan lentas."

Opciones consideradas

Opción	Ventajas	Inconvenientes	Propuesta de
A. Ejecutar el proceso por lotes cada minuto	Cambio pequeño	Las ejecuciones empiezan a solaparse al crecer el volumen	Diego
B. Enviar mediante una cola (Amazon SQS) y workers	Entrega en menos de un minuto; los fallos se reintentan uno a uno	Más cosas que monitorizar	Lucía
C. Usar un servicio externo de notificaciones	Casi sin código	Envía datos personales a un proveedor, por lo que requiere una revisión de seguridad	Marta

Decisión: Adoptar la opción B.

Justificación: La opción A se solapará con el volumen previsto para el año que viene (Diego: "En enero una sola ejecución tardará más de un minuto"). La revisión de seguridad de la opción C lleva unos dos meses, así que no llega a la corrección de este año (Marta: "Cuenta dos meses solo para la revisión").

Trabajo de seguimiento: Crear el worker (Diego, 18/11) / Configurar la cola y las alertas de mensajes fallidos (Javier, 20/11) / Planificar el apagado del proceso por lotes (Lucía, diciembre)

Preguntas abiertas: Si se prioriza las notificaciones por tipo (se decidirá en la próxima sincro)

¿Creo la página con este contenido?

Responde OK y aparece una página nueva bajo "Decisiones de arquitectura (ADR)". Si le pides al agente que ponga al principio de la página la reunión de origen y la fecha, cualquiera puede rastrear la decisión hasta la transcripción.

Como los motivos para descartar cada opción están en la página, la próxima vez que alguien pregunte "¿no sería más fácil un proveedor externo?", la respuesta ya está ahí: el plazo de la revisión de seguridad.

Uso 2: Detectar cada semana las decisiones que nunca llegaron a ser ADR

Las decisiones que moldean la arquitectura también salen de las sincros periódicas, no solo de las revisiones de diseño. Una vez por semana, haz que el agente lea las reuniones de la semana y las compare con tu lista de ADR.

Lee todas las reuniones de SuperIntern del proyecto "Ingeniería" de esta semana (del 2/11 al 6/11)
y compáralas con las páginas hijas de "Decisiones de arquitectura (ADR)" en Confluence.
- Decisiones tomadas en una reunión que no tienen ADR
- Decisiones que cambian o reemplazan un ADR existente
Muéstralas en una tabla: decisión / reunión / ADR relacionado / acción propuesta / cita de origen.
Solo para las filas que apruebe, crea borradores de ADR y actualiza las páginas existentes.

El agente alinea las decisiones de cada reunión con la lista de ADR:

He encontrado 3 decisiones esta semana que afectan a los ADR:

Decisión	Reunión	ADR relacionado	Acción propuesta	Cita de origen
Unificar las API de administración en REST	Sincro de API (5/11)	Ninguno	Crear ADR-015	Lucía: "Hagamos todas las pantallas nuevas sobre REST."
Reintentar las notificaciones hasta 3 veces, duplicando la espera cada vez	Sincro de ingeniería (6/11)	ADR-014	Añadir a "Decisión"	Diego: "Tras 3 fallos pasa a la cola de mensajes fallidos."
Registrar logs en stdout en lugar de archivos	Sincro de ingeniería (6/11)	ADR-009	Crear ADR-016 y marcar ADR-009 como "Reemplazada"	Javier: "Ahora estamos en contenedores, así que se acaba el log en archivos."

¿Aplico los 3?

Tras tu aprobación, se crean los borradores de ADR-015 y ADR-016, y la política de reintentos se añade a ADR-014. El estado de ADR-009 cambia a "Reemplazada" con un enlace a ADR-016. Pide a los responsables que lean los borradores antes de marcarlos como definitivos.

Uso 3: Encontrar durante la reunión decisiones pasadas relacionadas

SuperIntern MCP también puede leer la transcripción en vivo de una reunión en curso. Solo trae lo nuevo desde la última petición, así que preguntar varias veces durante la reunión sigue siendo rápido.

Cuando parezca que la discusión choca con una decisión anterior, pregunta:

Lee la transcripción en vivo del "Seguimiento de notificaciones" en curso
(solo lo nuevo desde la última vez) y busca en Confluence, en "Decisiones de arquitectura (ADR)",
ADR anteriores relacionados con lo que estamos hablando.
Si alguna decisión entra en conflicto con la discusión de hoy, dímelo junto con su justificación.
No escribas nada en Confluence.

El agente combina la conversación más reciente con los resultados de la búsqueda en Confluence:

La discusión actual trata de enviar las notificaciones por correo directamente desde el worker. Hay dos ADR relacionados:

• ADR-006 Enviar todo el correo por el servicio externo (junio de 2025): Para proteger la reputación del dominio de envío, el correo sale únicamente por el servicio de envío. La propuesta de hoy entra en conflicto con esta decisión.
• ADR-014 Enviar notificaciones mediante una cola (4/11): El worker toma las notificaciones de la cola, pero este ADR no decide cómo se envía el correo.

Una pregunta para resolverlo: "¿Revisamos el ADR-006, o el worker debería llamar al servicio de envío?"

En este uso no se escribe nada en Confluence. Como solo busca y lee páginas, funciona también en ChatGPT.

Consejos para el día a día

Mantén una plantilla de ADR en Confluence. Si hay una página de plantilla con tus secciones, el agente la lee y redacta con la misma estructura. Nómbrala en el prompt, por ejemplo "usa la misma estructura que la página 'Plantilla de ADR'".

Di la conclusión en voz alta al final. "Entonces vamos con la opción B, por el plazo de la revisión" deja una decisión y un motivo claros en la transcripción. Un asentimiento en silencio no es algo que el agente pueda reconocer como decisión.

Agrupa las reuniones en un proyecto de SuperIntern. Reúne las reuniones de ingeniería en un solo proyecto y podrás filtrar por fechas y proyecto, como en el uso 2.

Revisa siempre el plan antes de escribir. Todos los prompts de este artículo muestran primero un borrador y solo escriben tras tu aprobación. Los ADR se leen durante años, así que pide al responsable que revise la redacción de la decisión y la justificación antes de aprobar.

Los permisos son los tuyos. SuperIntern MCP solo lee las reuniones que tú puedes ver, y en Confluence el agente solo escribe en los espacios que puedes editar. Nada cambia nunca en SuperIntern.

Añade los nombres de servicios al diccionario. Cuanto más fielmente aparezcan en la transcripción los nombres de servicios y las siglas internas, más preciso será el ADR. Registra los términos frecuentes en el diccionario personalizado de SuperIntern.

Más allá de Confluence: el mismo patrón con otras herramientas

SuperIntern MCP aporta los datos de la reunión, el agente decide y otra herramienta ejecuta. El patrón no cambia aunque cambie el destino.

• Linear: para convertir el trabajo de seguimiento de un ADR en tareas de ingeniería, consulta la guía de Linear
• Claude Code: para pasar directamente de la decisión a la implementación, consulta la guía de Claude Code
• Notion: para guardar el registro de reuniones en una base de datos, consulta la guía de Notion
• Miro: para convertir en diagrama una arquitectura explicada en una reunión, consulta la guía de Miro

Preguntas frecuentes

¿Puedo usar SuperIntern MCP con el plan gratuito?

No. Los espacios de trabajo personales necesitan el plan Plus o superior. Los planes Team funcionan tal cual. En Enterprise, un administrador debe activar el "acceso MCP" en la configuración del espacio de trabajo.

¿SuperIntern escribe en Confluence?

No. El agente crea y actualiza las páginas a través del servidor MCP oficial de Atlassian. SuperIntern MCP solo aporta datos de reuniones en modo de solo lectura.

¿Puedo hacerlo con ChatGPT?

En parte. Entre los plugins de ChatGPT está la app oficial "Atlassian Rovo" de Atlassian, que puede buscar y leer páginas anteriores, como en el uso 3. La documentación de Atlassian no confirma que pueda crear ni actualizar páginas de Confluence, así que para los usos 1 y 2 puede que tengas que pegar tú mismo en Confluence el borrador del agente.

¿Necesito un formato de ADR fijo?

No. Sin uno, el agente usa las secciones del prompt del uso 1. Si tu equipo tiene un formato, indica en el prompt el nombre de la página de plantilla.

¿También puede crear incidencias de Jira?

Sí. El servidor MCP oficial de Atlassian cubre también Jira, así que en la misma conexión puedes pedirle al agente que registre como incidencias de Jira el trabajo de seguimiento de un ADR. Indica en el prompt el proyecto y el tipo de incidencia.

¿En qué se diferencia de la guía de Notion?

La guía de Notion trata de reunir en una base de datos el registro de todas las reuniones. Este artículo se centra en las decisiones de ingeniería y registra como ADR las opciones consideradas y los motivos para descartarlas.

Elige tu próxima revisión de diseño y, antes de detener la grabación en SuperIntern, di en voz alta la decisión y el motivo. Pocos minutos después de la reunión, tendrás en Confluence un borrador de ADR que incluye por qué perdieron las demás opciones.

Prueba SuperIntern Gratis