AWR es una plataforma de código abierto para la entrega de proyectos entre personas e IA. Conecta objetivos, líneas de trabajo, dependencias, contexto y aceptación en un único flujo de entrega de proyecto, de modo que un proyecto pueda avanzar desde un objetivo acordado hasta una entrega verificada, incluso cuando el trabajo se reparte entre varios agentes, sesiones y colaboradores.
AWR está pensado para dos situaciones que comparten el mismo problema de fondo:
- Una persona que coordina varios agentes en un proyecto complejo.
- Un equipo que entrega un proyecto compartido, empezando por proyectos de software complejos.
En ambos casos, las personas marcan la dirección y revisan los resultados; los agentes hacen el trabajo. AWR conecta su trabajo con el mismo estado del proyecto a través de su CLI y su servicio MCP.
El problema que resuelve AWR
Cuando trabajas con agentes de programación con IA, el conocimiento del proyecto suele vivir en la conversación privada del agente. Cuando la sesión termina, el modelo cambia, o una persona o agente distinto retoma el trabajo, ese contexto desaparece. Los esfuerzos en paralelo divergen y «terminado» significa lo que el último agente dijo que significaba.
AWR está diseñado en torno a lo que debería ser cierto en su lugar:
- Cambiar de sesiones, modelos o colaboradores preserva el proyecto. Los objetivos, las restricciones y el progreso verificado sobreviven al traspaso. Un sucesor recibe el contexto requerido de la tarea actual y su punto de control, de modo que el proyecto puede continuar entre sesiones y agentes.
- El trabajo en paralelo tiene propiedad y traspasos claros. Las líneas de trabajo independientes (por ejemplo frontend, backend y pruebas) mantienen sus propias tareas, contexto y propiedad mientras comparten las restricciones del proyecto.
- «Terminado» es verificable. Las declaraciones de finalización se conectan con evidencia vinculada a una versión. La implementación, la verificación, la fusión y la publicación se registran como hechos separados, no colapsados en una sola afirmación.
- El esfuerzo es visible. En cada etapa puedes saber qué está listo, qué está esperando, qué ha sido verificado y a dónde fue el esfuerzo.
En resumen: AWR preserva la continuidad del proyecto a través de ventanas de contexto finitas. La ventana de contexto de un agente es limitada, y la compactación (cuando un host acorta la conversación para que quepa) es tarea del host: en su lugar, los puntos de control de AWR transportan los hechos registrados del proyecto.
Cómo funciona: tus archivos siguen siendo la fuente de verdad
La arquitectura de AWR tiene tres partes:
- Tus archivos contienen la intención. Archivos Markdown y YAML en tu proyecto describen objetivos, planes, trabajo, restricciones y decisiones. AWR indexa estas fuentes sin reemplazarlas silenciosamente.
- AWR mantiene la continuidad. El estado local (un proyecto SQLite) contiene proyecciones de esas fuentes, además de sesiones, reservas, puntos de control y evidencia. La compilación de contexto — reunir los objetivos, reglas, dependencias y evidencia relevantes para la tarea actual — se ejecuta localmente y no hace llamadas a ningún modelo. Los controles de revisión protegen las escrituras contra estado obsoleto.
- Las personas y los agentes hacen el trabajo. La CLI y el servicio MCP conectan los hechos del proyecto con el host que uses. Los agentes aportan sus propios modelos, herramientas y conversaciones; los cambios revisados y el progreso regresan a las fuentes del proyecto.
Como los puntos de control registrados solo transportan hechos registrados, no reconstruyen el historial de conversación no registrado de un agente: eso sigue siendo responsabilidad del host.
Las piezas y cómo encajan
Interactúas con AWR a través de dos puntos de entrada, ambos instalados desde el mismo paquete:
- La CLI
awr— inicializa un proyecto, inspecciona el estado y dirige el flujo de sesión explícito: reserva una pieza de trabajo, obtén su contexto enfocado y guarda un punto de control antes de detenerte. Cualquier agente que pueda ejecutar comandos de shell puede usarla. - El servicio MCP
awr-mcp— expone el mismo estado del proyecto como herramientas MCP (MCP, el Model Context Protocol, es la forma en que los clientes de IA llaman a herramientas externas). Un cliente se conecta a un único proyecto por stdio, o a un servicio MCP HTTP compartido que atiende a varios clientes y proyectos.
Sobre estas piezas, AWR admite el agente con el que ya trabajas. Las integraciones vienen en capas:
- Contrato genérico (predeterminado, totalmente soportado). Cualquier host que pueda ejecutar una CLI o hablar MCP usa el mismo estado del proyecto a través del flujo de sesión compartido. Esto incluye Claude Code, Cursor, Windsurf y hosts similares: no se necesita ningún instalador especial.
- Notas por host. Para algunos hosts (Cursor, Kimi Code, Grok Build) AWR documenta las rutas exactas de fusión de configuración y las banderas de sesión nativas, verificadas contra una versión fechada del host. Estas notas no añaden funciones en tiempo de ejecución.
- Adaptador de ciclo de vida opcional. Donde los hooks nativos de ciclo de vida de un host son estables, un adaptador puede activar puntos de control de AWR a partir de eventos del host. Hoy esto existe para Codex. Un adaptador nunca convierte a AWR en el runtime de ese host.
Para una persona que coordina varios agentes, se aplica la misma disciplina de dependencias, revisión y contabilidad que para un equipo más grande: es un solo modelo de proyecto, no dos productos.
Qué NO es AWR
AWR está delimitado deliberadamente. Es un runtime de trabajo agnóstico del host, y su frontera de producto es el contrato compartido de CLI/MCP, no un editor o agente concreto.
- AWR no es un agente de IA. No selecciona, inicia ni configura un agente de programación. Los agentes aportan sus propios modelos, herramientas y conversaciones; las cadenas de proveedor y modelo que almacena AWR son etiquetas de visualización únicamente.
- AWR no es un editor, una interfaz de chat ni un proveedor de modelos. La interfaz del agente, los identificadores de conversación nativos y la compactación pertenecen al host.
- AWR no reemplaza los archivos de tu proyecto. Las fuentes Markdown/YAML siguen siendo la autoridad; el estado local de AWR es un índice más registros de continuidad, y no debe reemplazar silenciosamente tus fuentes.
- AWR no está atado a un solo transporte. Que MCP funcione por stdio, HTTP o esté ausente es elección del host; si un host no tiene hooks nativos, guardas puntos de control manualmente a través de la CLI.
- AWR no aísla físicamente las líneas de trabajo. El aislamiento de líneas de trabajo cubre el estado del proyecto y las operaciones soportadas; el aislamiento físico de procesos depende del host de ejecución.
Alcance actual: versión publicada frente a desarrollo
AWR es honesto sobre lo que está publicado frente a lo que se está construyendo. Los paquetes CLI/MCP 0.5.1 publicados proporcionan:
- Objetivos y tareas respaldados por fuentes, con navegación de dependencias
- Compilación de contexto enfocado para la tarea actual
- Reservas de sesión y puntos de control
- Evidencia vinculada a una versión
- Un servicio MCP HTTP compartido para varios clientes y proyectos
- Intercambio de archivos de Personal Workspace
- Una base de líneas de trabajo personales: propiedad explícita de las fuentes, atribución de sesiones y contexto acotado en un proyecto SQLite local
Esta versión no proporciona un servicio Team autenticado ni aislamiento completo entre clientes. Aún en desarrollo en main:
- Adopción versionada de entregas entre líneas de trabajo (vincular el trabajo posterior a un artefacto aceptado y a una versión de contrato; revisar de nuevo los consumidores cuando cambie)
- Colaboración en equipo y revisión de entregas (registros explícitos de revisor y aprobación)
- Contabilidad de uso, tiempo y ETA por línea de trabajo
Las notas de versión de cada versión publicada definen la frontera real del paquete.
Qué significa esto para ti
Si estás evaluando AWR: conservas tu agente actual y tus archivos actuales. Inicializas AWR en tu proyecto, le das a tu agente un acuerdo de trabajo y, a partir de ahí, cada sesión empieza desde objetivos, reglas, dependencias y puntos de control registrados en lugar de desde cero. Puedes inspeccionar el progreso en cualquier momento.
Si lo adoptas en un equipo: la misma base de CLI/MCP se extiende hacia la entrega y revisión compartidas a medida que esas capacidades se publiquen; la versión publicada ya te da el núcleo para un solo usuario y varios agentes.
A dónde ir después
- Quickstart — instala AWR, conecta un proyecto y ejecuta tu primera sesión.
- Conceptos — el modelo de proyecto en detalle: objetivos, líneas de trabajo, sesiones, reservas, puntos de control y evidencia.
- CLI y servicio MCP — los dos puntos de entrada en profundidad.
- Integraciones de agentes — conecta el agente que ya usas.