docs: crear roadmap de issues para agentes

Se crean 9 issues para trackear el desarrollo de agentes:

Nuevos agentes:
- #001 orchestrator: coordinar agentes para proyectos
- #002 ci-cd: pipelines de build/test/deploy
- #003 testing: tests automatizados Go y React
- #004 api-client: gestión de APIs externas
- #005 docs-generator: documentación automática

Mejoras a existentes:
- #006 db-reader: PostgreSQL, migraciones
- #007 backend-lib: nuevos módulos shell/app
- #008 frontend-lib: versionado, testing
- #009 gitea: Actions, templates

dev/issues/004-agent-api-client.md

@@ -0,0 +1,65 @@
+# 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