¿Qué es Project Builder?

Project Builder les da a los desarrolladores, y a los agentes de IA que trabajan junto a ellos, generación de código determinista. Un prompt produce algo distinto en cada ejecución; un schematic, un programa de mutación de archivos tipado y testeable, produce los mismos archivos, byte por byte, cada vez. Tú (o tu agente) codificas el cambio una vez, y a partir de ahí ejecutas ese programa en lugar de revisar la salida generada.

Construido para complementar a la IA

Como artesanos del software queremos construir software de calidad, y la calidad empieza con código predecible y repetible. La IA es una colaboradora capaz, pero su salida es variable: la misma petición produce código distinto en cada ejecución. Project Builder está diseñado para complementar esa variabilidad. Deja que la IA decida qué construir, y deja que un schematic haga determinista el cómo.

Ese determinismo mantiene consistente el código generado y ahorra tiempo y dinero:

Cada servicio, componente o módulo generado por un schematic sigue la misma estructura y las mismas convenciones, así que lo que la IA produce el viernes no se desvía de lo que produjo el lunes.
Un cambio codificado una vez se ejecuta en milisegundos en cada ejecución. No gastas tokens en regenerarlo ni ciclos de revisión en volver a validar una salida que nunca debió cambiar.

Los schematics también crecen con tu base de código y con tu equipo. Cada patrón que codificas se convierte en un bloque de construcción reutilizable y versionado que los nuevos integrantes del equipo, humanos o agentes, pueden ejecutar desde el primer día.

¿Qué es un schematic?

Un schematic es un paquete pequeño que vive en tu repositorio. Tiene tres archivos:

schema.json: las entradas tipadas del schematic, el contrato con quien lo ejecuta.
schema.generated.ts: un tipo Input generado a partir del schema, para que tu código quede tipado contra el contrato y no contra una forma escrita a mano.
factory.ts: tu lógica de autoría, una función que recibe la entrada tipada y programa mutaciones de archivos, como crear archivos, editar contenido y generar carpetas enteras de plantillas.

Una vez registrado, lo ejecutas con builder execute <collection>:<schematic>, pasando las entradas como flags de la CLI. Como un factory es simplemente una función tipada, también puede ejecutarse por completo en memoria con el harness de testing, sin la CLI ni el disco. Eso es lo que hace que los schematics sean testeables como cualquier otro código. Consulta Tu primer schematic para el recorrido de punta a punta.

La maquinaria (la conversación SDK–engine, los registros de instrucciones y la historia de los AST) tiene una página propia.

Principios de diseño que sentirás como usuario

Idempotencia. Los factories se vuelven a ejecutar contra proyectos ya generados, así que las mutaciones se escriben para ser seguras al repetirse: lee el árbol primero y luego crea o actualiza, y omite la edición cuando tu marcador, import o entrada ya está presente.
Fail-closed (ante un conflicto, se rechaza la escritura en lugar de sobrescribir). Los verbos que escriben en una ruta nueva (create, rename, move, copy, copyIn, scaffold) rechazan la operación al colisionar con una ruta existente; sobrescribir es siempre una decisión deliberada mediante force: true.
Ejecuciones de todo o nada. Nada toca el disco mientras tu factory corre. Si lanza un error antes de retornar, no se escribe absolutamente nada, y tu árbol queda exactamente como estaba.

Por dónde seguir

Cómo funciona

La conversación SDK–engine, el flush y el puente agnóstico del lenguaje: Cómo funciona.

Instálalo

Deja listos la CLI builder y Bun en un par de comandos: Instalación.

Crea tu primer schematic

De builder init a un generador idempotente en funcionamiento: Tu primer schematic.

¿Estás evaluando Project Builder en un repositorio existente? Puedes probarlo sin agregar el SDK a package.json. Consulta Evaluar sin adoptar el SDK.