Files
repo_Claude/dev/issues/004-agent-api-client.md
egutierrez f3d5ddcddd 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
2026-03-22 20:00:15 +01:00

66 lines
1.4 KiB
Markdown

# 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