Written by Juan Martín Gimenez Yunis, Senior Frontend Developer at Distillery

Don’t get me wrong—the work PMs and POs do is excellent. You’re the ones who understand the users, navigate the business constraints, and turn chaos into a coherent product vision. But what if we could take that already great work to the next level? In this new era shaped by AI, there’s an opportunity to create a much more powerful synergy between product and engineering. Let me tell you what I mean.

In past experiences across different teams, I’ve encountered user stories that simply said: “See attached Figma for design.” No frame name. No section hint. Just a link to a file with dozens of frames. Almost a few cups of coffee later, I’d find the component I needed, buried in a nested group.

I’m not pointing fingers—this is a process problem that affects every team I’ve worked with. PMs juggle a million priorities. Developers context-switch constantly. The system creates friction.

But here’s the exciting part: this doesn’t have to happen anymore.

The real problem: user stories that need rewriting before we can use them

Here’s what this looks like in practice: I receive a user story, and before I can even start coding—or feed it to my AI development tools—I have to rewrite it. I need to add the missing edge cases, clarify the acceptance criteria, and find the correct MCP link to give the AI the right design context (more on this ahead). The story as written isn’t actionable; it’s a starting point for a conversation.

This matters more than ever now. According to the Consortium for Information & Software Quality (CISQ), poor software quality cost the US economy an estimated $2.41 trillion in 2022—and a significant chunk of that traces back to requirements issues. When specs are unclear, bugs slip through, rework piles up, and everyone loses time.

This is the core friction. If user stories were clear and complete from the start, developers could take them and run—whether coding manually or using AI assistants. Instead, we spend time translating intentions into specifications.

And there’s a compounding factor: every PM has their own style. Some write detailed acceptance criteria using structured formats like Given/When/Then; others write free-form paragraphs or skip edge cases entirely. This inconsistency creates a hidden tax on every team.

The solution: AI sub-agents as the great equalizer

A few weeks ago, I attended a Cursor workshop where a tech lead from MercadoLibre—focused on GenAI productivity—was one of the speakers. He introduced Specification-Driven Development (SDD) and I learned that MercadoLibre had run an internal workshop on this for over 7,000 developers.

The core insight: “Vibe coding doesn’t work at enterprise scale.” You need structured specs.

Here’s the opportunity for product teams: a company-wide AI sub-agent that helps every PM write better user stories.

Imagine: instead of forcing PMs to change how they work, you give them an AI assistant pre-configured with your company’s conventions. The PM describes what they need naturally. The sub-agent asks clarifying questions: “What happens if the email isn’t found? How long should the reset link be valid?” Based on the answers, it drafts a complete, standardized user story.

For PMs, this is a win too: less time in alignment meetings and Slack threads clarifying what you meant. You catch gaps before devs start working. No need to memorize templates—the sub-agent handles structure.

For developers? We spend less time decoding and more time building. For the organization? When a senior PM leaves, their wisdom about writing good specs doesn’t walk out the door—it’s embedded in the sub-agent everyone uses.

Getting started: three things you can do now

1. Start with precise Figma links (this one’s a superpower). Instead of linking entire Figma files, select the specific component and copy its link (Cmd+L on Mac). That URL includes a node-id pointing directly to that exact element. No more treasure hunts. This simple change can save hours of back-and-forth per sprint—for you and for devs. For the technical details, check out Figma’s MCP server guide.

2. Experiment with Claude for drafting. Paste your user story into Claude and ask: “What edge cases am I missing? What questions might a developer have?” You might be surprised what surfaces—and it takes two minutes. Think of all the async Slack threads and alignment meetings this could replace. 

3. Talk to your developers. Ask them: “What was the last story that was frustrating to implement?” Their answers will tell you exactly what to focus on—and they’ll appreciate that you asked.

What do you think?

The tools exist. Companies like MercadoLibre are already moving. The question is whether we—PMs and developers together—will grab this opportunity.

Some Sources:

  1. CISQ: Cost of Poor Software Quality 2022 — The $2.41 trillion estimate
  2. GitHub spec-kit — Open-source SDD toolkit
  3. Figma MCP Server Guide — Precise design linking
  4. Claude Sub-agents Docs — Configuring AI agents

Escrito por Juan Martín Gimenez Yunis, Senior Frontend Developer en Distillery

No me malinterpretes: el trabajo de los PM y PO es excelente. Sois los que entendéis a los usuarios, navegáis por las limitaciones empresariales y convertís el caos en una visión coherente del producto. Pero, ¿y si pudiéramos llevar ese trabajo, ya de por sí excelente, al siguiente nivel? En esta nueva era configurada por la IA, existe la oportunidad de crear una sinergia mucho más poderosa entre el producto y la ingeniería. Déjame que te explique a qué me refiero.

En experiencias anteriores en diferentes equipos, me he encontrado con historias de usuario que simplemente decían: “Ver Figma adjunto para el diseño”. Sin nombre de marco. Ninguna sugerencia de sección. Sólo un enlace a un archivo con docenas de marcos. Casi unas tazas de café después, encontraba el componente que necesitaba, enterrado en un grupo anidado.

No estoy señalando a nadie, es un problema de proceso que afecta a todos los equipos con los que he trabajado. Los jefes de proyecto hacen malabarismos con un millón de prioridades. Los desarrolladores cambian constantemente de contexto. El sistema crea fricciones.

Pero ésta es la parte emocionante: esto ya no tiene por qué ocurrir.

El verdadero problema: historias de usuario que hay que reescribir antes de poder utilizarlas

Esto es lo que ocurre en la práctica: Recibo una historia de usuario, y antes de que pueda siquiera empezar a codificar -o alimentar con ella mis herramientas de desarrollo de IA- tengo que reescribirla. Tengo que añadir los casos extremos que faltan, aclarar los criterios de aceptación y encontrar el enlace MCP correcto para dar a la IA el contexto de diseño adecuado (más adelante hablaremos de esto). La historia tal y como está escrita no es procesable; es un punto de partida para una conversación.

Esto importa ahora más que nunca. Según el Consorcio para la Calidad de la Información y el Software (CISQ), la mala calidad del software costará a la economía de EE.UU. unos 2,41 billones de dólares en 2022, y una parte importante de ello se debe a problemas de requisitos. Cuando las especificaciones no son claras, se cuelan los errores, se acumulan las repeticiones y todo el mundo pierde tiempo.

Esta es la fricción central. Si las historias de usuario fueran claras y completas desde el principio, los desarrolladores podrían tomarlas y correr, ya sea codificando manualmente o utilizando asistentes de IA. En lugar de eso, dedicamos tiempo a traducir las intenciones en especificaciones.

Y hay un factor agravante: cada PM tiene su propio estilo. Algunos escriben criterios de aceptación detallados utilizando formatos estructurados como Dado/Cuando/Entonces; otros escriben párrafos sin formato u omiten por completo los casos extremos. Esta incoherencia crea un impuesto oculto en todos los equipos.

La solución: Los subagentes de IA como el gran ecualizador

Hace unas semanas, asistí a un taller de Cursor en el que uno de los ponentes era un responsable técnico de MercadoLibre centrado en la productividad GenAI. Presentó el Desarrollo Basado en Especificaciones (SDD) y me enteré de que MercadoLibre había organizado un taller interno sobre este tema para más de 7.000 desarrolladores.

La idea central: “La codificación vibe no funciona a escala empresarial”. Necesitas especificaciones estructuradas.

Aquí está la oportunidad para los equipos de producto: un subagente de IA para toda la empresa que ayude a cada PM a escribir mejores historias de usuario.

Imagínate: en lugar de obligar a los PM a cambiar su forma de trabajar, les das un asistente de IA preconfigurado con las convenciones de tu empresa. El PM describe lo que necesita de forma natural. El subagente hace preguntas aclaratorias: “¿Qué ocurre si no se encuentra el correo electrónico? ¿Durante cuánto tiempo debe ser válido el enlace de restablecimiento?”. En función de las respuestas, redacta una historia de usuario completa y estandarizada.

Para los PM, esto también es una victoria: menos tiempo en reuniones de alineación e hilos de Slack aclarando lo que querías decir. Detectas lagunas antes de que los desarrolladores empiecen a trabajar. No necesitas memorizar plantillas: el subagente se encarga de la estructura.

¿Para los desarrolladores? Pasamos menos tiempo descodificando y más tiempo construyendo. ¿Para la organización? Cuando un PM senior se va, su sabiduría sobre cómo escribir buenas especificaciones no sale por la puerta, sino que queda integrada en el subagente que todos utilizan.

Empezar: tres cosas que puedes hacer ahora

1. Empieza con enlaces Figma precisos (éste es un superpoder). En lugar de enlazar archivos Figma enteros, selecciona el componente concreto y copia su enlace (Cmd+L en Mac). Esa URL incluye un nodo-id que apunta directamente a ese elemento exacto. Se acabaron las búsquedas del tesoro. Este sencillo cambio puede ahorrarte horas de idas y venidas por sprint, tanto a ti como a los desarrolladores. Para conocer los detalles técnicos, consulta la guía del servidor MCP de Figma.

2. Experimenta con Claude para redactar. Pega tu historia de usuario en Claude y pregúntate: “¿Qué casos extremos me faltan? ¿Qué preguntas podría tener un desarrollador? Te sorprenderá lo que aparece, y tardarás dos minutos. Piensa en todos los hilos asíncronos de Slack y las reuniones de alineación que esto podría sustituir.

3. Habla con tus desarrolladores. Pregúntales: “¿Cuál ha sido la última historia frustrante de implementar?”. Sus respuestas te dirán exactamente en qué debes centrarte, y te agradecerán que se lo preguntes.

¿Qué te parece?

Las herramientas existen. Empresas como MercadoLibre ya se están moviendo. La cuestión es si nosotros, los PM y los desarrolladores juntos, aprovecharemos esta oportunidad.

Algunas fuentes:

  1. CISQ: Coste de la mala calidad del software 2022 – La estimación de 2,41 billones de dólares
  2. GitHub spec-kit – Conjunto de herramientas SDD de código abierto
  3. Guía del servidor Figma MCP – Vinculación precisa del diseño
  4. Claude Sub-agents Docs – Configurar agentes de IA