Metodología
Cómo trabajamos: blueprint vivo + sistema de agentes IA + validación mecánica + evaluación independiente.
Blueprint vivo
El blueprint completo está en repositorio versionado. Cualquier cambio sustantivo deja registro en
_changelog.md. Cada sección tiene propietario, cadencia de revisión y mecanismo de impugnación
ciudadana cuando aplique.
Sistema de agentes IA
14 agentes especializados (8 con schemas tipados de output) compuestos en flows de orquestación sincrónicos y asíncronos. Cada invocación produce:
- Output validado contra schema (cuando aplica).
- Métricas de costo y latencia persistentes.
- Hash de prompt para auditoría sin almacenar el prompt completo.
- Verdict de salvaguardas (PII redactada, marcas prohibidas detectadas).
Validación mecánica
Antes de cualquier publicación, tools/validate.py ejecuta verificaciones automáticas:
- Todos los archivos del blueprint presentes.
- Cada piloto mapea a país y pilar.
- Distribución geográfica de pilotos diversa (no solo BRA/MEX/CHL).
- Para cada país piloteado, perfil país publicado.
- Stakeholders regionales clave (CELAC, IDB, CAF, ECLAC) cubiertos.
Evaluación independiente
Cada piloto tiene plan de evaluación pre-registrado. Evaluadores académicos externos. Publicación íntegra obligatoria — éxitos y fracasos. Los pilotos no son demostraciones de marketing.
Pivot, pause, sunset
- Pivot: ajuste de enfoque sin parar operación. Disparado cuando KPI primario está estancado pero variables auxiliares sugieren cambio de táctica.
- Pause: pausa cautelar mientras se evalúa. Disparado cuando KPI cae 24 meses consecutivos o hay incidente reputacional/operativo grave.
- Sunset: cierre permanente. Disparado por captura confirmada, daño operativo grave atribuible, falla persistente sin path de corrección.
Transparencia
- Dashboard público con KPIs actualizado trimestralmente.
- Datos abiertos en formatos machine-readable.
- Auditoría externa anual con publicación íntegra.
- Mecanismo ciudadano de impugnación de cifras.
Stack técnico
- Blueprint y contenido: Markdown con frontmatter YAML.
- Agentes: Python + Anthropic SDK (Claude Opus 4.7), Pydantic, asyncio.
- Portal: Astro static + Vercel.
- Tests: pytest (90+ tests, mocks de Anthropic).
- Observabilidad: JSONL logs append-only, cost tracker, audit trail.
Open source
Todo el código del sistema de agentes y herramientas es liberado bajo licencia abierta. El contenido del blueprint es liberado bajo CC BY-SA salvo secciones con consentimiento comunitario específico restrictivo.