# NNNN — [Título de la Issue]

## Metadata

| Campo | Valor |
|-------|-------|
| **ID** | NNNN |
| **Estado** | 🟡 pendiente / 🔵 en progreso / ✅ completado / 🔴 bloqueado |
| **Prioridad** | alta / media / baja |
| **Tipo** | feature / bugfix / refactor / docs / infrastructure |

## Dependencias

<!-- Issues que DEBEN estar completadas antes de empezar esta -->

| ID | Título | Estado | Requerido |
|----|--------|--------|-----------|
| 0001 | Actualizar nombre del módulo | ✅ | Sí |
| 0002 | Implementar core/ | ✅ | Sí |

**Bloqueada por:** `#0001, #0002`

**Desbloquea:** `#0006, #0007`

> **⚠️ VALIDACIÓN AUTOMÁTICA**: Esta issue no puede iniciarse hasta que todas las dependencias estén en estado `✅ completado`.

---

## Objetivo

[Descripción concisa de qué se quiere lograr en 1-3 oraciones]

## Contexto

- [Punto de contexto 1]
- [Punto de contexto 2]
- [Referencias a otras issues o decisiones previas]

## Arquitectura

```
[Estructura de archivos afectados]
dir/
├── file1.go    — Descripción
├── file2.go    — NEW: Nuevo archivo
└── file3.go    — MODIFY: Modificación
```

### Patrón pure core / impure shell

- `core/` — [Qué funciones puras se agregan]
- `shell/` — [Qué operaciones I/O se implementan]
- `app/` — [Cómo se orquesta]

## Tareas

### Fase 1: [Nombre de fase]

- [ ] **1.1** [Descripción detallada de tarea]
- [ ] **1.2** [Otra tarea]

### Fase 2: [Otra fase]

- [ ] **2.1** [Tarea]
- [ ] **2.2** [Tarea]

### Fase N: Cleanup y docs

- [ ] Actualizar `README.md` con cambios relevantes
- [ ] Actualizar `CLAUDE.md` si hay cambios arquitectónicos
- [ ] Ejecutar `go mod tidy`
- [ ] Ejecutar `go test ./...`
- [ ] Actualizar issue en `dev/issues/README.md`

---

## Ejemplo de uso

```bash
# Comandos de ejemplo
comando ejemplo arg1 arg2

# Output esperado:
# ✓ Success message
```

```go
// Código de ejemplo si aplica
package example

func Example() {}
```

## Decisiones de diseño

- **Decisión 1**: Razón y trade-offs
- **Decisión 2**: Alternativas consideradas y por qué se eligió esta

## Prerequisitos

- Issue #NNNN completado
- Herramienta X instalada
- Configuración Y realizada

## Riesgos

- **Riesgo 1**: Descripción del riesgo. **Mitigación**: Cómo se mitigará
- **Riesgo 2**: Otro riesgo. **Mitigación**: Plan de mitigación

## Criterios de aceptación

- [ ] Todos los tests pasan
- [ ] Feature flag agregado en `feature_flags.json`
- [ ] Documentación actualizada
- [ ] Code review aprobado
- [ ] Deployable a main

---

## Notas de implementación

[Notas que surjan durante la implementación, decisiones tomadas, problemas encontrados]

## Referencias

- [Link a documentación relevante]
- [Link a PRs relacionados]
- [Link a discusiones]