# Issue #004: Crear agente api-client

**Tipo:** feat
**Prioridad:** media
**Estado:** pendiente

## Descripción

Crear un agente para gestionar integraciones con APIs externas: autenticación, rate limiting, retry logic, y generación de clientes.

## Capacidades requeridas

### Gestión de API Keys
- [ ] Almacenar keys en pass (cifrado GPG)
- [ ] Rotar keys automáticamente
- [ ] Validar keys antes de usar
- [ ] Documentar límites de cada API

### Generación de clientes
- [ ] Generar cliente Go desde OpenAPI/Swagger
- [ ] Generar cliente TypeScript desde OpenAPI
- [ ] Wrappers con retry y rate limiting
- [ ] Caché de respuestas

### APIs comunes pre-configuradas
- [ ] OpenAI / Anthropic (LLMs)
- [ ] Alpha Vantage / Yahoo Finance (finanzas)
- [ ] GitHub / Gitea (git)
- [ ] Cloudflare / AWS (infra)

## Integración con DevFactory

```go
// shell/api/openai.go
package api

import "github.com/lucasdataproyects/devfactory/core"

type OpenAIClient struct {
    apiKey string
    http   *shell.HTTPClient
}

func (c *OpenAIClient) Complete(prompt string) core.Result[string] {
    // Con retry y rate limiting automático
}
```

## Flujo de trabajo

```
Usuario: "Configura cliente para Alpha Vantage"

Agente:
1. Verifica si key existe en pass
2. Si no, pide al usuario que la añada
3. Genera cliente Go con DevFactory patterns
4. Añade a shell/api/ o app/finance/
5. Documenta uso
```

## Dependencias

- pass para gestión de secrets
- DevFactory para patrones HTTP