Ejecución de objetivos a largo plazo

La ejecución de objetivos a largo plazo mantiene el trabajo interrumpible de los agentes visible, reanudable y controlado por revisión.Utilice esta guía cuando un proyecto combine UAIX .uai archivos de memoria, un objetivo de tiempo de ejecución estilo Seguir objetivos, UAI-1 paquetes de tareas, puntos de control, bloqueadores, transferencias, informes finales y reescritura autorizada.

Este es un patrón de documentación y evidencia. El tiempo de ejecución, el IDE, el motor de flujo de trabajo, el operador humano o la plataforma del agente aún poseen la ejecución, la programación, el acceso a las herramientas, las aprobaciones, los seguimientos y la memoria administrada.

Para qué es esta página#

• Planifique un trabajo prolongado que pueda interrumpirse, reanudarse, delegarse, pausarse o completarse en más de una sesión de agente.
• Mantenga el objetivo de tiempo de ejecución activo pequeño mientras la memoria duradera del proyecto permanece en AGENTS.md, .uai/readme.human, registros escritos .uai y evidencia pública o local revisada.
• Asigne puntos de control, bloqueadores, transferencias, propuestas de memoria e informes finales a perfiles de paquetes de agentes UAI-1 existentes sin inventar un nuevo esquema.
• Ofrezca a los humanos una ruta de revisión clara antes de que cualquier resultado en tiempo de ejecución se convierta en una verdad aceptada del proyecto.

que esto no es#

• No es un tiempo de ejecución, programador, cola, demonio, motor de flujo de trabajo, base de datos de memoria, almacén de vectores, almacén de seguimiento ni servicio de orquestación alojado en UAIX.
• No es un adaptador oficial de OpenAI, un campo de objetivos nativo de OpenAI, SDK, CLI, un importador alojado, un escritor de repositorio, una sincronización Wiki automática de LLM, una certificación, un respaldo o un programa de conformidad.
• Sin permiso para ejecutar herramientas, implementar, publicar, autenticar, acceder a secretos, modificar la memoria, ampliar las reclamaciones de apoyo público o eludir la política local.
• No es motivo para copiar rastros sin procesar, registros privados, mensajes ocultos, secretos o resúmenes generados no revisados ​​en una memoria duradera.

División de capas#

Patrón canónico de objetivos a largo plazo#

1. Cargue la puerta principal de transferencia y los archivos .uai requeridos.
2. Indique el objetivo, los criterios de éxito, los límites estrictos, el plan de verificación, los puntos de contacto esperados y la cadencia de los puntos de control antes del trabajo amplio.
3. Ejecute un segmento acotado en el tiempo de ejecución externo.
4. Emita un paquete de punto de control cuando sea probable que se produzcan cambios de estado significativos o una interrupción.
5. Emitir un paquete bloqueador cuando el mismo obstáculo no pueda resolverse de forma segura.
6. Emitir un paquete de transferencia cuando otro agente, humano, tiempo de ejecución o sesión futura deba continuar.
7. Emitir paquetes de propuestas de memoria para hechos duraderos candidatos; no los escriba como verdad hasta que los revise.
8. Emitir un paquete de informe final cuando el objetivo se complete o se cierre explícitamente.
9. Vuelva a escribir los resultados aceptados en registros autorizados y luego archive o cite el material de ejecución sin procesar como evidencia solo cuando sea útil.

Orden de lectura requerido#

1. Instrucción humana actual y política local.
2. AGENTS.md o .uai/readme.human como puerta de entrada del proyecto.
3. .uai/memory-maintenance.uai, anclajes de instrucciones activas protegidas y .uai/short-term-memory.uai.
4. .uai/startup-packet.uai, .uai/system-profile.uai y .uai/receiver-brief.uai cuando estén presentes para la transferencia del proyecto.
5. .uai/constraints.uai, .uai/progress.uai, .uai/decisions.uai, .uai/test-plan.uai y registros de alcance de código cuando el trabajo toca el código.
6. .uai/exports/follow-goal.json solo cuando el entorno del receptor utiliza Seguir objetivos o /goal.
7. Admisión de transferencia de archivos de agente activo antes de un trabajo amplio no relacionado.
8. Fuentes de memoria fría o LLM Wiki solo después de que la memoria actual compacta y los límites estén claros.

Mapeo de archivos para puntos de control#

Mapeo de paquetes en tiempo de ejecución#

Cadencia del punto de control#

• Punto de control después de cada cambio de fuente significativo, paso de lanzamiento, paso de migración o actualización de evidencia revisada.
• Punto de control antes de la compactación del contexto, largas esperas, entrega de herramientas, interrupción del proceso o cambio de agentes.
• Punto de control antes de ampliar la autoridad, cambiar la memoria protegida, publicar, implementar o tocar sistemas adyacentes a secretos.
• Punto de control cuando el estado de la verificación cambia de no ejecutado a aprobado, fallido, omitido o bloqueado.
• No realice controles con tanta frecuencia que el ruido reemplace el progreso; cada punto de control debe responder qué cambió, qué queda, qué evidencia existe y qué se puede reanudar de manera segura.

Carga útil mínima del punto de control: ID de tarea o correlación, acción actual, trabajo completado, evidencia producida, pruebas/verificaciones ejecutadas, pruebas/verificaciones omitidas y por qué, bloqueadores activos, riesgos, archivos o rutas modificadas, actualizaciones de memoria propuestas, actualizaciones de memoria omitidas intencionalmente, siguiente acción exacta y una marca de tiempo UTC.

Interrupción y reanudación del flujo.#

1. Deténgase en un límite seguro: guarde archivos, evite publicaciones a medio escribir y no deje operaciones destructivas pendientes.
2. Escriba un punto de control del estado de la tarea con la hora UTC, el segmento actual, el trabajo completado, los archivos modificados, las comprobaciones, los bloqueadores y el comando o mensaje de reanudación.
3. Actualice .uai/short-term-memory.uai y .uai/progress.uai solo con datos candidatos aceptados o claramente marcados.
4. En el currículum, vuelva a cargar las instrucciones actuales, la memoria de entrada, la entrada activa y el último punto de control antes de utilizar el contexto de chat anterior.
5. Resuma el estado reanudado y solicite la opinión de una persona solo cuando el bloqueador no pueda resolverse a partir de evidencia visible y una suposición razonable sería arriesgada.

Flujo de estado: LoadAuthoritative -> BuildRuntimeGoal -> Working -> Checkpointed -> Working. Si falta aprobación, contexto, capacidad o evidencia, pase a Blocked. Si otro actor debe continuar, pase a Handoff. Cuando se cumplan los criterios de finalización, vaya a Finalized, luego a WriteBack y luego deténgase.

Resume task <task_id> using the authoritative handoff bundle, not the last chat turn.
Load AGENTS.md, .uai/readme.human when present, .uai/memory-maintenance.uai, identity, world-context, active instruction anchors, short-term-memory, current-state, progress, next-actions, constraints, decisions, and test-plan.
If code-bearing, also load .uai/next-recursive-prompt.uai only as derived hot memory.
Reconstruct:
- last accepted checkpoint
- unfinished subtask
- active blockers
- required checks
- exact next action
If any conflict is unresolved, emit uai.agent.blocker.v1 instead of guessing.

Escalera de resolución de conflictos#

1. La autorización humana explícita de artefactos y operaciones controla la mutación del ancla protegida.
2. .uai/memory-maintenance.uai, .uai/totem.uai, .uai/taboo.uai y .uai/talisman.uai gobiernan el ciclo de vida de la memoria y los límites protegidos.
3. AGENTS.md o .uai/readme.human proporcionan el registro de entrada y las instrucciones del proyecto local.
4. Los archivos autorizados .uai controlan la verdad del proyecto actual.
5. Las UAIX páginas públicas actuales, el código, las pruebas, las notas de la versión, el estado de la hoja de ruta, la evidencia del validador y los artefactos de la máquina rigen las reclamaciones de soporte público.
6. Las exportaciones de seguimiento de objetivos, el siguiente mensaje recursivo, los paquetes de estado de tareas, los resúmenes de tiempo de ejecución, las proyecciones de gráficos y las notas de memoria fría están subordinados a menos que se revisen y promuevan.
7. Los chats antiguos, los registros sin procesar, los informes antiguos, las notas de archivo no revisadas y las respuestas de recuperación son solo fuentes potenciales.

Si el conflicto persiste, detenga el trabajo general, emita un bloqueador, nombre los artefactos en conflicto, nombre la siguiente acción de revisión más segura y no fusione ni sobrescriba silenciosamente la memoria duradera.

Reglas de alcance del código#

• Para código, automatización, flujos de trabajo ejecutables o artefactos similares a código, se requiere arquitectura, estándares de codificación, restricciones, progreso, plan de prueba y registros de avisos recursivos antes de una edición amplia.
• Mapee los puntos de contacto esperados, los riesgos y las pruebas específicas antes de cambiar el código.
• Ejecute comprobaciones de sintaxis, unidades, integración, estáticas, paquetes, configuraciones regionales, rutas o navegadores que coincidan con el comportamiento tocado.
• Nunca reclame implementación, publicación, carga de paquetes, escrituras automáticas en repositorios, SDK, CLI, adaptador oficial, certificación o respaldo sin evidencia.

Reglas de alcance sin código#

• Para redacción, investigación, gobernanza, localización, SEO, políticas o planificación, se requieren notas fuente, superficie pública actual, revisión de los límites de soporte y ruta de evidencia final.
• No sintetice textos de estándares normativos, traducciones o autoridad política sin revisarlos.
• Utilice no-op/source-validation solo cuando no quede ninguna función concreta, error, mejora, prueba/verificación, paquete o trabajo de publicación por realizar y indique claramente la condición de detención.
• Mantenga explicaciones orientadas a humanos en archivos .human, texto de instrucciones de IA en archivos .uai y datos estructurados en archivos .json dentro de .uai/.

Contexto caliente y memoria fría#

El contexto activo es lo que el siguiente agente debe cargar de forma predeterminada: estado actual, restricciones, decisiones, bloqueadores activos, próximas acciones, comprobaciones específicas y resultados aceptados recientemente. La memoria fría es un origen recuperable: informes extensos, conversaciones antiguas, rastros sin procesar, instantáneas de investigaciones, aportes archivados y razonamientos voluminosos. La memoria fría puede informar el trabajo futuro, pero se activa sólo cuando un hecho revisado se promueve en los registros actuales.

Patrón de agente jerárquico#

Un proyecto de larga duración puede utilizar un coordinador y trabajadores especializados, pero UAIX registra la transferencia, no la jerarquía en vivo. El coordinador es responsable del encuadre de objetivos, el orden de lectura, la verificación de conflictos, la revisión de puntos de control, las propuestas de memoria y el informe final. Los agentes trabajadores poseen tareas limitadas y devuelven paquetes de estado de tarea, bloqueador, transferencia o informe final. La revisión humana todavía controla la memoria protegida, las afirmaciones públicas, la publicación y la implementación.

Evaluación de nuevo contexto#

Cuando un nuevo agente evalúa el trabajo, debe cargar los archivos autorizados más recientes, ignorar la memoria de chat privada a menos que se proporcione explícitamente, comparar las afirmaciones con la evidencia fuente, ejecutar o revisar comprobaciones específicas y decidir si el resultado anterior se acepta, se rechaza, se acepta parcialmente o necesita un bloqueador. El contexto nuevo es útil porque capta la deriva que una sesión larga puede normalizar.

Configuración del asistente#

1. Abre elAsistente de paquete de memoria de IA.
2. Seleccione Project Handoff u otro código/paquete de proyecto que coincida con el trabajo.
3. Complete el paquete de inicio, el resumen del receptor, las restricciones, el progreso, las decisiones, el plan de prueba y los archivos de alcance del código a partir de evidencia visible.
4. Habilite Seguir objetivos solo cuando el receptor utilice /goal o una superposición de objetivos de tiempo de ejecución equivalente.
5. Asegúrese de que .uai/exports/follow-goal.json mencione un objetivo activo, criterios de éxito, límites estrictos, verificación, cadencia de punto de control y objetivos de reescritura.
6. Después de completar un objetivo, muestra un siguiente mensaje sugerido /goal cuando el trabajo actual comenzó desde /goal o Seguir objetivos; de lo contrario, muestre un siguiente mensaje sugerido con la misma disciplina concreta del siguiente trabajo.

Expectativas de validación#

• Advierte cuando un objetivo activo carece de criterios de éxito, restricciones, verificación, cadencia de puntos de control o objetivos de reescritura.
• Advierte cuando a un punto de control le falta la hora UTC, el estado actual, el trabajo completado, el trabajo restante, el estado del bloqueador, la evidencia o la condición de reanudación.
• Advertir cuando una propuesta de memoria está escrita como verdad aceptada antes de su revisión.
• Advierte cuando un informe final omite archivos modificados, comprobaciones, comprobaciones omitidas, bloqueadores, estado de paquete/publicación, actualizaciones de memoria o un siguiente mensaje visible.
• Advierte cuando la copia pública implica ejecución alojada en UAIX, sincronización automática, adaptadores oficiales, SDK, CLI, certificación, respaldo o publicación de producción sin evidencia.

Si el validador actual aún no puede hacer cumplir una de estas expectativas, indíquelo como guía de documentación o trabajo futuro del validador. No lo describa como comportamiento actual del validador hasta que los esquemas, ejemplos, comprobaciones del validador, evidencia de conformidad y notas de la versión coincidan.

Mensajes copiables#

Mensaje A: Exportación del tiempo de ejecución del objetivo principal#

Goal:
Finish the next bounded work chunk for this project without widening support claims or violating hard constraints.

Success criteria:
- The bounded subtask is complete or a concrete blocker is recorded.
- Targeted checks are run or explicitly skipped with a reason.
- Accepted facts are written back to authoritative UAIX files.
- Runtime status, blockers, handoffs, memory proposals, and final evidence are packetized where applicable.
- A concrete next action is left for continuation.

Constraints:
- Authoritative truth is AGENTS.md plus the listed .uai files.
- Do not treat old chats, raw traces, graph retrieval, or large reports as current truth.
- Do not promote secrets, tokens, credentials, private keys, hidden prompts, or unreviewed cold-memory claims.
- If approval, context, capability, or evidence is missing, stop with a blocker.

Verification:
- Read .uai/test-plan.uai.
- Run targeted checks or name skipped checks.
- Use final-report evidence before completion.
- Write accepted changes back to authoritative files only after review.

Mensaje B: mensaje de ejecución de subtarea#

Read AGENTS.md first, then .uai/readme.human if present, then the relevant .uai files for this subtask.
Summarize current truth, hard constraints, expected touchpoints, and targeted checks.
Complete only this bounded subtask:
<subtask description>

After any meaningful change:
- update short-term-memory/progress/current-state/next-actions as appropriate;
- emit uai.agent.task-status.v1 when external runtime continuity matters;
- emit uai.agent.blocker.v1 if blocked;
- emit uai.agent.handoff.v1 if another actor should continue;
- emit uai.agent.memory-proposal.v1 only for candidate durable facts;
- close with uai.agent.final-report.v1 when the segment ends.

If this is code-bearing, regenerate next-recursive-prompt only after authoritative write-back.
Do not guess through unresolved conflicts.

Mensaje C: mensaje del agente de supervisión#

Monitor correlation_id <id>.
At each checkpoint require:
- percent complete
- current action
- blocker state
- checks run or pending
- skipped checks and reasons
- files/routes/artifacts changed
- memory updates proposed or skipped
- exact next action
- UTC timestamp

If a blocker persists across two checkpoints, require escalation or handoff.
If authoritative files drift from runtime status, prefer authoritative files and request reconciliation.

Mensaje D: Recuperación después de la interrupción#

Resume task <task_id> using the authoritative handoff bundle, not the last chat turn.
Load AGENTS.md, .uai/readme.human if present, .uai/memory-maintenance.uai, identity, world-context, totem, taboo, talisman, short-term-memory, current-state, progress, next-actions, constraints, decisions, and test-plan.
If code-bearing, also load next-recursive-prompt only as derived hot memory.
Reconstruct:
- last accepted checkpoint
- unfinished subtask
- active blockers
- required checks
- exact next action

If any conflict is unresolved, emit a blocker instead of guessing.

Secuencia de paquetes de ejemplo#

{
  "uai_version": "1.0",
  "profile": "uai.agent.task-status.v1",
  "message_id": "uaix-long-goal-status-20260613T210000Z",
  "source": { "id": "agent:worker-1" },
  "target": { "id": "project:example" },
  "body": {
    "task_id": "goal-20260613-001",
    "status": "checkpoint",
    "checked_at_utc": "2026-06-13T21:00:00Z",
    "completed": ["Read authoritative .uai files", "Patched guide source"],
    "remaining": ["Run static discovery test", "Update memory"],
    "evidence": ["git diff", "PHP lint pending"]
  }
}

{
  "uai_version": "1.0",
  "profile": "uai.agent.memory-proposal.v1",
  "message_id": "uaix-memory-proposal-20260613T211500Z",
  "body": {
    "proposal": "Promote the long-running goal guide as current UAIX guide-level operating recipe.",
    "target_records": [".uai/progress.uai", ".uai/short-term-memory.uai"],
    "review_required": true
  }
}

{
  "uai_version": "1.0",
  "profile": "uai.agent.final-report.v1",
  "message_id": "uaix-long-goal-final-20260613T213000Z",
  "body": {
    "status": "complete",
    "changed_files": ["wp-content/themes/uaix-authority-theme/functions.php"],
    "checks": ["php -l", "static discovery assets"],
    "publication_status": "source-only; no live publication claimed"
  }
}

Límite de soporte#

• Soporte actual:receta a nivel de guía, página pública, enlaces cruzados, guía del asistente, exportación de objetivos de seguimiento generados cuando se seleccionan y perfiles de paquetes de agentes UAI-1 existentes.
• Soporte no actual:ejecución alojada, programador, base de datos de memoria administrada, adaptador OpenAI oficial, escrituras automáticas en el repositorio, sincronización automática de LLM Wiki, SDK, CLI, certificación, respaldo o campo de objetivo de API nativa.
• Autoridad:Los UAIX archivos de memoria revisados, páginas públicas, notas de la versión, código, pruebas y registros de proyectos aceptados superan el estado de tiempo de ejecución.

Registros UAIX relacionados#

• Seguir la guía de objetivosSuperposición de objetivos de tiempo de ejecución predeterminados con requisitos condicionales de aviso de siguiente/objetivo.
• Traspaso de proyectoNúcleo de memoria de proyecto duradera y patrón de reescritura.
• Guía de archivos .uaiGuía cerrada sobre el orden de lectura y el conjunto de archivos requeridos.
• Guía OpenAI/CódiceOpenAI ejecuta agentes; Project Handoff conserva la memoria del proyecto.
• Guía de agentes codificadoresAplique el mismo paquete de transferencia en superficies de agentes con capacidad de codificación.
• Guía de presupuesto contextualMantenga los archivos de transferencia en caliente compactos y la memoria en frío recuperable.
• Modelo operativo de comunicación del agentePerfiles de paquetes para estado, bloqueador, transferencia, propuesta de memoria e informe final.
• EsquemasColección de esquemas UAI-1 verificable por máquina.
• RegistroID de perfil publicados y notas de compatibilidad.
• EjemplosAccesorios de paquetes seguros y escenarios de solo referencia.
• ValidadorLas comprobaciones actuales solo se realizan cuando se implementa realmente el comportamiento del validador.
• Kit de adopciónPaquete de evidencia inicial para registros respaldados.
• Paquete de conformidadEvidencia reutilizable de conformidad y revisión de lanzamiento sin declaraciones de certificación.
• Política y seguridadSecretos, redacción y postura de límites de apoyo.
• Hoja de rutaTiempo de ejecución actual versus planificado, adaptador, SDK, CLI y límites de certificación.
• Registro de cambiosRegistro público de cambios fechado.

Resumen legible por máquina#

Los agentes deben tratar este resumen como evidencia de orientación de página, no como autoridad de tiempo de ejecución.

{
    "kind": "uaix.guide.long-running-goal-execution.v1",
    "canonical_route": "/en-us/guides/long-running-goal-execution/",
    "status": "guide-level operating recipe",
    "standard_version": "v1.0",
    "composes": [
        "Project Handoff",
        ".uai File Guide",
        "Follow Goals runtime overlay",
        "UAI-1 agent packet profiles",
        "Context Budget"
    ],
    "not_a": [
        "runtime",
        "scheduler",
        "hosted memory database",
        "OpenAI adapter",
        "SDK",
        "CLI",
        "certification",
        "hosted importer",
        "automatic repository writer",
        "automatic sync"
    ],
    "required_packets": [
        "uai.task.status.v1",
        "uai.agent.task-status.v1",
        "uai.agent.blocker.v1",
        "uai.agent.handoff.v1",
        "uai.agent.memory-proposal.v1",
        "uai.agent.final-report.v1"
    ],
    "writeback_rule": "Runtime state is not accepted memory until reviewed and promoted into authoritative .uai files, docs, code, tests, release notes, roadmap state, or machine artifacts.",
    "checkpoint_cadence": "Checkpoint after meaningful work, before interruption, before boundary expansion, before context compaction, and before final handoff."
}

[]

Memoria de objetivos jerárquica#

UsarMemoria de objetivos jerárquicacuando un objetivo a largo plazo necesita subobjetivos, registros plegados, recuperación de evidencia limitada, revisión de contexto nuevo y reescritura controlada por revisión sin convertir los resúmenes en autoridad.