cambios profundos

docs/explicacion.md

@@ -1,14 +1,18 @@
 # Forja explicado de principio a fin
 
+> **Nota de estado (mayo 2026):** Este documento fue escrito para la arquitectura
+> anterior (dos servicios + Streamlit/NiceGUI). Forja ahora es un **único servicio
+> FastAPI** con UI HTMX embebida. El núcleo (runtime, guardrails, HITL, versionado)
+> sigue siendo el mismo. Algunas secciones de UI y despliegue están desactualizadas.
+>
+> Si solo quieres arrancarlo, ve al [`README.md`](../README.md).
+
 > **Para quién es esto.** Una guía didáctica para alguien que llega nuevo al
 > proyecto —técnico o no— y quiere entender *qué hace*, *por qué está hecho así*
 > y *cómo encajan las piezas* sin tener que leer todo el código primero.
 >
-> Si solo quieres arrancarlo, ve al [`README.md`](../README.md). Si quieres las
-> decisiones técnicas en bruto, ve a [`ARCHITECTURE.md`](../ARCHITECTURE.md). Si
-> quieres la referencia de cableado a bajo nivel (módulos, firmas, grafos de
-> dependencias, cadenas de llamada), ve a [`docs/componentes.md`](componentes.md).
-> Este documento está en medio: cuenta la historia.
+> Decisiones técnicas: [`ARCHITECTURE.md`](../ARCHITECTURE.md).
+> Cableado de bajo nivel: [`docs/componentes.md`](componentes.md).
 
 ---