# <NNN> — <Titulo corto y descriptivo>

## Objetivo

<Que se quiere lograr. 1-3 frases claras.>

## Contexto

- <Que existe actualmente que es relevante>
- <Que falta o que problema hay>
- <Dependencias con otros issues si las hay>

## Arquitectura

```
<Archivos y carpetas afectados, indicando NEW para archivos nuevos>
```

### Patron pure core / impure shell

- `pkg/` — <cambios puros, si aplica>
- `shell/` — <cambios impuros, si aplica>
- `agents/` — <cambios de composicion, si aplica>
- `tools/` — <cambios en tools, si aplica>

## Tareas

### Fase 1: <Nombre de la fase>

- [ ] **1.1** <Descripcion concreta de la tarea>
- [ ] **1.2** <Siguiente tarea>

### Fase 2: <Nombre de la fase>

- [ ] **2.1** <Descripcion concreta>

### Fase N: Tests

- [ ] **N.1** <Test especifico>

### Fase N+1: Cleanup y docs

- [ ] Actualizar `CLAUDE.md` si hay cambios en la estructura
- [ ] Actualizar docs relevantes

---

## Ejemplo de uso

```
<Flujo de ejemplo mostrando como se usaria la feature una vez implementada>
```

## Decisiones de diseno

- **<Decision>**: <justificacion breve>

## Prerequisitos

- <Que debe estar implementado antes>

## Riesgos

- **<Riesgo>**: <mitigacion>