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

1.4 KiB

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

// 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