Protocolo Andamio

Cómo hacer que cualquier IA lea tu contexto, trabaje, y te devuelva lo aprendido.

La idea en una línea: tu conocimiento vive en celdas fijas, no en texto suelto. Así se puede ver lo que falta — y lo que falta es exactamente lo que la IA te tiene que preguntar.

1. La matriz

Cada proyecto guarda lo que se sabe en 10 celdas fijas, agrupadas en 4 bloques. Todo hecho entra en una de estas:

QUÉ ES

Celda	Qué va aquí
`definicion`	Qué es esto en una línea, para alguien que nunca lo escuchó
`objetivo`	Cómo se ve el éxito, con número o fecha si se puede

DÓNDE ESTÁ

Celda	Qué va aquí
`estado`	Dónde está parado hoy, qué ya existe y funciona
`activos`	URLs, archivos, cuentas, accesos, datos que ya existen
`personas`	Quién es quién, su rol y cómo se le contacta

QUÉ SE APRENDIÓ

Celda	Qué va aquí
`decisiones`	Qué se decidió y por qué, para no rediscutirlo
`aprendizajes`	Qué se intentó y no funcionó, y por qué falló

QUÉ FALTA

Celda	Qué va aquí
`bloqueos`	Qué está frenando esto ahora mismo
`proximos`	La siguiente acción concreta, no una intención vaga
`preguntas`	Lo que todavía no sabemos y hay que averiguar

Regla de oro: un hecho = una línea corta y autocontenida. Nada de párrafos. Si no cabe en una línea, son dos hechos.

2. Leer el contexto

GET https://dnvrvdwnwfngopvnipzc.supabase.co/functions/v1/andamio-api?token=TU_TOKEN

Parámetro	Qué hace
`&huecos=1`	agrega la lista de celdas vacías de cada proyecto
`&proyecto=`	trae uno solo (por nombre o id) en vez de todos
`&formato=json`	JSON crudo en vez de markdown
`&vista=protocolo`	este protocolo, ya con tu token puesto

Devuelve markdown plano: cualquier modelo lo entiende sin parsear nada.

3. Escribir lo aprendido

POST https://dnvrvdwnwfngopvnipzc.supabase.co/functions/v1/andamio-api

{"token":"TU_TOKEN","accion":"importar_md","autor":"<tu modelo>","markdown":"<el bloque>"}

El bloque va en este formato exacto. Borra las secciones donde no tengas nada real que decir.

proyecto: Nombre exacto si ya existe, o uno nuevo
categoria: personal|laboral|investigacion|salud|mejora-continua|negocio|otro
estado: activo|pausado|completado

## definicion
- Una línea de qué es esto

## objetivo
- Cómo se ve el éxito

## estado
- Dónde está parado hoy

## activos
- URLs, cuentas, accesos que ya existen

## personas
- Quién es quién y cómo se le contacta

## decisiones
- Qué se decidió y por qué

## aprendizajes
- Qué se intentó y no funcionó

## bloqueos
- Qué está frenando esto

## proximos
- La siguiente acción concreta

## preguntas
- Lo que todavía no sabemos

## tareas
- [x] tarea ya terminada
- [ ] tarea pendiente

## bitacora
- Qué se avanzó en esta sesión

Cómo se comporta al guardar:

Si el proyecto no existe se crea; si existe (match por nombre) se actualiza.
Los hechos se suman, no se pisan. Repetir un hecho idéntico no lo duplica.
Las tareas se identifican por su texto: repetir el mismo texto la actualiza, no la duplica.
La bitácora es append-only y queda firmada con el modelo que la escribió.

¿La IA no puede abrir URLs? Que entregue el mismo bloque como texto en su respuesta, y pégalo en Andamio con el botón "Pegar resumen de otra IA". Mismo resultado.

3-bis. Los encargos (despachar trabajo)

Un encargo es una unidad de trabajo autocontenida. Sirve para tirarle una tarea a cualquier IA —incluida una con créditos gratis que nunca vio tus proyectos— sin explicarle nada.

GET .../andamio-api?token=TU_TOKEN&encargo=<codigo>

Esa URL sola trae todo: qué hay que hacer, cuándo está terminado, el contexto completo del proyecto, y cómo devolver el resultado. Eso es lo único que pegas en el chat.

Paso	Quién	Qué pasa
crear	tú	defines título, instrucciones y qué esperas recibir
tomar	la IA	marca que está trabajando, para que otra no lo duplique
entregar	la IA	manda el resultado; queda en la bitácora
aceptar / devolver	tú	cierras, o lo devuelves con el motivo para que otra IA lo corrija

Protección anti-duplicado: si una IA intenta tomar un encargo que ya tomó otra, el sistema la rechaza y le dice quién lo tiene. Así repartes trabajo entre varios modelos sin que se pisen.

Lo más importante al crear un encargo: define bien cuándo está terminado. Sin eso la IA no sabe dónde parar y te devuelve cualquier cosa.

4. La secuencia de iteraciones

Cada chat con cualquier IA es una pasada sobre la matriz. Siempre en este orden:

VOLCADO

Lee el GET con &huecos=1, revisa todo lo que se habló en el chat, extrae cada hecho nuevo clasificado en su faceta, y mándalo por POST.

Barata. Hazla siempre, al final de cualquier sesión.

HUECOS

Mira las celdas vacías que devolvió el GET. Haz preguntas concretas, de a una, para llenarlas. Empieza por el bloque QUÉ FALTA. No preguntes lo que ya está guardado.

Cuesta tiempo humano. Hazla cuando haya espacio.

CONTRADICCIONES

Compara lo guardado con lo que se habló hoy. Di qué quedó obsoleto o se contradice. No lo borres tú — dilo y que el humano decida.

Al final, cuando la matriz ya tiene volumen.

El orden importa: volcado primero porque es barato, huecos después porque consume tiempo humano, contradicciones al final porque solo tienen sentido cuando ya hay masa crítica guardada.

5. Todas las acciones

Todas por POST al mismo endpoint, cambiando accion. Todas requieren token — el token identifica al dueño, cada uno solo ve y escribe lo suyo.

Acción	Campos	Para qué
`importar_md`	markdown, autor	la principal — todo de una vez
`crear_encargo`	proyecto_id, titulo, instrucciones, entregable	despachar trabajo nuevo
`tomar_encargo`	codigo, autor	la IA marca que está trabajando
`entregar_encargo`	codigo, resultado	la IA entrega el resultado
`agregar_hecho`	proyecto_id, faceta, contenido	un solo hecho en una celda
`agregar_nota`	proyecto_id, nota, autor	una línea de bitácora
`agregar_paso`	proyecto_id, texto	una tarea nueva
`marcar_paso`	paso_id, hecho	marcar tarea hecha/pendiente
`crear_proyecto`	nombre, categoria, descripcion	proyecto vacío
`actualizar_estado`	proyecto_id, estado	activo/pausado/completado

📄 Ver este protocolo en markdown crudo Esa URL es la que le pasas a una IA que prefiera markdown a HTML.