De la Idea a la API en 2 Días: Construyendo Bankly con Flujos de Trabajo Agénticos
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í.
Chatbot IA, Servidor MCP construido con Protocolo de Flujo de Trabajo Agéntico para demo en Checkatrade.com
Una demostración completa de cómo construir un servidor MCP para integración de chatbot de e-commerce, con servicios de mantenimiento de calderas, acceso a datos en tiempo real y flujos de trabajo automatizados usando AWP.
Agentes MCP Tiny On-Premises: Liberándose de las Dependencias en la Nube
Explorando cómo ejecutar agentes basados en MCP completamente on-premises utilizando LLMs locales, examinando los compromisos entre la conveniencia de la nube y el control local para implementaciones empresariales de IA.
Chatbot IA, Servidor MCP construido con Protocolo de Flujo de Trabajo Agéntico para demo en Checkatrade.com
Una demostración completa de cómo construir un servidor MCP para integración de chatbot de e-commerce, con servicios de mantenimiento de calderas, acceso a datos en tiempo real y flujos de trabajo automatizados usando AWP.
Agentes MCP Tiny On-Premises: Liberándose de las Dependencias en la Nube
Explorando cómo ejecutar agentes basados en MCP completamente on-premises utilizando LLMs locales, examinando los compromisos entre la conveniencia de la nube y el control local para implementaciones empresariales de IA.

