De la Instrucción al Protocolo

Protocol Engineering

Introducción Ecosistema Metodología Workflows Prácticos

De la Instrucción al Protocolo

Una guía para transformar prompts ambiguos en flujos de trabajo de IA precisos, fiables y potentes dentro del ecosistema Windsurf/Cascade.

El Problema: Un Prompt Ambiguo

"usa tus mcps para tener el mayor control posible de lo que te estoy pidiendo"

Esta instrucción expresa una intención correcta, pero su vaguedad la hace ineficaz. Obliga a la IA a adivinar, lo que conduce a resultados impredecibles. El objetivo es pasar de la intención a la ejecución explícita.

El Ecosistema Windsurf/Cascade

Para lograr un control real, es crucial entender los cuatro pilares que trabajan en sinergia. Haz clic en cada pilar para explorar sus detalles.

⚙️Workflows

El motor de la automatización. Scripts reutilizables que guían a la IA a través de tareas complejas y repetitivas.

Son archivos Markdown que contienen una secuencia de pasos. Se invocan con comandos (ej: `/revisar-pr`) y actúan como los "programas" que la IA ejecuta.

🛠️MCPs

Las herramientas de la IA. Permiten interactuar con el mundo real: leer archivos, usar la terminal, APIs, etc.

Los Model Context Protocols transforman al modelo de lenguaje en un agente de acción. "Usar MCPs" significa invocar la herramienta correcta para la subtarea correcta (ej: `@github` para un PR).

📜Rules

La constitución guía. Instrucciones persistentes que aseguran que la IA se adhiera a estándares predefinidos.

Actúan como una "guía de estilo" para la IA. Pueden ser globales o específicas de un proyecto, garantizando consistencia en el comportamiento del agente.

🧠Memories

El contexto persistente. Mantienen el conocimiento del proyecto a lo largo de múltiples conversaciones.

Eliminan la necesidad de re-explicar detalles. La IA puede generar memorias automáticamente o el usuario puede crearlas explícitamente para un control total del contexto.

La Metodología del Protocolo

La clave es descomponer tareas complejas en una cadena de pasos simples y explícitos. Este enfoque, conocido como "Chain-of-Thought", transforma la fiabilidad y el control.

Análisis Comparativo: Prompt Único vs. Flujo Encadenado

Workflows Prácticos: El Playground

Explora escenarios de desarrollo comunes. Selecciona un workflow y haz clic en sus pasos para ver cómo se estructuran las instrucciones.

Este workflow automatiza la revisión inicial de un Pull Request, verificando el cumplimiento de los estándares del proyecto y generando sugerencias.

Paso 1: Recopilar Contexto del PR

<instruccion> Usa el MCP @github para obtener título, descripción y archivos del último PR. </instruccion>

Paso 2: Analizar Archivos Modificados

<instruccion> Para cada archivo, usa el MCP @file para leer su contenido. </instruccion>

Paso 3: Aplicar Reglas y Analizar Código

<instruccion> Verifica el cumplimiento de las directrices (JSDoc, no console.log, etc.). </instruccion>

Paso 4: Generar Comentarios de Revisión

<instruccion> Genera una lista de sugerencias de comentarios en Markdown. </instruccion>

Un workflow seguro para tareas de refactorización complejas, que propone un plan y espera la aprobación explícita del usuario antes de ejecutar cambios.

Paso 1: Definir Alcance y Analizar

<instruccion> Usa @file para leer 'apiService.ts' y consulta la memoria de arquitectura. </instruccion>

Paso 2: Proponer Plan de Refactorización

<instruccion> Propón un plan detallado paso a paso. No modifiques el código aún. </instruccion>

Paso 3: Esperar Aprobación (Control Gate)

<instruccion> No procedas hasta que el usuario escriba "APROBAR". </instruccion>

Paso 4: Ejecutar Cambios Aprobados

<instruccion> Una vez aprobado, usa @file para aplicar los cambios del plan. </instruccion>

Paso 5: Resumir y Verificar

<instruccion> Usa @terminal para ejecutar 'git status' y confirmar la finalización. </instruccion>

Este workflow lee un componente, investiga sus dependencias externas usando la web y genera automáticamente un archivo `README.md` completo.

Paso 1: Analizar Código Fuente

<instruccion> Usa @file para leer el contenido del componente especificado. </instruccion>

Paso 2: Identificar Dependencias

<instruccion> Analiza los 'import' y extrae una lista de librerías externas. </instruccion>

Paso 3: Investigar Dependencias

<instruccion> Usa @web-search para encontrar el propósito de cada librería. </instruccion>

Paso 4: Generar Documentación

<instruccion> Genera el contenido del README.md con secciones: Propósito, API, Dependencias, etc. </instruccion>

Paso 5: Crear Archivo README.md

<instruccion> Usa @file para escribir el contenido generado en un nuevo archivo 'README.md'. </instruccion>

Este workflow asiste en la configuración inicial de Firebase en un proyecto de Flutter, asegurando que se añadan las dependencias correctas.

Paso 1: Analizar `pubspec.yaml`

<instruccion>Usa @file para leer el contenido de 'pubspec.yaml' y listar las dependencias de Firebase existentes.</instruccion>

Paso 2: Investigar Últimas Versiones

<instruccion>Usa @web-search para encontrar las últimas versiones estables de 'firebase_core', 'cloud_firestore' y 'firebase_auth' en pub.dev.</instruccion>

Paso 3: Proponer Cambios en `pubspec.yaml`

<instruccion>Genera el bloque de dependencias para 'pubspec.yaml' con las versiones encontradas. No modifiques el archivo aún.</instruccion>

Paso 4: Ejecutar `flutter pub get`

<instruccion>Una vez que el usuario apruebe, usa @terminal para ejecutar 'flutter pub get' y muestra la salida.</instruccion>

Este workflow analiza las dependencias de un proyecto Flutter, con foco en AdMob, para identificar paquetes desactualizados o posibles conflictos.

Paso 1: Leer Archivos de Dependencias

<instruccion>Usa @file para leer 'pubspec.yaml' y 'pubspec.lock'.</instruccion>

Paso 2: Ejecutar `flutter pub outdated`

<instruccion>Usa @terminal para ejecutar 'flutter pub outdated' y capturar la salida.</instruccion>

Paso 3: Analizar Dependencia de AdMob

<instruccion>De la salida, extrae la versión actual y la más reciente de 'google_mobile_ads'. Usa @web-search para buscar notas de la versión sobre cambios importantes.</instruccion>

Paso 4: Generar Informe de Actualización

<instruccion>Genera un informe en Markdown resumiendo las dependencias desactualizadas, con un foco especial en AdMob y cualquier posible conflicto con Firebase.</instruccion>

© 2024 Guía Interactiva de Ingeniería de Workflows. Creado para transformar la colaboración con IA.