9.8 KiB
9.8 KiB
Portfolio IA: Desarrollo Inteligente de Principio a Fin
El Problema
Los equipos de desarrollo enfrentan desafíos críticos al integrar IA en sus flujos de trabajo:
- Conocimiento disperso: Decisiones en Slack, patterns en wikis, guidelines en docs separados
- Agentes IA sin contexto: Generan código que ignora las convenciones del proyecto
- Costos LLM descontrolados: Sin visibilidad ni límites por equipo o tarea
- Infraestructura manual: Configuración repetitiva que consume tiempo valioso
- Interfaces fragmentadas: Una herramienta para CLI, otra para web, otra para TUI
La Solución: Un Ecosistema Integrado
Cinco proyectos diseñados para trabajar juntos, cada uno resolviendo un problema específico.
Vapora: Orquestación Inteligente de Agentes
Agentes que Aprenden de la Experiencia
Vapora no es otro framework de agentes. Es un sistema que aprende qué agente es mejor para cada tarea basándose en ejecuciones previas.
Cómo funciona:
- Cada ejecución construye un perfil de expertise por tipo de tarea
- Las últimas 7 días pesan 3x más que el histórico (recency bias)
- Los agentes nuevos no se sobreponen a los experimentados (confidence weighting)
Control de costos real:
- Presupuestos por rol (mensual/semanal)
- Tres niveles: normal → cerca del límite → excedido
- Fallback automático a proveedores más baratos sin intervención manual
Para quién:
- Equipos que usan múltiples agentes IA para desarrollo
- Organizaciones que necesitan controlar gastos LLM
- Proyectos con pipelines de código (architect → developer → reviewer → tester)
Resultados esperados:
- Reducción de costos LLM mediante routing inteligente
- Mejora en calidad de outputs al asignar agentes según expertise
- Visibilidad completa de gastos y rendimiento por agente
Kogral: El Conocimiento del Equipo, Queryable
Tu Base de Conocimiento con IA Integrada
Kogral captura las decisiones, patterns y guidelines de tu equipo en un formato que tanto humanos como agentes IA pueden consultar.
Qué lo hace diferente:
- 6 tipos de nodo especializados: Notes, Decisions (ADRs), Guidelines, Patterns, Journals, Executions
- Git-native: Todo en markdown versionado, no en un SaaS externo
- MCP para Claude Code: Tus agentes consultan guidelines antes de generar código
El flujo:
Desarrollador toma decisión → Captura en Kogral como ADR
↓
Claude Code consulta via MCP → "¿Hay guidelines para auth?"
↓
Kogral responde con contexto del proyecto
↓
Código generado sigue convenciones del equipo
Para quién:
- Equipos que pierden conocimiento cuando rotan miembros
- Organizaciones con multiple proyectos que necesitan guidelines consistentes
- Desarrolladores usando Claude Code que quieren contexto del proyecto
Resultados esperados:
- Onboarding de nuevos miembros en días, no semanas
- Código generado por IA que respeta convenciones
- Decisiones arquitectónicas preservadas y buscables
TypeDialog: Una Definición, Seis Interfaces
Formularios que Funcionan en Todas Partes
Define un formulario una vez en TOML. Ejecútalo en CLI, TUI, Web, o deja que un agente IA lo complete.
Backends disponibles:
| Backend | Uso típico |
|---|---|
| CLI | Scripts de automatización, CI/CD |
| TUI | Herramientas de administración, dashboards terminal |
| Web | Aplicaciones SaaS, formularios públicos |
| AI | Búsqueda semántica, RAG sobre documentación |
| Agent | Ejecución de agentes desde archivos .agent.mdx |
| Prov-gen | Generación de infraestructura multi-cloud |
El flujo:
employee_onboarding.toml
↓
TypeDialog
↓
┌───────┬───────┬───────┐
CLI TUI Web Agent
│ │ │ │
▼ ▼ ▼ ▼
Mismo resultado validado con Nickel contracts
Para quién:
- Equipos que mantienen la misma lógica en CLI y Web
- DevOps que necesitan wizards de configuración
- Organizaciones con formularios multi-idioma
Resultados esperados:
- Una sola definición para todas las interfaces
- Validación tipada antes de runtime
- Formularios que ejecutan agentes LLM directamente
Provisioning: Infraestructura con IA
IaC Declarativo + Generación Asistida
Provisioning combina la precisión de configuración tipada (Nickel) con asistencia IA para generar y validar infraestructura.
Capacidades únicas:
- Nickel IaC: Configuración tipada con lazy evaluation, no YAML
- MCP Server: Consultas en lenguaje natural sobre infraestructura
- RAG integrado: 1,200+ documentos de dominio para respuestas contextuales
- Multi-cloud: AWS, UpCloud, local desde la misma definición
Seguridad enterprise:
- JWT + MFA (TOTP + WebAuthn)
- Cedar policy engine para RBAC
- 7 años retención de audit logs
- 5 backends KMS (RustyVault, Age, AWS KMS, Vault, Cosmian)
El flujo:
"Necesito un cluster K8s en AWS con 3 nodos"
↓
MCP Server (NLP)
↓
RAG busca configuraciones similares
↓
Genera Nickel + valida tipos
↓
Orchestrator despliega con rollback
Para quién:
- Equipos DevOps que quieren IaC tipado, no YAML frágil
- Organizaciones multi-cloud (AWS + otros)
- Equipos que necesitan audit y compliance
Resultados esperados:
- Errores de configuración detectados en compilación, no en runtime
- Infraestructura generada desde lenguaje natural
- Rollback automático ante fallos
SECRETUMVAULT: Secretos con Criptografía Post-Cuántica
El Primer Vault Rust con PQC en Producción
SecretumVault es un sistema de gestión de secretos que implementa criptografía post-cuántica lista para producción (ML-KEM-768, ML-DSA-65).
Criptografía agnóstica:
- OpenSSL: RSA, ECDSA, AES-256-GCM (compatibilidad clásica)
- OQS (Post-Quantum): ML-KEM-768, ML-DSA-65 (NIST FIPS 203/204)
- Backends conectables: Cambia algoritmos sin modificar código
Motores de secretos:
| Motor | Capacidad |
|---|---|
| KV | Almacenamiento versionado de secretos |
| Transit | Encryption-as-a-service con rotación de claves |
| PKI | Generación de certificados X.509 |
| Database | Credenciales dinámicas con TTL |
Storage multi-backend:
- Filesystem (desarrollo, single-node)
- etcd (Kubernetes, alta disponibilidad)
- SurrealDB (queries complejas, time-series)
- PostgreSQL (enterprise, ACID)
Seguridad enterprise:
- Shamir Secret Sharing para unsealing
- Cedar policy engine (ABAC)
- TLS/mTLS nativo
- Audit logging completo
Para quién:
- Equipos desplegando criptografía post-cuántica hoy
- Organizaciones con requisitos de agilidad criptográfica
- Plataformas multi-cloud que necesitan gestión de secretos Rust-native
Resultados esperados:
- Preparación para amenazas cuánticas sin cambiar arquitectura
- Gestión de secretos con garantías de memoria de Rust
- Integración nativa con el ecosistema (Provisioning, Vapora)
El Ecosistema en Acción
Escenario: Nuevo Feature con IA
1. Kogral proporciona guidelines y patterns a Claude Code via MCP
2. Vapora coordina agentes: Architect diseña → Developer implementa → Reviewer valida
3. TypeDialog captura configuraciones necesarias con validación Nickel
4. SecretumVault gestiona credenciales y secretos del feature
5. Kogral registra decisiones tomadas durante el desarrollo
6. Provisioning despliega cambios de infraestructura requeridos
Escenario: Onboarding de Nuevo Desarrollador
1. Kogral exporta knowledge graph del proyecto
2. TypeDialog presenta quiz interactivo sobre arquitectura
3. Vapora asigna tareas de onboarding progresivas
4. Provisioning configura entorno de desarrollo automáticamente
Escenario: Migración Multi-Cloud
1. Kogral documenta ADRs de la migración
2. TypeDialog valida parámetros de configuración
3. Provisioning ejecuta migración con checkpoints
4. Vapora orquesta agentes para monitoreo y reportes
Por Qué Elegir Este Ecosistema
Frente a Alternativas
| Nosotros | Alternativas |
|---|---|
| Rust nativo: Rendimiento, sin GC, type-safe | Python: GIL, typing opcional |
| Nickel configs: Validación pre-runtime | YAML/JSON: Errores en runtime |
| Aprendizaje de ejecuciones: Agentes mejoran | LangChain: Chains estáticos |
| MCP integrado: Contexto para Claude Code | Sin integración nativa |
| Budget control: Fallback automático | Control manual de costos |
| Multi-tenant nativo: SurrealDB scopes | Aislamiento manual |
Inversión Técnica
| Métrica | Valor |
|---|---|
| Crates Rust | 40+ |
| Tests | 4,360+ |
| Líneas de código | ~206K |
| Proveedores LLM | Claude, OpenAI, Gemini, Ollama |
| MCP Tools | 14+ |
| Backends crypto | OpenSSL, OQS (PQC), AWS-LC |
Comenzar
Adopción Progresiva Recomendada
- Kogral: Establece base de conocimiento (standalone, sin dependencias)
- TypeDialog: Habilita inputs estructurados y validación
- SecretumVault: Gestión de secretos con criptografía moderna
- Vapora: Orquesta agentes con contexto de Kogral
- Provisioning: Infraestructura informada por el ecosistema
Cada proyecto funciona de forma independiente. Las sinergias emergen al combinarlos.
Contacto
- Repositorios: GitHub (proyectos privados)
- Stack: Rust, Nickel, SurrealDB, Axum, Leptos
- Licencia: Propietaria / Por definir
El desarrollo asistido por IA no debería requerir 10 herramientas desconectadas. Un ecosistema. Cinco proyectos. Integración real.