# Issue #005: Crear agente docs-generator

**Tipo:** feat
**Prioridad:** baja
**Estado:** pendiente

## Descripción

Crear un agente para generar documentación técnica automáticamente desde el código.

## Capacidades requeridas

### Go
- [ ] Generar docs desde godoc comments
- [ ] README.md con ejemplos de uso
- [ ] API reference
- [ ] Diagramas de arquitectura (mermaid)

### React/TypeScript
- [ ] Docs desde JSDoc/TSDoc
- [ ] Props tables para componentes
- [ ] Storybook docs (ya existe en frontend-lib)
- [ ] Changelog automático

### Proyecto completo
- [ ] README.md con badges, instalación, uso
- [ ] CONTRIBUTING.md
- [ ] CHANGELOG.md (conventional commits)
- [ ] Arquitectura (diagrama mermaid)

## Templates

### README.md
```markdown
# Proyecto

![CI](badge) ![Coverage](badge)

## Instalación
## Uso
## API
## Desarrollo
## Licencia
```

### Diagrama arquitectura
```mermaid
graph TB
    A[Frontend] --> B[Backend]
    B --> C[Database]
    B --> D[Cache]
```

## Flujo de trabajo

```
Usuario: "Genera documentación para este proyecto"

Agente:
1. Detecta tipo de proyecto
2. Escanea código y comentarios
3. Genera README.md
4. Genera API docs
5. Genera diagrama de arquitectura
```

## Dependencias

- godoc para Go
- typedoc para TypeScript
- mermaid para diagramas