DOCUMENTATION

Documentacion completa

Todo lo que necesitas saber para gestionar proyectos con Planning Task.

Comenzar Instalacion
01—Que es Planning Task?

Planning Task es una plataforma de gestion de proyectos agil disenada especificamente para equipos de desarrollo de software. Combina las mejores practicas de Scrum con herramientas modernas de automatizacion e inteligencia artificial.

Para quien es?

Product Owner

Define User Stories con formato estandar, prioriza por valor de negocio y trackea progreso en el dashboard.

Scrum Master

Gestiona sprints, facilita retrospectivas, monitoriza velocity y detecta bloqueos automaticamente.

Developer

Trabaja con Kanban board, registra tiempo, linkea PRs de GitHub y completa checklists de review.

QA

Reporta bugs con severidad, valida tareas con criterios de aceptacion y usa el flujo to-validate.

Stakeholder

Visualiza dashboards de metricas, leaderboard del equipo y progreso de los sprints en tiempo real.

Proyectos con equipos y roles
User Stories con puntos Fibonacci
Sprints con burndown charts
Kanban board con drag & drop
Epics para agrupar funcionalidad
Bugs con severidad y tracking
Dashboard con metricas en tiempo real
Chatbot IA flotante integrado
PT
Planning Taskv1.68.1
TasksBugsProposals
To-Do3

Implementar OAuth Google

AuthCarlos M.

API notificaciones push

BackendAna L.

Disenar onboarding

Maria G.
+ Add
In Progress2

Refactorizar TaskService

CoreSergio R.PR

Time tracking widget

Carlos M.02:34:12
+ Add
To Validate1

Fix filtros dashboard

DashboardAna L.PR
+ Add
Done2

Dark mode header

Maria G.PR

CI/CD pipeline

Sergio R.PR
+ Add
02—Caracteristicas Principales

Mas de 20 features integradas para una gestion completa.

Proyectos

Multi-proyecto con equipos, colores tematicos, estadisticas y gestion de miembros.

Sprints

Ciclos de trabajo con estados planned/active/completed, burndown y retrospectiva.

Tareas

User Stories completas con puntos, prioridad calculada, criterios de aceptacion y plan de implementacion.

Epics

Agrupacion de funcionalidad con colores, linking bidireccional y tracking de progreso.

Bugs

Reporte de bugs con 4 niveles de severidad, estados y asignacion a developers.

Time Tracking

Cronometro integrado por tarea con historial de sesiones y tiempo total acumulado.

Kanban Board

Board con 4 columnas, drag & drop para cambiar estado, boton de agregar por columna.

Comentarios

Sistema de comentarios en cada tarea con @mentions y notificaciones.

Notificaciones

Sistema push en tiempo real con tipos info/success/warning/error y mark as read.

Team & Roles

4 roles con permisos granulares: Owner, Admin, Member, Viewer.

Proposals

Sistema de propuestas para mejoras con votacion y estados de aprobacion.

Achievements

14 badges en 4 categorias con auto-evaluacion, leaderboard y gamificacion.

Daily Standup

Vista automatica del standup diario con trabajo de ayer, hoy y bloqueos.

Retrospectiva

Notas de retrospectiva por sprint: que fue bien, que mejorar, action items.

Workflow Rules

Automatizacion con triggers, condiciones y acciones personalizables.

Task Templates

Blueprints reutilizables para crear tareas con campos pre-rellenados.

Saved Views

Guarda combinaciones de filtros para acceso rapido a vistas frecuentes.

AI Planning

Boton "Rellenar con IA" que genera automaticamente titulo, User Story, criterios y plan.

Modo Offline

Service Worker para trabajar sin conexion con sincronizacion posterior.

Dashboard

Metricas completas: KPIs, velocity, burndown, heatmap, performance y leaderboard.

03—User Stories y Tareas

El corazon de Planning Task. Cada tarea es una User Story completa con toda la informacion que tu equipo necesita.

Generacion con IA

El boton "Rellenar con IA" en la seccion General genera automaticamente:

  • User Story completa (Como/Quiero/Para)
  • Criterios de aceptacion relevantes
  • Plan de implementacion con pasos
  • Enfoque tecnico sugerido
  • Puntos de negocio y desarrollo estimados
Solo necesitas escribir el titulo de la tarea y pulsar el boton. La IA analiza el contexto del proyecto para generar contenido relevante.

Task Modal - 7 secciones completas

General
Subtareas
Deps
Tiempo
GitHub
Review
Actividad

Seccion General

La seccion principal tiene 4 sub-secciones:

General
Titulo

Nombre descriptivo de la tarea. Ej: "Implementar autenticacion"

Rellenar con IA

Boton magico que genera automaticamente User Story, criterios, plan de implementacion y mas a partir del titulo.

Sprint

Asignar a un sprint del proyecto (planned/active/completed)

Developer

Desarrollador principal asignado a la tarea

Co-Developer

Desarrollador secundario para pair programming

Status

to-do → in-progress → to-validate → done

Fecha inicio / fin

Rango de fechas para planificacion y calendario

Puntos Negocio

Fibonacci (1,2,3,5,8,13,21,34) - valor para el negocio

Puntos Dev

Fibonacci (1,2,3,5,8,13) - esfuerzo tecnico estimado

User Story
Como... (Quien)

El actor. Ej: "Como usuario registrado"

Quiero... (Que)

La funcionalidad. Ej: "quiero poder cambiar mi contrasena"

Para... (Para que)

El beneficio. Ej: "para mantener mi cuenta segura"

Criterios de Aceptacion

Lista dinamica de criterios que deben cumplirse para considerar la tarea terminada.

Implementacion
Estado del Plan

Pendiente / En Progreso / Completado

Enfoque tecnico

Descripcion del approach para resolver la tarea

Pasos de implementacion

Lista ordenada de pasos a seguir

Cambios en modelo de datos

Alteraciones necesarias en la base de datos

Cambios en API

Endpoints nuevos o modificados

Riesgos

Riesgos tecnicos identificados

Fuera de alcance

Que NO se incluye en esta tarea

Adjuntos
Subir archivos

Arrastra o selecciona archivos de cualquier tipo

Archivos existentes

Descarga o elimina archivos adjuntos previos

Crear Nueva Tarea

Template
General
Subtareas3
Deps
Tiempo
GitHub1
Review
Actividad
Implementar sistema de notificaciones push
GeneralUser StoryImplementacionAdjuntos
Sprint 14 - Active
Sergio R.
in-progress
Carlos M.
2026-03-18
2026-03-25
8 (Complejo)
5 (Moderado)
GeneralUser StoryImplementacionAdjuntos
Como usuario registrado del sistema
quiero recibir notificaciones push en tiempo real
para estar informado de cambios en mis tareas sin tener que recargar la pagina
1.El usuario recibe notificacion cuando le asignan una tarea
2.Las notificaciones aparecen en el bell icon del header
3.Se puede marcar como leida con un click
4.Funciona en Chrome, Firefox y Safari
GeneralUser StoryImplementacionAdjuntos
Opcional — completa estos campos para tareas complejas que necesitan un plan tecnico.
Usar Firebase Cloud Messaging (FCM) con Service Worker para recibir notificaciones push en el navegador.
En Progreso
Compatibilidad Safari WebPush
1Configurar Firebase Cloud Messaging en el proyecto
2Implementar Service Worker para recibir push
3Crear UI de notificaciones en el Header (bell icon)
4Agregar endpoints API para enviar notificaciones
5Tests e2e con Cypress

Seccion Subtareas

Divide tareas complejas en subtareas mas pequenas. Cada subtarea tiene su propio status y developer asignado. Barra de progreso automatica.

Subtareas
2/4
Setup FCM en proyecto FirebaseSergio R.
Implementar Service WorkerSergio R.
Crear componente NotificationBellCarlos M.
Tests de notificacionesAna L.

Herramienta de Dependencias

Define relaciones entre tareas: "bloqueada por" y "bloquea a". Las tareas bloqueadas muestran un icono de alerta en el Kanban.

Dependencies
Blocked

Blocked by:

Configurar Firebase Cloud Messaging

Blocks:

Tests e2e notificaciones Deploy a staging

Herramienta de Tiempo

Cronometro integrado play/stop. Registra sesiones de tiempo con inicio, fin y duracion. Muestra tiempo total acumulado.

Time Tracker
02:34:12Total: 6h 15m

Sesiones anteriores (3)

09:00 - 11:302h 30mSergio R.
14:00 - 15:451h 45mSergio R.
10:00 - 12:062h 06mCarlos M.

Herramienta GitHub

Linkea Pull Requests de GitHub. Soporta formato completo (URL) o corto (owner/repo#123). Muestra estado: Open, Merged, Closed.

Pull Requests
2 linked
planning-task#247

feat: add push notifications

feat/push-notifications
open
planning-task#243

fix: notification bell badge count

fix/bell-badge
merged

Herramienta de Review

Checklist de code review con templates predefinidos (Frontend, Backend, Fullstack). Solo visible cuando la tarea esta en to-validate o posterior.

Code Review Checklist
4/6
Codigo compilado sin erroresSergio R.
Tests unitarios pasanSergio R.
Sin console.log en produccionAna L.
Responsive en mobileAna L.
Documentacion actualizada
Performance verificada

Seccion Actividad

Timeline de actividad: comentarios del equipo y historial de cambios. Filtros: Todo, Comentarios, Cambios.

Actividad
TodoComentariosCambios

Carlos M. · hace 2h

@Sergio he terminado el componente NotificationBell. Puedes revisar el PR #247?

Sistema · hace 3h

Status cambiado: to-do → in-progress

Sergio R. · hace 5h

He empezado con la configuracion de FCM. El Service Worker ya esta registrado.

Flujo de Estados

to-doin-progressto-validatedone

Sistema de Prioridad

La prioridad se calcula automaticamente: bizPoints / devPoints. A mayor ratio, mayor prioridad. Ejemplo: 13 bizPoints / 3 devPoints = P4.3

04—Sprints y Kanban

Ciclos de trabajo con board visual y metricas.

Ciclo de vida del Sprint

Planned

Sprint creado con fechas, listo para asignar tareas.

Active

Sprint en curso. Las tareas se trabajan en el Kanban board.

Completed

Sprint finalizado. Se genera retrospectiva y metricas.

Kanban Board

Board visual con 4 columnas. Arrastra las tareas para cambiar su estado. Cada columna muestra el conteo de tareas.

PT
Planning Taskv1.68.1
To-Do3

Implementar OAuth Google

AuthCarlos M.

API notificaciones push

BackendAna L.

Disenar onboarding

Maria G.
+ Add
In Progress2

Refactorizar TaskService

CoreSergio R.PR

Time tracking widget

Carlos M.02:34:12
+ Add
To Validate1

Fix filtros dashboard

DashboardAna L.PR
+ Add
Done2

Dark mode header

Maria G.PR

CI/CD pipeline

Sergio R.PR
+ Add

Sprint Cards

Sprint 14Active

Mar 11 - Mar 25

12

Tasks

62

Pts Neg

38

Pts Dev

Sprint 13Completed

Feb 24 - Mar 10

15

Tasks

78

Pts Neg

45

Pts Dev

Sprint 15Planned

Mar 25 - Abr 8

0

Tasks

0

Pts Neg

0

Pts Dev

Burndown Chart

Grafico que muestra el progreso del sprint vs la linea ideal. Actualizado en tiempo real conforme se completan tareas.

Retrospectiva

Al final de cada sprint, el equipo registra: que fue bien, que mejorar, y action items para el siguiente sprint.

05—Epics

Agrupa funcionalidad relacionada bajo un Epic con color identificativo.

AuthCoreDashboardUI/UXBackendMobileDevOpsSecurity
  • Colores personalizados (8 opciones: morado, azul, esmeralda, ambar, rojo, rosa, cian, indigo)
  • Linking bidireccional: Epic ↔ Tareas
  • Barra de progreso automatica basada en tareas completadas
  • Filtro por Epic en la tabla y Kanban
  • Badge de color en las Task Cards del Kanban
06—Bugs y QA

Sistema de tracking de bugs integrado en cada proyecto.

Niveles de Severidad

Critical

Bloquea funcionalidad principal. Requiere fix inmediato.

High

Funcionalidad importante afectada. Prioridad alta.

Medium

Problema menor que afecta la experiencia.

Low

Mejora estetica o problema trivial.

OpenIn ProgressResolvedClosed

Login falla con email largo

CriticalOpen

Dashboard no carga en Safari

HighIn Progress

Typo en modal de confirmacion

LowResolved
07—Team y Roles

Sistema de roles con permisos granulares.

Owner

Control total. Puede eliminar el proyecto, gestionar miembros y cambiar roles.

Todo
Admin

Gestiona tareas, sprints, bugs y miembros. No puede eliminar el proyecto.

Crear/editar tareasGestionar sprintsInvitar miembros
Member

Trabaja en tareas asignadas, comenta y registra tiempo.

Editar sus tareasComentarTime tracking
Viewer

Solo lectura. Puede ver el proyecto pero no modificar nada.

Ver proyectoVer tareasVer dashboard
Los miembros se invitan por email. Reciben una notificacion con boton para aceptar o rechazar la invitacion.
08—Notificaciones y Comentarios

Sistema de comunicacion integrado en tiempo real.

Info

Informacion general: asignaciones, cambios de estado.

Success

Acciones completadas: tarea finalizada, sprint cerrado.

Warning

Alertas: tarea bloqueada, sprint por vencer.

Error

Problemas: bug critico reportado, conflicto de dependencias.

@mentions en comentarios generan notificaciones directas al usuario mencionado.
09—Dashboard y Metricas

Panel de control con metricas en tiempo real.

KPIs

Proyectos activos, sprints activos, tareas completadas, tareas pendientes.

Sprint Chart

Grafico de lineas con puntos de negocio y desarrollo por sprint.

Tasks Completion

Grafico de completado de tareas en el tiempo.

Task Distribution

Distribucion de tareas por estado (pie chart).

Team Velocity

Velocidad del equipo sprint a sprint.

Developer Workload

Carga de trabajo por developer (tareas asignadas).

Sprint Burndown

Progreso del sprint actual vs linea ideal.

Overdue Tasks

Tareas vencidas que necesitan atencion.

Bugs Severity

Distribucion de bugs por severidad.

Activity Heatmap

Mapa de calor de actividad del equipo.

Sprint Timeline

Timeline visual de los sprints del proyecto.

Performance Metrics

Metricas detalladas de rendimiento por developer.

Achievements

Badges desbloqueados y progreso de gamificacion.

Leaderboard

Ranking del equipo por puntos (tareas + bugs + achievements).

PT
Planning Taskv1.68.1

Welcome, Sergio! 👋

4

Proyectos

3

Sprints

47

Completadas

12

Pendientes

Sprint Burndown

Activity Heatmap

10—Achievements y Gamificacion

Sistema de logros para motivar al equipo.

ProductividadCalidadColaboracionConsistencia

14 badges desbloqueables con auto-evaluacion automatica.

Ranking por puntos: devPoints completados + bugs resueltos (x3) + achievements (x5). Periodos: Mes, Trimestre, Total.

🚀

First Task

⚡

Speed Demon

🐛

Bug Hunter

🏆

Sprint Master

💪

10 Tasks

🎯

Perfectionist

🤝

Team Player

🔥

On Fire

11—Sprint Retrospective

Al finalizar cada sprint, el equipo analiza metricas, rendimiento y registra aprendizajes para mejorar en el siguiente ciclo.

42pts

Velocity

83%

Completion

10/12

Completadas

58pts

Biz Points

+12%

vs Anterior

Performance por Developer

Sergio R.
4/5 tareas21pts
Carlos M.
3/4 tareas15pts
Ana L.
3/3 tareas12pts

👍 Que fue bien

Buen ritmo de entregas. PRs revisados en menos de 2h. Cero bugs criticos. La planificacion con IA ahorro mucho tiempo.

💡 Que mejorar

Documentar mejor los endpoints nuevos. Mejorar cobertura de tests e2e. Definir criterios de aceptacion mas detallados.

Carry-over — Tareas no completadas

Estas tareas pasan al siguiente sprint automaticamente.

Migrar autenticacion a OAuth2 (8 bizPts / 5 devPts)
Optimizar queries del dashboard (5 bizPts / 3 devPts)
12—Daily Standup

Vista automatica del standup diario con timer de 15 minutos, navegacion por developer y clasificacion de tareas.

Daily Standup — Sprint 14

14:32
2 / 4developers

El timer empieza en 15:00 y cuenta hacia atras. Usa los botones para navegar entre developers. El developer activo se resalta.

S
Sergio R.Activo

Ayer2

OAuth Google flow
Fix session bugs

Hoy1

Refactor TaskService
C
Carlos M.

Ayer1

Time tracking widget

Hoy2

Review PR #247
API notificaciones

Bloqueado1

Migrar auth — bloqueado por OAuth
A
Ana L.

Ayer1

Fix filtros dashboard

Hoy1

Tests e2e dashboard
M
Maria G.

Ayer1

Dark mode header

Hoy1

Disenar onboarding
13—Workflow Automation

Crea reglas automaticas con triggers, condiciones y acciones.

Trigger

Evento que dispara la regla: cambio de estado, nueva tarea, nuevo comentario, etc.

Condition

Condicion que debe cumplirse: status es X, developer es Y, sprint es Z.

Action

Accion automatica: enviar notificacion, cambiar estado, asignar developer.

Ejemplo: Auto-notify on done
Trigger:Cuando una tarea cambia a "done"
Condition:Si tiene developer asignado
Action:Enviar notificacion de exito al equipo
14—Task Templates y Saved Views

Reutiliza configuraciones frecuentes.

Task Templates

Crea blueprints reutilizables. Al crear una tarea, puedes guardarla como template para usar en futuras tareas similares. Incluye todos los campos: titulo, User Story, criterios, puntos, etc.

Saved Views

Guarda combinaciones de filtros (developer, status, sprint, epic) para acceso rapido. Puedes marcar vistas como compartidas para que todo el equipo las use.

15—Instalacion

Pon Planning Task en marcha en minutos. La web app y el MCP Server se instalan por separado.

1Web App (Frontend)
Requisitos previos
Node.js 18+npmFirebaseGit
web-app

# 1. Clone repository

$ git clone https://github.com/sergioramosv/planning-task.git

# 2. Install dependencies

$ cd planning-task && npm install

# 3. Configure environment

$ cp .env.example .env

# 4. Start development server

$ npm run dev

✓ Ready on http://localhost:3000

Variables de entorno (Firebase)
NEXT_PUBLIC_FIREBASE_API_KEY="..."
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN="..."
NEXT_PUBLIC_FIREBASE_DATABASE_URL="..."
NEXT_PUBLIC_FIREBASE_PROJECT_ID="..."
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET="..."
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID="..."
NEXT_PUBLIC_FIREBASE_APP_ID="..."
2MCP Server (87 herramientas)
Disponible en npm

Instala el servidor MCP globalmente con un solo comando. Funciona con Claude Code, Codex, Gemini y mas.

npmjs.com/package/planning-task-mcp
mcp-server

# 1. Instalar globalmente

$ npm install -g planning-task-mcp

# 2. Configurar (interactivo)

$ planning-task-mcp-setup

✓ MCP registrado en todos tus clientes — 87 tools disponibles

Clientes compatibles
Claude CodeClaude DesktopCodex (OpenAI)Gemini CLICursorWindsurfVS Code Copilot

El setup detecta y configura automaticamente todos los clientes MCP instalados en tu sistema.

16—FAQ

Preguntas frecuentes.

Es gratis Planning Task?
Si, es open source con licencia MIT. Puedes usarlo, modificarlo y distribuirlo libremente.
Puedo usarlo sin Firebase?
Actualmente Firebase es requerido para la base de datos en tiempo real y autenticacion. Es el unico backend soportado.
Cuantos proyectos puedo crear?
No hay limite. Puedes crear tantos proyectos como necesites con equipos independientes.
Funciona offline?
Si, tiene Service Worker para modo offline. Los cambios se sincronizan cuando vuelve la conexion.
Como funciona el MCP Server?
El MCP Server expone 87 herramientas que la IA puede usar para gestionar tu proyecto. Se conecta via el protocolo MCP estandar.
Puedo integrar con GitHub?
Si, puedes linkear Pull Requests a tareas y ver su estado (open/merged/closed) directamente en la tarea.
Como funciona el chatbot de IA?
El boton flotante abre un panel de chat donde puedes pedirle a la IA que cree tareas, consulte metricas o genere reportes usando lenguaje natural.
Soporta modo oscuro?
Si, incluye tema claro y oscuro con toggle en el header. Todas las variables CSS se adaptan automaticamente.

Empieza con Planning Task

Gestion agil con inteligencia artificial para automatizar tu flujo de desarrollo completo.

Ver en GitHub

Inspirado en pgamexp.com de manufosela