Transfert de projet

Project Handoff est une mémoire de projet portable pour les humains et les agents IA.Il aide les humains et les agents IA à transférer l’état du projet sans s’appuyer sur l’historique des discussions privées.

Il donne à OpenAI, Codex, Claude, aux agents locaux, aux fournisseurs et aux équipes humaines un point de départ local partagé: qu'est-ce que ce projet, ce qui a changé, quelles contraintes comptent, quelles décisions ont été prises et ce qui doit être vérifié avant la prochaine édition.

OpenAI exécute les agents. Project Handoff préserve la mémoire du projet.

Les packages projet/développeur nécessitent également .uai/coding-standards .uai.Avant le codage, l'agent récepteur doit déduire les profils de langage/framework/données/API/sécurité applicables à partir de la base de code visible, des manifestes, des tests, des CI, des fichiers de déploiement, des itinéraires, des schémas et des instructions du propriétaire, puis mapper les vérifications automatisées avant de procéder à l'édition.

• Commencez par AGENTS.mdCréez la porte d'entrée du référentiel durable.
• Afficher un exemple de bundle de transfertInspectez le ZIP de démarrage du projet Handoff généré.
• Utiliser avec les agents OpenAI/CodexDémarrez des workflows centrés sur OpenAI avec une mémoire repo-locale.
• Utiliser avec des agents de codageMappez le même ensemble de transferts dans Codex, Claude Code, Cursor, Copilot et Gemini Code Assist.
• Lire le projet de spécificationVérifiez la syntaxe des liens AGENTS.md et .uai.

Qu'est-ce que c'est/ce que ceci n'est pas#

Contexte chaud, mémoire froide#

Le transfert du projet doit être un contexte chaud: vérité actuelle, contraintes actuelles, décisions acceptées, bloqueurs actifs, prochain travail et vérifications. Il ne doit pas devenir l'endroit où chaque rapport de recherche, ancienne note de session ou paragraphe de feuille de route historique est chargé par défaut.

Lorsqu'un ensemble de transfert devient trop volumineux, conservez les fichiers pré-slim dans une couche de mémoire froide de style LLM Wiki ou AIWikis avec un manifeste, des chemins sources, des sommes de contrôle, des résumés et un journal daté. Gardez ensuite les fichiers actifs AGENTS.md, readme.human et .uai concis et pointez vers la mémoire froide uniquement lorsque la tâche nécessite des preuves originales.

Cadres de mémoire de rêve IA#

Dans les conseils UAIX, AI Dreaming Memory est une passe de consolidation sélectionnée et révisée sur la mémoire de projet visible. Il peut relire les fichiers de transfert récents, les résultats d'admission acceptés, les registres de preuves et les archives de mémoire froide nommées pour proposer des fusions en double, l'élagage des faits périmés, des notes de contradiction, des mises à jour d'action suivante et des modifications de mémoire chaude/froide.

Une passe de rêve devrait produire des propositions de deltas, et non une vérité silencieuse. Enregistrez la portée de la saisie, les invites ou les paramètres de travail, les expurgations, le résumé de la mémoire avant/après, les modifications acceptées et rejetées, le réviseur, les vérifications, le chemin d'archivage et l'instantané de restauration dans Project Handoff ou dans le registre des preuves sélectionné.

• Utilisez-le pour:hygiène périodique de la mémoire, examen de la mémoire liée à la version, découverte des contradictions, résumés de préservation des sources et contrôles de préparation au transfert.
• Ne l'utilisez pas pour:mémoire de modèle cachée, mises à jour de poids de modèle, traitement de données privées non supervisé, écritures automatiques dans le référentiel, synchronisation automatique du wiki LLM ou réclamations de support public sans examen.
• Règle de promotion:une sortie de rêve ne devient opérationnelle que lorsque sa tranche acceptée est écrite dans AGENTS.md, readme.human, des enregistrements .uai saisis, des documents, du code, des tests, des notes de version, l'état de la feuille de route, le journal des modifications, des artefacts de machine ou des preuves de mémoire longue.

Tri de la mémoire de déploiement de production#

Les versions de déploiement de production et les packages de version sont le bon moment pour exécuter la gestion de la mémoire. Avant de terminer un déploiement, mettez à jour la mémoire active avec la vérité actuellement déployée, le pointeur d'autorité de version de l'espace de travail, les fichiers modifiés, les vérifications exécutées, les bloqueurs, les propriétaires et les actions suivantes. Conservez les valeurs exactes de la version actuelle et suivante du package dans le coordinateur racine workspace.uai et les preuves de publication, pas dans la mémoire active du projet ou du plugin .uai. Déplacez l'historique volumineux, les anciens rapports, les sources brutes, les plans périmés et les antécédents ou les justifications rejetées dans le wiki LLM nommé, l'archive de style AIWikis ou le chemin de mémoire froide lorsqu'il en existe un avec des preuves de transfert. Rédiger une mémoire de déploiement durable et un rapport d'exécution de test à côté des artefacts de version ou dans le grand livre de preuves sélectionné; une note finale uniquement sur le chat ne suffit pas.

N'exécutez pas cette passe pour les versions de développement ordinaires, les exécutions de tests, les expériences de packages locaux ou les contrôles de fumée, à moins qu'un humain ne marque explicitement la version comme étant liée à la version ou comme étant une version candidate.

Comment cela s'intègre-t-il avec OpenAI, Codex, Skills, MCP et les environnements d'exécution des agents#

Les environnements d'exécution des agents sont conçus pour exécuter le travail: choisir des outils, appeler des API, appliquer des approbations, déléguer entre spécialistes, préserver l'état d'exécution et produire des traces ou des demandes d'extraction. Le projet Handoff vit une couche plus tôt et une couche plus tard. Il indique au moteur d'exécution quelle mémoire de projet durable charger avant le début du travail, et il donne aux humains un endroit consultable pour réécrire le résultat accepté une fois le travail terminé.

Project Handoff est la surface limitée d'entrée et de réécriture pour l'ingénierie des harnais: chargez les spécifications actuelles, les contraintes, les propriétaires, les contrôles et les limites de support avant une exécution; après examen, réécrivez uniquement les décisions acceptées, les fichiers modifiés, les résultats de test ou d'évaluation, les bloqueurs, les résumés de pages, les signaux d'adoption et les actions suivantes.

Utilisez OpenAI, Codex, Skills, les serveurs MCP, Claude, des agents locaux ou d'autres systèmes d'orchestration pour exécuter le travail. Utilisez Project Handoff pour vous assurer que ces systèmes démarrent avec la mémoire de projet, les contraintes, les décisions et le plan de vérification appropriés.

Orchestration du temps d'exécution OpenAI et transfert de projet#

Utilisez OpenAI pour exécuter des agents. Utilisez Project Handoff pour vous assurer que ces agents démarrent avec la bonne mémoire de projet, les bonnes contraintes, les bonnes décisions et le bon plan de vérification.

Offre groupée de transfert minimale#

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

• AGENTS.md est la porte d'entrée durable: résumé, liste de chargement, état actuel, prochaines étapes, historique et première réponse requise.
• readme.human est le briefing humain du point de vue de l'IA: ce que les humains doivent savoir, clarifier, protéger et approuver.
• .uai/context.uai explique ce qu'est le projet, à qui il sert et ce que signifie le succès.
• .uai/stack.uai enregistre les langages, les frameworks, les hypothèses d'exécution, les surfaces des packages et les commandes importantes.
• .uai/constraints.uai comporte des règles strictes pour les actions destructrices, les secrets, la production, les demandes de support et les portes d'examen.
• .uai/progress.uai enregistre l'état actuel, les travaux récents, les prochaines actions, les bloqueurs et les notes de version.
• .uai/test-plan.uai est sélectionné pour les plus petits projets et attendu lorsque les choix de vérification sont importants.

Prise de fichiers actifs#

Les projets réels reçoivent également des fichiers libres: PDF, notes, discussions exportées, mémos de recherche, fichiers ZIP de packages, captures d'écran, preuves de feuilles de calcul et brouillons provenant d'autres systèmes d'IA. Associer le transfert de projet avecTransfert de fichiers agentlorsque ces fichiers doivent être visibles pendant le chargement de AGENTS.md.

• En charge:énumérez directement agent-file-handoff/Content/ et agent-file-handoff/Improvement/ et inspectez chaque fichier actif sans espace réservé avant un travail général sans rapport. Ne créez pas et ne vous fiez pas à un fichier d'index d'admission.
• Règle de travail:pour chaque fichier sûr et pertinent, effectuez au moins un élément de travail de projet nommé avant de le supprimer de la prise en charge active du site source. Copier un rapport dans .uai, des documents locaux, AIWikis ou un wiki LLM est une distribution de mémoire, et non le travail du projet en lui-même.
• Résultat complet:enregistrez les preuves d'analyse de compartiment en direct, une entrée de registre de disposition par fichier, le travail réel effectué, la mise à jour de la mémoire chaude ou la raison de non-changement, la préservation de la mémoire durable lorsqu'elle est configurée ou not configured, le résumé du pointeur lorsque la mémoire longue est utilisée, les vérifications et les bloqueurs.
• Règle d'échec:La distribution de mémoire sans travail de projet est un échec de transfert, à moins que chaque fichier actif ne soit dangereux, en double, hors de portée ou véritablement bloqué pour une raison durable.
• Aucune règle d'archivage du site source:lorsqu'un stockage de mémoire durable configuré existe déjà, conservez les originaux avec la somme de contrôle/manifeste dans le chemin de preuve de mémoire durable configuré, puis supprimez les copies du site source avant de revendiquer l'achèvement. Les fichiers non réservés conservés sont des états de blocage ou de blocage humain inachevés.

Compatible avec OpenAI par conception#

Project Handoff est conçu pour fonctionner avec les flux de travail centrés sur OpenAI, et non pour les combattre.

1. AGENTS.md donne au Codex ou à un agent d'exécution la porte d'entrée durable.
2. Les références @uai[] pointent vers un contexte de projet structuré.
3. .uai/context.uai, .uai/stack.uai, .uai/constraints.uai et .uai/progress.uai fournissent l'état actuel du projet.
4. constraints.uai peut être compilé dans des garde-fous d'exécution, des approbations d'outils et des portes d'examen humain.
5. test-plan.uai indique à l'agent quelles vérifications exécuter et quelles vérifications ne doivent pas simuler.
6. Après l'exécution, les traces acceptées, les décisions et le travail terminé sont réécrits dans .uai/progress.uai, .uai/decisions.uai et AGENTS.md.

Diagramme de flux de travail#

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

Approbation humaine et modèle de confiance#

Les fichiers chargés sont du contexte, pas d'autorité. Ils ne remplacent pas les instructions du système, la demande actuelle de l'humain, les règles du référentiel, les obligations de confidentialité, les limites de sécurité ou les limites de support public.

• Les opérations destructrices du système de fichiers ou de Git nécessitent une approbation humaine explicite.
• Les déploiements de production, la publication de packages publics, les modifications de domaine ou de cache et les modifications de découverte de racine nécessitent une approbation et des preuves explicites au niveau de la version.
• Les secrets, informations d'identification, clés privées, jetons, données client brutes, données tierces et documents juridiques ou de sécurité privés ne doivent pas être placés dans un transfert portable à moins que le destinataire, les limites de stockage et le processus de révision ne soient explicites.
• Les récupérations externes, les échappements du répertoire parent, les inclusions générées et les fichiers exécutables supprimés nécessitent un examen humain explicite.
• Les réclamations publiques non prises en charge telles que la validation d'importation hébergée, les écritures automatiques dans le référentiel, la synchronisation automatique LLM Wiki, SDK, CLI, la certification, l'approbation ou le support de production doivent rester en dehors de la copie actuelle jusqu'à ce que des preuves publiques existent.

Plan de vérification#

Chaque transfert doit indiquer quelles vérifications doivent être effectuées, quelles vérifications sont hors de portée et quelles preuves doivent être rapportées. L’objectif n’est pas de forcer chaque agent à exécuter chaque suite. L’objectif est d’empêcher les agents de deviner, de sauter ou de faire semblant.

• Ciblez les vérifications sur les fichiers, les routes, les artefacts de machine, les packages ou les revendications publiques modifiées.
• Nommez les analyses complètes de la version, du package, des paramètres régionaux, des performances, de la surface de lancement et des tests de fumée uniquement lorsque le travail est limité à la version ou explicitement demandé.
• Enregistrez pourquoi une vérification pertinente n’a pas pu être exécutée dans l’environnement actuel.
• Rapportez les preuves dans la réponse finale et mettez à jour .uai/progress.uai lorsque la vérité du projet change.

Pourquoi le transfert du projet est toujours important#

Les temps d'exécution des agents s'améliorent pour effectuer leur travail. Cela rend le contexte durable plus important, et non moins.

Sans une couche de transfert portable, les connaissances importantes du projet peuvent rester piégées dans les discussions privées, les tableaux de bord des fournisseurs, les sessions d'exécution, les traces difficiles à déplacer, les commentaires émis, les documents obsolètes et la mémoire d'une personne.

Project Handoff conserve l'état durable du projet dans le référentiel, où les humains, les agents, les réviseurs et les futurs fournisseurs peuvent l'inspecter.

Feuille de route de compatibilité#

Les outils de transfert de projet UAIX prévus ou recommandés appartiennent à la feuille de route jusqu'à ce que les appareils publics, le comportement de validation et les preuves de publication existent.

Pack de démarrage en direct#

Mémoire IAest le cadrage grand public, et Project Handoff est la configuration de transfert pour la prise en charge du référentiel ou le mouvement des responsabilités. Ce ZIP de démarrage est généré à la demande à partir du même registre de modèles canoniques et du même chemin de manifeste généré que ceux utilisés sur la page mémoire IA.

Résumé en langage simple#

OpenAI crée de meilleures façons pour les agents d'IA de travailler. Cela ne tue pas le projet Handoff. Cela change ce que Project Handoff devrait prétendre.

Project Handoff ne devrait pas essayer d’être un agent coureur. Ce devrait être la chose qui dit à tout agent: voici le projet, voici ce qui compte, voici ce qui a changé, voici les règles, voici les décisions déjà prises, voici ce que vous devez vérifier, et voici ce que vous n'êtes pas autorisé à faire sans un humain.

OpenAI exécute le travail. UAIX Project Handoff préserve la mémoire du projet.

Limite de support actuelle#

• Cette page publie le projet de modèle de transfert AGENTS.md, readme.human et .uai pour examen public et utilisation anticipée.
• Le ZIP de démarrage visible est actuel et est généré à partir de modèles et de manifestes canoniques.
• La validation de téléchargement/importation .uai hébergée, les écritures automatiques dans le référentiel, la synchronisation automatique du wiki LLM, SDK, CLI, la certification et la prise en charge de l'approbation restent planifiées jusqu'à ce que les outils publics, les appareils, le comportement de validation et les preuves de publication existent.
• Ne décrivez pas un projet comme certifié ou approuvé par UAIX simplement parce qu'il utilise des fichiers AGENTS.md, readme.human ou .uai.
• Lorsqu'un transfert devient une preuve publique, joignez les documents pertinentsValidateurrésultat,Paquet de conformitépreuve,Mise en oeuvreenregistrer, etJournal des changementsentrée.

Enregistrements associés#

• Utilisation du transfert de projet avec les agents OpenAI et le CodexDémarrez des workflows centrés sur OpenAI avec une mémoire de dépôt portable.
• Utilisation du transfert de projet avec des agents de codageConservez Codex, Claude Code, Cursor, Copilot et Gemini Code Assist sur la même vérité de transfert locale.
• Budget du contexte de transfert du projetConservez les fichiers AGENTS.md, .uai/readme.human et .uai compacts pendant que l'historique long est déplacé vers la mémoire froide.
• Transfert de fichiers agentRendre les fichiers déposés visibles, examinés et éliminés avant un travail généralisé.
• Spécification de liaison AGENTS.md .uaiLisez la syntaxe des liens, le comportement du chargeur et l'arrière-plan de la forme d'enregistrement.
• Feuille de routeVérifiez l'adaptateur, le validateur, le schéma, SDK, CLI et les limites de certification actuels par rapport à ceux prévus.

Un travail de longue haleine#

Pour les objectifs étendus ou disruptibles, utilisezExécution des objectifs à long terme. Suivre les objectifs porte l'objectif d'exécution; les fichiers .uai faisant autorité comportent des points de contrôle durables; Les paquets d'état de tâche, de bloqueur, de transfert, de proposition de mémoire et de rapport final UAI-1 contiennent des preuves portables. La sortie d’exécution n’est pas acceptée en mémoire tant qu’elle n’a pas été révisée et réécrite.