Plugin de Claude Code que actúa como Product Owner profesional. Descubrimiento de producto, historias de usuario con criterios de aceptación y publicación en Trello. Para desarrolladores y equipos pequeños que quieren construir producto, no gestionar producto.
Tienes ideas de producto pero no sabes traducirlas en historias accionables. PSPO Agent te hace las preguntas correctas y genera la documentación de producto que no tienes tiempo de hacer.
Haces de PO a tiempo parcial además de tu trabajo técnico. PSPO Agent estandariza la calidad de las historias, distribuye el trabajo y detecta dependencias entre tareas.
Todo lo que necesitas para gestionar producto como un profesional, sin serlo.
Pega un documento (brief, email, PRD, mensaje de Slack) y el agente lo interroga hasta alcanzar un 80% de claridad. Evalúa 8 categorías: usuario final, problema, contexto, alcance, restricciones, criterios de éxito, dependencias y fuera de alcance. Sustituye al descubrimiento cuando hay documento de partida.
/pspo-agent:analyze Configura Trello sin conocimiento de APIs. El plugin detecta que es tu primera ejecución y te guía paso a paso para obtener las credenciales, generar el token y configurar el tablero.
/pspo-agent:start HU-01 Comprueba si hay una versión nueva del plugin comparando con las releases de GitHub. Descarga e instala la actualización verificando el checksum SHA-256 del instalador.
/pspo-agent:update El agente formula preguntas de descubrimiento antes de generar nada. Identifica al usuario final, el problema, las restricciones y el alcance. No genera historias sin antes entender el contexto.
/pspo-agent:discovery HU-02 Produce historias de usuario en formato "Como [rol], quiero [acción], para [beneficio]" con criterios de aceptación Given/When/Then. Cada historia es independiente y de tamaño manejable.
/pspo-agent:generate-stories HU-03 El usuario revisa cada historia individualmente. Puede aprobar, rechazar o pedir cambios. Nada se publica sin aprobación explícita. Soporta aprobación parcial del lote.
/pspo-agent:validate HU-04 Publica las historias aprobadas como tarjetas en el tablero de Trello. Muestra vista previa antes de ejecutar. Detecta duplicados por título. Si falla, guarda localmente para reintentar.
/pspo-agent:publish HU-05 Guarda los artefactos de producto en docs/ del repositorio: vision.md, una historia por fichero en docs/historias/, y backlog.md con la lista priorizada. Todo versionado junto al código.
/pspo-agent:save-docs HU-06 Exporta las historias aprobadas a tres formatos: CSV para hojas de cálculo, JSON para integraciones programáticas, y CSV compatible con la importación de Jira para equipos que migran.
/pspo-agent:export Define los miembros del equipo con rol, categoría, porcentaje de dedicación y si usan agentes de IA. Importa desde CSV o usa el asistente guiado. Los datos se persisten en team.csv.
/pspo-agent:team Calcula la capacidad del equipo con factor de corrección por agentes IA (65% por defecto, respaldado por estudios). Estima historias, detecta desbordamiento y sugiere recortes por prioridad.
/pspo-agent:sprint-plan Configura los criterios mínimos que toda historia debe cumplir: tests, code review, linter, seguridad, documentación. Se añade automáticamente como checklist en las tarjetas de Trello.
/pspo-agent:sprint-plan Consulta el estado de las tarjetas en Trello, evalúa el cumplimiento de la Definition of Done y genera un informe de cierre de sprint con métricas de completitud.
/pspo-agent:sprint-review Agente revisor de estilo que corrige todo el contenido antes de mostrarlo: normas RAE, castellano neutro, tono profesional (CTO), detallista con los criterios de aceptación. Aprende de las correcciones del usuario.
De la idea al tablero de Trello en 5 pasos. Sin trabajo manual.
Un comando en la terminal y listo
Pega tu documento y el agente pregunta hasta entenderlo
Produce historias con criterios Given/When/Then
Tú apruebas, rechazas o pides cambios
Las historias se publican como tarjetas en Trello
Un comando en la terminal y listo
Pega tu documento y el agente pregunta hasta entenderlo
Produce historias con criterios Given/When/Then
Tú apruebas, rechazas o pides cambios
Las historias se publican como tarjetas en Trello
Instala el plugin en menos de 5 minutos. Sin conocimientos previos de APIs.
Necesitas tener instalados Claude Code y Python 3.8+. Verifica que están disponibles en tu terminal.
claude --version
python3 --version # Debe ser >= 3.8Ejecuta el instalador con un solo comando. Registra el marketplace y el plugin en Claude Code automáticamente.
curl -fsSL https://raw.githubusercontent.com/686f6c61/PSPO-Agent/main/install.sh | bashReinicia Claude Code, ábrelo en cualquier proyecto y ejecuta el comando de inicio. El plugin detectará que es tu primera ejecución y te guiará por el asistente de configuración de Trello.
/pspo-agent:startNecesitas Claude Code y Python 3 (viene preinstalado en macOS).
claude --version
python3 --version # Debe ser >= 3.8Ejecuta el instalador con un solo comando.
curl -fsSL https://raw.githubusercontent.com/686f6c61/PSPO-Agent/main/install.sh | bashReinicia Claude Code y ejecuta el comando de inicio para activar el asistente de configuración.
/pspo-agent:startNecesitas Claude Code y Python 3.8+. Usa PowerShell como terminal.
claude --version
python3 --version # Debe ser >= 3.8Ejecuta el instalador con un solo comando en PowerShell.
irm https://raw.githubusercontent.com/686f6c61/PSPO-Agent/main/install.ps1 | iexReinicia Claude Code y ejecuta el comando de inicio.
/pspo-agent:startEl plugin guía la configuración de Trello automáticamente en la primera ejecución. No necesitas editar ficheros manualmente. El asistente te lleva paso a paso:
Visita la página de administración de Power-Ups de Trello, crea un nuevo Power-Up y copia la API Key.
https://trello.com/power-ups/adminEl plugin construye automáticamente la URL de autorización con tu API Key. Solo necesitas abrir el enlace en el navegador, autorizar a PSPO Agent y copiar el token.
El plugin lista tus tableros de Trello y te permite elegir uno existente o crear uno nuevo con las columnas y etiquetas por defecto.
Asegúrate de reiniciar Claude Code después de la instalación. Los plugins se cargan al inicio de sesión.
claude plugin list # Verifica que pspo-agent apareceSi instalas manualmente, asegúrate de que los scripts tienen permisos de ejecución.
chmod +x install.sh
chmod +x hooks/scripts/*.shInstala Python 3.8+ desde la web oficial o con tu gestor de paquetes.
# Ubuntu/Debian
sudo apt install python3
# macOS (viene preinstalado)
python3 --version
# Windows: descarga desde https://python.orgVerifica que la API Key tiene 32 caracteres hexadecimales y que el token empieza por ATTA. Los tokens caducan a los 30 días. Genera uno nuevo con /pspo-agent:onboarding.
Verifica que Python 3 está en el PATH. El servidor MCP es un fichero Python puro sin dependencias externas.
python3 --version
# Si falla, instala Python desde https://python.orgSkills, agentes, servidor MCP y hooks. Cada pieza tiene una única responsabilidad.
PSPO Agent es un plugin de Claude Code que opera como un conjunto coordinado de skills (instrucciones estructuradas en Markdown) que guian el comportamiento del LLM, combinado con un servidor MCP ligero para la integración con la API de Trello. El plugin no implementa logica de negocio en codigo compilado. Las skills contienen la inteligencia de producto; el servidor MCP encapsula toda la comunicación HTTP con Trello.
El servidor MCP es la única pieza que ejecuta código. Es un fichero Python puro (stdlib, sin dependencias externas) que implementa el protocolo JSON-RPC 2.0 sobre stdio y expone herramientas para interactuar con la API REST de Trello.
| Herramienta | Método | Endpoint | Entrada | Salida |
|---|---|---|---|---|
| verify-credentials | GET | /1/members/me | key, token | Nombre usuario, id, URL perfil |
| list-boards | GET | /1/members/me/boards | key, token | Lista de tableros (id, nombre, URL) |
| get-board | GET | /1/boards/{id} | boardId | Tablero con listas y etiquetas |
| create-board | POST | /1/boards | name, defaultLists | Tablero creado (id, URL) |
| manage-lists | POST/PUT | /1/boards/{id}/lists | boardId, action, params | Lista creada/modificada |
| manage-labels | POST/PUT | /1/boards/{id}/labels | boardId, action, params | Etiqueta creada/modificada |
| create-cards | POST | /1/cards | listId, cards[] | Tarjetas creadas (id, URL) |
| search-cards | GET | /1/boards/{id}/cards | boardId, query | Tarjetas que coinciden |
| add-checklist | POST | /1/cards/{id}/checklists | cardId, name, items[] | Checklist creado con items |
| attach-file | POST | /1/cards/{id}/attachments | cardId, fileName, content | Adjunto creado (id, URL) |
El plugin gestiona estas variables automáticamente durante el onboarding. No necesitas editarlas manualmente.
# Credenciales de la API de Trello
TRELLO_API_KEY= # API Key del Power-Up (32 caracteres hex)
TRELLO_TOKEN= # Token de autorización (cadena larga)
TRELLO_BOARD_ID= # ID del tablero seleccionadoDatos reales de empresas y estudios académicos. No opiniones, no marketing. Resultados medidos.
Cuando un miembro del equipo usa un agente autónomo de IA (no autocompletado), el tiempo necesario para completar tareas de desarrollo se reduce significativamente. PSPO Agent aplica un factor de corrección del 65% por defecto (70% recomendado, configurable entre 30% y 80%) al calcular la capacidad del equipo en la planificación de sprint.
Este factor está respaldado por los siguientes estudios con agentes autónomos. La diferencia con el autocompletado es significativa: mientras que el autocompletado ofrece mejoras del 20-55%, los agentes autónomos alcanzan el 75-97% en tareas repetitivas y el 60-75% en desarrollo general.
Una historia estimada en 10 días de desarrollo sin agente IA, con un factor del 65%, se completa en 3.5 días con agente. Con el factor recomendado del 70%, en 3 días.
| Fuente | Año | Reducción |
|---|---|---|
| Amazon Q (Andy Jassy, CEO) | 2024 | ~97% |
| Devin / Oracle (Cognition Labs) | 2025 | 93% (14x) |
| Devin / Nubank (Cognition Labs) | 2025 | 92% (12x) |
| Devin general (Cognition Labs) | 2025 | 75% (4x) |
| McKinsey (estudio controlado) | 2024 | 50% (2x) |
| GitHub Copilot (arXiv) | 2023 | 55% |
| Claude Code agent mode | 2026 | 30-40% |
| Google RCT interno | 2024 | 21% |
Todos los enlaces apuntan a las fuentes originales. Los datos de reducción corresponden a agentes autónomos de IA (no autocompletado), excepto GitHub Copilot y Google RCT que se incluyen como referencia comparativa.
Los requisitos del propio PSPO Agent, generados con la misma metodología que el plugin aplica a tus proyectos.
Como desarrollador que instala el plugin por primera vez, quiero que el plugin detecte que no hay configuración y me guíe paso a paso para obtener las credenciales de Trello y configurar mi tablero, para poder empezar a usar el plugin sin necesitar conocimientos previos sobre la API de Trello.
Detección automática de primera ejecución
Given el plugin está instalado y no existe un fichero .env con las variables TRELLO_API_KEY y TRELLO_TOKEN
When el usuario ejecuta cualquier comando del plugin
Then el plugin detecta que falta la configuración
Then arranca automáticamente el asistente de onboarding
Then muestra un mensaje de bienvenida explicando que va a guiarle paso a paso
Paso 1 -- Obtener la API Key
Given el asistente de onboarding está en ejecución
When llega al paso de obtener la API Key
Then explica al usuario que necesita crear un Power-Up en Trello
Then le indica que visite https://trello.com/power-ups/admin
Then le pide que pegue la API Key en el terminal
Then valida que el formato es correcto (32 caracteres hexadecimales)
Verificación de credenciales
Given el usuario ha proporcionado la API Key y el token
When el plugin verifica la conexión
Then hace una llamada a GET /1/members/me con las credenciales
Then si la respuesta es exitosa, muestra el nombre del usuario de Trello
Then si la respuesta es un error, identifica cuál credencial es incorrecta
Then NO almacena las credenciales inválidas
Como desarrollador que acaba de conectar sus credenciales de Trello, quiero elegir o crear un tablero y configurar sus columnas y etiquetas, para tener el tablero listo para recibir historias de usuario sin configuración manual.
Selección de tablero
Given las credenciales de Trello están verificadas y no hay TRELLO_BOARD_ID configurado
When el asistente llega al paso de configuración del tablero
Then consulta los tableros del usuario vía la API de Trello
Then muestra la lista de tableros disponibles
Then ofrece seleccionar un tablero existente o crear uno nuevo
Crear tablero nuevo
Given el usuario elige crear un tablero nuevo
When introduce el nombre del tablero
Then crea el tablero con columnas: Backlog, Sprint actual, En progreso, En revisión, Hecho
Then crea etiquetas de prioridad: Crítica (rojo), Alta (naranja), Media (amarillo), Baja (azul)
Then guarda el TRELLO_BOARD_ID en .env
Then muestra la URL del tablero creado
Como desarrollador con una idea de producto, quiero que el agente me haga preguntas de descubrimiento antes de generar nada, para asegurarme de que el problema está bien definido antes de escribir una sola línea de código.
Inicio del descubrimiento
Given el usuario activa el plugin y describe una necesidad en lenguaje natural
When el agente recibe la descripción
Then NO genera historias de usuario inmediatamente
Then formula al menos 3 preguntas de descubrimiento
Then pregunta sobre el usuario final, el problema actual, las restricciones y el resultado esperado
Iteración en descubrimiento
Given el agente ha formulado preguntas y el usuario las ha respondido
When las respuestas revelan ambigüedades o contradicciones
Then hace preguntas de seguimiento para clarificar
Then no avanza a la generación hasta que el alcance esté definido
Descripción suficientemente detallada
Given el usuario proporciona una descripción con usuario, problema, contexto y restricciones
When el agente analiza la descripción
Then puede reducir el número de preguntas de descubrimiento
Then confirma con el usuario los puntos clave antes de avanzar
Como desarrollador que ha completado el descubrimiento, quiero recibir historias de usuario bien formadas con criterios de aceptación, para tener una guía clara de qué construir y cómo verificar que está bien hecho.
Formato correcto de historias
Given el descubrimiento está completo y el alcance está definido
When el agente genera las historias de usuario
Then cada historia sigue el formato "Como [rol específico], quiero [acción concreta], para [beneficio medible]"
Then el rol nunca es genérico ("usuario"), siempre es específico
Then cada historia es independiente y se puede entregar por separado
Then las historias están ordenadas por prioridad de valor
Criterios de aceptación completos
Given el agente ha generado una historia de usuario
When presenta los criterios de aceptación
Then cada criterio usa formato Given/When/Then
Then incluye al menos un escenario positivo (happy path)
Then incluye al menos un escenario negativo (error, entrada inválida)
Then los valores son concretos, no genéricos
Tamaño manejable
Given el agente genera historias de usuario
When una historia es demasiado grande (más de 3 días de trabajo)
Then la descompone en historias más pequeñas
Then explica cómo se relacionan entre sí
Como desarrollador que recibe los artefactos generados, quiero revisar y aprobar cada artefacto antes de que se publique en Trello, para mantener el control sobre lo que se gestiona en mi tablero.
Presentación para revisión
Given el agente ha generado las historias de usuario y criterios
When presenta los artefactos al usuario
Then muestra un resumen estructurado con todas las historias
Then permite aprobar, rechazar o pedir cambios en cada historia individualmente
Aprobación parcial
Given el usuario aprueba algunas historias pero no todas
When confirma la selección
Then solo las historias aprobadas se marcan como listas para publicar
Then las historias pendientes quedan en estado de revisión
Como desarrollador que ha aprobado las historias, quiero que el plugin publique las historias como tarjetas en el tablero de Trello configurado, para tener la gestión visual del backlog sin trabajo manual.
Publicación en tablero existente
Given el usuario tiene un tablero configurado y las historias están aprobadas
When confirma la publicación en Trello
Then publica cada historia como una tarjeta en la columna Backlog
Then NO duplica tarjetas que ya existan (comparación por título)
Formato de tarjetas
Given el plugin crea una tarjeta en Trello
When la tarjeta se publica
Then el título es la historia en formato corto
Then la descripción incluye la historia completa y los criterios Given/When/Then
Then la tarjeta tiene la etiqueta de prioridad correspondiente
Vista previa antes de publicar
Given las historias están aprobadas y listas para publicar
When el usuario da la orden de publicar
Then muestra una vista previa de las tarjetas a crear
Then pide confirmación final antes de ejecutar
Como desarrollador que trabaja en el proyecto, quiero que los artefactos de producto se guarden como ficheros en el repositorio, para tener la documentación versionada junto al código.
Estructura de ficheros
Given el agente ha generado y el usuario ha aprobado los artefactos
When se guardan en el sistema de ficheros
Then crea docs/vision.md con la visión de producto
Then crea docs/historias/HU-XX-titulo.md para cada historia
Then crea docs/backlog.md con la lista priorizada
Then cada fichero usa formato Markdown limpio y legible
Como tech lead de un equipo pequeño sin PO dedicado, quiero definir los miembros de mi equipo con sus roles dentro del plugin, para que el PSPO tenga la información necesaria para distribuir historias de forma inteligente.
Detección de equipo no definido
Given el usuario tiene historias aprobadas y no existe team.csv
When solicita distribuir historias al equipo
Then detecta que no hay equipo definido
Then ofrece: importar CSV, rellenar plantilla, o añadir miembros uno a uno
Alta guiada de miembros
Given el usuario elige añadir miembros de forma guiada
When el plugin inicia el asistente
Then para cada miembro pregunta: nombre, email, rol y categoria
Then sugiere roles comunes pero acepta texto libre
Then al terminar, muestra el resumen y pide confirmación
Persistencia del equipo
Given el usuario ha confirmado la composición del equipo
When el plugin guarda los datos
Then escribe team.csv con cabecera: nombre,email,rol,categoria,dedicacion,usa_agente_ia
Then en futuras sesiones, lee team.csv automáticamente
Como tech lead que tiene historias aprobadas y un equipo definido, quiero que el PSPO sugiera una distribución de historias entre los miembros del equipo, para no tener que repartir el trabajo a ojo y asegurarme de que la carga está equilibrada.
Propuesta de distribución basada en roles
Given hay historias aprobadas y equipo definido
When el PSPO analiza las historias y el equipo
Then identifica el tipo de trabajo de cada historia
Then cruza el tipo de trabajo con los roles del equipo
Then genera una propuesta de asignación en formato tabla
Then muestra la carga total por miembro y señala desequilibrios
Aprobación del usuario sobre la distribución
Given el PSPO presenta la propuesta completa
When el usuario la revisa
Then puede aprobar la distribución tal como está
Then puede modificar asignaciones individuales
Then puede rechazar y pedir nuevo análisis con criterios distintos
Como tech lead que coordina el trabajo de un equipo pequeño, quiero que el PSPO identifique dependencias y bloqueantes entre historias, para saber en qué orden deben ejecutarse y qué impacto tiene un retraso.
Análisis automático de dependencias
Given hay al menos 3 historias aprobadas
When el usuario solicita el mapa de dependencias
Then analiza el contenido de cada historia buscando relaciones técnicas, de datos y de UX
Then genera una lista de dependencias con nivel de confianza (alta, media, baja)
Visualización del grafo de dependencias
Given el mapa está confirmado por el usuario
When el plugin genera la visualización
Then crea un diagrama Mermaid en docs/dependencias.md
Then cada historia es un nodo con ID y título
Then las historias bloqueantes se resaltan visualmente
Análisis de impacto de retrasos
Given el mapa está confirmado y las historias están asignadas
When el usuario pregunta qué pasa si una historia se retrasa
Then recorre la cadena de dependencias desde esa historia
Then muestra historias y miembros afectados directa e indirectamente
Then calcula el radio de impacto total
Como tech lead que gestiona su equipo a través de Trello, quiero que las asignaciones y dependencias se reflejen en las tarjetas del tablero, para que todo el equipo vea quién hace qué y qué depende de qué sin salir de Trello.
Asignación de miembros a tarjetas
Given las historias están publicadas y las asignaciones aprobadas
When el plugin sincroniza con Trello
Then busca cada miembro asignado por email en el tablero
Then si existe, lo asigna a la tarjeta correspondiente
Then si no existe, ofrece invitarle al tablero o registrar la asignación localmente
Checklists de dependencias
Given el mapa de dependencias está confirmado y las tarjetas existen en Trello
When el plugin sincroniza las dependencias
Then crea un checklist "Dependencias" en cada tarjeta afectada
Then cada item es una dependencia con enlace a la tarjeta de la que depende
Vista previa antes de sincronizar
Given el plugin va a sincronizar asignaciones y dependencias
When el usuario solicita la sincronización
Then muestra una vista previa completa de los cambios
Then pide confirmación explícita antes de ejecutar
Then NUNCA modifica tarjetas sin confirmación del usuario
Como tech lead de un equipo pequeño, quiero definir una Definition of Done para el proyecto, para que todas las historias tengan un estándar mínimo de calidad verificable.
DoD por defecto
Given el usuario no ha configurado una DoD personalizada
When el agente genera historias
Then aplica una DoD por defecto: criterios cumplidos, código revisado, tests pasando, documentación actualizada
Como desarrollador con muchas historias en el backlog, quiero que el agente me ayude a priorizar por valor de negocio, para trabajar primero en lo que más impacto tiene.
Sugerencia de priorización
Given hay más de 5 historias en el backlog sin priorizar
When el usuario pide ayuda para priorizar
Then pregunta por criterios de valor (impacto, esfuerzo, riesgo)
Then sugiere un orden con justificación para cada historia
Then el usuario tiene la última palabra sobre el orden final