Transfert de fichiers agent

Étiquette de navigation courte: File Handoff.

Agent File Handoff est une boîte de réception pour le transfert de projets d’IA, avec une limite de confiance stricte. Transfert de projetindique à la prochaine IA quel est le projet. Agent File Handoff indique à l’IA suivante quels nouveaux fichiers en vrac sont arrivés depuis le dernier transfert. La phrase standard est:Visible, examiné, disposé, résultat enregistré.

• Continuer vers le transfert du projetCréez le bundle durable AGENTS.md, .uai/readme.human et .uai.
• Copier le bloc d’admission AGENTS.mdExiger un examen du compartiment actif au démarrage du chat.
• Copier le modèle .uai/file-handoff .uaiDémarrez un enregistrement de stratégie local du référentiel.
• Afficher les spécifications de liaison AGENTS.md .uaiLisez la syntaxe du chargeur et faites confiance à l’arrière-plan.
• Afficher UAI-1Utilisez l’enveloppe d’échange public lorsque les admissions doivent voyager.
• Afficher la limite de prise en charge de la feuille de routeVérifiez le futur générateur, validateur, SDK, CLI et l’état de certification.

Prise de fichiers locaux déclenchée par AGENTS.md#

Agent File Handoff donne à un référentiel une petite voie d’admission vérifiable pour les fichiers libres fournis par des humains, d’autres systèmes d’IA, des exportations et des outils adjacents. Au début du chat, l’IA suivante énumère directement les compartiments de dépôt actifs, examine chaque fichier en attente et indique une disposition ainsi que le résultat traité avant une planification ou des modifications générales.

La vérification de démarrage crée ou vérifie les compartiments de dépôt actifs et classe les fichiers racine égarés avant l’examen direct du compartiment actif.

Un fichier supprimé ne fait pas partie du transfert jusqu’à ce qu’il soit visible dans l’admission active, examiné par l’IA suivante, donné une décision, attribué un résultat traité, puis promu ou conservé avec des preuves.

Pourquoi les fichiers déposés disparaissent lors du transfert de l’IA#

Le véritable travail de projet arrive sous forme de captures d’écran, de PDF, de notes, d’exportations, de ZIP, de brouillons, d’audits, de listes de problèmes, de feuilles de calcul et de fichiers produits par des outils adjacents. Un transfert normal indique AGENTS.md, mais les fichiers lâches peuvent toujours disparaître à la vue de tous.

• Un fichier peut être présent dans le référentiel mais invisible si les buckets actifs ne font pas partie du comportement de chargement du transfert.
• Un fichier peut être visible dans un compartiment mais toujours ignoré si l’agent suivant ne l’inspecte pas et ne dit pas ce qui devrait se passer ensuite.
• Agent File Handoff corrige les preuves de visibilité, de disposition et de résultat.

Le modèle mental#

1. BaisseUn humain, une IA, une exportation ou un outil place un fichier dans un compartiment actif.
2. RevoirLe chargeur AGENTS.md énumère directement Content/ et Improvement/ et ouvre tous les fichiers actifs non réservés.
3. DispositionL’IA résume le risque, la surface cible et l’action proposée.
4. RésultatL’IA enregistre si le fichier a été incorporé, rejeté avec raison, conservé dans une mémoire durable ou maintenu actif avec raison en tant que blocage humain ou bloqueur inachevé.
5. Promouvoir ou préserverLe contenu utile passe par une révision normale; les fichiers sources traités sont conservés dans le chemin de preuve de mémoire durable configuré et supprimés de l’admission du site source.

Admission couplée rapide#

L’admission n’est pas seulement un instantané de démarrage. Si l’invite la plus récente nomme agent-file-handoff/, Content/, Improvement/, un fichier supprimé, un traitement manqué ou un travail probablement lié aux suppressions actives, énumérez à nouveau les compartiments actifs en direct avant une implémentation sans rapport. Pour chaque fichier sécurisé, enregistrez son lien avec la tâche en cours. Les fichiers associés doivent façonner le travail réel, et pas seulement le routage de la mémoire.

Résultat d’admission complet#

Un dossier d’admission pertinent et sûr n’est pas complet s’il est simplement résumé, copié en mémoire ou mis de côté. Un résultat d’admission complet comprend des preuves d’analyse de compartiment en direct, un résumé et une disposition révisés, le résultat traité, une mise à jour de la mémoire chaude ou une raison explicite de non-changement, la préservation de la mémoire durable lorsqu’elle est configurée ou explicite not configured, le travail de projet réel terminé, les vérifications ou les bloqueurs et un résumé du pointeur lorsque la mémoire longue est utilisée.

Le résultat traité doit être l’un des incorporated, rejected-with-reason, preserved-to-durable-memory ou kept-active-with-reason. La valeur maintenue active est un état de maintien ou de blocage humain inachevé, et non un état d’admission terminé. La distribution de mémoire sans travail de projet est un échec de transfert de fichier. Le report sans travail d’un rapport pertinent et sûr est également un échec. Les rapports généraux, stratégiques ou orientés vers l’avenir doivent toujours produire une tranche utile actuelle: une mise à jour de page, une correction de guide, un test, une feuille de route ou une entrée de progression, un enregistrement de problème/preuve, un changement de code, une mise à jour des métadonnées d’un package ou une autre surface système acceptée. Utilisez le report avec raison uniquement lorsqu’aucune tranche exploitable sûre ne peut être promue maintenant; la valeur de disposition est defer-with-reason.

Porte d’achèvement d’admission#

Une actualisation .uai, une réorganisation de la mémoire, une mise à jour de l’assistant ou une configuration de transfert sont incomplètes alors qu’un Content/, Improvement/ actif ou un fichier d’admission racine égaré ne dispose pas de preuves d’analyse de compartiment en direct, de disposition enregistrée, de résultat traité et de preuve d’utilisation. L’achèvement nécessite l’analyse du compartiment actif, une entrée de registre de disposition par fichier, un résultat traité par fichier, un travail accepté ou un bloqueur durable, une mise à jour de la mémoire chaude, une préservation de la mémoire durable une fois configurée, un résumé du pointeur lorsque la mémoire longue est utilisée, des vérifications ou des bloqueurs et la suppression du site source avant la fin; les fichiers conservés sont des états de blocage ou de blocage humain inachevés.

Ce n’est pas#

• Il ne s’agit pas d’un système de téléchargement public.
• Pas un validateur.
• Pas un certificat.
• Pas un SDK.
• Il ne s’agit pas d’un démon, d’un observateur, d’une file d’attente, d’une boucle cron ou d’un service d’arrière-plan.
• Pas un moteur de confiance.
• Ce n’est pas une raison pour exécuter du code supprimé.
• Il ne s’agit pas d’un plan de site public ni d’une médiathèque.
• Pas de publication automatique.
• Cela ne remplace pas l’examen humain.
• Il ne s’agit pas d’un générateur .uai officiel.
• Ne remplace pas l’échange de messages UAI-1.

Contrat d’annuaire#

agent-file-handoff/
  Content/
    candidate-article.md
    source-notes.pdf
  Improvement/
    audit-report.md
    ux-feedback.txt

.uai/
  file-handoff.uai

AGENTS.md

Prise de contenu#

Déposez le matériel source, les brouillons, les captures d’écran, les exportations ou les candidats de contenu dans agent-file-handoff/Content/ pour une admission examinée. Tout ce qui est déposé dans ce dossier devrait être utilisé en partie ou en totalité après examen. Les fichiers ne sont pas des références passives, des antécédents à ignorer ou des éléments à simplement résumer; ce sont des documents d’admission à intégrer immédiatement dans le travail concerné.

Pour le contenu du site, l’admission n’est pas considérée comme réussie à moins que le contenu supprimé soit utilisé immédiatement sur le site, soit dans son intégralité, soit en tant que source incorporée pour le contenu, la copie, les actifs, la structure ou la mise en œuvre révisés de la page. Si le contenu ne peut pas être utilisé immédiatement, enregistrez clairement la raison et utilisez autant de matériel que cela est sûr, pris en charge et approprié.

Le contenu du dossier constitue l’index d’admission; ne créez pas et ne vous fiez pas à un fichier d’index d’admission tenu à jour. Enregistrez les dispositions dans .uai/intake-outcome-ledger.uai ou dans un dossier de preuve d’utilisation durable équivalent .uai. Une fois qu’un fichier a une disposition enregistrée et qu’il existe des preuves de mémoire durable configurées, supprimez la copie du site source avant de revendiquer l’achèvement.

Apport d’amélioration#

Déposez les suggestions, les correctifs, les notes d’audit, les paquets de révision ou les modifications proposées dans agent-file-handoff/Improvement/ pour une admission révisée. Les fichiers de ce dossier sont des instructions par défaut. Traitez-les comme des éléments de travail exploitables, à moins qu’une instruction humaine actuelle, une contrainte d’autorité supérieure, un problème d’autorité source ou une limite de support ne l’empêche clairement de le faire.

Ne vous contentez pas de les résumer ou de les indexer. Examinez chaque fichier en profondeur, déterminez les modifications demandées ou implicites et effectuez le travail suggéré immédiatement lorsqu’il est sûr et approprié. Des modifications de code, des mises à jour de la documentation, des modifications de configuration, des tests, des audits et d’autres travaux de mise en œuvre concrets sont attendus lorsqu’ils sont suggérés par le matériel d’admission. Lorsqu’un élément ne peut pas être terminé, notez pourquoi et effectuez autant de travaux sûrs et soutenus que possible.

Le contenu du dossier constitue l’index d’admission; ne créez pas et ne vous fiez pas à un fichier d’index d’admission tenu à jour. Enregistrez les dispositions dans .uai/intake-outcome-ledger.uai ou dans un dossier de preuve d’utilisation durable équivalent .uai. Une fois qu’un fichier a une disposition enregistrée et qu’il existe des preuves de mémoire durable configurées, supprimez la copie du site source avant de revendiquer l’achèvement.

Archiver en double#

Lorsqu’un stockage de mémoire durable configuré existe déjà, un dossier agent-file-handoff/Archive/ du site source constitue une mémoire en double. Conservez les originaux traités dans le chemin de preuve à mémoire durable configuré avec les sommes de contrôle, les manifestes, la disposition, l’acteur, l’horodatage et les preuves de transfert, puis supprimez la copie du site source avant de revendiquer l’achèvement.

Digérer, conserver et supprimer les copies du site source#

Le cycle de vie complet comprend la digestion, la disposition, la préservation de la mémoire durable configurée et la suppression du site source avant la fin. Les fichiers non réservés conservés sont des états de blocage ou de blocage humain inachevés. Digest signifie que l’IA lit le fichier actif, le résume, enregistre le risque et la surface cible, et capture les informations utiles dans la bonne page publique, le changement de code, la feuille de route, la note d’avancement, la décision, le problème ou le motif de rejet. La préservation signifie que le fichier source d’origine est enregistré dans le chemin de preuve de mémoire durable configuré avec la somme de contrôle, le manifeste, la disposition, l’acteur, l’horodatage et les preuves de transfert afin que l’apport de routine de l’IA cesse de le traiter comme un nouveau travail.

Si une implémentation Wiki LLM telle que AIWikis.org récupère les fichiers source traités, elle doit déplacer ou copier cette source dans un chemin final de la mémoire système tel que raw/system-archives/{source-site}/.... La récupération doit conserver le chemin source, le chemin mémoire final, les sommes de contrôle, la disposition originale, l’acteur, l’horodatage et les preuves de transfert, puis mettre à jour l’historique AIWikis, le journal, l’index ou le graphique wiki afin que le lieu de repos final du fichier soit détectable. Ce n’est qu’après que cette preuve existe que la copie du site source doit être supprimée. La copie AIWikis est la provenance et la mémoire à long terme, et non la vérité publique canonique UAIX.

Si la cible configurée est des documents locaux, utilisez le corpus /docs, docs/reports ou docs/memory appartenant au projet et conservez .uai/long-term-memory.uai comme registre de pointeur sémantique qui nomme le fichier Markdown examiné, la somme de contrôle, le déclencheur, le réviseur et la limite de vérité.

Pas d’indice d’apport#

Les listes de répertoires de compartiments actifs sont la source de vérité en attente d’admission. Ne créez pas et ne vous appuyez pas sur un fichier d’index d’admission distinct; cela crée une deuxième source de vérité obsolète qui peut masquer les fichiers récemment déposés.

Modèle de première réponse requis#

Lorsqu’un apport en attente existe, la prochaine IA doit rendre l’examen visible avant la planification ou les modifications sans rapport.

File intake found:
1. agent-file-handoff/Content/example.md
   - Summary:
   - Risk:
   - Recommended disposition:
   - Target surface:
   - Checks needed:

Si aucun fichier actif n’est en attente, dites-le directement.

File intake checked:
No active Content or Improvement files require review.

Vocabulaire de disposition#

Limite de confiance#

• La visibilité n’est pas la confiance.
• La visibilité de l’annuaire n’est pas une approbation.
• L’archive n’est pas une certification.
• Les sommes de contrôle sont des preuves d’identité et non des preuves de vérité.
• Les conseils d’itinéraire sont des suggestions et non une autorisation de publication.
• Les fichiers exécutables ne doivent jamais être exécutés automatiquement.
• Les fichiers supprimés peuvent contenir des secrets, des données privées, des logiciels malveillants, des réclamations non prises en charge, du matériel protégé par des droits d’auteur ou des instructions inexactes.
• La promotion nécessite une cible nommée et le chemin de révision normal pour cette cible.

Routage de type fichier#

Bloc d’admission AGENTS.md copiable#

## File Intake

At the start of every broad AI work session:

1. Inspect agent-file-handoff/Content/ and agent-file-handoff/Improvement/.
2. Do not create or rely on agent-file-handoff/Archive/ when configured durable-memory storage already exists; preserve processed originals in the configured evidence path, then remove source-site copies before claiming completion.
3. Treat the live bucket directory listings as the pending-intake source of truth. Do not create or rely on an intake-index file.
4. Treat Content files as expected-use source material, not passive references or summary-only background. For site content, intake is not successful unless the dropped content is used immediately on the site as full content or incorporated source for revised page content, copy, assets, structure, or implementation.
5. Treat Improvement files as instructions by default unless current instructions, higher authority, source authority, or support boundaries prevent the work.
6. Load .uai/file-handoff.uai with the rest of the handoff context.
7. Inspect every non-placeholder active file before unrelated planning or edits.
8. Do not merely summarize or index active intake. Determine the requested or implied changes and perform safe concrete work when appropriate.
9. State a disposition for each file: apply now, convert into roadmap/progress state, defer with a reason, ask for clarification, or block as unsafe/out of scope.
10. State one processed outcome for each file: incorporated, rejected-with-reason, preserved-to-durable-memory, or kept-active-with-reason for an unfinished human-hold/blocker.
11. Record the outcome in .uai/intake-outcome-ledger.uai or equivalent durable .uai proof-of-use state.
12. Treat any .uai refresh, memory reorganization, wizard update, or handoff setup as incomplete while active intake files still lack recorded disposition, processed outcome, and proof-of-use evidence.
13. Preserve processed originals in the configured durable-memory target after the recorded disposition and completed safe work, then remove the source-site copy before claiming completion.
14. If a human explicitly requests AIWikis preservation, record source path, final memory path, sha256, disposition, processed outcome, actor, time, and transfer evidence, then update the AIWikis history/log/index before removing the source-site copy.

Dropped files are local review inputs only. They are not public truth, trusted content, release evidence, certified material, or permission to execute code.

Modèle .uai/file-handoff .uai#

---
uaix: "1.0"
type: operations
title: "Agent File Handoff"
status: active
---

# Agent File Handoff

## Purpose

This repository uses AGENTS.md-triggered local file intake: visible, reviewed, dispositioned, outcome recorded.

## Active Buckets

- agent-file-handoff/Content/ is for candidate public or editorial material.
- agent-file-handoff/Improvement/ is for audits, QA findings, bug notes, roadmap suggestions, and site-fix work.
- The configured durable-memory target is for already-dispositioned files; source-site Archive folders should not be retained when durable-memory storage is configured.
- If a human explicitly asks an LLM Wiki such as AIWikis.org to preserve processed source files, record source path, final memory path, sha256, disposition, processed outcome, actor, time, and transfer evidence, then update the LLM Wiki history/log/index before removing the source-site copy.

## Required First Response

If Content/ or Improvement/ contains non-placeholder files, the AI must summarize each file, name the risk, recommend a disposition, choose one processed outcome, name the target surface, and name checks needed before unrelated broad work.

If no active files are pending, the AI must say:
File intake checked: No active Content or Improvement files require review.

## Prompt-Coupled Intake

If the newest prompt names agent-file-handoff, Content, Improvement, a dropped file, missed processing, or work likely related to active drops, enumerate the live active buckets again. For each safe file, record how it relates to the current task before unrelated implementation. Related files must shape actual project work, not only memory routing.

## Blocked Extensions

Block automatic execution for .bat, .cmd, .exe, .msi, .phar, .php, .php3, .php4, .php5, .phtml, .ps1, and .sh.

## Trust Boundary

Directory visibility is not approval. Checksums identify bytes, not truth. Route hints are suggestions, not publishing authorization. Promotion requires normal review for the named target.