empirica se ejecuta dentro de tu herramienta de IA para programar como plugin y como herramienta de línea de comandos. Mantiene un registro de lo que la IA aprende y hace, y obliga a la IA a seguir una regla simple: entender antes de actuar. Todo se queda en tu máquina.
Pensar antes de actuar, sin excepciones
Antes de que la IA pueda cambiar un archivo o ejecutar un comando, tiene que demostrar que entiende el trabajo. Un control lo impone, así que es el sistema el que marca el límite, no las buenas intenciones de la IA.
Un registro que puedes auditar
Los hallazgos, las decisiones y los callejones sin salida se registran con su confianza a medida que avanza el trabajo. Puedes mirar atrás y ver qué sabía, qué asumió o en qué se equivocó la IA, en cualquier punto.
Confianza contrastada con la realidad
Después de cada tarea, la visión que tiene la IA de cómo lo hizo se compara con evidencia real: si pasaron las pruebas, si se cumplieron los objetivos. La brecha entre la creencia y el resultado es la señal que la mantiene honesta con el tiempo.
Cómo se estructura el trabajo
empirica le da forma a una pieza de trabajo. Un plan se divide en transacciones, pequeños fragmentos medidos, cada uno con sus propios objetivos y las tareas que los cumplen. Dentro de cada uno, la IA ejecuta el mismo bucle breve antes de que se publique nada.
Un plan, dividido en fragmentos medidos
El trabajo se descompone en unidades pequeñas y autocontenidas. Cada una abre con una intención declarada y cierra con una medición, así que el progreso es algo que puedes ver por partes, no un gran acto de fe.
Objetivos y tareas, no intuiciones
Cada fragmento nombra sus objetivos y los divide en tareas concretas. Una tarea cierra con evidencia, un commit o una prueba que pasa o un archivo, así que «hecho» significa algo verificable, no una sensación.
Investigar, luego actuar, con un control sobre la confianza fundamentada
Dentro de cada fragmento, la IA investiga primero: lee, busca y registra lo que aprende. Solo puede pasar a cambiar cosas cuando su confianza está fundamentada en lo que encontró, no en una suposición. Ese control es el Sentinel.
Medido al cierre
Cuando el fragmento está listo, la IA vuelve a comprobar su propio estado y el cambio se evalúa frente a evidencia real. La brecha entre lo que esperaba y lo que ocurrió es lo que afina su calibración la próxima vez.
empirica funciona en una sola máquina, para un solo practicante. Compartir lo que aprende entre proyectos y compañeros de equipo es tarea del producto alojado, no del framework gratuito. El framework es la base. La capa compartida se construye encima.
Primeros pasos
empirica se ejecuta dentro de Claude Code y herramientas de IA de terminal compatibles.
# Instala el framework y la CLI
pip install empirica
# Configura el plugin, los hooks y el control para Claude Code
empirica setup-claude-codeTambién disponible vía Homebrew y Chocolatey. Consulta el repositorio para las versiones actuales y la configuración completa.