GitHub Companion

Una extensión avanzada para Visual Studio Code que integra GitHub, GitHub Projects y GitHub Copilot para proporcionar capacidades de gestión de proyectos inteligente.

Características Principales

🚀 Modo Companion Agent

• PM Experto: Un asistente de gestión de proyectos inteligente basado en GitHub Copilot
• Gestión de Backlog: Análisis y gestión automatizada del backlog del proyecto
• Planificación de Sprints: Ayuda en la planificación y seguimiento de sprints
• Análisis de Progreso: Insights automáticos sobre el progreso del proyecto

📊 Vista de Proyectos GitHub

• Visualización Completa: Panel lateral dedicado para proyectos de GitHub
• Gestión de Items: Ver y gestionar issues, PRs y elementos del proyecto
• Estados en Tiempo Real: Seguimiento del estado de todos los elementos

🧠 Sistema de Memorias

• Notas del Proyecto: Guarda y organiza notas por proyecto
• Requerimientos: Recopilación y gestión de requerimientos
• Decisiones: Registro de decisiones importantes del proyecto
• Contexto Inteligente: El Companion recuerda el contexto del proyecto

💬 Chat Interactivo

• Conversación Natural: Interactúa con el Companion usando lenguaje natural
• Comandos Inteligentes: Procesa solicitudes complejas de gestión de proyectos
• Sugerencias Contextuales: Proporciona sugerencias basadas en el estado del proyecto

Configuración Inicial

1. Autenticación GitHub

1. Ve a GitHub Settings > Developer settings > Personal access tokens
2. Crea un nuevo token con los siguientes permisos:
   • repo (acceso completo a repositorios)
   • project (acceso a proyectos)
   • read:org (leer organizaciones)
3. Configura el token en VS Code:
   • Abre Command Palette (Cmd+Shift+P)
   • Ejecuta GitHub Companion: Authenticate
   • Pega tu token

2. Configuración de Organización (Opcional)

{
  "github-companion.defaultOrganization": "tu-organizacion"
}

🤖 Modo Companion con GitHub Copilot Chat

Activación

La extensión registra automáticamente un modo de chat personalizado para GitHub Copilot Chat que actúa como un PM experto y desarrollador senior.

Método 1: Desde Copilot Chat

@companion Analiza el estado actual del proyecto

Método 2: Comando VS Code

• Cmd+Shift+P → GitHub Companion: Activar Modo Companion

Capacidades del Companion

• 📊 Análisis de Proyectos: Evalúa estado, métricas y progreso
• 📋 Gestión de Backlog: Priorización inteligente basada en valor/complejidad
• 🚀 Planificación de Sprints: Diseño de sprints balanceados y alcanzables
• 💡 Recomendaciones Técnicas: Sugerencias de arquitectura y mejores prácticas
• 📈 Reporting: Genera reportes para stakeholders

Ejemplos de Uso

@companion Planifica un sprint de 2 semanas con 40 story points
@companion Revisa el código y sugiere mejoras de arquitectura  
@companion Genera un reporte de progreso para stakeholders
@companion Identifica riesgos en el proyecto actual

Uso

Activar Modo Companion

1. Abre la vista de GitHub Companion en el panel lateral
2. Haz clic en "Activar Modo Companion" o usa el Command Palette
3. Comienza a chatear con tu asistente PM

Gestionar Proyectos

1. La vista "GitHub Projects" muestra todos tus proyectos
2. Haz clic en un proyecto para seleccionarlo
3. Usa el Companion para analizar y gestionar el proyecto

Crear y Gestionar Memorias

1. Ve a la vista "Memorias del Proyecto"
2. Usa el Command Palette: GitHub Companion: Manage Memories
3. Crea, edita o elimina memorias según necesites

Comandos Disponibles

• GitHub Companion: Authenticate - Autenticar con GitHub
• GitHub Companion: Activate Companion Mode - Activar el modo PM
• GitHub Companion: Manage Memories - Gestionar memorias del proyecto
• GitHub Companion: Refresh Projects - Actualizar lista de proyectos

Ejemplos de Uso del Companion

Análisis de Proyecto

Usuario: "Analiza el progreso de mi proyecto"
Companion: "📊 Tu proyecto tiene 15 items totales, 8 completados (53%), 
           4 en progreso y 3 en backlog. Velocity actual: 3 items/sprint."

Gestión de Backlog

Usuario: "Muéstrame el backlog"
Companion: "📋 Tienes 5 items en backlog. Los de mayor prioridad son:
           1. Implementar autenticación (High)
           2. Diseñar dashboard (Medium)..."

Planificación

Usuario: "Ayúdame a planificar el próximo sprint"
Companion: "🎯 Basado en tu velocity y capacidad, recomiendo incluir 
           estos 4 items en el próximo sprint de 2 semanas..."

Desarrollo

Estructura del Proyecto

src/
├── extension.ts              # Punto de entrada principal
├── services/
│   ├── GitHubService.ts      # API de GitHub
│   ├── MemoryService.ts      # Gestión de memorias
│   └── CompanionModeService.ts # Lógica del PM Agent
└── providers/
    ├── GitHubProjectsProvider.ts # Vista de proyectos
    ├── MemoriesProvider.ts      # Vista de memorias
    └── CompanionChatProvider.ts  # Chat del Companion

Scripts Disponibles

• npm run compile - Compilar TypeScript
• npm run watch - Modo watch para desarrollo

Roadmap

Próximas Características

• [ ] Integración con GitHub Actions
• [ ] Métricas avanzadas y reporting
• [ ] Templates de proyectos
• [ ] Integración con calendarios
• [ ] Notificaciones inteligentes
• [ ] Sincronización con herramientas externas
• [ ] Análisis de código automático
• [ ] Sugerencias de refactoring

Características Avanzadas (Futuro)

• [ ] ML para predicción de entregas
• [ ] Análisis de sentimientos en comentarios
• [ ] Integración con herramientas de diseño
• [ ] Dashboard web externo
• [ ] API pública para integraciones

Contribuciones

Este software es propietario de Emerick Echeverría Vargas (@EmerickVar) y New Age Coding Organization.

Para contribuir al proyecto:

1. Contacta primero para obtener autorización
2. Fork el repositorio autorizado
3. Crea una branch para tu feature
4. Firma el Contributor License Agreement (CLA)
5. Commit tus cambios siguiendo las guías de estilo
6. Push a la branch
7. Abre un Pull Request para revisión

Nota: Todas las contribuciones quedan bajo la propiedad de New Age Coding Organization.

Licencia

PROPRIETARY SOFTWARE - Copyright (c) 2025 Emerick Echeverría Vargas (@EmerickVar) y New Age Coding Organization.

Este software es propietario y confidencial. Ver el archivo LICENSE para términos completos.

Soporte y Contacto

Soporte Técnico:

• GitHub Issues: Para reportar bugs autorizados
• Email: support@newagecodingorg.com

Licenciamiento:

• Email: licensing@newagecodingorg.com
• GitHub: @EmerickVar

Empresa:

• New Age Coding Organization
• Website: https://newagecodingorg.com

GitHub Companion - Desarrollado por Emerick Echeverría Vargas (@EmerickVar) para New Age Coding Organization 🚀