BAISH Logo
BuenosAiresAISafetyHub
Sobre nosotrosProgramasInvestigaciónRecursosContacto
EnglishEspañol
ResumenProblemaSoluciónAgentesPlanningDevelopmentRecursos
Inicio / Agentic Coding Workshop

Workshop de Agentic Coding

Armá proyectos con AI como si tuvieras todo un equipo: metodología BMAD, agentes, procesos y herramientas listas para usar.

Viernes 3 de octubre 2025, 16:00hs · Salas 1109 y 1110 — BAISH x Y-hat

Esta página reúne todos los materiales y recursos del workshop.

Unite al grupo de WhatsApp "Agentic Coding" dentro de la comunidad BAISH para discutir ideas, compartir proyectos y pedir ayuda con BMAD.

Empezar ahoraBAISHY-hatUnirse al WhatsAppVer recursos

Contexto

El problema con los LLMs tradicionales

Dos obstáculos hacen que “darle todo al modelo” no funcione: degradación en contextos largos y falta de memoria real a través del tiempo.

Degradación con contexto largo

El benchmark LoCoDiff (enero 2025) muestra que incluso el mejor modelo disponible, Sonnet 4.5, degrada significativamente con contextos largos.

El resultado: de 96 % de precisión con contextos de 2 K–21 K tokens a 64 % con más de 60 K tokens. Cuando le das todo tu codebase al modelo, se ahoga en información.
  • •Los modelos de punta siguen dependiendo de ventanas de contexto manejables para mantener la precisión.
  • •Darles archivos completos o repositorios enteros produce ruido, repeticiones y decisiones inconsistentes.

Fuente: LoCoDiff Benchmark

Sin memoria a largo plazo

Un estudio de METR (julio 2025) demostró que developers expertos con 2+ años de experiencia en sus propios proyectos fueron 20 % más lentos usando AI que trabajando solos.

¿Por qué? El LLM arranca de cero cada vez: no tiene el contexto tácito que las personas acumulan. Los expertos predijeron que serían 39 % más rápidos, pero la realidad fue lo opuesto.
  • •Tiempo observado por story: 1.67 h sin AI vs 2.26 h con AI asistida.
  • •Predicciones previas esperaban reducciones de 24 %–39 %, exponiendo la brecha entre expectativas y realidad.

Fuente: METR AI R&D Study (July 2025)

Método BMAD

La solución: un equipo agentic que planifica y ejecuta

BMAD es un método de desarrollo con AI donde ocho agentes especializados trabajan como un equipo real. Planifican todo el proyecto antes de codear y luego ejecutan story por story con validaciones continuas.

Cada agente es el mismo LLM con un prompt especializado y acceso a contexto shardeado y verificado. No hay memoria mágica: hay documentación estructurada al alcance justo.

Sharding

Documentos grandes se dividen en fragmentos pequeños y enfocados. En vez de darle al Developer un PRD de 10 000 tokens, recibe un shard de 400–600 tokens con lo esencial para la story.

Resultado: cada agente opera en la zona de 96 % de precisión (<5 K tokens) sin ruido adicional.

Agentes especializados

Ocho agentes con roles concretos: Product Manager, Architect, Developer, QA, etc. Cada uno tiene instrucciones y checklist propios, y consulta solamente el contexto que necesita.

Resultado: contexto quirúrgicamente preciso para cada decisión, sin sobrecargar al modelo.

Documentación estructurada

Planning riguroso antes de codear: PRD completo, arquitectura definida y stories secuenciales que se validan entre sí. Eso crea la “memoria” que los LLMs no tienen.

Resultado: los agentes trabajan con información profesional y verificable, siempre alineada con el objetivo del proyecto.

¿Por qué funciona BMAD?

1. Contexto optimizado

En el estudio METR los equipos trabajaron con codebases enormes en Cursor y terminaron 20 % más lentos. BMAD hace lo contrario: el PM trabaja con 2 K tokens de requirements, Arquitectura con ~3 K tokens y el Developer con un único epic (1.5 K tokens). Precisión alta, sin degradación.

2. Validaciones y transparencia

El Product Owner valida cada story draft antes de pasar a desarrollo, el QA revisa el trabajo del Developer y el equipo humano aprueba cada hito. Los artefactos son legibles por humanos y quedan versionados en el repo.

3. Elicitación avanzada

Los agentes hacen preguntas y completan documentación iterativamente. No es solo generar código: descubren, clarifican y actualizan requirements manteniendo a la persona en el loop.

Equipo Agentic

Los ocho agentes de BMAD

Cada rol es el mismo modelo con un prompt especializado y contexto shardeado. El resultado: un equipo multidisciplinario que trabaja como si fuera humano.

Business Analyst

Insightful Analyst & Strategic Ideation Partner

/analyst *create-project-brief

Market research, brainstorming, competitive analysis, creación de project briefs y documentación de proyectos brownfield.

Artefactos

  • ●Project brief
  • ●Market research
  • ●Competitor analysis
  • ●Brainstorming output

Product Manager

Investigative Product Strategist & Market-Savvy PM

/pm *create-prd

Crea PRDs, define estrategia de producto, prioriza features y mantiene alineados a los stakeholders. Paso obligatorio del método.

Artefactos

  • ●PRD (Product Requirements Document)
  • ●Brownfield PRD

Architect

Holistic System Architect & Full-Stack Technical Leader

/architect *create-full-stack-architecture

Diseño de sistemas, arquitectura técnica, selección de tecnologías, contratos de API y planes de infraestructura. Paso obligatorio del método.

Artefactos

  • ●Full-stack architecture
  • ●Backend architecture
  • ●Frontend architecture
  • ●Brownfield architecture

UX Expert

User Experience Designer & UI Specialist

/ux-expert *create-front-end-spec

Diseño UI/UX, wireframes, prototipos, front-end specifications y prompts listos para v0 o Lovable.

Artefactos

  • ●Front-end spec
  • ●UI design prompts

Product Owner

Technical Product Owner & Process Steward

/po *shard-doc

Gestiona el backlog, refina historias, define acceptance criteria y valida la coherencia entre artefactos. Crítico: el sharding evita la degradación del modelo.

Artefactos

  • ●Sharded documents
  • ●Epic files
  • ●Story validations

Scrum Master

Technical Scrum Master & Story Preparation Specialist

/sm *draft

Prepara historias claras, gestiona epics, dirige retros y mantiene la cadencia ágil. Produce drafts listos para que el Developer implemente sin fricción.

Artefactos

  • ●User story drafts
  • ●Sequential tasks
  • ●Acceptance criteria

Developer

Expert Senior Software Engineer & Implementation Specialist

/dev *develop-story

Implementa código, cubre tests, refactoriza y documenta decisiones. Trabaja story por story con cobertura de pruebas.

Artefactos

  • ●Production code
  • ●Unit tests
  • ●Integration tests
  • ●E2E tests
  • ●Code documentation

QA

Test Architect with Quality Advisory Authority

/qa *review

Define estrategias de testing, evalúa riesgos, asegura trazabilidad de requirements y emite la decisión de calidad final.

Artefactos

  • ●QA results & gate decisions
  • ●Risk profiles
  • ●Test plans & design
  • ●Requirements tracing
  • ●NFR assessments

Operativa diaria

Cómo se usan los comandos

Los agentes se invocan por terminal o en el IDE usando comandos cortos. En todos los casos pasás el contexto con @archivo.md.

Sintaxis de comandos

Elegí la herramienta que uses y seguí la misma estructura: comando + acción + archivos relevantes.

Claude Code / OpenCode

/pm *create-prd here's some rough notes @notes.md/architect *create-full-stack-architecture @prd.md/dev *develop-story @docs/stories/1.1.md

Cursor / Windsurf

@PM Create PRD, here's some notes @notes.md@architect Design the system architecture, here's the @prd.md@dev *develop @docs/stories/1.1.md

Cambiar de agente sin ruido

Cada agente opera en su propio contexto. Para alternar sin confusiones:

  1. 1Limpia el contexto con /clear (Claude Code) o /new (OpenCode).
  2. 2Invocá el agente con su comando de inicialización (ej: /po *shard-doc).
  3. 3Pasale únicamente los archivos relevantes usando @filename.md.

Tip: Mantené tus documentos en docs/ y usá nombres claros (ej. docs/epics/epic-2-dashboard.md) para shardear contexto con precisión.

Fase 1

Planning (una sola vez al inicio)

Diseño completo antes de escribir código. Todo se ejecuta desde la terminal con comandos BMAD.

1

PM: PRD Creation

El Product Manager crea el Product Requirements Document guiando al usuario sección por sección.

  • •Proceso interactivo: el PM hace preguntas y captura respuestas a medida que avanza.
  • •Define features y epics (solo títulos de stories en esta fase).
  • •Detalla requirements funcionales y no funcionales.
  • •Prioriza MVP vs roadmap y captura dependencias clave.
  • •Cada sección se revisa y aprueba antes de continuar.
/pm *create-prd
Nota importanteLas stories en el PRD son breves (solo títulos). Más adelante el Scrum Master las expandirá con tareas detalladas.
2

Architect: System Design

El Architect lee el PRD y diseña la arquitectura técnica completa, siempre de forma interactiva.

  • •Selecciona tech stack para frontend, backend y base de datos.
  • •Define la estructura de carpetas y organización del código.
  • •Diseña APIs y contratos entre componentes.
  • •Cubre escalabilidad, seguridad, observabilidad y performance.
  • •Cada sección se valida con el usuario antes de avanzar.
/architect *create-full-stack-architecture
3

PO: Master Checklist

El Product Owner valida que PRD y arquitectura estén perfectamente alineados antes de sharding.

  • •Verifica coherencia entre requirements y diseño técnico.
  • •Confirma que la arquitectura permite implementar todos los features priorizados.
  • •Identifica gaps, contradicciones o riesgos que deben resolverse antes de continuar.
/po *execute-checklist-po
Si algo no cierraSe refinan los documentos hasta que todo tenga sentido. No se pasa a la siguiente fase sin validación completa.
4

PO: Sharding

El Product Owner ejecuta el sharding de PRD y Arquitectura en epics y stories manejables (<2 K tokens).

  • •Corre el programa de terminal que divide automáticamente los documentos.
  • •Genera shards pequeños ubicados en docs/epics y docs/stories.
  • •Cada archivo contiene contexto enfocado y se guarda como Markdown versionable.
  • •Ejemplo: un PRD grande se transforma en docs/epics/epic-1-auth.md, docs/epics/epic-2-dashboard.md, etc.
/po *shard-doc docs/prd.md/po *shard-doc docs/architecture.md
ResultadoBacklog priorizado, con stories shardeadas y listas para desarrollo iterativo.

Agentes adicionales según necesidad

  • •Business Analyst: investigaciones greenfield y project brief inicial.
  • •UX Expert: specs de interfaz y prompts para herramientas como v0 o Lovable.
  • •QA: perfila riesgos y criterios de calidad antes de empezar el desarrollo.

Al finalizar planning tenés:

  • ✓PRD completo y validado.
  • ✓Arquitectura definida y alineada con el PRD.
  • ✓Backlog de stories shardeadas y priorizadas.
  • ✓Contexto estructurado y versionado para todo el equipo.

No escribiste una línea de código todavía. Ese enfoque intencional evita semanas de refactorings más adelante.

Fase 2

Development loop iterativo

Implementación story por story con validaciones integradas. Repetí este loop hasta completar tu backlog.

1

SM: Review previous notes

El Scrum Master repasa las notas de la story anterior para arrancar con aprendizaje acumulado.

  • •Identifica qué funcionó y qué no funcionó.
  • •Recupera decisiones técnicas importantes.
  • •Revisa feedback del Developer y del QA.
  • •Documenta aprendizajes para aplicar en la próxima story.
/sm *review-notes @docs/stories/1.0.md
Loop de aprendizajeLas notas de hoy alimentan el draft de mañana. El equipo mejora story tras story.
2

SM: Draft next story

El Scrum Master arma el draft de la próxima story usando únicamente el contexto relevante.

  • •Lee solo el epic correspondiente (no todo el PRD).
  • •Revisa la arquitectura y el PRD en la medida justa.
  • •Genera tareas secuenciales muy claras.
  • •Define criterios de aceptación específicos.
  • •Incluye suficiente contexto sin ahogar al modelo.
/sm *draft story 1.1
3

PO: Validate story draft

El Product Owner valida el draft con el PRD para asegurar coherencia antes de codear.

  • •Chequea que el draft coincida con los objetivos originales.
  • •Confirma que todos los requirements estén cubiertos.
  • •Señala gaps o contradicciones para corrección inmediata.
  • •Puede aportar recomendaciones al Scrum Master.
/po *validate story @docs/stories/1.1.md
Check de alineaciónGarantiza que el Developer implemente exactamente lo acordado en planning.
4

Dev: Implementation

El Developer implementa la story completa siguiendo arquitectura, UX y checklist de pruebas.

  • •Produce código de producción alineado con la arquitectura.
  • •Escribe tests unitarios, de integración y E2E según corresponda.
  • •Cubre manejo de errores y edge cases.
  • •Puede invocar MCPs como Playwright para automatizar pruebas end-to-end.
/dev *develop-story @docs/stories/1.1.md
5

QA: Test story thoroughly

El QA ejerce el rol de gatekeeper de calidad antes de que la story avance.

  • •Ejecuta todos los tests (unitarios, integración, E2E).
  • •Realiza testing manual sobre user flows y edge cases.
  • •Verifica que se cumplan los criterios de aceptación.
  • •Perfila riesgos (seguridad, performance, fiabilidad).
  • •Emite veredicto: PASS (todo ok) / CONCERNS (revisar) / FAIL (crítico) / WAIVED (aceptado explícitamente).
/qa *review @docs/stories/1.1.md
Quality gatesPASS (todo ok) • CONCERNS (señales leves) • FAIL (problema crítico) • WAIVED (riesgo aceptado explícitamente).
Check críticoEl QA asegura que el código funciona y cumple estándares profesionales antes de pasar a producción.
6

Dev: Fix according to QA review

El Developer corrige según el reporte del QA y deja todo en estado PASS.

  • •Revisa el resultado del QA (PASS/CONCERNS/FAIL).
  • •Implementa fixes y mejoras puntuales.
  • •Resuelve cada CONCERN y FAIL registrado.
  • •Reejecuta los tests para confirmar que nada se rompe.
/dev Fix the issues from QA review @docs/stories/1.1.md
IterativoSi el QA emitió FAIL, se repite la revisión hasta obtener PASS o WAIVED.
7

Mark done & next story

Se cierra la story y el equipo vuelve al paso 1 con la siguiente prioridad.

  • •Actualiza el backlog marcando la story como done.
  • •Elige la siguiente story del backlog priorizado.
  • •Vuelve al paso 1: el SM revisa las notas recién escritas.
Loop iterativoStory por story, commit por commit, hasta completar el proyecto.

Este loop se repite: volvés al paso 1 con la próxima story.

Notas sobre el proceso

  • •Validaciones integradas: PO valida antes de codear, QA testea después, Developer corrige y documenta.
  • •Flexibilidad de calidad: podés aceptar CONCERNS en un MVP o exigir PASS en software crítico.
  • •Loop de aprendizaje continuo: las notas del Developer alimentan al SM en la siguiente iteración.

Ventajas del loop iterativo

  • ✓Siempre tenés una versión funcional y testeada después de cada story.
  • ✓Podés pivotar rápido: cada ciclo entrega valor independiente.
  • ✓El aprendizaje se acumula con notas y retrospectivas cortas.
  • ✓La persona sigue en control: aprueba cada transición clave.

Recursos

Todo para empezar hoy mismo

Herramientas, plantillas y guías para ejecutar BMAD sin fricción.

¿Qué herramienta usar?

Claude Code

Mejor opción: herramienta oficial de Anthropic con Sonnet 4.5 (top del benchmark).

  • ✓Máxima calidad
  • ✓Integración perfecta
  • ✓$100/mes (Max Plan)

OpenCode

Más versátil: te logueás con tu proveedor y usa ese plan.

  • ✓Login con Anthropic, GitHub Copilot, Z.ai, etc.
  • ✓Usa el plan de tu proveedor
  • ✓Open source y multi-modelo

Requiere workaround (ver más abajo).

Cursor / Windsurf

IDEs populares que soportan BMAD con sintaxis @mention.

  • ✓Editores completos
  • ✓Comunidad grande
  • ✓Sintaxis @agent

Gemini CLI

Gratis: Gemini 2.5 Pro con soporte oficial BMAD.

  • ✓Gemini 2.5 Pro
  • ✓Uso gratuito incluido
  • ✓Soporte oficial BMAD

Droid CLI

Gratis: GPT-5-Codex a través de Factory AI.

  • ✓GPT-5-Codex model
  • ✓100 % gratis
  • ✓Factory AI platform

Requiere workaround (ver más abajo).

Workshop Repo — empezá ahora

Repositorio listo con BMAD preinstalado, scripts de setup y MCPs configurados.

  • ✓BMAD pre-instalado y configurado
  • ✓Script de setup para Droid CLI (gratis)
  • ✓MCPs incluidos (Sequential Thinking, Playwright)
  • ✓Comandos BMAD listos para usar
  • ✓Workflows de ejemplo
github.com/baisharg/Workshop-Vibe-Coding↗

Quick start

git clone https://github.com/baisharg/Workshop-Vibe-Codingcd Workshop-Vibe-Coding./setup.sh

El script instala Droid CLI (gratis, GPT-5-Codex) y configura todos los comandos BMAD automáticamente.

Repositorios y aprendizaje

BMAD Repository

Repositorio completo con prompts, documentación y ejemplos.

  • ✓Prompts de los 8 agentes
  • ✓Setup automatizado
  • ✓Documentación completa
  • ✓Ejemplos de proyectos
github.com/bmad-code-org/bmad-method↗

BMAD Method Masterclass

Tutorial en video que recorre el método de punta a punta.

  • ✓Setup paso a paso
  • ✓Uso de cada agente
  • ✓Workflow completo
  • ✓Ejemplos en vivo
youtu.be/LorEJPrALcg↗

Planes recomendados

Z.ai Coding Plan

Recomendado: opción económica para estudiantes y makers.

  • ✓Solo $3/mes
  • ✓Modelo GLM 4.6
  • ✓Performance cercana a Sonnet 4
  • ✓Ideal para estudiantes
z.ai/subscribe↗

Claude Code + Max Plan

Para entusiastas: máxima calidad para agentic coding.

  • ✓Terminal Agent oficial de Anthropic
  • ✓Acceso a Sonnet 4.5
  • ✓Max Plan: $100/mes con límites altos
  • ✓Experiencia optimizada para agentes
claude.com/product/claude-code↗

GitHub Student Pack

Si sos estudiante, conseguís Copilot Pro gratis.

  • ✓Copilot Pro incluido
  • ✓Acceso a Sonnet 4.5
  • ✓Mejor modelo del benchmark
  • ✓Sin costo para estudiantes
education.github.com/pack↗

Herramientas CLI / Terminal

OpenCode

Programa de terminal open source. Te logueás con tu proveedor y OpenCode usa ese plan.

  • ✓Login con Anthropic, Copilot, Z.ai, etc.
  • ✓Corre en la terminal de cualquier IDE
  • ✓Compatible con MCP servers
  • ✓Multi-modelo y open source
opencode.ai↗

Instalación:

curl -fsSL https://opencode.ai/install | bash

Configuración BMAD:

  1. Instalá BMAD seleccionando la opción «Claude Code».
  2. Renombrá el directorio .claude/ a .opencode/.
  3. Pasá los archivos .md al nivel superior (no dentro de agents/ o tasks/).

Requiere workaround para mapear la carpeta de BMAD.

Droid CLI

Cliente de Factory AI que expone GPT-5-Codex gratis, compatible con BMAD.

  • ✓Modelo GPT-5-Codex
  • ✓Completamente gratis
  • ✓Terminal program orientado a agentes
docs.factory.ai/cli↗

Configuración BMAD:

  1. Instalá BMAD seleccionando la opción «Claude Code».
  2. Renombrá .claude/ a .factory/.
  3. Mové los archivos .md al nivel superior de .factory/.

Workaround similar al de OpenCode para reutilizar los prompts.

Instalación y setup

Instalación de BMAD

BMAD se instala por proyecto en el directorio raíz, dejando todo versionable.

En la raíz de tu proyecto:

npx bmad-method install
  • ✓Crea la carpeta .bmad-core/ con agentes y templates.
  • ✓Instalación por proyecto (no global).
  • ✓Todo queda bajo control de versiones.

MCP Tools recomendadas

Herramientas que amplían las capacidades de los agentes.

  • ✓Playwright: browser automation para testing E2E.
  • ✓Sequential Thinking: razonamiento estructurado.
  • ✓Explorá más MCPs en el repositorio de Smithery.
smithery.ai — repositorio de MCP tools↗

Configurá los MCPs en tu IDE y los agentes los usarán cuando los necesiten.

BAISH Logo

Buenos Aires AI Safety Hub

© 2025 BAISH. Todos los derechos reservados.

Sobre nosotrosProgramasInvestigaciónRecursosContacto
Política de privacidad