# AGENTS.md

## MAINFO Bootstrap Studio Research Engine

Este repositorio es un laboratorio de ingeniería inversa del formato `.bsdesign` de Bootstrap Studio.

**No es un proyecto de IA.**

La prioridad absoluta es comprender y reproducir el comportamiento de Bootstrap Studio de forma determinista.

---

## Objetivo del agente

El agente debe ayudar a investigar, documentar y automatizar experimentos, nunca asumir cómo funciona Bootstrap Studio.

La regla principal es:

> **Toda afirmación debe poder demostrarse mediante un experimento reproducible.**

---

## Fases del proyecto

| Fase             | Estado    |
| ---------------- | --------- |
| F0 Investigación | Activa    |
| F1 Extractor     | Pendiente |
| F2 Reconstructor | Pendiente |
| F3 Validación    | Pendiente |
| F4 Workspace     | Pendiente |
| F5 Modificación  | Pendiente |
| F6 IA            | Bloqueada |

El agente no debe proponer funcionalidades de fases posteriores salvo petición explícita.

---

## Reglas obligatorias

### 1. Nunca modificar originales

Los archivos dentro de `golden/` son inmutables.

Cualquier experimento debe trabajar sobre una copia.

### 2. No asumir el formato

Nunca afirmar que una estructura del JSON significa algo sin evidencia experimental.

Usar siempre expresiones como:

* Hipótesis
* Observación
* Verificado
* Pendiente de comprobar

### 3. Un único cambio por experimento

Cada experimento introduce **una sola variable nueva**.

Correcto:

* Añadir un párrafo
* Añadir una imagen
* Añadir una segunda página

Incorrecto:

* Añadir imagen + navbar + CSS + JS simultáneamente

### 4. Documentar antes que programar

Si un comportamiento nuevo es descubierto:

1. Documentarlo en `docs/research/`
2. Crear el experimento correspondiente
3. Actualizar los Golden Projects
4. Implementar únicamente después

### 5. Mantener determinismo

El agente nunca debe introducir:

* UUID aleatorios
* timestamps innecesarios
* nombres temporales variables
* orden no determinista de elementos

El mismo proyecto debe producir siempre el mismo resultado.

---

## Golden Projects

Los Golden Projects representan la verdad conocida del sistema.

Estructura:

golden/
├── 001-text/
├── 002-layout/
├── 003-css/
└── ...

Cada carpeta contiene:

* original.bsdesign
* exported/
* README.md

Nunca deben editarse directamente.

---

## Experimentos

Cada experimento debe contener:

experiments/
└── E001/
├── objetivo.md
├── original.bsdesign
├── exported/
├── observaciones.md
└── conclusiones.md

El agente debe completar las observaciones únicamente con hechos verificables.

---

## Convención de documentación

Estados permitidos:

* 🔴 Hipótesis
* 🟡 Observado
* 🟢 Verificado

No convertir una hipótesis en verificada sin evidencia.

---

## Qué puede hacer el agente

* Analizar JSON
* Comparar estructuras
* Generar diffs
* Documentar hallazgos
* Crear informes
* Automatizar validaciones
* Proponer nuevos experimentos

## Qué NO puede hacer

* Modificar `.bsdesign` originales
* Saltarse experimentos
* Inventar estructuras internas
* Introducir IA en Fase 0
* Eliminar Golden Projects

---

## Filosofía

Comprender → Reproducir → Validar → Modificar

La Inteligencia Artificial será una capa superior. El núcleo del proyecto debe ser completamente determinista y reproducible.