Skip to content

686f6c61/PSPO-Agent

Repository files navigation

PSPO Agent

Plugin no oficial de Product Owner profesional para Claude Code. Analisis de requisitos, descubrimiento de producto, historias de usuario con criterios Given/When/Then, asignacion operativa, mapa de dependencias, planificacion de sprint con factor de productividad por agentes IA, y publicacion remota en Trello o Notion.

Documentacion del plugin

La documentacion tecnica y de desarrollador vive en:

Importante:

  • Documents/ = documentacion del plugin
  • docs/ = artefactos generados por el flujo de producto

Requisitos

  • Python 3.8+
  • Claude Code

Instalacion

Un solo comando:

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/686f6c61/PSPO-Agent/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/686f6c61/PSPO-Agent/main/install.ps1 | iex

Primer uso

Reinicia Claude Code y ejecuta:

/pspo-agent:start

El asistente de onboarding te guiara para configurar el proveedor remoto, validar credenciales y dejar listo el destino de publicacion.

Proveedores de publicación

Estado actual:

  • trello: integrado y validado
  • notion: integrado y validado para flujo zero-template
  • local: artefactos solo en docs/

La documentación de esta capa vive en:

Skills disponibles

Skill Comando Descripcion
analyze /pspo-agent:analyze Analiza un documento crudo (brief, email, PRD) hasta alcanzar un 80% de claridad en 8 categorias.
start /pspo-agent:start Punto de entrada. Detecta configuracion y redirige al flujo correcto.
onboarding /pspo-agent:onboarding Asistente guiado: credenciales de Trello y configuracion de tablero.
discovery /pspo-agent:discovery Preguntas de descubrimiento desde cero (sin documento de partida).
generate-stories /pspo-agent:generate-stories Genera historias con criterios de aceptacion Given/When/Then.
validate /pspo-agent:validate Revision historia por historia: aprobar, rechazar o pedir cambios.
publish /pspo-agent:publish Publica en el proveedor remoto activo con resumen + adjunto .md + dependencias y asignacion real cuando aplica.
save-docs /pspo-agent:save-docs Guarda artefactos de producto en Markdown local.
update /pspo-agent:update Comprueba y aplica actualizaciones del plugin.
team /pspo-agent:team Gestion de equipo: CSV con dedicacion y uso de agentes IA.
assign /pspo-agent:assign Propone y guarda la asignacion de historias al equipo.
dependencies /pspo-agent:dependencies Detecta y persiste dependencias, bloqueantes e impacto por persona.
sprint-plan /pspo-agent:sprint-plan Planificacion de sprint: DoD, estimacion en horas efectivas, capacidad con factor IA.
autopilot /pspo-agent:autopilot Lee una carpeta con instrucciones + cualquier CSV de equipo compatible y ejecuta el flujo autonomamente hasta la gate final.
sprint-review /pspo-agent:sprint-review Revision de sprint: estado de tarjetas y cumplimiento de DoD.
export /pspo-agent:export Exportacion a CSV, JSON y Jira CSV.
audit /pspo-agent:audit Auditoria senior: completitud, coherencia, HU que faltan/sobran.

Agentes

Agente Responsabilidad
requirement-analyst Interroga documentos hasta alcanzar claridad suficiente para generar historias.
product-owner Descubrimiento de producto, generacion de historias y validacion.
publisher Publicacion operativa en Trello; Notion usa fallback oficial zero-template desde la skill publish.
sprint-planner DoD, equipo, capacidad con factor IA y planificacion de sprint.
culture-guardian Revisor de estilo: normas RAE, tono profesional, aprende del proyecto.
senior-auditor Auditoria de fondo: completitud, coherencia, HU que faltan/sobran.

Integracion remota

Trello se opera con 12 herramientas operativas + 2 de sincronizacion via MCP en Python puro (stdlib, 0 dependencias):

Herramienta Proposito
verify-credentials Verificar API Key + Token
list-boards Listar tableros del usuario
get-board Obtener tablero con listas y etiquetas
create-board Crear tablero nuevo
manage-lists Crear, renombrar, reordenar, archivar listas
manage-labels Crear, actualizar, eliminar etiquetas
create-cards Crear tarjetas con etiquetas y miembros asignados
search-cards Buscar tarjetas por titulo (deteccion de duplicados)
add-checklist Anadir checklist de DoD a tarjetas
attach-file Adjuntar fichero .md completo a tarjetas
get-board-members Obtener miembros del tablero con sus IDs
invite-member Invitar miembros al tablero por email

Notion se opera por fallback oficial zero-template desde:

  • servers/notion-fallback.py
  • .pspo-agent/runtime/notion-fallback.sh

Hooks de seguridad

Hook Evento Funcion
check-env.sh PreToolUse (MCP) Bloquea llamadas MCP si faltan credenciales en .env
block-trello-bash.sh PreToolUse (Bash, Fetch) Bloquea acceso directo a Trello fuera del MCP
warn-sensitive-read.sh PreToolUse (Read) Avisa cuando se intenta leer .env u otros ficheros sensibles
check-gitignore.sh PostToolUse (Write) Verifica que .env esta en .gitignore

Configuracion

El fichero settings.json permite personalizar el comportamiento del plugin:

Parametro Defecto Descripcion
sprint.ai_agent_factor 0.65 Factor de productividad con agentes IA (65%)
sprint.ai_agent_factor_recommended 0.70 Factor recomendado (70%)
sprint.ai_agent_factor_range [0.30, 0.80] Rango configurable
sprint.duration_days 5 Duracion por defecto del sprint en dias laborables
stories.estimation_sizes XS=1, S=2, M=4, L=8, XL=16 Tallas en horas efectivas con agentes
sprint.focus_hours_per_day 6 Horas reales productivas por dia para el calculo de capacidad
trello.default_lists Backlog, Sprint activo, Bloqueada, En progreso, En revision, Hecho Columnas por defecto
trello.default_labels Critica, Alta, Media, Baja Etiquetas de prioridad
docs.date_format DD/MM/AAAA Formato de fechas

Estructura del proyecto

pspo-agent/
├── .claude-plugin/
│   ├── plugin.json
│   └── marketplace.json
├── agents/                  # 6 agentes especializados
├── skills/                  # 18 skills
├── servers/
│   ├── trello-mcp.py        # Servidor MCP Trello
│   ├── trello-mcp-launcher.py
│   ├── trello-fallback.py   # Fallback oficial Trello
│   └── notion-fallback.py   # Fallback oficial Notion
├── hooks/
│   └── scripts/             # hooks de runtime y seguridad
├── tests/                   # tests unitarios, de contenido y runtime
├── Documents/               # documentación viva del plugin
├── docs/                    # artefactos generados por el flujo de producto
├── .mcp.json
├── .env.example
├── settings.json
├── install.sh               # Instalador Linux/macOS
├── install.ps1              # Instalador Windows
├── uninstall.sh
└── uninstall.ps1

Desinstalacion

Linux / macOS

bash uninstall.sh

Windows (PowerShell)

.\uninstall.ps1

Descargo de responsabilidad

PSPO Agent es una herramienta experimental que utiliza inteligencia artificial para generar artefactos de producto. No sustituye el criterio profesional de un Product Owner certificado ni de ningun rol de gestion de producto.

El contenido generado (historias de usuario, criterios de aceptacion, documentacion) es una sugerencia automatizada que el usuario debe revisar, validar y aprobar antes de utilizarlo. El usuario es el unico responsable de las decisiones de producto y de la informacion publicada en Trello o cualquier otro sistema.

Este proyecto no esta afiliado, asociado ni respaldado por Anthropic (Claude), Atlassian (Trello) ni Scrum.org (PSPO). Las marcas mencionadas pertenecen a sus respectivos propietarios.

El software se proporciona "tal cual", sin garantia de ningun tipo, expresa o implicita.

Licencia

MIT

Web

https://pspo-agent.com

About

Plugin de Product Owner profesional para Claude Code. Analisis de requisitos, historias de usuario con Given/When/Then, planificacion de sprint con factor IA y publicacion en Trello.

Topics

Resources

Stars

Watchers

Forks

Contributors