Exécution des objectifs à long terme

L’exécution d’objectifs à long terme garantit que le travail des agents pouvant être interrompu est visible, repris et soumis à une révision.Utilisez ce guide lorsqu’un projet combine des fichiers mémoire UAIX .uai, un objectif d’exécution de type Follow Goals, des paquets de tâches UAI-1, des points de contrôle, des bloqueurs, des transferts, des rapports finaux et une écriture faisant autorité.

Il s’agit d’un modèle de documentation et de preuves. Le runtime, l’EDI, le moteur de workflow, l’opérateur humain ou la plateforme d’agent sont toujours propriétaires de l’exécution, de la planification, de l’accès aux outils, des approbations, des traces et de la mémoire gérée.

À quoi sert cette page#

• Planifiez un travail long qui peut être interrompu, repris, délégué, mis en pause ou terminé sur plusieurs sessions d’agent.
• Gardez l’objectif d’exécution actif petit tandis que la mémoire durable du projet reste dans AGENTS.md, .uai/readme.human, les enregistrements .uai saisis et l’examen des preuves publiques ou locales.
• Mappez les points de contrôle, les bloqueurs, les transferts, les propositions de mémoire et les rapports finaux dans les profils de paquets d’agent UAI-1 existants sans inventer de nouveau schéma.
• Donnez aux humains un chemin de révision clair avant qu’un résultat d’exécution ne devienne la vérité acceptée du projet.

Ce que ce n’est pas#

• Il ne s’agit pas d’un environnement d’exécution, d’un planificateur, d’une file d’attente, d’un démon, d’un moteur de flux de travail, d’une base de données de mémoire, d’un magasin de vecteurs, d’un magasin de trace ou d’un service d’orchestration hébergé par UAIX.
• Il ne s’agit pas d’un adaptateur OpenAI officiel, d’un champ d’objectif OpenAI natif, de SDK, CLI, d’un importateur hébergé, d’un rédacteur de référentiel, d’une synchronisation automatique LLM Wiki, d’un programme de certification, d’approbation ou de conformité.
• Pas l’autorisation d’exécuter des outils, de déployer, de publier, de s’authentifier, d’accéder à des secrets, de muter la mémoire, d’élargir les revendications de soutien public ou de contourner la politique locale.
• Ce n’est pas une raison pour copier des traces brutes, des journaux privés, des invites cachées, des secrets ou des résumés générés non vérifiés dans une mémoire durable.

Division des calques#

Modèle d’objectif canonique à long terme#

1. Chargez la porte d’entrée de transfert et les fichiers .uai requis.
2. Énoncez l’objectif, les critères de réussite, les limites strictes, le plan de vérification, les points de contact attendus et la cadence des points de contrôle avant un travail général.
3. Exécutez une tranche délimitée dans le runtime externe.
4. Émettez un paquet de point de contrôle lorsque des changements d’état significatifs ou une interruption sont probables.
5. Émettez un paquet bloqueur lorsque le même obstacle ne peut pas être résolu en toute sécurité.
6. Émettez un paquet de transfert lorsqu’un autre agent, un humain, un runtime ou une future session doit continuer.
7. Émettre des paquets de propositions de mémoire pour les faits durables candidats; ne les écrivez pas comme étant véridiques jusqu’à ce qu’ils soient examinés.
8. Émettez un paquet de rapport final lorsque l’objectif est atteint ou est explicitement clôturé.
9. Rédigez les résultats acceptés dans des enregistrements faisant autorité, puis archivez ou citez le matériel d’exécution brut comme preuve uniquement lorsque cela est utile.

Ordre de lecture obligatoire#

1. Instruction humaine actuelle et politique locale.
2. AGENTS.md ou .uai/readme.human comme porte d’entrée du projet.
3. .uai/memory-maintenance.uai, ancres d’instructions actives protégées et .uai/short-term-memory.uai.
4. .uai/startup-packet.uai, .uai/system-profile.uai et .uai/receiver-brief.uai lorsqu’ils sont présents pour le transfert du projet.
5. .uai/constraints.uai, .uai/progress.uai, .uai/decisions.uai, .uai/test-plan.uai et enregistrements de portée du code lorsque le travail touche au code.
6. .uai/exports/follow-goal.json uniquement lorsque l’environnement récepteur utilise Follow Goals ou /goal.
7. Prise de transfert de fichiers d’agent actif avant un travail général sans rapport.
8. Sources wiki à mémoire froide ou LLM uniquement une fois que la mémoire actuelle compacte et les limites sont claires.

Mappage de fichiers pour les points de contrôle#

Mappage des paquets d’exécution#

Cadence du point de contrôle#

• Point de contrôle après chaque changement de source significatif, étape de publication, étape de migration ou mise à jour de preuves examinées.
• Point de contrôle avant le compactage du contexte, les longues attentes, le transfert d’outils, l’interruption de processus ou le changement d’agent.
• Point de contrôle avant d’étendre l’autorité, de modifier la mémoire protégée, de publier, de déployer ou de toucher des systèmes adjacents à des secrets.
• Point de contrôle lorsque l’état de la vérification passe de non exécuté à réussi, échoué, ignoré ou bloqué.
• Ne contrôlez pas les points si fréquemment que le bruit remplace la progression; chaque point de contrôle doit répondre à ce qui a changé, à ce qui reste, aux preuves existantes et à ce qui peut reprendre en toute sécurité.

Charge utile minimale du point de contrôle: ID de tâche ou de corrélation, action en cours, travail terminé, preuves produites, tests/vérifications exécutés, tests/vérifications ignorés et pourquoi, bloqueurs actifs, risques, fichiers ou itinéraires modifiés, mises à jour de mémoire proposées, mises à jour de mémoire intentionnellement ignorées, action suivante exacte et horodatage UTC.

Interruption et reprise du flux#

1. Arrêtez-vous sur une limite sûre: sauvegardez les fichiers, évitez les versions à moitié écrites et ne laissez pas en attente d’opérations destructrices.
2. Écrivez un point de contrôle de l’état de la tâche avec l’heure UTC, la tranche actuelle, le travail terminé, les fichiers modifiés, les vérifications, les bloqueurs et la commande ou l’invite de reprise.
3. Mettez à jour .uai/short-term-memory.uai et .uai/progress.uai uniquement avec les faits candidats acceptés ou clairement marqués.
4. À la reprise, rechargez les instructions actuelles, la mémoire de la porte d’entrée, l’admission active et le dernier point de contrôle avant d’utiliser l’ancien contexte de discussion.
5. Résumez l’état de reprise et demandez une intervention humaine uniquement lorsque le bloqueur ne peut pas être résolu à partir de preuves visibles et qu’une hypothèse raisonnable serait risquée.

Flux d’état: LoadAuthoritative -> BuildRuntimeGoal -> Working -> Checkpointed -> Working. S’il manque une approbation, un contexte, une capacité ou des preuves, passez à Blocked. Si un autre acteur doit continuer, passez à Handoff. Lorsque les critères terminés sont remplis, passez à Finalized, puis à WriteBack, puis arrêtez.

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.

Échelle de résolution des conflits#

1. L’autorisation humaine explicite d’artefact et d’opération contrôle la mutation d’ancre protégée.
2. .uai/memory-maintenance.uai, .uai/totem.uai, .uai/taboo.uai et .uai/talisman.uai régissent le cycle de vie de la mémoire et les limites protégées.
3. AGENTS.md ou .uai/readme.human fournissent le dossier d’entrée et les instructions du projet local.
4. Les fichiers .uai faisant autorité contrôlent la vérité actuelle du projet.
5. Les pages UAIX publiques actuelles, le code, les tests, les notes de version, l’état de la feuille de route, les preuves du validateur et les artefacts de la machine régissent les demandes de support public.
6. Les exportations de suivi des objectifs, l’invite récursive suivante, les paquets d’état des tâches, les résumés d’exécution, les projections graphiques et les notes de mémoire froide sont subordonnés à moins qu’ils ne soient examinés et promus.
7. Les anciennes discussions, les journaux bruts, les anciens rapports, les notes d’archives non révisées et les réponses de récupération ne sont que des pistes sources.

Si le conflit persiste, arrêtez le travail général, émettez un bloqueur, nommez les artefacts en conflit, nommez la prochaine action de révision la plus sûre et ne fusionnez pas ou n’écrasez pas silencieusement la mémoire durable.

Règles de portée portant code#

• Pour le code, l’automatisation, les flux de travail exécutables ou les artefacts de type code, nécessitent une architecture, des normes de codage, des contraintes, des progrès, un plan de test et des enregistrements d’invites récursives suivantes avant une modification générale.
• Cartographiez les points de contact attendus, les risques et les tests ciblés avant de modifier le code.
• Exécutez des vérifications ciblées de syntaxe, d’unité, d’intégration, statiques, de package, de paramètres régionaux, de route ou de navigateur qui correspondent au comportement touché.
• Ne revendiquez jamais le déploiement, la publication, le téléchargement de packages, les écritures automatiques dans le référentiel, SDK, CLI, l’adaptateur officiel, la certification ou l’approbation sans preuve.

Règles de portée autre que le code#

• Pour la rédaction, la recherche, la gouvernance, la localisation, le référencement, la politique ou la planification, exigez des notes sources, la surface publique actuelle, l’examen des limites de support et le chemin des preuves finales.
• Ne synthétisez pas le texte des normes normatives, les traductions ou l’autorité politique sans examen.
• Utilisez la validation sans opération/source uniquement lorsqu’il n’y a plus de travail concret de fonctionnalité, de bogue, d’amélioration, de test/vérification, de package ou de publication à effectuer et d’énoncer clairement la condition d’arrêt.
• Conservez les explications destinées aux humains dans les fichiers .human, le texte des instructions de l’IA dans les fichiers .uai et les données structurées dans les fichiers .json à l’intérieur de .uai/.

Contexte chaud et mémoire froide#

Le contexte chaud est ce que le prochain agent doit charger par défaut: état actuel, contraintes, décisions, bloqueurs actifs, prochaines actions, contrôles ciblés et résultats récemment acceptés. La mémoire froide est une provenance récupérable: longs rapports, anciennes discussions, traces brutes, instantanés de recherche, apports archivés et justifications volumineuses. La mémoire froide peut éclairer les travaux futurs, mais elle ne devient active que lorsqu’un fait examiné est intégré aux archives actuelles.

Modèle d’agent hiérarchique#

Un projet de longue durée peut utiliser un coordinateur et des travailleurs spécialisés, mais UAIX enregistre le transfert, pas la hiérarchie en direct. Le coordinateur est responsable de la définition des objectifs, de l’ordre de lecture, des vérifications des conflits, de l’examen des points de contrôle, des propositions de mémoire et du rapport final. Les agents de travail possèdent des tâches limitées et renvoient des paquets d’état de tâche, de blocage, de transfert ou de rapport final. L’examen humain contrôle toujours la mémoire protégée, les revendications publiques, la publication et le déploiement.

Évaluation dans un nouveau contexte#

Lorsqu’un nouvel agent évalue le travail, il doit charger les derniers fichiers faisant autorité, ignorer la mémoire de discussion privée à moins qu’elle ne soit explicitement fournie, comparer les réclamations avec les preuves sources, exécuter ou examiner des contrôles ciblés et décider si la sortie précédente est acceptée, rejetée, partiellement acceptée ou nécessite un bloqueur. Un nouveau contexte est utile car il détecte les dérives qu’une longue session peut normaliser.

Configuration de l’assistant#

1. Ouvrez leAssistant de paquet de mémoire IA.
2. Sélectionnez Project Handoff ou un autre package de code/projet qui correspond au travail.
3. Remplissez le paquet de démarrage, le brief du destinataire, les contraintes, les progrès, les décisions, le plan de test et les fichiers de portée du code à partir de preuves visibles.
4. Activez Suivre les objectifs uniquement lorsque le récepteur utilise /goal ou une superposition d’objectifs d’exécution équivalente.
5. Assurez-vous que .uai/exports/follow-goal.json nomme un objectif actif, des critères de réussite, des limites strictes, une vérification, une cadence de point de contrôle et des cibles de réécriture.
6. Après avoir atteint un objectif, affichez une invite /goal suivante suggérée lorsque le travail en cours a commencé à partir de /goal ou suivez les objectifs; sinon, affichez une invite suivante suggérée avec la même discipline concrète de prochain travail.

Attentes de validation#

• Avertir lorsqu’un objectif actif manque de critères de réussite, de contraintes, de vérification, de cadence de point de contrôle ou d’objectifs de réécriture.
• Avertir lorsqu’un point de contrôle manque d’heure UTC, d’état actuel, de travail terminé, de travail restant, de statut de bloqueur, de preuves ou de condition de reprise.
• Avertir lorsqu’une proposition de mémoire est rédigée comme étant une vérité acceptée avant son examen.
• Avertir lorsqu’un rapport final omet des fichiers modifiés, des vérifications, des vérifications ignorées, des bloqueurs, l’état du package/publication, des mises à jour de mémoire ou une invite suivante visible.
• Avertir lorsqu’une copie publique implique une exécution hébergée par UAIX, une synchronisation automatique, des adaptateurs officiels, SDK, CLI, une certification, une approbation ou une publication de production sans preuve.

Si le validateur actuel ne peut pas encore appliquer l’une de ces attentes, indiquez-la comme guide de documentation ou comme travail futur du validateur. Ne le décrivez pas comme le comportement actuel du validateur tant que les schémas, les exemples, les vérifications du validateur, les preuves de conformité et les notes de version ne sont pas d’accord.

Invites copiables#

Invite A: Exportation de l’environnement d’exécution de l’objectif parent#

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.

Invite B: invite d’exécution de sous-tâche#

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.

Invite C: invite de l’agent de surveillance#

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.

Invite D: récupération après interruption#

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.

Exemple de séquence de paquets#

{
  "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"
  }
}

Limite de support#

• Prise en charge actuelle:recette de niveau guide, page publique, liens croisés, conseils de l’assistant, exportation des objectifs de suivi générée une fois sélectionnée et profils de paquets d’agent UAI-1 existants.
• Pas de support actuel:exécution hébergée, planificateur, base de données de mémoire gérée, adaptateur OpenAI officiel, écritures automatiques dans le référentiel, synchronisation automatique du wiki LLM, SDK, CLI, certification, approbation ou champ d’objectif de l’API native.
• Autorité:l’examen des fichiers mémoire UAIX, des pages publiques, des notes de version, du code, des tests et des enregistrements de projet acceptés a permis de gagner sur l’état d’exécution.

Enregistrements UAIX associés#

• Suivre le guide des objectifsSuperposition d’objectifs d’exécution par défaut avec exigences conditionnelles d’invite suivante/objectif.
• Transfert de projetMémoire de projet et modèle de réécriture durables de base.
• Guide des fichiers .uaiEnsemble de fichiers requis fermé et conseils sur l’ordre de lecture.
• Guide OpenAI/CodexOpenAI exécute des agents; Project Handoff préserve la mémoire du projet.
• Guide des agents de codageAppliquez le même ensemble de transferts sur les surfaces d’agent compatibles avec le code.
• Guide budgétaire contextuelGardez les fichiers de transfert à chaud compacts et la mémoire froide récupérable.
• Modèle opérationnel de communication des agentsProfils de paquets pour l’état, le bloqueur, le transfert, la proposition de mémoire et le rapport final.
• SchémasCollection de schémas UAI-1 vérifiable par machine.
• RegistreID de profil publiés et notes de compatibilité.
• ExemplesMontages de paquets sécurisés et scénarios de référence uniquement.
• ValidateurCurrent vérifie uniquement là où le comportement du validateur est réellement implémenté.
• Kit d’adoptionEnsemble de preuves de démarrage pour les enregistrements pris en charge.
• Paquet de conformitéPreuves de conformité et d’examen de lancement réutilisables sans réclamations de certification.
• Politique et sécuritéSecrets, rédaction et posture de limite de support.
• Feuille de routeDurée d’exécution actuelle par rapport à prévue, adaptateur, SDK, CLI et limites de certification.
• Journal des changementsDossier de modification public daté.

Résumé lisible par machine#

Les agents doivent traiter ce résumé comme une preuve d’orientation de page et non comme une autorité d’exécution.

{
    "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."
}

[]

Mémoire d’objectif hiérarchique#

UtiliserMémoire d’objectif hiérarchiquelorsqu’un objectif à long terme a besoin de sous-objectifs, d’enregistrements pliés, de récupération de preuves limitées, de révision de contexte frais et de réécriture contrôlée sans transformer les résumés en autorité.