Project Handoff doit rester suffisamment petit pour être chargé et suffisamment précis pour faire confiance.Utilisez ce guide lorsque les fichiers AGENTS.md, readme.human ou .uai ont commencé à absorber d’anciennes recherches, un historique de discussion, des rapports SEO, des audits, des détails de feuille de route ou des instantanés pré-slim.
La leçon de UAIX, LlmWikis et AIWikis est simple: le contexte chaud doit véhiculer la vérité opérationnelle actuelle; la mémoire froide devrait préserver le long enregistrement. Un bundle de transfert échoue lorsqu’il tente d’être à la fois le paquet de démarrage et l’ensemble des archives institutionnelles.
Quel problème cela résout
- Les nouveaux agents dépensent des jetons de démarrage pour lire l’ancien arrière-plan avant de voir les contraintes actuelles.
- Les anciennes revendications de soutien, les suppositions sur la feuille de route et les décisions remplacées côtoient la vérité actuelle sans règle de promotion.
- Les rapports volumineux sont copiés dans
AGENTS.mdou.uai/progress.uaicar aucun emplacement de mémoire froide n’a été nommé. - Les équipes suppriment ou écrasent les notes volumineuses sans manifeste, somme de contrôle, résumé source ou chemin de récupération.
À qui est destinée cette page
- Les responsables des référentiels qui utilisentTransfert de projet.
- Compact de jumelage d’équipesMémoire IApaquets avec unWiki LLM, archive de style AIWikis ou wiki de recherche interne.
- Les agents d’IA ont demandé de réduire les transferts de fichiers sans perdre leur provenance.
- Les examinateurs vérifient si les réclamations publiques proviennent de l’état source actuel ou d’anciennes notes de référence.
Contexte chaud versus mémoire froide
| Couche | Charger par défaut? | Appartient ici | N’a pas sa place ici |
|---|---|---|---|
| Transfert de projet à chaud | Oui | AGENTS.md, readme.human, contexte actuel .uai, contraintes, pile, surface publique, décisions, progrès, opérations, plan de test, prise de fichiers et style. |
Rapports de recherche complets, anciennes discussions, chaque paragraphe précédent de la feuille de route, audits bruts, idées de mise en œuvre obsolètes ou instantanés pré-slim. |
| Des références chaleureuses | Seulement lorsque la tâche en a besoin | Documents canoniques actuels, pages publiques, journal des modifications, feuille de route, notes de version, résumés de sources ciblés et pages de rapport datées. | Fichiers supprimés non révisés ou anciennes notes brutes traitées comme des instructions actives. |
| Mémoire froide | Non | LLM Pages wiki, archives brutes AIWikis, manifestes de transfert, enregistrements de somme de contrôle, résumés de sources, idées rejetées, anciens instantanés et longues traces de sources. | Des affirmations qui devraient régir le travail actuel sans examen ni promotion. |
La boucle contexte-budget
- Détecter l’accumulation:recherchez les fichiers de démarrage qui expliquent davantage l’ancien historique que l’action en cours, ou les fichiers qui obligent un nouvel agent à lire des rapports volumineux avant de pouvoir nommer les contraintes.
- Snapshot avant minceur:copiez les fichiers pré-slim dans la mémoire froide et enregistrez le chemin source, le chemin final, le hachage SHA-256, l’acteur, l’horodatage, le résumé et la disposition.
- Résumez le bilan froid:créez un résumé de la source, un nœud de concept, une entrée de journal, une note du grand livre ou un index équivalent afin qu’un futur responsable puisse trouver la source brute sans la charger par défaut.
- Minceur les fichiers chauds:conservez la vérité actuelle, les décisions actives, les bloqueurs connus, les prochaines vérifications et un pointeur concis vers l’emplacement de la mémoire froide.
- Promouvoir délibérément:lorsqu’un fait archivé redevient actuel, reformulez-le dans le
.uaiactif, la documentation, le code, les tests, les notes de version, l’état de la feuille de route ou les artefacts de la machine. - Vérifiez la répartition:exécutez le lint de transfert local, les vérifications des espaces et tout lint wiki/archive nécessaire pour le côté mémoire froide.
Que conserver dans les fichiers chauds
AGENTS.md: instructions de porte d’entrée, liste de chargement, état actuel, première réponse requise, lignes rouges marquées et bref historique de l’agent.readme.human: briefing face à des humains, ce que l’IA a besoin que les gens clarifient et ce que l’IA défendra..uai/context.uai: objectif, vérité publique actuelle, audience et critères de réussite..uai/constraints.uai: lignes rouges, limites des revendications de support, politique des secrets et limites des opérations destructrices..uai/progress.uai: travaux récemment terminés, objectif actuel, bloqueurs, prochains travaux et critères terminés..uai/decisions.uai: décisions durables avec effet et limites, pas toutes les discussions qui y ont conduit..uai/test-plan.uai: contrôles ciblés, déclencheurs de balayage complet et attentes du rapport de contrôle final.
Que déplacer dans la mémoire froide
- De longs rapports de recherche, des études comparatives de fournisseurs, d’anciennes ébauches de propositions, de vastes audits SEO, des feuilles de route exploratoires et des récits de mise en œuvre datés.
- Instantanés pré-slim des enregistrements
AGENTS.md,readme.humanet.uai. - Fichiers d’admission bruts une fois que leurs informations utiles ont été éliminées et capturées.
- Options rejetées, recommandations remplacées, justification historique et formulation de la source nécessaire uniquement pour la provenance.
Règle de promotion
La mémoire froide est une provenance récupérable, et non une vérité active du projet. Un fait ne devient actuel que lorsqu’il est examiné et promu dans une surface actuelle nommée: enregistrements AGENTS.md, readme.human, .uai, documents canoniques, pages publiques, code, tests, notes de version, état de la feuille de route, entrées du journal des modifications, preuves du validateur ou artefacts de machine.
Bloc budgétaire contextuel AGENTS.md copiable
## Context Budget
Keep startup context concise. AGENTS.md, .uai/readme.human, and loaded .uai files carry current operating truth only.
Move long research, old progress detail, raw audits, proposal history, and pre-slim snapshots into cold memory before slimming active files.
Every cold-memory transfer should record source path, final path, sha256, actor, timestamp, summary, and disposition. Cold memory is provenance, not active project truth, until a fact is reviewed and promoted back into current files, docs, code, tests, release notes, roadmap state, or machine artifacts.Liste de contrôle d’entretien
- Une nouvelle IA peut-elle expliquer le projet en 3 à 5 puces sans ouvrir les archives brutes?
- Les fichiers chauds nomment-ils les contraintes actuelles, les itinéraires publics actuels, les prochaines vérifications, les bloqueurs et les limites de support?
- Chaque indicateur de mémoire froide inclut-il suffisamment de provenance pour récupérer la source brute?
- Les revendications publiques sont-elles étayées par les pages UAIX actuelles, les artefacts de machine, le comportement du validateur, les notes de version, l’état de la feuille de route ou les preuves de mise en œuvre?
- Les packs de démarrage, les manifestes, les échantillons visibles et les pages publiques sont-ils toujours compatibles?
- La réponse finale a-t-elle nommé les vérifications exécutées et les vérifications de version/package intentionnellement ignorées?
Ce qu’il faut éviter
- Ne supprimez pas l’ancien historique de transfert sans manifeste ou preuve de transfert équivalente.
- Ne laissez pas
AGENTS.mddevenir une archive de recherche. - Ne traitez pas LLM Wiki, AIWikis, les rapports bruts ou les anciennes discussions comme preuves de support actives par défaut.
- Ne revendiquez pas la synchronisation wiki LLM automatique, la validation d’importation hébergée, les écritures de référentiel, les SDK, les CLI, la certification, l’approbation ou les adaptateurs officiels à partir de ce seul modèle.
- Ne placez pas de secrets, d’informations d’identification, de données privées sur les clients, d’invites masquées ou de journaux de production non vérifiés dans la mémoire portable.
Comment UAIX dogfoods cela
UAIX utilise cette même répartition localement. Les agents de routine chargent le bundle chaud Project Handoff. Les recherches volumineuses UAIX, l’historique des propositions, l’arrière-plan de la feuille de route et les instantanés de transfert pré-slim se trouvent dans la mémoire froide AIWikis avec les preuves de transfert. LlmWikis utilise la même leçon pour son contexte de manuel, tandis que UAIX.org reste l’autorité canonique pour UAI-1 et les demandes de soutien public.
Enregistrements UAIX associés
- Transfert de projetCréez le bundle de démarrage AGENTS.md, .uai/readme.human et .uai.
- Mémoire IAUtilisez des paquets de travail compacts pour le contexte de projet accepté.
- Utilisation des packages UAI avec un wiki LLMAssociez des paquets compacts à une mémoire profonde sans que les notes wiki soient automatiquement vraies.
- Transfert de fichiers agentDigérez les fichiers supprimés avant qu’ils ne deviennent des archives ou de la mémoire froide.
- Guide OpenAI/CodexSéparez les traces d’exécution de la mémoire durable du projet.
- Guide des agents de codageGardez de nombreux outils pointés dans un seul ensemble compact.
- Feuille de routeVérifiez les limites d’automatisation et de support actuelles par rapport à celles prévues.
- Journal des changementsSuivez la piste de modification publique datée.
- RapportsUtilisez des pages de rapport datées pour l’arrière-plan, et non pour la prise en charge automatique du courant.
- Spécification de liaison AGENTS.md .uaiSyntaxe de lien plus profonde et arrière-plan de forme d’enregistrement.
Branches de longue date
Les branchements de longue durée, les tentatives, les recherches approfondies et les chemins rejetés appartiennent à la mémoire froide à moins qu’ils ne soient sélectionnés et examinés. UtiliserExécution des objectifs à long termelorsque la mémoire chaude doit préserver l’état actuel, les bloqueurs, les vérifications et la prochaine action exacte en cas d’interruptions.
Mémoire d’objectif hiérarchique
Mémoire d’objectif hiérarchiqueréduit le contexte chaud en intégrant les sous-objectifs acceptés dans des enregistrements liés à la source tout en préservant les preuves brutes dans la mémoire froide ou les archives.