FDN

Antes del código, la fundación.

Una app que se abre en tu navegador para modelar tu negocio con tu agente de IA: historias, reglas que se ejecutan y escenarios que las prueban, guardados en tu git. Cuando el modelo no deja dudas, el código sale exacto.

Ver en GitHub npm
NegocioIngenieríaOperacionesAgentes de IA
un solo modelohistorias · reglas · escenarios · en tu git
el problema

Lo difícil es que negocio, ingeniería y operaciones hablen el mismo idioma.

Cada quien tiene su versión

En la cabeza, en el código, en un manual o en el chat del agente.

La ambigüedad llega a producción

Lo que nadie decidió se decide en un if.

Los post-its se quedan en la foto

El event storming no se ejecuta ni se revisa.

cómo es trabajar con fdn

Tú y tu agente, sobre el mismo modelo.

Negocio, ingeniería y operaciones trabajan juntos, cada quien con su agente preferido.

FDN · Gastos de viaje
Jefe
Autorizar viaje
Viaje
Viaje autorizado
¿Lo autoriza cualquier jefe?

agenteNada dice quién es el jefe del viaje: cualquiera podría autorizarlo. Te dejé una propuesta.

Autorizar viaje require estatus = enviado require actor = jefe del viaje Aplicar

túTiene sentido. La apruebo.

actorcomando: lo que se pideagregado: lo que guarda y decidehecho: lo que pasópregunta abierta

Tu agente propone cambios en FDN a través de MCP, el protocolo con el que los agentes de IA usan herramientas. Tú los revisas y decides cuáles se aplican.

las capas

Tres capas sin ambigüedad. La cuarta la escribe tu agente.

1

Historia

Event storming: lo que pasa en el negocio, en orden, en post-its.

2

Dominio

DDD: las reglas de cada parte del negocio. Un motor las ejecuta, así que los escenarios Given, When, Then corren sin una línea de código.

3

Contratos

La forma exacta de lo que entra y sale, agnóstica a la tecnología.

4

Código

Lo escribe tu agente, en tu lenguaje, con las reglas de construcción que FDN le da: sin decisiones a medio camino, y cada pieza marcada con el id del modelo que la hace nacer. fdn trace comprueba que nada falta ni sobra, y fdn verify corre los mismos escenarios contra tu código: si dice otra cosa que el modelo, falla.

// fdn: rule 01J9…3QK «require actor = jefe del viaje» · rechazo NoEsElJefe if (approver.id !== trip.bossId) throw new NotTheBoss();
empieza

Tres pasos para empezar.

Instala

Node 22.18 o posterior.

npm install -g @fdn-dev/cli

Abre FDN

En la carpeta que contiene tus repositorios. Se abre en tu navegador, y cada repositorio guarda su modelo en .foundation/, legible y con su diff en cada PR.

fdn --open

Conecta tu agente

Cualquier cliente MCP, en http://127.0.0.1:4848/mcp. Con Claude Code:

claude mcp add --transport http fdn http://127.0.0.1:4848/mcp

Con un servidor del equipo, negocio y operaciones entran desde el navegador, sin instalar nada. Con agente o sin él: también puedes modelar directamente en FDN.

preguntas

Lo que suelen preguntar.

¿Las personas de negocio necesitan git o la terminal?

No. Ingeniería instala FDN una vez en un servidor del equipo; negocio y operaciones entran desde el navegador con la cuenta de su empresa, y su agente se conecta al mismo lugar. Lo que aprueban llega a git como commits, e ingeniería lo revisa en un PR.

¿Necesito saber DDD o event storming?

Ayuda, pero no es requisito. Tu agente modela contigo y FDN revisa el modelo en cada cambio: te dice, en el lenguaje del negocio, qué falta o qué no cuadra.

¿Sirve en un proyecto que ya tiene código?

Sí. El modelo vive aparte, en .foundation/ del mismo repositorio, y no toca tu código. FDN no deduce el modelo del código que ya tienes: se modela a partir de las historias del negocio.

¿Qué agentes funcionan con FDN?

Cualquier cliente MCP: por HTTP en http://127.0.0.1:4848/mcp, o por stdio con fdn mcp si tu cliente no se conecta por HTTP. FDN no trae IA propia ni cobra por usarla.

¿Mi modelo sale de mi máquina?

No. FDN corre en tu máquina, el modelo vive en tu git y FDN no envía telemetría. Tu agente solo propone: aplicar un cambio lo decide una persona.

¿Qué me queda si dejo FDN?

Tu modelo: un archivo JSON legible por contexto dentro de .foundation/, con su historial en git. Es tuyo y se lee sin FDN.

¿En qué se diferencia de una especificación en Markdown o de Gherkin?

Una especificación en Markdown la lee tu agente una vez, y nadie comprueba que el código la siga. Gherkin describe escenarios, pero no tiene un modelo que los ejecute. En FDN el modelo se ejecuta: los escenarios pasan o fallan antes de que exista el código, FDN avisa en cada cambio lo que deja de cuadrar, y después fdn verify corre los mismos escenarios contra tu código.

¿En qué estado está?

Antes de su primera versión, que sale cuando las cuatro capas estén listas. La documentación y las capturas de la interfaz llegan con ella.

Antes del código: FDN.