01
Descubrir
Entender el problema antes de escribir código.
Framework de agentes con humano en el loop
La IA hace el trabajo. Vos decidís lo que importa.
Lexis-Two es un framework abierto para flujos de agentes donde la IA planifica, construye y revisa — mientras el humano conserva el control de las decisiones críticas.
$
npx @draig/lexis-two install HUMANO / INTENCIÓN Definís el objetivo y los límites.
01 / DESCUBRIR Entender el problema.
02 / PLANIFICAR Definir la solución más chica.
03 / CONSTRUIR El agente ejecuta una porción.
04 / REVISAR Chequear contra la intención.
05 / CHECKPOINT HUMANO Aprobás, modificás o rechazás — y sigue.
LOOP DE AGENTE / ESPERA DECISIÓN HUMANA ↻ vuelve a 01 en la próxima vuelta
El problema
Autónomo no tiene por qué ser sin supervisión.
Los agentes ya pueden planificar, escribir, revisar y operar herramientas. La pregunta no es si pueden actuar solos, sino en qué punto del sistema tiene que entrar el criterio humano.
SIN UN LOOP CONTROLADO
Humano →Prompt →Agente →Resultado
CON LEXIS-TWO
Intención →Loop de agentes →Checkpoint humano →Resultado
El principio
Los humanos no necesitan supervisar cada paso. Necesitan ser dueños de los importantes.
El loop de Lexis-Two
Un flujo diseñado alrededor de decisiones.
Estructura el trabajo de los agentes en etapas explícitas, para que el sistema sepa qué hacer, qué revisar y cuándo involucrar a un humano.
02
Especificar
Definir la solución mínima válida.
03
Construir
El agente ejecuta una tarea y se detiene.
⏸ espera tu OK
04
Revisar
Chequear la implementación contra la intención.
01
Descubrir
Igual: define el MVP antes de especificar.
02
Especificar
Genera spec y tareas sin pausa intermedia.
03
Construir todo
Ejecuta la lista completa de una corrida, acotado por Discovery.
sin pausa
04
Revisar al final
Una sola revisión sobre todo el lote antes de cerrar.
Checkpoint humano
El agente sabe cuándo parar.
No todas las acciones necesitan aprobación. Las decisiones críticas, sí. Acá el humano pasa de supervisor a quien decide.
AGENTE / IMPLEMENTACIÓN ● EN PAUSA
Encontré dos enfoques válidos para esta feature.
OPCIÓN A
Usar la API nativa de la plataforma. Sin dependencia nueva. Implementación más chica.
OPCIÓN B
Agregar una librería de modales. Menos código propio, pero suma una dependencia.
Recomendación: OPCIÓN A
✓ Decisión registrada. El agente retoma…
Arquitectura de agentes
Un loop. Varios agentes especializados.
Separá responsabilidades sin perder un flujo compartido. Cada rol tiene permisos explícitos — los auditores son de solo lectura por diseño.
CONTROL HUMANO / LOOP
lexis-one escribe Implementa, edita, corre bash dentro del gate.
lexis-review solo lectura Evalúa cambios contra la spec. Nunca edita.
ui-architect solo lectura Asesora sobre diseño. No implementa.
refactor-agent escribe Reestructuración a gran escala, dentro de una tarea acotada.
security-auditor solo lectura Corre auditorías. Reporta, no corrige.
design-auditor solo lectura Detecta desliz visual de IA genérica. Solo puede escribir DESIGN-AUDIT.md.
Principios de ingeniería
Los agentes necesitan límites, no más prompts.
Lexis-Two inclina el loop hacia soluciones más simples, chicas y mantenibles.
Construí lo necesario.
No metas funcionalidad antes de que haya una necesidad concreta.
Preferí el camino simple.
Usá capacidades nativas antes que sumar una abstracción.
Una sola fuente de verdad.
Evitá conocimiento duplicado e implementaciones paralelas.
Límites explícitos.
Responsabilidades claras, interfaces mantenibles.
Escalera de decisión
Antes de sumar código, preguntar si el código debe existir.
01
YAGNI ¿Necesita existir?
02
Plataforma ¿La plataforma ya lo resuelve?
03
Dependencia existente ¿El proyecto ya lo provee?
04
Código mínimo ¿Cuál es la implementación más chica que funciona?
Comandos explicados
/lexis, /specx y /desx no son lo mismo.
Cada comando controla una capa distinta del flujo.
/lexis Intensidad Cambia qué tan agresivamente el ruleset frena al agente. Para trabajo diario lean, refactors o apagar reglas.
/specx Specs Ciclo dirigido por specs para features de 3+ archivos: propuesta, plan, implementar una tarea por vez, revisar, cerrar.
/desx Diseño Auditoría de diseño de solo lectura después de UI. Detecta slop visual y deriva de tokens, y aplica fixes fuera del loop de specs.
Prueba en el loop
El agente no solo escribe código. Lo cuestiona.
Una decisión representativa: usar una capacidad nativa del navegador en vez de sumar una abstracción.
SIN LEXIS 74 líneas
function Modal({ open, onClose, title, children }) {
useEffect(() => {
document.addEventListener("keydown", onEscape);
document.body.style.overflow = "hidden";
return () => { /* cleanup */ };
}, [open]);
return createPortal(
<div className="modal-overlay" onClick={onClose}>
<div role="dialog">
<h2>{title}</h2>
{children}
</div>
</div>,
document.body,
);
} CON LEXIS 24 líneas
// lexis: <dialog> nativo — focus trap
// y backdrop ya incluidos
<dialog ref={dialogRef}>
<h2>Confirmar borrado</h2>
<form method="dialog">
<button value="cancel">Cancelar</button>
<button value="confirm">Borrar</button>
</form>
</dialog> El agente eligió la plataforma antes que la librería — sin que nadie se lo pidiera vuelta a vuelta.
Portable por diseño
Usá el agente que ya tenés.
Lexis-Two no reemplaza al agente que usás hoy. Le da una forma compartida de trabajar.
OpenCode
Claude Code
Cursor
Codex
Gemini CLI
Copilot
Agnóstico por diseño
La misma filosofía. Tu stack, tu host, tu agente.
Lexis-Two no te ata a un framework, a un editor ni a un orquestador. El core queda universal; lo específico se detecta por tarea y por host.
Stack
Agnóstico de stack
La filosofía vive en AGENTS.md. Las convenciones viven en stacks/<id>.md y se detectan desde los archivos de la tarea — Node/TS shipped, Python/Go/Rust/Astro planificados.
Host
Agnóstico de host
Un catálogo skills/ y adaptadores delgados para OpenCode, Claude Code, Cursor, Codex, Gemini CLI, Copilot, pi y AGENTS.md plano.
Agente
Agnóstico de agente
Un ruleset portable, no un lock-in de producto. Cualquier agente que lea instrucciones puede seguir el loop sin un orquestador privado.
Con números, no solo promesas
Lo que cambia cuando el loop tiene disciplina.
Benchmark OpenCode Go, mediana de LOC en 5 tareas de código, 3 corridas por celda.
−68%
reducción de LOC vs baseline
9
casos antes/después documentados — Next.js, Express, FastAPI
9
hosts con soporte completo
Resultados de una corrida — específicos por modelo y tarea, no una promesa universal.
La dirección
De reglas a orquestación.
Lexis-Two es la base portable de hoy. La dirección de largo plazo es una capa de orquestación programable para flujos humano + agente.
HOY
Lexis-Two
Principios, skills, comandos, adaptadores y loop de agentes estructurado.
PRÓXIMO
Lexis-Core
Orquestación, estado, coordinación de agentes, contexto compartido y checkpoints humanos configurables.
VISIÓN
Sistemas de agentes
Una capa programable para flujos inteligentes que saben cuándo actuar y cuándo preguntar.
¿Y si el agente pudiera trabajar hasta que se necesite tu criterio?
El objetivo no es la autonomía máxima. Es autonomía útil, con control humano explícito en los momentos que importan.
Empezá
Arrancá con el agente que ya usás.
npx @draig/lexis-two install