# Guías de Comunicación en Equipos de Desarrollo

## Principios de Comunicación Efectiva

### Claridad y Concisión
- Ser específico en las solicitudes y reportes
- Usar ejemplos concretos cuando sea necesario
- Evitar ambigüedades y suposiciones
- Estructurar mensajes con puntos clave

### Transparencia
- Comunicar problemas temprano
- Compartir progreso regularmente
- Admitir cuando no se sabe algo
- Documentar decisiones importantes

### Respeto y Profesionalismo
- Usar lenguaje constructivo
- Dar feedback específico y actionable
- Reconocer el trabajo de otros
- Mantener conversaciones enfocadas

## Canales de Comunicación

### Slack/Teams - Chat Institucional
**Para**: Comunicación rápida, notificaciones, discusiones informales
- Usar threads para conversaciones largas
- Mencionar @usuario cuando se requiera respuesta
- Usar canales específicos (#dev, #general, #bugs)

### Email
**Para**: Comunicación formal, documentación oficial, externos
- Subject line claro y descriptivo
- Usar bullets para información múltiple
- CC solo a personas relevantes

### Video Calls
**Para**: Discusiones complejas, brainstorming, demos
- Preparar agenda previa
- Grabar sesiones importantes
- Seguimiento con resumen por escrito

### Pull Requests/Code Reviews
**Para**: Discusión técnica sobre código
- Comentarios constructivos y específicos
- Explicar el "por qué" de los cambios
- Usar templates de PR consistentes

## Reuniones Efectivas

### Daily Standup (5-15 min)
**Formato**:
- ¿Qué hice ayer?
- ¿Qué haré hoy?
- ¿Tengo algún bloqueo?

**Buenas prácticas**:
- Mantener enfoque en el trabajo
- Identificar bloqueos temprano
- Coordinar colaboraciones

### Sprint Planning
**Preparación**:
- Backlog refinado previamente
- Estimaciones actualizadas
- Criterios de aceptación claros

### Retrospectivas
**Formato**:
- ¿Qué funcionó bien?
- ¿Qué podemos mejorar?
- ¿Qué acciones tomaremos?

## Reportes de Bugs

### Información Requerida
```markdown
**Descripción**: Breve descripción del problema

**Pasos para Reproducir**:
1. Ir a página X
2. Hacer clic en botón Y
3. Llenar formulario con datos Z

**Resultado Esperado**: Lo que debería pasar

**Resultado Actual**: Lo que realmente pasa

**Entorno**:
- OS: Windows 10
- Browser: Chrome 96.0
- Version: v2.1.3

**Screenshots/Videos**: [Adjuntar si aplica]

**Logs de Error**: [Incluir stack trace si está disponible]
```

### Severidad de Bugs
- **Critical**: Sistema no funciona, pérdida de datos
- **High**: Funcionalidad principal rota
- **Medium**: Funcionalidad menor afectada
- **Low**: Mejoras cosméticas, edge cases

## Code Reviews

### Como Reviewer
**Enfocarse en**:
- Lógica de negocio
- Adherencia a estándares
- Posibles bugs o edge cases
- Performance y seguridad

**Dar feedback constructivo**:
```
❌ "Este código está mal"
✅ "Considera usar Optional.ofNullable() aquí para evitar NPE"

❌ "No me gusta esta implementación"
✅ "Esta implementación podría beneficiarse de factory pattern para mayor flexibilidad"
```

### Como Author
- Responder a todos los comentarios
- Hacer preguntas si algo no está claro
- Explicar decisiones de diseño cuando sea necesario
- Ser receptivo al feedback

## Gestión de Conflictos

### Conflictos Técnicos
1. Presentar ambas opciones objetivamente
2. Discutir pros/cons con datos
3. Hacer POCs si es necesario
4. Decidir basado en criterios técnicos

### Conflictos de Proceso
1. Escuchar todas las perspectivas
2. Identificar puntos en común
3. Buscar compromiso win-win
4. Escalar a management si es necesario

## Documentación Técnica

### READMEs de Proyecto
```markdown
# Project Name

## Description
Brief description of what the project does

## Prerequisites
- Node.js 16+
- PostgreSQL 12+

## Installation
```bash
npm install
npm run setup
```

## Usage
How to run the project locally

## API Documentation
Link to API docs or inline documentation

## Contributing
Guidelines for contributing
```

### Decisiones Arquitectónicas (ADRs)
```markdown
# ADR-001: Use PostgreSQL for Primary Database

## Status
Accepted

## Context
We need to choose a database for our new microservice...

## Decision
We will use PostgreSQL as our primary database.

## Consequences
- Positive: ACID compliance, JSON support, mature ecosystem
- Negative: Additional operational complexity compared to managed solutions
```

## Templates de Comunicación

### Solicitud de Ayuda
```
**Contexto**: Estoy trabajando en [descripción del task]

**Problema**: [Descripción específica del problema]

**Lo que he intentado**:
- Opción A: Resultado X
- Opción B: Resultado Y

**Pregunta específica**: [Pregunta concreta]

**Urgencia**: [Alta/Media/Baja] - [Razón]
```

### Reporte de Progreso
```
**Task**: [Nombre del task/ticket]

**Progreso**: [X% completo]

**Completado**:
- ✅ Item 1
- ✅ Item 2

**En progreso**:
- 🔄 Item 3 (esperado: viernes)

**Bloqueado**:
- ❌ Item 4 (esperando respuesta de team X)

**Próximos pasos**: [Plan para los siguientes días]
```