---
name: fix-issue
description: Implementa un issue completo de punta a punta con confirmación
argument-hint: <NNNN>
disable-model-invocation: true
user-invocable: true
allowed-tools: Bash, Read, Write, Edit, TodoWrite
---

# fix-issue

Ejecuta el flujo completo de implementación/cierre de un issue: crear rama, implementar, testear, cerrar, confirmar, integrar.

## Sintaxis

```bash
/fix-issue <NNNN>
/fix-issue <NNNN>-<slug>
```

## Precondiciones

- [ ] Directorio `dev/issues/` existe
- [ ] Directorio `dev/issues/completed/` existe
- [ ] Tests configurados
- [ ] Working tree limpio

## Flujo

### 1. Resolver issue objetivo

```bash
ls dev/issues/<NNNN>-*.md
```

- Si no existe: STOP "Issue no encontrado"
- Si ya completado: STOP "Issue ya completado"

### 2. Leer issue completo

Extraer: objetivo, tareas, arquitectura, patrón pure/impure, tests.

### 3. Crear rama de trabajo

```bash
git checkout master
git pull --rebase
git checkout -b issue/<NNNN>-<slug>
```

### 4. Planificar con TodoWrite

Crear plan basado en tareas del issue.

### 5. Implementar completo

Para cada tarea:
1. Implementar siguiendo patrón pure core / impure shell
2. Compilar frecuentemente: `go build -tags goolm ./...`
3. Crear commits atómicos durante implementación

### 6. Tests obligatorios

```bash
go test -tags goolm ./...
```

- Pasan: continuar
- Fallan: STOP y corregir

### 7. Feature flags (si aplica)

Actualizar `dev/feature_flags.json` si es multi-issue.

### 8. Cerrar issue

```bash
mv dev/issues/<NNNN>-<slug>.md dev/issues/completed/
```

Actualizar índice en README.md.

### 9. Mostrar resumen y confirmar

```
Issue <NNNN> completado

Resumen:
- N archivos modificados
- N commits realizados
- Tests: pasando

¿Integrar a master?
```

### 10. Ejecutar /git-push

Si confirma, ejecutar flujo de integración.

## Convenciones

- Implementar TODAS las tareas
- Commits atómicos durante implementación
- Tests obligatorios
- Pure core / impure shell

## Reglas

- NO saltear tareas
- NO commits WIP
- SIEMPRE tests antes de cerrar
- Confirmación obligatoria antes de integrar