team-coordination

# Skill: Team Coordination

> Prerequisito: @docs/rules/domain/team-structure.md
> Complementa: @.claude/skills/capacity-planning/SKILL.md

Orquesta la creación, gestión y coordinación de equipos dentro de departamentos.
Detecta dependencias cross-equipo, bloqueos y problemas de capacidad.

## Flujo 1 — Crear equipo (`create`)

1. Verificar que el departamento existe en `teams/departments.md`
   - Si no existe, preguntar si crear el departamento primero
2. Crear estructura de directorios: `teams/{dept}/{team}/`
3. Generar `team.md` con schema de @team-structure.md:
   - name, department, lead (vacío si no se indica), members: []
   - capacity_total: 0, velocity_avg: 0, sprint_cadence: 2w
4. Generar `deps.md` vacío: `dependencies: []`
5. Actualizar `teams/departments.md` con el nuevo equipo
6. Output: confirmación + ruta + siguiente paso ("asigna miembros con /team-orchestrator assign")

## Flujo 2 — Asignar miembro (`assign`)

1. Verificar que el equipo existe en `teams/{dept}/{team}/team.md`
2. Verificar que el usuario tiene perfil (`.claude/profiles/{user}/` o `active-user.md`)
3. Añadir entrada a `members:` en team.md:
   - handle, role (contributor|pm|tech-lead|qa|architect), capacity (FTE), projects
4. Recalcular `capacity_total` (suma de FTE de todos los miembros)
5. Si el usuario ya está en otro equipo, advertir (multi-equipo permitido si capacity < 1.0)
6. Output: miembro asignado + capacidad total actualizada

## Flujo 3 — Dependencias cross-equipo (`deps`)

1. Leer todos los `teams/*/*/deps.md` recursivamente
2. Construir grafo de dependencias:
   - Nodos = equipos
   - Aristas = dependencias (blocking, informational, shared-resource)
3. Detectar:
   - **Bloqueos activos** (deps con status: red o amber)
   - **Dependencias circulares** (A→B→C→A)
   - **Equipos aislados** (sin ninguna dependencia declarada — posible gap)
4. Si `--critical`: filtrar solo blocking con status red/amber
5. Output: tabla de dependencias + alertas + gráfico ASCII

```
Ejemplo output:
┌─────────┐  blocking  ┌─────────┐
│ Backend │──────────→│ Frontend │
└─────────┘            └─────────┘
     │ shared-resource      │ informational
     ▼                      ▼
┌──────────┐          ┌──────────┐
│ Platform │          │  Mobile  │
└──────────┘          └──────────┘

⚠️ 2 bloqueos activos:
  Backend → Frontend (red): API contracts pendientes
  Platform → Backend (amber): migración K8s en progreso
```

## Flujo 4 — Sincronizar estado (`sync`)

1. Para cada equipo, leer team.md y deps.md
2. Verificar coherencia:
   - ¿Todos los miembros listados tienen perfil?
   - ¿Las deps referencian equipos que existen?
   - ¿La capacity_total coincide con suma de FTE?
3. Recalcular velocity_avg si hay datos de sprint disponibles
4. Actualizar status de deps basándose en última actividad
5. Guardar `output/team-sync-YYYYMMDD.md` con resumen

## Flujo 5 — Dashboard de estado (`status`)

1. Leer todos los equipos (o filtrar por dept si `--dept`)
2. Para cada equipo calcular:
   - Capacidad: total FTE, % utilizado (si hay sprint activo)
   - Salud: dependency_health (% deps en green)
   - Velocidad: velocity_avg + tendencia (↑↗→↘↓)
   - Bloqueos: count de deps blocking con status != green
3. Agregar por departamento si `--all`
4. Output: tabla resumen + alertas

```
Ejemplo output:
══════════════════════════════════════════════
  Multi-Team Status — Engineering Department
══════════════════════════════════════════════

  Team         │ FTE │ Velocity │ Health │ Blocks
  ─────────────┼─────┼──────────┼────────┼───────
  Backend Core │ 4.5 │   42 ↗   │  80%   │   1
  Frontend Web │ 3.0 │   35 →   │ 100%   │   0
  Platform     │ 2.0 │   18 ↘   │  50%   │   2
  Mobile       │ 3.5 │   28 ↑   │ 100%   │   0
  ─────────────┼─────┼──────────┼────────┼───────
  TOTAL        │13.0 │  123     │  83%   │   3

  ⚠️ Platform: 2 bloqueos activos, velocity descendente
```

## Errores

| Error | Acción |
|---|---|
| Departamento no existe | Preguntar si crear. Si sí, crear departments.md |
| Equipo ya existe | Mostrar datos actuales, preguntar si actualizar |
| Miembro sin perfil | Ejecutar `/profile-setup` primero |
| Dependencia circular detectada | Alertar como CRÍTICO, sugerir reunión de resolución |
| deps.md referencia equipo inexistente | Advertir + sugerir actualizar |

## Seguridad

- NUNCA exponer datos personales de miembros en output público
- SIEMPRE usar @handles, no nombres reales en reports exportables
- Datos de equipo en `teams/` — git-tracked (sin datos sensibles)
- Rates/salarios NUNCA en team.md — esos van en `.flow-data/rates.json` (git-ignored)