Lab AE02: Spec-Driven Development

Escribe una especificación técnica completa para tu agente antes de escribir una sola línea de código.

Tu reto: Escribe la spec completa de un agente usando el framework SDD

Necesitas

  • La ficha del agente del Lab AE01
  • Conocimiento del dominio del agente
  • Acceso a ChatGPT, Claude o Gemini
  • 20 minutos de tiempo

Pasos

Paso 1: Define los contratos de entrada y salida

Especifica exactamente qué recibe y qué produce tu agente, con tipos de datos concretos.

Actúa como arquitecto de software especializado en agentes IA. Necesito definir los contratos de mi agente: Nombre: [NOMBRE DEL AGENTE] Objetivo: [OBJETIVO] Contexto: [DESCRIPCIÓN DEL PROYECTO] Define en formato JSON Schema: 1. Input contract (qué recibe, tipos, validaciones) 2. Output contract (qué produce, tipos, formato) 3. Error contract (cómo reporta errores) 4. Estado intermedio (qué persiste entre ejecuciones)
Paso 2: Especifica los casos de uso

Documenta los escenarios principales, los edge cases y los modos de fallo esperados.

Para el agente "[NOMBRE]" con estos contratos: [PEGA LOS CONTRATOS DEL PASO 1] Genera una tabla de casos de uso con columnas: | ID | Escenario | Input ejemplo | Output esperado | Prioridad | Incluye: - 3 casos principales (happy path) - 3 edge cases (datos incompletos, formatos inesperados) - 2 modos de fallo (timeout, servicio externo caído)
Paso 3: Escribe la spec formal

Compila todo en un documento de especificación que cualquier desarrollador pueda implementar.

Genera un documento de especificación SDD (Spec-Driven Development) con estas secciones: 1. Resumen ejecutivo (2 frases) 2. Contratos (input/output/error) 3. Tabla de casos de uso 4. Dependencias externas (APIs, bases de datos) 5. Requisitos no funcionales (latencia, disponibilidad, coste) 6. Criterios de aceptación (cuándo la spec está implementada) 7. Riesgos y mitigaciones Agente: [NOMBRE] Contratos: [PEGA CONTRATOS] Casos de uso: [PEGA CASOS]

Checklist de calidad

Comparte con tu equipo

Envía la spec a un compañero técnico y pídele que identifique ambigüedades. Si encuentra más de 3 preguntas sin respuesta, la spec necesita más detalle. Una buena spec elimina interpretaciones.

Resultado final

Un documento de especificación SDD completo con contratos, casos de uso, criterios de aceptación y riesgos, listo para pasar a implementación.

🚀 ¿Quieres todos los módulos completos?

Este laboratorio es parte de IAcademy: módulos con vídeo, contenido, quiz y laboratorio práctico para integrar la IA en tu empresa con criterio.

Ver planes Recursos gratuitos
← Lab anterior Siguiente lab →