Gestión de Proyectos

Las funcionalidades de gestión de proyectos de Habito proporcionan una alternativa completa a herramientas como Linear, Jira y GitHub Issues. Organizá el trabajo con proyectos, seguí issues con metadatos ricos y colaborá con tu equipo - todo mientras ganás XP por trabajo completado.

Resumen de Proyectos

Los proyectos son contenedores para issues, representando un cuerpo de trabajo con un objetivo claro y cronograma.

Cuándo Usar Proyectos

• Desarrollo de software (funcionalidades, bugs, sprints)
• Creación de contenido (posts de blog, videos, cursos)
• Objetivos personales (aprender español, renovación de casa)
• Iniciativas de equipo (rediseño de sitio web, lanzamiento de producto)

Crear un Proyecto

Configuración Básica

1. Navegá a Proyectos en la barra lateral
2. Hacé clic en Nuevo Proyecto
3. Completá los campos requeridos:
   • Nombre: Título claro del proyecto (ej: "Rediseño de Sitio Web 2024")
   • Slug: Identificador amigable para URL (auto-generado del nombre)
4. Agregá detalles opcionales:
   • Descripción: Objetivos y alcance del proyecto
   • Ícono: Identificador visual (🚀, 💻, 📱, etc.)
   • Color: Color de marca para organización visual
   • Lead: Gerente/dueño del proyecto
   • Fecha de Inicio: Cuándo comienza el trabajo
   • Fecha Objetivo: Cuándo apuntás a completar
5. Hacé clic en Crear

Metadatos del Proyecto

Opciones de Estado:

• Backlog: Planificado pero no iniciado
• Planificado: Definido y listo para comenzar
• En Progreso: Trabajo activo sucediendo
• Completado: Todo el trabajo terminado
• Cancelado: Proyecto abandonado

Ejemplos de Proyectos:

🚀 Rediseño de Sitio Web (En Progreso)
   Lead: Alicia
   Inicio: 1 Ene 2024
   Objetivo: 31 Mar 2024
   25 issues (8 hechos, 12 en progreso, 5 backlog)

💻 App Móvil v2.0 (Planificado)
   Lead: Roberto
   Inicio: 1 Abr 2024
   Objetivo: 31 Jul 2024
   12 issues (0 hechos, 0 en progreso, 12 backlog)

📱 Campaña de Marketing Q1 (Completado)
   Lead: Carolina
   Completado: 15 Mar 2024
   18 issues (18 hechos)

Issues

Los issues son items de trabajo individuales dentro de un proyecto. Son similares a GitHub Issues o Linear Issues.

Crear un Issue

1. Abrí un proyecto
2. Hacé clic en Nuevo Issue
3. Completá los detalles:

Requerido:

• Título: Descripción clara y accionable
  • ✅ Bueno: "Agregar modo oscuro a página de configuración"
  • ❌ Malo: "Mejoras de configuración"

Opcional:

• Descripción: Información detallada (soporta Markdown)
• Asignado: Quién es responsable de completarlo
• Estado: Backlog, Todo, En Progreso, En Revisión, Hecho, Cancelado
• Prioridad: Ninguna, Baja, Media, Alta, Urgente
• Etiquetas: Categorizar (bug, feature, enhancement, etc.)
• Estimación: Story points (1, 2, 3, 5, 8, 13, etc.)
• Fecha de Vencimiento: Deadline para completitud
• Issue Padre: Hacer este un sub-issue de otro issue

4. Hacé clic en Crear

Identificadores de Issues

Cada issue obtiene un identificador único:

• Formato: [PROJECT-SLUG]-[NÚMERO]
• Ejemplo: REDISEÑO-42, APP-123, CAMPAÑA-7

Usá identificadores para referenciar issues en:

• Comentarios ("Esto bloquea REDISEÑO-41")
• Mensajes de commit ("Arreglar bug mencionado en APP-98")
• Discusiones de equipo ("Prioricemos APP-45 este sprint")

Estados de Issues

Seguí progreso mediante estados de flujo de trabajo predefinidos:

Niveles de Prioridad

Establecé urgencia e importancia:

• Ninguna: Por defecto, no urgente
• Baja: Nice to have, bajo impacto
• Media: Debería hacerse, impacto moderado
• Alta: Importante, impacto significativo
• Urgente: Crítico, bloqueando otro trabajo

Etiquetas

Organizá issues por tipo, categoría o taxonomía personalizada:

Esquemas Comunes de Etiquetas:

Basadas en Tipo:

• 🐛 bug
• ✨ feature
• 🔧 enhancement
• 📝 documentación
• 🧪 testing

Basadas en Área:

• frontend
• backend
• base-de-datos
• diseño
• infraestructura

Personalizadas:

• buen-primer-issue
• necesita-diseño
• cambio-que-rompe
• deuda-técnica

Creá etiquetas en configuración del proyecto:

1. Abrí proyecto
2. Hacé clic en pestaña Etiquetas
3. Hacé clic en Nueva Etiqueta
4. Elegí nombre y color

Sub-Issues

Desglosá issues grandes en piezas más pequeñas y manejables.

Crear Sub-Issues

Método 1: Desde Issue Padre

1. Abrí el issue padre
2. Hacé clic en Nuevo Sub-Issue
3. Completá detalles del sub-issue
4. El padre se establece automáticamente

Método 2: Desde Nuevo Issue

1. Hacé clic en Nuevo Issue
2. Seleccioná un issue padre del dropdown
3. Creá como normal

Mejores Prácticas de Sub-Issues

Cuándo Usar:

• El issue es muy grande para completar en una sesión
• El issue requiere trabajo de múltiples personas
• El issue tiene componentes distintos y separables

Ejemplo: "Agregar Autenticación de Usuario" (Padre)

• Sub-issue: "Diseñar mockups de UI de login"
• Sub-issue: "Implementar endpoints backend de auth"
• Sub-issue: "Crear schema de base de datos de usuario"
• Sub-issue: "Agregar integración OAuth"
• Sub-issue: "Escribir tests de autenticación"

Bloqueadores de Issues

Marcá dependencias entre issues para seguir qué está bloqueando el progreso.

Agregar un Bloqueador

1. Abrí el issue bloqueado
2. Hacé clic en pestaña Bloqueadores
3. Hacé clic en Agregar Bloqueador
4. Seleccioná el issue que está bloqueando este
5. Hacé clic en Agregar

Ejemplo:

• Issue: APP-42 "Deployear nueva funcionalidad"
• Bloqueado por: APP-40 "Escribir docs de deployment"
• Bloqueado por: APP-41 "Obtener aprobación de QA"

Ver Bloqueadores

Desde Vista de Issue:

• Bloqueado Por: Qué está previniendo que esto se complete
• Bloqueando: Qué issues este está previniendo

Desde Tablero del Proyecto:

• Issues con bloqueadores muestran un ícono 🔒
• Pasá el mouse para ver detalles de bloqueador

Comentarios & Colaboración

Discutí issues con tu equipo usando comentarios.

Agregar Comentarios

1. Abrí un issue
2. Desplazate a la sección Comentarios
3. Escribí tu comentario (soporta Markdown)
4. Hacé clic en Comentar

Funcionalidades de Comentarios

Soporte de Markdown:

## Encabezado
- Listas con viñetas
**Negrita**, *cursiva*, `código`
[Links](https://example.com)

Menciones (Próximamente):

@alicia podés revisar esto?
@roberto esto bloquea tu trabajo en APP-45

Bloques de Código:

```typescript
function ejemplo() {
  console.log('Compartir snippets de código')
}
```

Editar & Eliminar Comentarios

• Editar: Hacé clic en menú ⋯ → Editar (solo dueño)
• Eliminar: Hacé clic en menú ⋯ → Eliminar (solo dueño)

Línea de Tiempo de Actividad

Cada issue sigue un historial completo de cambios.

La Línea de Tiempo Muestra:

• Cambios de estado ("movido de Todo a En Progreso")
• Cambios de asignación ("asignado a Alicia")
• Actualizaciones de prioridad ("cambió prioridad de Baja a Alta")
• Ediciones de campos ("actualizó fecha de vencimiento")
• Comentarios ("Alicia comentó: ...")
• Creación de sub-issues ("creó sub-issue APP-43")
• Adiciones de bloqueadores ("bloqueado por APP-40")

Ejemplo de Línea de Tiempo:

hace 2 horas - Roberto cambió estado de Todo a En Progreso
hace 4 horas - Alicia asignó a Roberto
hace 1 día - Carolina cambió prioridad de Media a Alta
hace 2 días - Roberto comentó: "Empezando a trabajar en esto hoy"
hace 3 días - Alicia creó este issue

Tablero Kanban

Visualizá tu flujo de trabajo del proyecto con un tablero Kanban.

Vistas del Tablero

Navegá a proyecto → pestaña Tablero:

┌─────────────┬──────────────┬──────────────┬────────────┬──────┐
│  Backlog    │    Todo      │ En Progreso  │ En Revisión│ Hecho│
├─────────────┼──────────────┼──────────────┼────────────┼──────┤
│ APP-50      │ APP-45       │ APP-42       │ APP-40     │APP-38│
│ APP-51      │ APP-46       │ APP-43       │ APP-41     │APP-37│
│ APP-52      │ APP-47       │ APP-44       │            │APP-36│
│             │ APP-48       │              │            │      │
│             │ APP-49       │              │            │      │
└─────────────┴──────────────┴──────────────┴────────────┴──────┘

Arrastrar y Soltar

Mové issues entre columnas para actualizar estado:

• Arrastrá de Backlog → Todo (priorizar trabajo)
• Arrastrá de Todo → En Progreso (empezar trabajo)
• Arrastrá de En Progreso → En Revisión (enviar para revisión)
• Arrastrá de En Revisión → Hecho (completar trabajo)

Filtrar el Tablero

Filtrá issues por:

• Asignado: Mostrá solo tus issues
• Etiqueta: Ver solo bugs, features, etc.
• Prioridad: Enfocate en trabajo urgente
• Buscar: Encontrá issues específicos

Buscar Issues

Encontrá issues rápidamente a través de todos los proyectos.

Métodos de Búsqueda

Búsqueda Rápida:

1. Hacé clic en barra de búsqueda (o presioná /)
2. Escribí palabras clave
3. Seleccioná de los resultados

Búsqueda Avanzada:

• Navegá a página Issues
• Usá barra lateral de filtros:
  • Proyecto
  • Estado
  • Asignado
  • Prioridad
  • Etiquetas

Sintaxis de Búsqueda

Por Contenido:

• Buscar en títulos: bug de autenticación
• Buscar en descripciones: flujo de login

Por Identificador:

• Búsqueda directa: APP-42
• Prefijo de proyecto: APP- (muestra todos los issues de APP)

Por Asignado:

• Filtrá a asignado vía dropdown

Flujos de Trabajo de Proyectos

Planificación de Sprint Ágil

Setup:

1. Creá proyecto: "Sprint 24"
2. Establecé marco temporal de 2 semanas
3. Agregá issues del backlog
4. Estimá story points
5. Asigná a miembros del equipo

Diario:

• Miembros del equipo mueven issues en el tablero
• Actualizá bloqueadores según sea necesario
• Agregá comentarios sobre progreso

Fin de Sprint:

• Revisá issues completados
• Mové incompletos al próximo sprint
• Marcá proyecto de sprint como Completo

Seguimiento de Bugs

Setup:

1. Creá proyecto: "Arreglos de Bugs Q1"
2. Agregá etiqueta: 🐛 bug
3. Establecé niveles de prioridad

Flujo de Trabajo:

1. Usuario reporta bug → creá issue
2. Triaje: establecé prioridad y asigná
3. Desarrollador: mové a En Progreso
4. QA: mové a En Revisión
5. Verificado: mové a Hecho

Desarrollo de Funcionalidad

Setup:

1. Creá issue padre: "Agregar Modo Oscuro"
2. Creá sub-issues para componentes:
   • Diseñar mockups
   • Implementar theme switcher
   • Actualizar componentes existentes
   • Agregar almacenamiento de preferencia de usuario
   • Escribir tests
3. Agregá bloqueadores (diseño debe terminar primero)

Ejecución:

1. Completá sub-issue de diseño
2. Trabajo paralelo en sub-issues de implementación
3. Sub-issue de test bloqueado hasta que implementación esté hecha
4. Cerrá padre cuando todos los sub-issues estén hechos

XP de Proyectos

Completar issues gana XP basado en estimación:

Mejores Prácticas

Títulos de Issues

Bueno:

• "Agregar flujo de reseteo de contraseña a página de login"
• "Arreglar memory leak en dashboard de usuario"
• "Mejorar rendimiento de navegación móvil"

Malo:

• "Mejoras de login" (muy vago)
• "Bug" (sin contexto)
• "Hacerlo mejor" (no accionable)

Descripciones de Issues

Incluir:

• Contexto: ¿Por qué necesita hacerse esto?
• Criterios de Aceptación: ¿Qué define "hecho"?
• Referencias: Links, capturas de pantalla, issues relacionados
• Notas Técnicas: Pistas de implementación

Template:

## Contexto
Los usuarios reportan confusión durante flujo de reseteo de contraseña.

## Criterios de Aceptación
- [ ] Usuario puede solicitar reseteo de contraseña vía email
- [ ] Link de reseteo expira después de 1 hora
- [ ] Requisitos de contraseña mostrados claramente
- [ ] Mensaje de éxito mostrado después de reseteo

## Referencias
- Diseño en Figma: https://...
- Relacionado: APP-34, APP-35

## Notas Técnicas
Usar servicio de email existente, agregar nueva tabla reset_tokens

Organización de Proyectos

Proyectos Pequeños (< 20 issues):

• Usá etiquetas para organización
• Un solo proyecto cubre todo el alcance

Proyectos Grandes (20-50 issues):

• Creá múltiples sub-proyectos
• Usá issues padre para épicas
• Sesiones regulares de grooming

Muy Grandes (50+ issues):

• Dividí en múltiples proyectos enfocados
• Considerá usar equipo separado

Integraciones

Servidor MCP

Usá asistentes de IA para gestionar proyectos:

Creá un issue en el proyecto Rediseño de Sitio Web titulado
"Optimizar carga de imágenes" con prioridad Alta y etiqueta "rendimiento"

Mirá Integración MCP para detalles completos.

Acceso API (Próximamente)

Acceso programático a proyectos e issues para:

• Dashboards personalizados
• Creación automatizada de issues
• Integración CI/CD
• Conexiones de herramientas de terceros

Próximos Pasos

• Equipos - Colaborá con miembros del equipo
• Gamificación - Ganá XP del trabajo de proyecto
• Integración MCP - Gestioná proyectos con IA
• Guía de Uso - Flujos de trabajo diarios