Scrum Manager

Asistente personal de scrum para Azure DevOps, integrado en el chat de GitHub Copilot en VS Code.

Gestiona work items, planifica tu sprint y lleva seguimiento de tu trabajo sin salir del editor — todo a través de lenguaje natural.

Requisitos

• VS Code 1.100.0 o superior
• GitHub Copilot activo (licencia individual o empresarial)
• Azure DevOps con un Personal Access Token (PAT)

Crear el PAT

1. Ve a Azure DevOps > User Settings > Personal Access Tokens
2. Crea un token con los permisos:
   • Work Items: Read & Write
   • Project and Team: Read
3. Copia el token — lo necesitarás en la configuración inicial

Instalacion

Desde .vsix (recomendado)

code --install-extension scrum-manager-0.0.1.vsix

O en VS Code: Ctrl+Shift+P > "Extensions: Install from VSIX..." > selecciona el archivo.

Desde el codigo fuente

git clone <repo-url>
cd scrum-manager
pnpm install
pnpm package
code --install-extension scrum-manager-0.0.1.vsix

Desarrollo

git clone <repo-url>
cd scrum-manager
pnpm install

Abre el proyecto en VS Code y presiona F5 — se abre una ventana nueva (Extension Development Host) con la extension cargada. Los cambios se recompilan automaticamente en modo watch.

Configuracion inicial

1. Abre el panel de chat de Copilot (Ctrl+Shift+I)
2. Escribe @scrum
3. El asistente te guia en 2 pasos:
   • Paso 1: Pega tu PAT de Azure DevOps
   • Paso 2: Pega la URL de tu proyecto o sprint board

El PAT se almacena en el llavero del sistema operativo (no en archivos). La URL se analiza automaticamente para extraer organizacion, proyecto y equipo.

Para actualizar el PAT despues: Ctrl+Shift+P > "Scrum Manager: Configure".

Uso

Lenguaje natural (agente)

Escribe lo que necesitas directamente — el agente entiende tu intencion y usa las herramientas disponibles:

@scrum que tengo pendiente?
@scrum como vamos en el sprint?
@scrum mueve el [#1234](https://github.com/cristian/scrum-manager/issues/1234) a Active
@scrum agrega una nota al item de migracion: termine la revision de codigo
@scrum por donde deberia empezar hoy?

Para mutaciones (mover items, agregar comentarios), el agente pide confirmacion antes de ejecutar.

Comandos directos

Tambien puedes usar slash commands como atajos:

Ejemplos:

@scrum /today
@scrum /today anterior
@scrum /today Sprint 5
@scrum /create Bug: el endpoint de notificaciones retorna 500 cuando el payload no tiene campo "channel"
@scrum /move [#723720](https://github.com/cristian/scrum-manager/issues/723720) Active
@scrum /note [#723720](https://github.com/cristian/scrum-manager/issues/723720) Termine la revision del PR
@scrum /plan que deberia priorizar esta semana?

Como funciona /create

El comando /create clasifica automaticamente el work item usando IA:

1. Describes el trabajo en lenguaje natural
2. El agente clasifica tipo (Bug, Task, User Story, Enabler), asigna tags, story points y epic
3. Muestra un borrador con indicadores de confianza
4. Puedes editar cualquier campo conversacionalmente: "cambia el tipo a Task", "quita el tag backend"
5. Confirmas y se crea en Azure DevOps

Herramientas del agente

El agente tiene acceso a estas herramientas que invoca automaticamente segun lo que pidas:

Puedes referenciar las herramientas directamente con # en el chat de Copilot (ej: #scrum_getSprintItems).

Arquitectura

La extension usa dos patrones segun el tipo de operacion:

• Operaciones de lectura/asesoria (sprint, plan, preguntas): el LLM razona libremente sobre los datos reales del sprint, consultados via herramientas
• Operaciones de escritura (crear, mover, comentar): flujos determinísticos con validacion, campos exactos y confirmacion antes de mutar Azure DevOps

Stack

• TypeScript + esbuild
• VS Code Chat Participant API + Language Model Tools API
• azure-devops-node-api (SDK oficial de Microsoft)
• js-yaml para el archivo de reglas de clasificacion

Licencia

GPL-3.0-or-later — ver LICENSE.

Copyright (C) 2026 Cristian Camilo Giraldo Mazo giraldo.0302@gmail.com