Desarrollo Agéntico, Overvibing · · por Michael Wybraniec

De la Idea a la API en 2 Días: Construyendo Bankly con Flujos de Trabajo Agénticos

Descubre cómo Bankly, un sistema bancario backend, fue construido en solo dos días usando Apollo GraphQL, Prisma y el Flujo de Trabajo Agéntico - un protocolo para el desarrollo sostenible asistido por IA.

Bankly, un sistema bancario backend construido en solo dos días utilizando Apollo GraphQL y Prisma. Diseñado como una prueba técnica personal y prueba de concepto que demuestra cómo los flujos de trabajo agénticos y el desarrollo asistido por IA pueden acelerar la entrega de software moderno mientras mantienen la calidad y la estructura.

Cronología del Desarrollo

Aquí está la progresión completa commit por commit que muestra cómo AWP permitió un desarrollo sistemático sin perder impulso:

---
title: Cronología del Desarrollo de Bankly - 24-25 Junio 2025 @michaelwybraniec
---
gitGraph
    commit id: "Diagramas ER" tag: "3.1.2" type: HIGHLIGHT
    commit id: "Modelos Prisma" tag: "3.1.1"
    commit id: "Política AWP → Protocolo" tag: "9.1" type: REVERSE
    commit id: "BD Segura Transaccional" tag: "3.3"
    commit id: "Dependencias" tag: "1.3"
    commit id: "API GraphQL" tag: "4.4" type: HIGHLIGHT
    commit id: "ESLint + Herramientas" tag: "1.4"
    commit id: "User Stories" tag: "5.1"
    commit id: "Productor Kafka" tag: "5.1" type: HIGHLIGHT
    commit id: "Emisión de Eventos" tag: "5.2"
    commit id: "Pasos Kafka Completados" tag: "5.0"
    commit id: "Procedimientos AWP" tag: "9.2"
    branch pre-prod
    checkout pre-prod
    commit id: "Tests Unitarios" tag: "8.1"
    commit id: "Docker Compose" tag: "10.1"
    commit id: "Release Semántico" tag: "7.4" type: HIGHLIGHT
    commit id: "Winston + Prometheus" tag: "10.3" type: HIGHLIGHT
    commit id: "Controles de Salud" tag: "10.3"
    commit id: "Eventos de Auditoría" tag: "6.1"
    commit id: "Acciones GitHub" tag: "7.4"
    commit id: "Docs Observabilidad" tag: "10.5"
    commit id: "Estructura Proyecto" tag: "11"
    checkout main
    merge pre-prod tag: "v0.9.0" type: HIGHLIGHT

%%{init: {
        "gitGraph": {
            "titleTopMargin": 80,
            "diagramPadding": 20
        }
    }}%%

¿Cómo se construyó? Usando Vibe-Coding con la Estrategia de Flujo de Trabajo Agéntico.

El Vibecoding con Flujo de Trabajo Agéntico significa:

  • Trabajar en un estado de flujo de alta creatividad y velocidad
  • Dejar que los co-pilotos de IA manejen tareas dentro de un marco estructurado
  • Evitar el agotamiento cognitivo o "over-vibing" a través de límites sistemáticos
  • Mantener la claridad y el contexto durante todo el proceso de desarrollo

El mercado laboral está evolucionando, y los ingenieros deben adaptarse. La IA ya no es opcional—es un multiplicador. Pero escalar la ingeniería con IA requiere madurez, estructura y conciencia de los riesgos.

Llamo a este riesgo "over-vibing"—un estado donde se empuja demasiado lejos, demasiado rápido, y se pierde el contexto. Las herramientas de IA (especialmente los LLM) sufren de deriva del contexto. Los humanos también. Cuando estás en el flujo pero pierdes de vista el panorama general, la productividad puede convertirse rápidamente en deuda técnica. Para gestionar este riesgo, creé un "AWP" que mantiene la estructura mientras preserva el impulso creativo.

El secreto detrás del rápido desarrollo de Bankly reside en una metodología que llamo "Vibecoding con Flujo de Trabajo Agéntico". Este enfoque combina estados de flujo de alta creatividad con colaboración estructurada de IA, evitando las trampas de la automatización incontrolada o el "over-vibing". La prueba está en los commits: Bankly fue construido el 24-25 de junio de 2025 en dos días con más de 35 commits estructurados siguiendo el Protocolo de Flujo de Trabajo Agéntico (AWP). Cada commit representa un paso deliberado en el proceso de desarrollo, desde la configuración inicial hasta las características de pre-producción.

---
title: AWP - Protocolo de Flujo de Trabajo Agéntico
---
graph TD
    subgraph Planificación
        A[Definir Tareas] --> B[Iterar Tareas]
    end
    
    subgraph Desarrollo
        C[Revisar Alcance] --> D[Desarrollo]
        D --> E[Verificar Contexto]
        E --> F[Ejecutar Pruebas]
    end
    
    subgraph Documentación
        G[Documentación] --> H[Verificación Final]
    end
    
    subgraph Control de Versiones
        I[Revisión Git] --> J[Siguiente Tarea]
    end
    
    B --> C
    F --> G
    H --> I
    J --> B
    E --> C

MCP SLDC Agéntico (Ciclo de Desarrollo de Software) es un protocolo de código abierto diseñado para ayudar a los equipos y agentes de IA a mantener la claridad, transparencia y flujo durante todo el desarrollo.

Beneficios Clave:

  • Siempre saber cuál es el siguiente paso
  • Restaurar el contexto después de pausas o reinicios
  • Mantener la documentación y el código sincronizados
  • Equilibrar eficazmente la colaboración humano-IA

Consideraciones Clave en 2025:

  • VIBE-CODING: Flujo creativo productivo en desarrollo
  • OVER-VIBING: Pérdida de control del proyecto debido a la automatización excesiva o la deriva
  • Colaboración Agéntica: Asignación de roles y propiedad estructurados a humanos e IAs

Aquí hay un diagrama simplificado del bucle de desarrollo:

---
title: SLDC Agéntico - Bucle de Desarrollo
---
flowchart TD
    Start(["Inicio Paso (ej., 4.2)"])
    Code["Implementar Característica/Tarea"]
    Update["mcp:update<br/>Actualizar README.md & mcp-agentic-sldc.yml<br/>Marcar paso como completado"]
    Commit["mcp:commit<br/>Commit con mensaje Conventional Commit"]
    Next["mcp:next<br/>Pasar al siguiente paso"]
    Review["Revisar Progreso<br/>(Si hay bloqueos, reportarlos)"]
    Done(["Paso Completado"])

    Start --> Code --> Update --> Commit --> Next --> Review --> Done
    Review -- "Si no está listo" --> Start

Y cómo recuperar el contexto después de una pausa:

---
title: SLDC Agéntico - Recuperar contexto
---
flowchart TD
    Done --> MemoryLoss["¿Pérdida de Memoria?"]
    MemoryLoss -- "Sí" --> Recall --> Start
    MemoryLoss -- "No" --> Start
    Recall["Consultar mcp-agentic-sldc.yml<br/>Restaurar contexto, ver progreso, siguientes acciones"]

MCP

El Archivo mcp-agentic-sldc.yml: Tu Hoja de Ruta Viva

Como estamos en etapa temprana, cada proyecto que use SLDC Agéntico con el Protocolo de Flujo de Trabajo Agéntico debe incluir un archivo estructurado como este ejemplo:

author: Michael Wybraniec
goal: Construir una API backend moderna para banca
overview:
  - Configuración
  - Esquema & Modelos
  - Auth & Permisos
  - Pruebas & Documentación
outcome: Una API bancaria lista para extender, construida con GraphQL y Prisma
steps:
  - number: 1
    name: Configurar el proyecto
    owner: human
    done: true
  - number: 2
    name: Definir esquema GraphQL
    owner: ai
    done: true
  - number: 3
    name: Conectar modelos Prisma
    owner: ai
    done: true
  - number: 4
    name: Auth & middleware
    owner: human
    done: false

El YAML también define procedimientos como update, commit, next, y reglas para las transferencias humano-IA.

Como el Vibe-Coding es nuevo, al igual que todos los conceptos, mantienes el control total, lo quieras o no. Por lo tanto, ten presente esta lista:

  • Usar commits convencionales vinculados a cada paso
  • Mantener README.md y el YAML SLDC siempre actualizados
  • Definir la propiedad: Humano vs IA
  • Permitir una transferencia estructurada entre agentes
  • Recuperarse de una pérdida de memoria con un solo comando check
  • Mantener una arquitectura de código modular y testeable
  • Documentar decisiones y compensaciones sobre la marcha

Bankly se completó en 2 días porque:

  • La hoja de ruta era clara y estructurada a través del protocolo AWP
  • El trabajo era modular y agéntico con propiedad definida
  • La IA manejaba tareas estructuradas como esquema, generación de modelos y configuración
  • El enfoque humano se mantuvo en la arquitectura, lógica y revisión
  • El contexto nunca se perdió gracias al protocolo SLDC
  • 35+ commits muestran una progresión sistemática sin deriva de características
  • El Día 1 se centró en la funcionalidad central, el Día 2 en la preparación para producción

Esto no es solo productividad—es velocidad sostenible. El sistema previene el agotamiento mientras mantiene la calidad y permite una iteración rápida.

MCP SLDC Agéntico o mi AWP - Protocolo de Flujo de Trabajo Agéntico - no es solo una herramienta—es una filosofía para el desarrollo moderno:

  • Construir más rápido, pero mantener el arraigo
  • Colaborar con IA, pero mantener la estrategia y propiedad
  • Usar claridad y proceso para evitar el agotamiento y la confusión
  • La estructura es la nueva velocidad en un mundo asistido por IA

Ya sea que estés haciendo Vibe-Coding en solitario o gestionando un equipo de agentes, la colaboración estructurada es la clave para una entrega de software sostenible y de alta calidad.

Contribuye al MCP SLDC Agéntico y únete al movimiento hacia un desarrollo centrado en el humano y asistido por IA -> aquí.

Michael Wybraniec

Michael Wybraniec

Freelance, MCP Servers, Desarrollo Full-Stack, Arquitectura