Cómo Funciona GitScrum

GitScrum organiza el trabajo en una jerarquía de tres niveles: los Workspaces contienen Proyectos, los Proyectos contienen Tareas. Esta estructura mapea directamente cómo operan las agencias — el workspace es tu agencia, los proyectos son engagements con clientes, y las tareas son el trabajo real.

Entender esta jerarquía es clave para usar GitScrum efectivamente. Todo fluye desde la configuración del workspace hacia las tareas individuales. Los miembros del equipo pueden pertenecer a un workspace y ser asignados a proyectos específicos con diferentes niveles de permisos.

La Jerarquía del Workspace

Workspace

El workspace es el contenedor de nivel superior. Piensa en él como tu agencia o empresa dentro de GitScrum. Contiene todos tus proyectos, miembros del equipo, información de facturación y configuraciones globales.

Cuando creas una cuenta, GitScrum automáticamente crea tu primer workspace. La mayoría de agencias solo necesitan uno. Crea workspaces adicionales solo si necesitas aislamiento completo de datos entre unidades de negocio o si gestionas múltiples agencias separadas.

Las configuraciones del workspace afectan a todos los proyectos dentro: horario de trabajo, zona horaria, plan de facturación, integraciones con GitHub o GitLab. Los cambios aquí se propagan hacia abajo.

Proyecto

Un proyecto es donde sucede el trabajo real. Cada proyecto tiene su propio tablero Kanban, sprints, user stories, wiki, discusiones, almacenamiento de archivos y seguimiento de tiempo. Los miembros del equipo se asignan a proyectos con roles específicos.

Para agencias, un proyecto por engagement de cliente tiene sentido. Un cliente puede tener múltiples proyectos en el tiempo — un lanzamiento de sitio web, luego una app móvil, luego mantenimiento continuo. Cada uno es un proyecto separado con su propio tablero y línea de tiempo.

Los proyectos pueden ser públicos (visibles para cualquiera con el enlace) o privados (solo miembros del equipo). Los proyectos públicos son útiles para trabajo open-source o dashboards de cliente donde los stakeholders solo necesitan ver el progreso.

Tarea

Las tareas son las unidades atómicas de trabajo. Viven en el tablero Kanban y se mueven entre columnas según avanza el trabajo. Cada tarea tiene un código único (como PRJ-123), título, descripción, asignado, fecha límite, etiquetas, estimaciones de tiempo y tiempo registrado.

Las tareas pueden tener checklists, archivos adjuntos, comentarios e historial de actividad. Pueden vincularse a user stories para flujos Scrum o existir independientemente para configuraciones solo-Kanban más simples. El seguimiento de tiempo se integra directamente — inicia un timer, trabaja, detén cuando termines.

El Tablero Kanban

Cada proyecto tiene un tablero Kanban como su vista central. Las tareas se muestran como tarjetas en columnas. Arrastra tarjetas entre columnas para actualizar su estado. Aquí es donde los desarrolladores pasan la mayor parte de su tiempo.

Las columnas por defecto son Backlog, Por Hacer, En Progreso y Hecho. Puedes personalizarlas — agrega Review, QA, Bloqueado, lo que se ajuste a tu flujo de trabajo. Cada columna puede tener límites de trabajo en progreso para prevenir sobrecarga.

El tablero soporta filtrado por asignado, etiqueta, sprint y fecha límite. La búsqueda avanzada encuentra tareas por número o contenido. Los atajos de teclado hacen la navegación rápida. La sincronización en tiempo real significa que todos ven los cambios instantáneamente.

Sprints y User Stories

Para equipos siguiendo Scrum, GitScrum soporta sprints y user stories. Las user stories describen funcionalidades desde la perspectiva del usuario — "Como usuario, quiero..." — y agrupan tareas relacionadas.

Los sprints son iteraciones con tiempo limitado, típicamente dos semanas. Planificas qué lograr, trabajas durante el sprint, luego revisas resultados. GitScrum rastrea velocidad (cuántos story points completas por sprint) y genera gráficos burndown mostrando progreso.

Los story points se estiman durante el refinamiento de backlog. GitScrum incluye planning poker para estimación colaborativa. Arrastra user stories para priorizarlas. Cuando un sprint comienza, las stories comprometidas se bloquean — puedes ver qué se planeó versus qué se entregó realmente.

¿No haces Scrum? No hay problema. Sprints y user stories son opcionales. Muchos equipos usan GitScrum como una herramienta Kanban pura con solo tareas y columnas.

Seguimiento de Tiempo

El seguimiento de tiempo está integrado en cada tarea. Haz clic en el botón de play para iniciar un timer. Trabaja. Haz clic en stop cuando termines. El tiempo se registra automáticamente con la fecha actual y notas opcionales.

También puedes agregar entradas de tiempo manualmente — útil para registrar trabajo hecho offline o ajustar entradas. El tiempo registrado alimenta los reportes del proyecto, mostrando horas gastadas por tarea, por miembro del equipo, por rango de fechas.

Los horarios de trabajo definidos a nivel workspace (días laborables y horas por día) afectan los cálculos de capacidad. Si alguien tiene asignadas 40 horas de trabajo en una semana y trabajan días de 8 horas, GitScrum los muestra a capacidad completa. La sobre-asignación dispara advertencias.

Los datos de tiempo se exportan a reportes. Las agencias usan esto para facturación a clientes, planificación de capacidad y entender dónde realmente va el tiempo.

Roles y Permisos

GitScrum tiene cuatro roles con diferentes niveles de permisos:

• Agency Owner — Acceso completo a todo. Gestiona facturación, configuraciones del workspace, todos los miembros del equipo, todos los proyectos. Puede eliminar el workspace. Usualmente el fundador o titular de la cuenta.
• Manager — Puede gestionar proyectos, crear y asignar tareas, ver todos los reportes. No puede acceder a facturación ni remover Agency Owners. Típicamente project managers o líderes de equipo.
• Developer — Puede trabajar en proyectos asignados, completar tareas, registrar tiempo, comentar en items de trabajo. No puede cambiar configuraciones del proyecto ni acceder a otros proyectos. El rol estándar para desarrolladores y contratistas.
• Client — Acceso limitado de solo lectura. Ve el progreso del proyecto y puede comentar en tareas a las que está invitado. No puede ver discusiones internas, detalles de seguimiento de tiempo u otros proyectos. Perfecto para stakeholders que necesitan visibilidad sin acceso completo.

Los permisos se aplican tanto a nivel workspace como proyecto. Un Developer en el workspace puede ser asignado a proyectos específicos — solo ven e interactúan con esos proyectos.

Los roles pueden sobrescribirse por proyecto. Un miembro del equipo puede ser Developer en un proyecto pero Manager en otro, dependiendo de sus responsabilidades.

Integraciones

GitHub y GitLab

Conecta tus repositorios para vincular automáticamente commits, branches y pull requests a tareas. Referencia un código de tarea en tu mensaje de commit (como "Fix login issue #PRJ-123") y GitScrum muestra ese commit en la tarea.

Cuando un pull request se fusiona, GitScrum puede mover automáticamente la tarea a Hecho. La información de branch aparece en las tarjetas de tarea para que el equipo sepa quién está trabajando en qué.

Extensión VS Code

La extensión de VS Code trae GitScrum a tu editor. Ve tus tareas asignadas, inicia y detén seguimiento de tiempo, actualiza estado de tareas, agrega comentarios — todo sin cambiar al navegador.

Crea tareas desde comentarios TODO en tu código. La extensión lee tus archivos y te permite convertir notas inline en tareas rastreadas con un clic.

Extensión Chrome

Captura pantallas y crea tareas desde cualquier página web. ¿Encontraste un bug en staging? Captura la pantalla, agrega una descripción, asígnalo a ti mismo — listo. La captura se adjunta a la tarea automáticamente.

Creación rápida de tareas sin dejar tu contexto actual. Útil para equipos de soporte, QA, o cualquiera que encuentre problemas mientras navega.

Servidor MCP para Asistentes IA

GitScrum proporciona un servidor MCP (Model Context Protocol) que conecta con asistentes IA como Claude, GitHub Copilot y otros. La IA puede leer tus tareas, actualizar estado, registrar tiempo y gestionar proyectos usando lenguaje natural.

Pregunta "¿Cuáles son mis tareas abiertas?" o "Registra 2 horas en PRJ-123" y el asistente lo ejecuta directamente. Funciona desde VS Code, terminal, o cualquier cliente compatible con MCP.

Un Flujo de Trabajo Típico

Así es como luce una semana típica para una agencia de desarrollo usando GitScrum:

1. Lunes por la mañana — El equipo abre el tablero Kanban. Cada desarrollador toma tareas de Por Hacer y las mueve a En Progreso. El seguimiento de tiempo comienza.
2. Durante el día — Los desarrolladores trabajan en tareas, registrando tiempo conforme avanzan. Los comentarios en tareas capturan decisiones y bloqueos. Los PRs referencian códigos de tarea.
3. Standup diario — El tablero sirve como agenda del standup. ¿Qué está en progreso? ¿Qué está bloqueado? ¿Qué se movió a Hecho ayer?
4. Pull request fusionado — La integración con GitHub mueve la tarea a Hecho automáticamente. El tiempo gastado queda registrado.
5. Fin del sprint — Los reportes de velocidad muestran cuántos story points se completaron. El gráfico burndown muestra si el equipo alcanzó el objetivo. La retrospectiva usa los datos para mejorar.
6. Check-in con cliente — Comparte un enlace de solo lectura al proyecto. El cliente ve el progreso sin necesidad de iniciar sesión. O agrégalos como rol Client para comentarios.

Este flujo de trabajo escala desde desarrolladores individuales hasta equipos de 50 personas. La jerarquía y los permisos mantienen todo organizado conforme creces.

Siguientes Pasos

Ahora que entiendes la arquitectura:

• Inicio Rápido — crea tu primer proyecto en 5 minutos
• Aplicación Web — documentación detallada de cada funcionalidad
• Extensión VS Code — gestiona tareas desde tu editor