Project Handoff est une mémoire portable prête pour les graphiques.Un graphe de connaissances peut faciliter l’interrogation, la vérification, la réduction, l’archivage et la promotion de la mémoire de transfert, mais la source de vérité actuelle du projet Handoff reste l’ensemble de fichiers locaux du dépôt examiné: AGENTS.md, readme.human, enregistrements .uai saisis, registres de preuves et artefacts de projet acceptés.
Utilisez ce guide lorsqu’une équipe souhaite disposer d’une mémoire IA capable de répondre à des questions relationnelles telles que quelles contraintes s’appliquent à un itinéraire, quelles décisions ont affecté un plan de test, quelles affirmations manquent de preuves, quels anciens rapports ont été déplacés vers la mémoire froide et quels faits peuvent être partagés en toute sécurité avec un agent récepteur.
Limite du graphique de connaissances du transfert de projet
- Prise en charge actuelle de UAIX:des conseils publics pour la conception de transfert de projet prête pour les graphiques, les identifiants stables, les champs source/provenance, les questions de validation, les champs de planification de l’assistant et la planification des graphiques de connaissances LLM Wiki requise pour la configuration de la mémoire graphique.
- Source actuelle de vérité:le groupe de fichiers examiné et les pages publiques UAIX, pas un cache graphique déduit ou une réponse de récupération.
- Situation actuelle des exportations:toute projection graphique doit être dérivée et en lecture seule jusqu’à sa révision; il s’agit d’une navigation dans les preuves, pas d’une écriture automatique dans le référentiel.
- Pas de support actuel:base de données de graphiques hébergée, API de graphiques publique, point de terminaison SPARQL public, synchronisation wiki automatique LLM, importation automatique, SDK, CLI, certification, approbation, profil de conformité ou adaptateur officiel.
Il ne s’agit pas d’une base de données de graphiques hébergée; il s’agit de conseils pour dériver des projections prêtes à être graphiques à partir des fichiers Project Handoff examinés tout en gardant les fichiers sources faisant autorité.
Modèle de mémoire prêt pour les graphiques
| Nœud graphique | Source de transfert du projet | Pourquoi c’est important |
|---|---|---|
| Projet | AGENTS.md, .uai/context.uai |
Nomme le système, la portée, le public, les propriétaires et les limites de l’autorité publique. |
| Offre groupée de transfert | AGENTS.md, readme.human, liste .uai chargée |
Affiche ce qu’un agent récepteur doit charger avant de travailler. |
| Artefact de document | Documents, pages publiques, chemins de code, fichiers de package, ressources de découverte | Connecte la mémoire au fichier ou à l’itinéraire qui a changé. |
| Enregistrement de contexte | Fichiers .uai saisis |
Sépare la pile, l’architecture, les contraintes, les opérations, la progression, les décisions, le style, la surface publique et les tests. |
| Contrainte | .uai/constraints.uai, règles strictes des AGENTS |
Empêche les agents de contourner les limites des secrets, des demandes de support, des opérations destructrices et des voies publiques. |
| Décision | .uai/decisions.uai, journal des modifications, notes de version |
Explique pourquoi le comportement actuel existe et quand il peut changer. |
| Élément de travail | .uai/progress.uai, feuille de route, disposition d’admission |
Relie le travail en cours, les bloqueurs, les contrôles, les prochaines actions et les résultats acceptés. |
| Vérifier | .uai/test-plan.uai, scripts, tests de packages, résultats du validateur |
Montre quelles preuves sont requises avant que les réclamations avancent. |
| Réclamer | Copie de page publique, texte de feuille de route, artefacts de machine, plans générés | Permet à UAIX de suivre si une réclamation est en cours, planifiée, non prise en charge, obsolète ou nécessaire à la source. |
| Risque | Contraintes, documents de confidentialité/sécurité, dispositions relatives au transfert de fichiers | Achemine les données privées, les actions destructrices, les réclamations non fondées et les fichiers dangereux à examiner. |
| Exécution de l’agent | Résumé accepté, fichiers modifiés, vérifications exécutées, bloqueurs | Préserve les résultats d’exécution utiles sans stocker les traces privées brutes comme vérité opérationnelle. |
| Enregistrement de mémoire froide | LLM Wiki, AIWikis archive, manifeste de transfert, résumé des sources | Permet de récupérer les recherches volumineuses tandis que le transfert à chaud reste compact. |
Vocabulaire de bord utile
| Bord | Signification | Exemple |
|---|---|---|
references |
Un enregistrement pointe vers un itinéraire, un fichier, un schéma, une source ou un artefact public. | .uai/public-surface.uai fait référence à /en-us/tools/validator/. |
containsRecord |
Un bundle contient un enregistrement de mémoire typé. | AGENTS.md contient la liste de chargement @uai[] requise. |
appliesTo |
Une contrainte, un contrôle ou une décision s’applique à un dossier, un itinéraire, un colis ou une réclamation. | La limite de demande de support s’applique à l’assistant AI Memory Package. |
requiresCheck |
Une surface modifiée nécessite un contrôle ciblé avant la réalisation. | Les modifications apportées par l’assistant nécessitent des vérifications ciblées de l’assistant. |
blockedBy |
Un élément de travail ne peut pas se poursuivre tant qu’un fait nommé ou une décision du propriétaire n’existe pas. | Achèvement de la version bloqué par un téléchargement de production manquant. |
approvedBy |
Une personne, une note de révision, une version ou un artefact public a accepté la modification. | L’entrée du journal des modifications approuve le libellé actuel du support public. |
mayReverseWhen |
Une décision peut changer lorsque des preuves spécifiées apparaissent. | Un adaptateur prévu ne peut devenir actuel qu’une fois que les luminaires et les propriétaires existent. |
hasTrustBoundary |
Un enregistrement comporte une limite de confidentialité, de secret, de support, de paramètres régionaux ou d’opération destructrice. | File Handoff interdit l’exécution des fichiers supprimés. |
archivesToColdMemory |
Une histoire volumineuse a été transférée à chaud avec des preuves de transfert. | Ancien rapport d’admission archivé avec somme de contrôle et résumé. |
wasDerivedFrom |
Un enregistrement public ou généré provient d’un matériau source nommé. | Élément de la feuille de route dérivé d’un rapport d’admission examiné et des preuves publiques actuelles. |
Politique d’identification
Utilisez des identifiants stables pour les faits durables et des identifiants instantanés pour les états datés. Un nœud graphique ne doit pas dépendre d’un titre susceptible d’être réécrit, d’un chemin de fichier susceptible d’être déplacé ou d’un slug de page susceptible d’être localisé. Gardez les étiquettes lisibles par l’homme à proximité du nœud, mais traitez l’ID stable comme descripteur de citation.
uaix:project/uaix
uaix:handoff-bundle/uaix-local
uaix:record/.uai/constraints.uai
uaix:constraint/no-automatic-repository-writes
uaix:claim/ai-memory-wizard-current-output
uaix:check/scripts-test-uaix-ai-memory-bundle
uaix:snapshot/2026-05-06-project-handoff-kg-guideProjection des normes
Project Handoff ne nécessite pas RDF ou JSON-LD. Lorsqu’un projet nécessite un échange de graphiques, utilisez les normes comme projections sur la mémoire examinée, et non comme remplacement du groupe de fichiers.
| Standard | UAIX utilisation | Limite |
|---|---|---|
| RDF | Représentez les instructions de transfert révisées sous forme de triplets et de graphiques nommés. | Exportez uniquement après examen des fichiers sources. |
| JSON-LD | Partagez des métadonnées sous forme de graphique dans JSON avec des contextes explicites. | Idéal pour les superpositions dérivées et les enregistrements structurés Web. |
| PROV-O | Dérivation du modèle, source, acteur et lignée des événements de révision. | Conservez les preuves originales; le balisage de provenance est un indicateur, pas la preuve elle-même. |
| SHACL | Décrivez les vérifications de forme de graphique pour les ID requis, les traces sources, les propriétaires et les statuts des revendications. | L’échec du lint du graphique bloque la préparation à l’exportation; il ne doit pas réécrire automatiquement les sources. |
| SPARQL | Exécutez des requêtes dorées sur une projection graphique révisée. | Les points de terminaison de requêtes publiques ne sont pas pris en charge actuellement. |
| SKOS | Gérez les étiquettes, les alias, les concepts plus larges/plus étroits et les termes contrôlés. | Utile avant des engagements d’ontologie plus lourds. |
| HIBOU | Ajoutez des règles d’ontologie formelles uniquement lorsque la sémantique du domaine est stable. | N’introduisez pas de raisonnement qui cache l’incertitude de la source. |
Rôles RDF, graphe de propriétés et démarques
Le modèle UAIX le plus sûr est canonique du fichier source, compatible RDF/JSON-LD et compatible avec les graphes de propriétés. Les fichiers restent le chemin d’écriture. Les normes et les bases de données graphiques sont des projections choisies pour un travail.
| Couche | Utilisez-le pour | Ne l’utilisez pas pour |
|---|---|---|
| Fichiers de transfert de projet | Mémoire actuelle faisant autorité, contraintes, décisions, résultats d’admission, contrôles et examen lisible par l’homme. | Traversée importante de graphiques ou échange de données externes liées par lui-même. |
| JSON-LD/RDF/Projection Tortue | Échange sémantique stable, instantanés de graphiques nommés, provenance, validation SHACL et planification de la publication de graphiques alignée sur les normes. | Remplacer le groupe de fichiers examiné ou cacher l’incertitude derrière l’inférence. |
| Projection du graphe de propriétés | Analyse d’impact, exploration de graphiques, tableaux de bord de relations, flux de travail de style Cypher et navigation opérationnelle. | Devenir une deuxième source de vérité qui peut dériver de AGENTS.md, .uai/readme.human et .uai. |
| Récupération assistée par vecteur ou par graphique | Trouver des documents probablement pertinents, agrandir les quartiers et rassembler des ensembles de preuves. | Promouvoir le texte récupéré, les réponses générées ou la confiance du voisin le plus proche dans la vérité acceptée du projet sans examen. |
Pipeline de graphiques dérivés
- Analysez le bundle de transfert:lire
AGENTS.md,.uai/readme.human, charger les enregistrements.uai, les documents sélectionnés, les itinéraires publics et les registres de preuves. - Normaliser l’identité:créer des identifiants stables pour les projets, les enregistrements, les sections, les revendications, les contraintes, les décisions, les contrôles, les fichiers, les itinéraires et les instantanés; conservez les titres et les slugs comme étiquettes.
- Extrayez d’abord les faits examinés:utilisez les éléments de présentation, les en-têtes, les liens
@uai[]explicites, les registres d’itinéraires, les identifiants de feuille de route, les règles du plan de test et les registres d’admission avant l’extraction LLM. - Joindre la provenance:chaque pointeur de réclamation, contrainte, décision, vérification et archive doit indiquer quel fichier source, section, itinéraire, somme de contrôle, événement de révision ou version l’a produit.
- Valider:exécutez des vérifications de schéma, des peluches de graphiques, des vérifications de forme de style SHACL, des requêtes de transfert doré et des vérifications de réclamation de support avant l’exportation ou la récupération.
- Projeter vers l’extérieur:n’émettez JSON-LD/RDF/Turtle ou une charge de graphe de propriétés qu’une fois que l’état du fichier examiné est cohérent.
- Écrivez délibérément:les résultats acceptés renvoient aux fichiers de transfert, aux documents, au code, aux tests, à la feuille de route, au journal des modifications ou aux artefacts de machine actuels; le cache graphique lui-même n’est pas la cible de réécriture.
États des allégations et des preuves
| État | Signification | Comportement de transfert autorisé |
|---|---|---|
proposed |
Extrait d’un rapport, d’un brouillon LLM, d’une ancienne note ou d’une page non révisée. | Utiliser uniquement comme arrière-plan; ne se présentent pas comme support actuel. |
reviewed |
La source, le propriétaire, la contradiction, la sensibilité et la surface cible ont été vérifiés. | Peut guider le travail lorsqu’il correspond à la tâche et aux contraintes actuelles. |
current |
Promu en fichiers actifs, pages publiques, artefacts de machine, tests, notes de version ou état de feuille de route. | Peut être chargé en tant que vérité opérationnelle jusqu’à son remplacement. |
stale |
Connu pour être ancien, incertain, remplacé ou en dehors du tracé/surface de support actuel. | Rester visible comme historique; ne pas utiliser sans un nouvel examen. |
blocked |
Autorité privée, dangereuse, non prise en charge, contradictoire ou manquante. | Arrêtez-vous et demandez à un humain ou un itinéraire au propriétaire avant la promotion. |
Requêtes de transfert doré
- Quelles contraintes s’appliquent à cet itinéraire, package, test ou réclamation publique?
- Quelles décisions ont changé ce dossier, et quelles preuves nous permettraient de les renverser?
- Quelles affirmations actuelles manquent de preuves publiques, de tests ou d’artefacts machines correspondants?
- Quels dossiers d’admission active sont liés à l’invite actuelle et nécessitent encore un véritable travail de projet?
- Quels rapports volumineux ont été déplacés vers la mémoire froide, où se trouvent les hachages et qu’est-ce qui a été renvoyé vers la mémoire chaude?
- Quelles vérifications sont nécessaires avant que ce changement puisse être qualifié de terminé?
- Quels faits peuvent être partagés en toute sécurité en externe et lesquels sont privés, non pris en charge, périmés ou uniquement contextuels?
Limite de récupération assistée par graphique
La récupération assistée par graphique peut aider un agent récepteur à trouver plus rapidement les bons enregistrements et les bons chemins de relation. Il doit toujours citer les fichiers sources, exposer les contradictions, conserver les étiquettes de limite de support et traiter les réponses comme des candidates jusqu’à ce que la règle normale de promotion du Project Handoff soit satisfaite. La récupération est une assistance; la mémoire revue reste l’autorité.
Prise en charge de l’assistant
L’assistant AI Memory Package peut planifier les champs de graphe de connaissances wiki LLM requis pour la configuration de la mémoire graphique pour les projets qui utilisent délibérément une couche wiki plus profonde. Ces champs doivent nommer la stratégie graphique, la politique d’identification stable, la politique de validation, la politique d’exportation et la politique de requête. Le plan généré reste un fichier de planification local et ne crée pas de synchronisation automatique ni de service graphique public.
Règle de promotion
Un fait graphique ne devient opérationnel que lorsque le fait sous-jacent est examiné et promu dans une surface actuelle: AGENTS.md, readme.human, enregistrements .uai saisis, documents canoniques, pages publiques, code, tests, notes de version, état de la feuille de route, journal des modifications, preuves du validateur ou artefacts de machine. Un cache graphique, un résultat d’intégration ou une réponse LLM ne suffisent pas.
Enregistrements associés
- Transfert de projetLe bundle de mémoire locale de dépôt canonique.
- Mémoire IACadrage de mémoire portable et bundles de démarrage pris en charge.
- Assistant de paquet de mémoire IAFichiers locaux générés et configuration du grand livre de pointeurs à long terme.
- Budget contextuelGardez la mémoire de transfert à chaud compacte pendant que les preuves graphiques volumineuses sont déplacées vers la mémoire froide.
- Transfert de fichiers agentDisposition prise active avant graphique ou promotion de la mémoire.
- LLMWikis.org Graphiques de connaissancesDes conseils plus approfondis sur la conception de graphiques Wiki LLM.
- Feuille de routeGraphique actuel par rapport à prévu, adaptateur, synchronisation, SDK, CLI et limites de conformité.
- Journal des changementsPiste de changement publique datée.
Mémoire d’objectif hiérarchique
Associez des enregistrements de transfert prêts pour le graphique avecMémoire d’objectif hiérarchiqueen traitant le graphe comme une hiérarchie de mémoire dérivée, et non comme la source de vérité.