INTRODUCCIÓN

Documentación

foundry-ai es una capa de gobernanza y memoria para agentes de IA. Envuelve a Claude Code, Cursor, Codex y cualquier agente compatible con MCP — sin reemplazarlos.

Principio cero fricción: foundry-ai nunca hace llamadas LLM propias. El arquitecto vive dentro de tu agente, usando tu suscripción. Foundry solo persiste veredictos y refuerza reglas.

INICIO RÁPIDO

Instalación

terminal

$ npm install -g foundry-ai   # o pnpm / bun
$ cd mi-proyecto && fnd init
$ fnd doctor

fnd init crea .fnd/echo, registra los hooks de Claude Code y añade el servidor MCP. fnd doctor verifica que todo está conectado correctamente.

COMANDOS CLI

Referencia de comandos

fnd init Asistente de configuración. Crea el echo encriptado, hooks y MCP.

fnd daemon Daemon de larga duración: cola de hooks, socket Unix, webhooks GitHub.

fnd connect Autentica Jira, Asana o GitHub. Credenciales cifradas en .fnd/echo.

fnd spec Ciclo de vida de specs: crear, listar, avanzar estado, buscar.

fnd memory Búsqueda FTS5 sobre eventos capturados.

fnd score Snapshot del score de salud del proyecto.

fnd doctor 6 verificaciones: echo, cadena HMAC, hooks, MCP, daemon, eventos.

Para la referencia completa con flags y ejemplos, ver la documentación en inglés.

HERRAMIENTAS MCP

Servidor MCP

foundry-ai expone 10 herramientas via MCP. Cualquier agente con soporte MCP puede usarlas — Claude Code, Cursor, Codex CLI.

memory.search Búsqueda FTS5 sobre eventos capturados.

memory.recent Eventos recientes desde un timestamp unix-ms.

spec.list / get / create / set_status / set_audit Ciclo de vida completo de specs.

pm.get_ticket Ticket de Jira/Asana enriquecido con spec, memoria y gobernanza.

sentinel.sanitize Redactar secretos sin LLM ni red.

master_context.get Contexto maestro del proyecto (propósito + no-negociables).

INTEGRACIÓN PM

Conectar Jira / Asana

Conectá una vez. Todos los agentes reciben contexto enriquecido a través de pm.get_ticket.

terminal

$ fnd connect jira   # requiere API token de Atlassian
$ fnd connect asana  # requiere PAT de Asana

ARQUITECTURA

Cómo funciona

7 crates Rust. Todo gira alrededor de .fnd/echo — el único store SQLite encriptado del proyecto.

flujo de datos

Claude Code  →  fnd hook  →  .fnd/echo (eventos)
     ↕
MCP server  →  memory.* / spec.* / pm.get_ticket
     ↕
daemon  →  cola de hooks / GitHub webhooks / auto-audit