Deja de improvisar con la IA. Construye lo que quedó escrito.

Un asistente de IA escribe código más rápido de lo que nadie puede revisarlo. El problema no es la velocidad: es que nadie dejó escrito qué se pidió. Sin eso, cada sesión empieza de cero y el asistente llena los huecos con lo más probable.

Nada de esto se arregla con un mejor prompt. Se arregla cambiando qué manda: no la conversación, sino un documento que tú apruebas.

En Fabrik OS, el spec de una tarea es un contrato que se puede comprobar. Cada requisito tiene un identificador y criterios de aceptación; el plan dice qué tarea cubre qué requisito; y cada requisito termina respaldado por un test o por una evidencia registrada.

Se instala una vez como plugin de Claude Code y se usa en cada proyecto. Estos son los comandos, en el orden en que los vas a usar.

1. 1/fabrikos:quickstart

   De tu idea a un backlog

   Cuentas la idea con tus palabras y respondes solo lo que falte. Confirmas dos cosas: el documento de producto y un backlog inicial que sale de tu propio alcance. Para un proyecto que ya existe, /fabrikos:init.

2. 2/fabrikos:discover

   Opcional: ordenar el negocio

   Propuesta de valor, usuarios, alternativas, modelo de ingresos y dirección visual. Separa lo que sabes de lo que supones, y no inventa un mercado.

3. 3/fabrikos:refine

   Una tarea se vuelve spec

   El asistente pregunta en un solo bloque, recorre los casos borde y escribe requisitos que se pueden comprobar. Tú apruebas.

4. 4/fabrikos:start

   La tarea empieza, con su rama

   Solo arranca una tarea aprobada. Antes de tocar código se escribe el plan: tareas pequeñas, cada una con los requisitos que cubre.

5. 5/fabrikos:execute

   El plan se ejecuta

   Las tareas que el plan declara independientes corren en paralelo; las demás, en secuencia. Un commit por tarea, verificada y revisada. Ante un conflicto, se detiene y pregunta.

6. 6/fabrikos:finish

   Se cierra con evidencia

   Comprueba que cada requisito tenga su test, ejecuta las revisiones que apliquen y deja la tarea lista para que una persona la revise.

7. 7/fabrikos:launch-check

   Antes de salir a producción

   Junta todas las revisiones en una recomendación: listo, listo con riesgos aceptados, o no listo. No despliega nada.

Si tu equipo gestiona el trabajo en Azure DevOps, los mismos comandos leen y escriben los work items. Si no, el backlog vive en un archivo del repositorio.

Cuatro listas de comprobación acompañan el ciclo. Cada punto se responde con una de cuatro cosas: cumple, no cumple, no aplica y por qué, o pendiente. Varias se apoyan en reglas que leen tu código y señalan candidatos.

Todo esto se instala con el plugin. No instala nada dentro de tu proyecto ni elige tu stack.

10

Comandos

Los del ciclo, más diagnóstico de la instalación y migración del backlog.

14

Skills

Refinamiento, trazabilidad, ejecución, seguridad, datos, accesibilidad, lanzamiento y documentos legales en borrador.

23

Plantillas

Producto, spec, plan, backlog, listas de comprobación, políticas y términos en borrador.

4

Hooks

Avisos y un bloqueo que funcionan solos, sin que nadie se acuerde.

2

Subagentes

Un implementador que trabaja en una copia aislada, y un revisor sin herramientas de edición.

Prefiero decirlo antes de que lo instales.

Esta es la estructura de un spec de Fabrik OS, reducida a lo esencial. Úsala hoy, con o sin el plugin: copia la plantilla, llénala con tu próxima tarea y pídele al asistente que no escriba código hasta que digas que está aprobada.

# Diseño: <título de la tarea>

Estado: En revisión

## Contexto
Qué problema origina esta tarea y qué existe hoy.

## Alcance
- Lo que esta tarea entrega.

## Fuera de alcance
- Lo que no entrega, aunque alguien podría esperarlo.

## Datos personales
¿Crea, lee, guarda, muestra o envía datos de personas? Si no, por qué.

## Interfaz
¿Alguien verá una pantalla nueva o cambiada? Qué se ve vacía,
cargando, con error, con éxito y sin permiso.

## Requisitos

### LOGIN-R1 — Entrar con correo y contraseña
- CA1. Dado un usuario registrado, cuando escribe su correo y su
  contraseña correctos, entonces entra y ve su panel.
- CA2. Dado un correo que no existe, cuando intenta entrar, entonces
  ve "Correo o contraseña incorrectos" y no se dice cuál falló.

## Criterios de finalización
Cada criterio tiene un test que pasa.

## Preguntas abiertas
Ninguna. (Con una sola pregunta abierta, el spec no se aprueba.)

El plugin hace esto mismo con más rigor: identificadores que los tests citan, casos borde recorridos uno por uno, un plan que cubre cada requisito y una verificación que no deja cerrar con huecos.