Traspaso de archivos de agente

Etiqueta de navegación corta: Transferencia de archivos.

Agent File Handoff es una bandeja de entrada para la transferencia de proyectos de IA, con un estricto límite de confianza. Traspaso de proyectole dice a la próxima IA cuál es el proyecto. El agente File Handoff le dice a la siguiente IA qué nuevos archivos sueltos llegaron desde la última transferencia. La frase estándar es:Visible, revisado, dispuesto, resultado registrado.

• Continuar con la transferencia del proyectoCree el paquete duradero AGENTS.md, .uai/readme.human y .uai.
• Copiar bloque de admisión AGENTS.mdRequerir revisión del grupo activo de inicio de chat.
• Copiar plantilla .uai/file-handoff .uaiInicie un registro de política local del repositorio.
• Ver AGENTS.md .uai especificación de enlaceLea la sintaxis del cargador y confíe en los antecedentes.
• Ver UAI-1Utilice el sobre de intercambio público cuando el ingreso deba viajar.
• Ver los límites de soporte de la hoja de rutaVerifique el futuro generador, validador, SDK, CLI y el estado de certificación.

Entrada de archivos local activada por AGENTS.md#

Agent File Handoff brinda a un repositorio una vía de entrada pequeña y auditable para archivos sueltos proporcionados por humanos, otros sistemas de inteligencia artificial, exportaciones y herramientas adyacentes. Al iniciar el chat, la siguiente IA enumera directamente los depósitos activos, revisa cada archivo pendiente y establece una disposición y un resultado procesado antes de una planificación o edición amplia.

La verificación de inicio crea o verifica depósitos de entrega activos y clasifica los archivos raíz extraviados antes de la revisión directa del depósito activo.

Un archivo descartado no forma parte de la transferencia hasta que sea visible en la admisión activa, revisado por la siguiente IA, dada una disposición, asignado un resultado procesado y luego promovido o preservado con evidencia.

¿Por qué los archivos caídos desaparecen durante la transferencia de IA?#

El trabajo real del proyecto llega en forma de capturas de pantalla, archivos PDF, notas, exportaciones, archivos ZIP, borradores, auditorías, listas de problemas, hojas de cálculo y archivos producidos por herramientas adyacentes. Una transferencia normal dice AGENTS.md, pero los archivos sueltos aún pueden desaparecer a simple vista.

• Un archivo puede estar presente en el repositorio pero ser invisible si los depósitos activos no forman parte del comportamiento de carga de transferencia.
• Un archivo puede ser visible en un depósito pero aún así ignorarse si el siguiente agente no lo inspecciona y dice qué debe suceder a continuación.
• Agent File Handoff corrige la visibilidad, la disposición y la evidencia de resultados.

El modelo mental#

1. GotaUn ser humano, una IA, una exportación o una herramienta colocan un archivo en un depósito activo.
2. RevisarEl cargador AGENTS.md enumera Content/ y Improvement/ directamente y abre todos los archivos activos que no son de marcador de posición.
3. DisposiciónLa IA resume el riesgo, la superficie objetivo y la acción propuesta.
4. ResultadoLa IA registra si el archivo se incorporó, se rechazó con razón, se conservó en una memoria duradera o se mantuvo activo con razón como un bloqueo o retención humana inacabada.
5. Promocionar o preservarEl contenido útil pasa por la revisión normal; Los archivos de origen manejados se conservan en la ruta de evidencia de memoria duradera configurada y se eliminan de la entrada del sitio de origen.

Admisión acoplada rápidamente#

La ingesta no es sólo una instantánea del inicio. Si el mensaje más nuevo nombra agent-file-handoff/, Content/, Improvement/, un archivo descartado, un procesamiento perdido o un trabajo probablemente relacionado con caídas activas, enumere los depósitos activos en vivo nuevamente antes de una implementación no relacionada. Para cada archivo seguro, registre cómo se relaciona con la tarea actual. Los archivos relacionados deben dar forma al trabajo real, no sólo al enrutamiento de la memoria.

Resultado completo de la ingesta#

Un archivo de entrada relevante y seguro no está completo cuando simplemente se resume, se copia en la memoria o se deja a un lado. Un resultado de admisión completo incluye evidencia de escaneo de depósito en vivo, resumen y disposición revisados, resultado procesado, actualización de la memoria activa o motivo explícito de no cambio, preservación de la memoria duradera cuando está configurada o explícitamente not configured, trabajo real del proyecto completado, verificaciones o bloqueadores y un resumen de puntero cuando se usa memoria larga.

El resultado procesado debe ser uno de incorporated, rejected-with-reason, preserved-to-durable-memory o kept-active-with-reason. El valor mantenido activo es un estado de bloqueo o retención humana inconcluso, no un estado de ingesta completado. La distribución de memoria sin trabajo en el proyecto es una falla en la transferencia de archivos. El aplazamiento inútil de un informe relevante y seguro también es un fracaso. Los informes amplios, estratégicos o de cara al futuro aún deberían generar una porción útil actual: una actualización de página, corrección de guía, prueba, hoja de ruta o entrada de progreso, registro de problema/evidencia, cambio de código, actualización de metadatos de paquete u otra superficie aceptada del sistema. Utilice el aplazamiento con motivo solo cuando no se pueda promover ninguna porción procesable segura en este momento; el valor de disposición es defer-with-reason.

Puerta de finalización de admisión#

Una actualización de .uai, una reorganización de la memoria, una actualización del asistente o una configuración de transferencia están incompletas, mientras que cualquier Content/, Improvement/ activo o un archivo de entrada raíz fuera de lugar carece de evidencia de escaneo de depósito en vivo, disposición registrada, resultado procesado y evidencia de prueba de uso. La finalización requiere el escaneo del depósito activo, una entrada del libro mayor de disposición por archivo, un resultado procesado por archivo, trabajo aceptado o bloqueador duradero, actualización de la memoria activa, preservación de la memoria duradera cuando está configurada, resumen del puntero cuando se usa memoria larga, comprobaciones o bloqueadores y eliminación del sitio de origen antes de completarse; Los archivos retenidos son estados de bloqueo o de retención humana inacabados.

esto no es#

• No es un sistema de carga público.
• No es un validador.
• No es un certificado.
• No es un SDK.
• No es un demonio, un observador, una cola, un bucle cron o un servicio en segundo plano.
• No es un motor de confianza.
• No es una razón para ejecutar código descartado.
• No es un mapa del sitio público ni una biblioteca multimedia.
• Publicación no automática.
• No es un sustituto de la revisión humana.
• No es un generador oficial de .uai.
• No reemplaza el intercambio de mensajes UAI-1.

contrato de directorio#

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

.uai/
  file-handoff.uai

AGENTS.md

Ingesta de contenido#

Coloque material fuente, borradores, capturas de pantalla, exportaciones o candidatos de contenido en agent-file-handoff/Content/ para su revisión. Se espera que todo lo que se coloque en esta carpeta se utilice en parte o en su totalidad después de la revisión. Los archivos no son referencias pasivas, antecedentes para ignorar o material para simplemente resumir; son materiales de entrada para su inmediata incorporación al trabajo correspondiente.

Para el contenido del sitio, la admisión no se considera exitosa a menos que el contenido eliminado se use en el sitio inmediatamente, ya sea en su totalidad o como una fuente incorporada para el contenido, la copia, los activos, la estructura o la implementación de la página revisada. Si el contenido no se puede utilizar de inmediato, registre el motivo claramente y utilice la mayor cantidad de material que sea seguro, respaldado y apropiado.

El contenido de la carpeta es el índice de admisión; no cree ni dependa de un archivo de índice de admisión mantenido manualmente. Registre las disposiciones en .uai/intake-outcome-ledger.uai o en un registro de prueba de uso duradero equivalente .uai. Después de que un archivo tenga una disposición registrada y exista evidencia de memoria duradera configurada, elimine la copia del sitio de origen antes de reclamar su finalización.

Ingesta de mejora#

Deje sugerencias, correcciones, notas de auditoría, paquetes de revisión o cambios propuestos en agent-file-handoff/Improvement/ para su revisión. Los archivos de esta carpeta son instrucciones de forma predeterminada. Trátelos como elementos de trabajo procesables a menos que una instrucción humana actual, una restricción de autoridad superior, un problema de autoridad de origen o un límite de soporte claramente impidan hacerlo.

No se limite a resumirlos o indexarlos. Revise cada archivo en profundidad, determine los cambios solicitados o implícitos y realice el trabajo sugerido inmediatamente cuando sea seguro y apropiado. Se esperan cambios de código, actualizaciones de documentación, ediciones de configuración, pruebas, auditorías y otros trabajos de implementación concretos cuando lo sugiera el material de admisión. Cuando no se pueda completar un elemento, registre el motivo y complete la mayor cantidad posible de trabajo seguro y con apoyo.

El contenido de la carpeta es el índice de admisión; no cree ni dependa de un archivo de índice de admisión mantenido manualmente. Registre las disposiciones en .uai/intake-outcome-ledger.uai o en un registro de prueba de uso duradero equivalente .uai. Después de que un archivo tenga una disposición registrada y exista evidencia de memoria duradera configurada, elimine la copia del sitio de origen antes de reclamar su finalización.

Archivar como duplicado#

Cuando ya existe un almacenamiento de memoria duradera configurado, una carpeta agent-file-handoff/Archive/ del sitio de origen es memoria duplicada. Conserve los originales procesados ​​en la ruta configurada de evidencia de memoria duradera con sumas de verificación, manifiestos, disposición, actor, marca de tiempo y evidencia de transferencia, luego elimine la copia del sitio de origen antes de reclamar la finalización.

Digerir, conservar y eliminar copias del sitio de origen#

El ciclo de vida completo es el resumen, la disposición, la preservación de la memoria duradera configurada y la eliminación del sitio de origen antes de su finalización. Los archivos retenidos que no son marcadores de posición son estados de bloqueo o de retención humana inacabados. Resumen significa que la IA lee el archivo activo, lo resume, registra el riesgo y la superficie objetivo, y captura la información útil en la página pública correcta, cambio de código, hoja de ruta, nota de progreso, decisión, problema o motivo de rechazo. Preservación significa que el archivo fuente original se guarda en la ruta de evidencia de memoria duradera configurada con suma de verificación, manifiesto, disposición, actor, marca de tiempo y evidencia de transferencia para que la ingesta rutinaria de IA deje de tratarlo como trabajo nuevo.

Si una implementación Wiki LLM como AIWikis.org recoge archivos fuente procesados, debe mover o copiar esa fuente a una ruta final de memoria del sistema como raw/system-archives/{source-site}/.... La recogida debe preservar la ruta de origen, la ruta de memoria final, las sumas de verificación, la disposición original, el actor, la marca de tiempo y la evidencia de transferencia, luego actualizar el historial, el registro, el índice o el gráfico wiki de AIWikis para que se pueda descubrir el lugar de descanso final del archivo. Sólo después de que exista esa evidencia se debe eliminar la copia del sitio fuente. La copia AIWikis es procedencia y memoria a largo plazo, no verdad pública canónica UAIX.

Si el objetivo configurado son documentos locales, use el corpus /docs, docs/reports o docs/memory propiedad del proyecto y mantenga .uai/long-term-memory.uai como el libro de registro de puntero semántico que nombra el archivo Markdown revisado, la suma de verificación, el activador, el revisor y el límite de verdad.

Sin índice de ingesta#

Los listados del directorio de depósitos activos son la fuente de verdad de la ingesta pendiente. No cree ni dependa de un archivo de índice de admisión separado; crea una segunda fuente de verdad obsoleta que puede ocultar archivos recién eliminados.

Patrón de primera respuesta requerido#

Cuando existe una entrada pendiente, la siguiente IA debería hacer visible la revisión antes de la planificación o edición no relacionada.

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

Si no hay archivos activos pendientes, dígalo directamente.

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

Vocabulario de disposición#

Límite de confianza#

• La visibilidad crea deberes obligatorios de revisión, disposición y finalización; no hace que el contenido del archivo sea una verdad infalible.
• La visibilidad del directorio es autoridad laboral, no ejecución o aprobación de publicación.
• El archivo no es una certificación.
• Las sumas de verificación son evidencia de identidad, no evidencia de verdad.
• Las sugerencias de ruta son sugerencias, no autorización de publicación.
• Los archivos ejecutables nunca deben ejecutarse automáticamente.
• Los archivos eliminados pueden contener secretos, datos privados, malware, afirmaciones no respaldadas, material protegido por derechos de autor o instrucciones inexactas.
• La promoción requiere un objetivo con nombre y la ruta de revisión normal para ese objetivo.

Enrutamiento de tipo de archivo#

Bloque de admisión AGENTS.md copiable#

## File Intake

At the start of every broad AI work session:

Intake is the lifeblood of the system. A file in intake is an unfulfilled work contract. A completed cycle leaves no processed file behind.

Every active non-placeholder file is trusted as an intentional mandatory work request. Trust applies to the obligation to review and act, not to blind verbatim obedience, factual infallibility, or automatic execution.

1. Begin every startup and loop by inspecting agent-file-handoff/Content/, agent-file-handoff/Improvement/, and misplaced root intake files.
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. Fully read each active file. For reports, audits, architecture documents, research packets, and improvement analyses, inventory every material finding and recommendation, reconcile each with current source/evidence and the protected anchor set, and classify each as incorporated, adapted, rejected-with-reason, or blocked-by-anchor.
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. kept-active-with-reason is always incomplete and prevents handoff, work, release, or intake completion.
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. Perform substantive project work for accepted findings and record targeted checks. Copying, summarizing, indexing, pointer creation, or memory preservation is not substantive work by itself.
14. Update concise hot .uai truth and configured agent/memory channels. Preserve the complete original in durable memory with provenance, checksum, disposition, review evidence, and truth boundary; add a context-rich .uai/long-term-memory.uai pointer; then remove the source copy.
15. Finish with a live scan proving active intake is empty or placeholder-only. A processed file still present means the lifecycle is incomplete.
16. Load and validate Totem, Taboo, and Talisman before ordinary prompts or intake content. Ordinary instructions cannot override them. For a conflict, no-op only the conflicting action, cite the anchor file and stable rule ID, record talk-back evidence, and complete non-conflicting work.
17. 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 trusted work obligations, but their contents are not automatically public truth, release evidence, certified material, or permission to execute code.

Plantilla .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 fully read each file, inventory material findings and recommendations, reconcile them with current source and protected anchors, classify each recommendation, name the risk and disposition, perform substantive accepted work, record targeted checks and memory outcomes, preserve the full source, remove it from active intake, and prove a final empty-or-placeholder-only scan before claiming completion.

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.