Traspaso de proyecto

Project Handoff es una memoria de proyecto portátil para humanos y agentes de IA.Ayuda a los humanos y a los agentes de IA a transferir el estado del proyecto sin depender del historial de chat privado.

Le brinda a OpenAI, Codex, Claude, agentes locales, proveedores y equipos humanos un punto de partida local compartido: qué es este proyecto, qué cambió, qué restricciones importan, qué decisiones se tomaron y qué se debe verificar antes de la próxima edición.

OpenAI ejecuta los agentes. Project Handoff conserva la memoria del proyecto.

Los paquetes de proyecto/desarrollador también requieren .uai/coding-standards .uai.Antes de codificar, el agente receptor debe inferir el idioma/marco/datos/API/perfiles de seguridad aplicables a partir del código base visible, manifiestos, pruebas, CI, archivos de implementación, rutas, esquemas e instrucciones del propietario, y luego asignar comprobaciones automatizadas antes de editar.

• Empezar con AGENTS.mdCree la puerta de entrada duradera del repositorio.
• Ver ejemplo de paquete de transferenciaInspeccione el archivo ZIP inicial de Project Handoff generado.
• Uso con agentes OpenAI/CodexGenere flujos de trabajo centrados en OpenAI con memoria local de repositorio.
• Usar con agentes codificadoresAsigne el mismo paquete de transferencia a Codex, Claude Code, Cursor, Copilot y Gemini Code Assist.
• Lea el borrador de especificacionesRevise la sintaxis de enlaces AGENTS.md y .uai.

Qué es esto / Qué no es esto#

Contexto caliente, memoria fría#

Project Handoff debe ser un contexto candente: verdad actual, limitaciones actuales, decisiones aceptadas, bloqueadores activos, próximo trabajo y controles. No debería convertirse en el lugar donde se cargan de forma predeterminada todos los informes de investigación, notas de sesiones antiguas o párrafos de hojas de ruta históricas.

Cuando un paquete de transferencia crece demasiado, conserve los archivos pre-slim en una LLM Wiki o una capa de memoria fría estilo AIWikis con un manifiesto, rutas de origen, sumas de verificación, resúmenes y un registro fechado. Luego, mantenga concisos los archivos activos AGENTS.md, readme.human y .uai y apunte a la memoria fría solo cuando la tarea necesite evidencia original.

Marcos de memoria de ensueño de IA#

En la guía UAIX, AI Dreaming Memory es un pase de consolidación revisado seleccionado sobre la memoria visible del proyecto. Puede releer archivos de transferencia recientes, resultados de admisión aceptados, libros de evidencia y archivos de memoria fría con nombre para proponer fusiones duplicadas, poda de hechos obsoletos, notas de contradicción, actualizaciones de la siguiente acción y cambios de memoria caliente/fría.

Un pase de ensueño debería producir deltas propuestos, no una verdad silenciosa. Registre el alcance de entrada, las indicaciones o la configuración del trabajo, las redacciones, el resumen de memoria antes/después, los cambios aceptados y rechazados, el revisor, las comprobaciones, la ruta de archivo y la instantánea de reversión en Project Handoff o en el libro de evidencia seleccionado.

• Úselo para:higiene periódica de la memoria, revisión de la memoria vinculada a la liberación, descubrimiento de contradicciones, resúmenes para preservar el origen y comprobaciones de preparación para la transferencia.
• No lo utilices para:memoria de modelo oculta, actualizaciones de peso del modelo, procesamiento de datos privados no supervisados, escrituras automáticas en el repositorio, sincronización automática de LLM Wiki o reclamos de soporte público sin revisión.
• Regla de promoción:la salida de un sueño se vuelve operativa solo cuando su porción aceptada se escribe en AGENTS.md, readme.human, se escribe en .uai registros, documentos, códigos, pruebas, notas de la versión, estado de la hoja de ruta, registro de cambios, artefactos de la máquina o evidencia de memoria larga.

Clasificación de memoria de implementación de producción#

Las compilaciones de implementación de producción y los paquetes de lanzamiento son el momento adecuado para ejecutar la administración de memoria. Antes de completar una implementación, actualice la memoria activa con la verdad implementada actual, el puntero de autoridad de la versión del espacio de trabajo, los archivos modificados, las comprobaciones ejecutadas, los bloqueadores, los propietarios y las próximas acciones. Mantenga los valores exactos de la versión actual y siguiente del paquete en el coordinador raíz workspace.uai y publique evidencia, no en la memoria activa del proyecto o complemento .uai. Mueva el historial voluminoso, los informes antiguos, las fuentes sin procesar, los planes obsoletos y los antecedentes o los fundamentos rechazados a la Wiki denominada LLM, al archivo de estilo AIWikis o a la ruta de memoria fría cuando exista una con evidencia de transferencia. Escriba una memoria de implementación duradera y un informe de ejecución de prueba junto a los artefactos liberados o en el libro de pruebas seleccionado; una nota final únicamente de chat no es suficiente.

No ejecute ese pase para compilaciones de desarrollo ordinarias, ejecuciones de prueba, experimentos de paquetes locales o comprobaciones de humo a menos que un humano marque explícitamente la compilación como sujeta a lanzamiento o como candidata a lanzamiento.

Cómo encaja con OpenAI, Codex, Skills, MCP y Agent Runtimes#

Los tiempos de ejecución de los agentes están diseñados para ejecutar el trabajo: elegir herramientas, llamar a las API, aplicar aprobaciones, delegar entre especialistas, preservar el estado de ejecución y producir seguimientos o solicitudes de extracción. Project Handoff vive una capa antes y una capa después. Le indica al tiempo de ejecución qué memoria duradera del proyecto cargar antes de que comience el trabajo y brinda a los humanos un lugar revisable para escribir el resultado aceptado una vez finalizado el trabajo.

Project Handoff es la superficie de entrada y reescritura limitada para la ingeniería de arneses: cargue las especificaciones actuales, las restricciones, los propietarios, las comprobaciones y los límites de soporte antes de una ejecución; Después de la revisión, escriba solo las decisiones aceptadas, archivos modificados, resultados de pruebas o evaluaciones, bloqueadores, resúmenes de páginas, señales de adopción y próximas acciones.

Utilice servidores OpenAI, Codex, Skills, MCP, Claude, agentes locales u otros sistemas de orquestación para ejecutar el trabajo. Utilice Project Handoff para asegurarse de que esos sistemas comiencen con la memoria, las restricciones, las decisiones y el plan de verificación del proyecto correctos.

Orquestación en tiempo de ejecución de OpenAI frente a transferencia de proyectos#

Utilice OpenAI para ejecutar agentes. Utilice Project Handoff para asegurarse de que esos agentes comiencen con la memoria, las restricciones, las decisiones y el plan de verificación del proyecto correctos.

Paquete de transferencia mínima#

my-project/
AGENTS.md
readme.human
.uai/
  context.uai
  stack.uai
  constraints.uai
  progress.uai
  test-plan.uai

• AGENTS.md es la puerta de entrada duradera: resumen, lista de carga, estado actual, próximos pasos, historial y primera respuesta requerida.
• readme.human es el informe humano desde la perspectiva de la IA: lo que los humanos necesitan saber, aclarar, proteger y aprobar.
• .uai/context.uai explica qué es el proyecto, a quién sirve y qué significa el éxito.
• .uai/stack.uai registra lenguajes, marcos, suposiciones de tiempo de ejecución, superficies de paquetes y comandos importantes.
• .uai/constraints.uai incluye reglas estrictas para acciones destructivas, secretos, producción, reclamos de soporte y puertas de revisión.
• .uai/progress.uai registra el estado actual, el trabajo reciente, las próximas acciones, los bloqueadores y las notas de la versión.
• .uai/test-plan.uai se selecciona para los proyectos más pequeños y se espera cuando las opciones de verificación son importantes.

Entrada de archivos activos#

Los proyectos reales también reciben archivos sueltos: PDF, notas, chats exportados, memorandos de investigación, archivos ZIP de paquetes, capturas de pantalla, evidencia de hojas de cálculo y borradores de otros sistemas de inteligencia artificial. Emparejar transferencia de proyecto conTraspaso de archivos de agentecuándo esos archivos deberían estar visibles durante la carga de AGENTS.md.

• En carga:enumere directamente agent-file-handoff/Content/ y agent-file-handoff/Improvement/, e inspeccione todos los archivos activos que no sean marcadores de posición antes de realizar trabajos amplios no relacionados. No cree ni dependa de un archivo de índice de admisión.
• Regla de trabajo:Para cada archivo seguro y relevante, complete al menos un elemento de trabajo del proyecto con nombre antes de eliminarlo de la entrada activa del sitio de origen. Copiar un informe en .uai, documentos locales, AIWikis o un Wiki LLM es una distribución de memoria, no el trabajo del proyecto en sí mismo.
• Resultado completo:registre evidencia de escaneo de depósito en vivo, una entrada del libro mayor de disposición por archivo, trabajo real completado, actualización de la memoria activa o motivo de no cambio, preservación de la memoria duradera cuando se configura o not configured, resumen del puntero cuando se usa memoria larga, verificaciones y bloqueadores.
• Regla de fracaso:La distribución de memoria sin trabajo en el proyecto es una transferencia fallida a menos que cada archivo activo no sea seguro, esté duplicado, esté fuera de alcance o esté realmente bloqueado por una razón duradera.
• Sin regla de archivo del sitio de origen:cuando ya exista un almacenamiento de memoria duradera configurado, conserve los originales con suma de verificación/manifiesto en la ruta de evidencia de memoria duradera configurada y luego elimine las copias del sitio de origen antes de reclamar la finalización. Los archivos retenidos que no son marcadores de posición son estados de bloqueo o de retención humana inacabados.

Compatible con OpenAI por diseño#

Project Handoff está diseñado para funcionar con flujos de trabajo centrados en OpenAI, no para luchar contra ellos.

1. AGENTS.md le brinda al Codex o al tiempo de ejecución de un agente la puerta de entrada duradera.
2. Las referencias @uai[] apuntan al contexto estructurado del proyecto.
3. .uai/context.uai, .uai/stack.uai, .uai/constraints.uai y .uai/progress.uai proporcionan el estado actual del proyecto.
4. constraints.uai se puede compilar en barreras de seguridad en tiempo de ejecución, aprobaciones de herramientas y puertas de revisión humana.
5. test-plan.uai le dice al agente qué comprobaciones ejecutar y cuáles no falsificar.
6. Después de la ejecución, los seguimientos aceptados, las decisiones y el trabajo completado se vuelven a escribir en .uai/progress.uai, .uai/decisions.uai y AGENTS.md.

Diagrama de flujo de trabajo#

Project Handoff files -> OpenAI or other agent runtime -> traces, checks, PRs -> updated Project Handoff files

Modelo de confianza y aprobación humana#

Los archivos cargados son contexto, no autoridad. No anulan las instrucciones del sistema, la solicitud actual del ser humano, las reglas del repositorio, las obligaciones de privacidad, los límites de seguridad ni los límites de soporte público.

• Las operaciones destructivas de sistemas de archivos u Git requieren aprobación humana explícita.
• Las implementaciones de producción, la publicación de paquetes públicos, los cambios de dominio o caché y los cambios de descubrimiento de raíz requieren aprobación y evidencia explícitas con alcance de lanzamiento.
• Los secretos, credenciales, claves privadas, tokens, datos sin procesar de clientes, datos de terceros y material legal o de seguridad privado no deben colocarse en una transferencia portátil a menos que el destinatario, los límites de almacenamiento y el proceso de revisión sean explícitos.
• Las recuperaciones externas, los escapes de directorios principales, las inclusiones generadas y los archivos ejecutables descartados requieren una revisión humana explícita.
• Las afirmaciones públicas no respaldadas, como la validación de importación alojada, las escrituras automáticas en el repositorio, la sincronización automática de LLM Wiki, SDK, CLI, la certificación, el respaldo o el soporte de producción deben permanecer fuera de la copia actual hasta que exista evidencia pública.

Plan de verificación#

Cada traspaso debe indicar qué comprobaciones ejecutar, qué comprobaciones están fuera de alcance y qué pruebas deben presentarse. El objetivo no es hacer que todos los agentes ejecuten todas las suites. El objetivo es evitar que los agentes adivinen, salten o finjan.

• Dirija las comprobaciones a los archivos, rutas, artefactos de la máquina, paquetes o reclamos públicos modificados.
• Nombra la versión completa, el paquete, la configuración regional, el rendimiento, la superficie de lanzamiento y los barridos de prueba de humo solo cuando el trabajo tenga un alcance de publicación o se solicite explícitamente.
• Registre por qué no se pudo ejecutar una verificación relevante en el entorno actual.
• Informe la evidencia en la respuesta final y actualice .uai/progress.uai cuando cambie la verdad del proyecto.

Por qué la transferencia del proyecto sigue siendo importante#

Los tiempos de ejecución de los agentes están mejorando en su funcionamiento. Eso hace que el contexto duradero sea más importante, no menos.

Sin una capa de transferencia portátil, el conocimiento importante del proyecto puede quedar atrapado en chats privados, paneles de control de proveedores, sesiones de ejecución, rastros que son difíciles de mover, comentarios emitidos, documentos obsoletos y la memoria de una persona.

Project Handoff mantiene el estado duradero del proyecto en el repositorio, donde los humanos, agentes, revisores y futuros proveedores pueden inspeccionarlo.

Hoja de ruta de compatibilidad#

Las herramientas de transferencia del proyecto UAIX planificadas o recomendadas deben estar en la hoja de ruta hasta que existan elementos públicos, comportamiento de validación y evidencia de publicación.

Paquete inicial en vivo#

Memoria de IAes el marco público amplio, y Project Handoff es la configuración de transferencia para la toma de posesión del repositorio o el movimiento de responsabilidad. Este ZIP inicial se genera a pedido a partir del mismo registro de plantilla canónico y la ruta del manifiesto generado que se utilizan en la página AI Memory.

Resumen en lenguaje sencillo#

OpenAI está creando mejores formas para que los agentes de IA trabajen. Eso no acaba con el Proyecto Handoff. Cambia lo que debería afirmar Project Handoff.

Project Handoff no debería intentar ser un corredor de agentes. Debería ser lo que le diga a cualquier agente: aquí está el proyecto, aquí está lo que importa, aquí está lo que cambió, aquí están las reglas, aquí están las decisiones ya tomadas, esto es lo que debes verificar y esto es lo que no puedes hacer sin un humano.

OpenAI ejecuta el trabajo. UAIX Project Handoff conserva la memoria del proyecto.

Límite de soporte actual#

• Esta página publica el borrador del patrón de transferencia AGENTS.md, readme.human y .uai para revisión pública y uso temprano.
• El ZIP inicial visible es actual y se genera a partir de plantillas y manifiestos canónicos.
• La validación de carga/importación alojada de .uai, las escrituras automáticas en el repositorio, la sincronización automática de LLM Wiki, SDK, CLI, la certificación y el soporte de respaldo permanecen planificados hasta que existan herramientas públicas, accesorios, comportamiento de validación y evidencia de publicación.
• No describa un proyecto como certificado o respaldado por UAIX solo porque utiliza archivos AGENTS.md, readme.human o .uai.
• Cuando una transferencia se convierta en prueba de divulgación pública, adjunte la documentación pertinente.Validadorresultado,Paquete de conformidadevidencia,Implementacióngrabar, yRegistro de cambiosentrada.

Registros relacionados#

• Uso de Project Handoff con agentes OpenAI y CodexGenere flujos de trabajo centrados en OpenAI con memoria de repositorio portátil.
• Uso de Project Handoff con agentes de codificaciónMantenga Codex, Claude Code, Cursor, Copilot y Gemini Code Assist en la misma verdad de transferencia local.
• Presupuesto del contexto de transferencia del proyectoMantenga compactos los archivos AGENTS.md, .uai/readme.human y .uai mientras el historial largo pasa a la memoria fría.
• Traspaso de archivos de agenteHaga que los archivos caídos sean visibles, revisados ​​y dispuestos antes de realizar un trabajo amplio.
• Especificación de vinculación AGENTS.md .uaiLea la sintaxis de los enlaces, el comportamiento del cargador y el fondo de la forma del registro.
• Hoja de rutaVerifique el adaptador, el validador, el esquema, SDK, CLI y los límites de certificación actuales versus planificados.

Trabajo de larga duración#

Para objetivos extendidos o interrumpibles, utiliceEjecución de objetivos a largo plazo. Seguir objetivos lleva el objetivo de tiempo de ejecución; los archivos autorizados .uai llevan puntos de control duraderos; UAI-1 paquetes de estado de tarea, bloqueador, traspaso, propuesta de memoria e informe final llevan evidencia portátil. La salida en tiempo de ejecución no se acepta en la memoria hasta que se revisa y se vuelve a escribir.