Agents Never Sleep (ANS)
Exécuter un backlog jusqu'à son achèvement sans supervision, sans que l'exécution ne s'arrête jamais en douceur sur une question. La partie difficile n'est pas d'effectuer le travail — c'est la durabilité de l'état + la sémantique concrète park-vs-continue + l'anti-famine, et c'est autour de cela que ce skill est construit. La colonne vertébrale de fiabilité a été livrée en premier (voir BUILD-PLAN.md); l'entonnoir de révision multi-modèle plus lourd a été séquencé par-dessus et est maintenant construit (statut dans « La machinerie qualité superposée à la colonne vertébrale » ci-dessous).
Justification complète :
agents-never-sleep-design.md(13 fils de conception + 3 revues du conseil). La colonne vertébrale MVP est implémentée sous la forme d'un petit package Python sousagents_never_sleep/(l'ancien nom d'importationharnessfonctionne toujours via un shim de rétrocompatibilité pour toute la version 1.x) et est prouvée paracceptance/run_acceptance.py(le seul test qui correspond à la douleur « s'arrête en cours d'exécution »).
Le contrat d'autonomie — trois états distincts, jamais fusionnés
Une exécution a exactement trois réponses à l'incertitude. Gardez-les séparées ; les fusionner, c'est ainsi qu'une exécution s'inverse dans le blocage même qu'elle existe pour empêcher.
- ASK — demander à l'humain. Interdit en mode non supervisé. N'émettez pas
AskUserQuestion; il n'y a personne pour répondre à 2 heures du matin, et une seule question gaspille toute l'exécution. Ceci est appliqué structurellement, pas par discipline : le hook PreToolUsedeny_ask.sh(correspondantAskUserQuestion, conditionné par l'environnementCLAUDE_UNATTENDED=1) REFUSE l'outil et vous redirige vers PARK/PROCEED — le miroir de la garantie de non-arrêt. - PARK — reporter cette décision ou ce ticket et continuer l'exécution vers le prochain ticket indépendant. Le parking est normal et sain, pas un arrêt.
- HALT — arrêter toute l'exécution. Uniquement en cas de danger vraiment irréversible que la couche de hook bloquerait de toute façon, ou lorsqu'il n'y a aucun filet de sécurité de réversibilité (système de fichiers en lecture seule, pas de VCS et aucun de créable).
En mode non supervisé, vous ne choisissez jamais que PROCEED, PARK ou HALT. Jamais ASK.
Décider PROCEED vs PARK par rayon d'explosion (donc « incertain » est rare)
Rendez le nivellement concret — deviner sur un élément à fort rayon d'explosion et avoir tort avec confiance pour toute l'exécution est le pire résultat, pire que le parking.
Hard-PARK (ne jamais deviner) : schéma de base de données / direction de migration, contrat d'API public ou partagé, limite de sécurité / authentification / isolation de locataire, argent / facturation / tarification, une interface inter-tickets sur laquelle d'autres construisent, et le sens de l'exigence (vous ne savez pas réellement quoi construire) à moins qu'il ne soit à la fois localement réversible et isolé — alors construisez-le de manière réversible derrière un drapeau / un changement de brouillon ET reportez la décision (hybride).
Proceed (supposer + journaliser + continuer) : nommage, structure interne, formulation des logs / commentaires / erreurs, fixtures de test, un choix entre deux implémentations locales équivalentes, des valeurs par défaut trivialement activables/désactivables.
Quand vraiment non classifiable → PARK. Un petit élément mal parké coûte une décision de 5 secondes par la suite ; un grand élément mal supposé coûte une exécution de travail erroné.
Validez chaque hypothèse PROCEED afin qu'elle puisse être annulée ; si le commit instantané ne peut pas être effectué (verrouillage Git / délai d'attente / magasin d'objets en lecture seule), traitez le ticket comme BLOCKED_ENV plutôt que de modifier de manière irréversible. Chaque PARK doit enregistrer : pourquoi, les interprétations candidates, l'action humaine exacte suivante, et son périmètre de contamination.
La boucle par ticket (ce que le harnais applique)
- Preflight mesure les capacités (
agents_never_sleep/preflight.py) — VCS/réversibilité, plateforme, portes, mode d'exécution, tokonomix/Vault/Paperclip. Une capacité manquante n'arrête jamais l'exécution ; elle abaisse le rendement attendu et augmente le conservatisme. Pas de VCS → établir un filet de sécurité (git init / sauvegarde horodatée) avant toute modification risquée ; si impossible → non destructif uniquement. - Décider ASK/PARK/HALT pour le ticket (ci-dessus). Non supervisé : ASK→PARK.
- Implémenter le ticket PROCEED — vous, l'agent, êtes le travailleur : lisez le ticket que le harnais vous remet et modifiez les fichiers. Vous pilotez ce ticket un à la fois via les deux sous-commandes ci-dessous ; le harnais possède l'ordonnancement, le parking, l'instantané/rétablissement et la sentinelle de non-arrêt.
- Tester déterministiquement (
agents_never_sleep/gates.py) — le FONDEMENT. Classifier les échecs : introduits par le diff → blocage dur (revenir au dernier vert + parker/échouer) ; préexistants / instables / environnement → baisser la confiance, continuer ou parker (ne jamais rapporter comme « le ticket a échoué ») ; délai d'attente / environnement → BLOCKED_ENV. Chaque porte s'exécute avec un délai d'attente par étape et un environnement non interactif afin qu'elle ne puisse jamais se bloquer sur une invite TTY. Ne jamais supprimer ou sauter un test qui échoue pour devenir vert — c'est un angle mort bloquant. - Enregistrer exactement un résultat durable (
agents_never_sleep/state.py) : DONE, DONE_LOW_CONFIDENCE, PARKED_DECISION, PARKED_FOUNDATIONAL, BLOCKED_ENV, FAILED_RETRYABLE, FAILED_BUG_IN_AGENT — avec les champs requis. Écritures atomiques ; sûr pour la reprise. - Ticket suivant. Tentative + limite de boucle (
agents_never_sleep/ledger.py) force le park d'un ticket qui dépasse sa limite de tentatives inter-reprises ou qui boucle de manière prouvée, afin que l'exécution ne soit jamais consumée sur un seul élément maudit. Un disjoncteur de faible rendement s'arrête et alerte si la plupart du travail est parké/bloqué.
L'exécuter — l'agent EST le travailleur (piloter cette boucle)
Avant de démarrer à partir d'une session interactive, demandez à l'utilisateur UNE FOIS, dans le chat : exécuter le backlog ici dans cette session (premier plan — il s'arrête s'il ferme le terminal), ou lancer une exécution détachée via bin/ans-run qui survit à la déconnexion ? C'est une décision de configuration/routage, pas une question en milieu d'exécution — cela ne viole pas le contrat jamais-ASK, et c'est la seule question que vous posez.
Si le mode consensus tokonomix est configuré (bloc council dans les charges utiles PROCEED, ou un outil MCP tokonomix_* est disponible) : au début de l'exécution :
- Non supervisé (
CLAUDE_UNATTENDED=1): émettre UNE ligne de log et continuer immédiatement — ne jamais bloquer ou demander :ℹ️ Consensus Tokonomix actif — notation automatique de chaque appel du conseil via tokonomix_rate_consensus. - Interactif (pas de
CLAUDE_UNATTENDED): si le compte n'a pas encore de préférence de notation enregistrée (c'est-à-dire quereview_feedback_opt_inn'est pas encore défini — détectable carfeedback_inviteest absent de la première réponse de consensus), demandez à l'utilisateur UNE FOIS dans le chat :« Le consensus Tokonomix est actif. Après chaque appel du conseil, je peux soumettre automatiquement une évaluation d'utilité (score + constatations) pour améliorer les scores du modèle. Activer cette option ? (oui/non) » Stockez la réponse dans
.unattended/state/consensus_rating_pref.jsonafin que cette question ne soit posée qu'une seule fois entre les sessions. Si oui : continuer avec la notation automatique. Si non : ignorer complètement les appels de notation.
Si consensus_rating_endpoint_enabled renvoie 404 lors de la première tentative de notation, journalisez-le une fois comme un angle mort et ignorez tous les appels de notation suivants pour cette exécution.
Le harnais ne peut pas vous appeler depuis l'intérieur d'une boucle Python, donc vous le pilotez. Alternez ces deux sous-commandes jusqu'à ce que le backlog soit épuisé. Chacune imprime un objet JSON sur la sortie standard.
# 1. Demander au harnais la prochaine chose à faire. Il parque automatiquement les tickets ambigus/à fort rayon d'explosion
# et ne vous remet JAMAIS qu'UN SEUL ticket prêt à être implémenté, ou un signal terminal.
python3 -m agents_never_sleep.run next --repo <project> --tickets <dir-of-.md-tickets>
Lisez le status JSON :
-
PROCEED→ implémenter UNIQUEMENTticket.bodyen modifiant les fichiers dans le dépôt (ne touchez PAS aux autres tickets, ne vous arrêtez PAS, ne demandez PAS). Ensuite, appelezcomplete:python3 -m agents_never_sleep.run complete --repo <project> --attempted "résumé en une ligne de ce que vous avez fait"Utilisez
--cannot-implement(avec--attemptedexpliquant pourquoi) si vous ne pouvez vraiment pas le faire — le harnais annule vos modifications partielles et enregistre BLOCKED_ENV. Aprèscomplete, appelez à nouveaunext.Si la charge utile
PROCEEDcontenait un bloccouncilouspecialists, vous avez effectué des révisions — vous DEVEZ renvoyer les résultats surcomplete, sinon la porte de confiance consultative ne se déclenche jamais silencieusement :... complete --attempted "…" [--council-verdict pass|concerns|error --council-cost <€>] \ [--specialist-concerns architect,security,… --specialist-cost <€>] [--review-coverage "<qui a exécuté>"]. Omettez un indicateur uniquement lorsque vous n'avez effectué aucune révision de ce type. (Détails : les sections Conseil et Spécialistes ci-dessous.) -
PARK_CONSENSUS_ELIGIBLE→ le ticket serait autrement PARKé sur une ambiguïté de sens de l'exigence uniquement (jamais une catégorie Hard-PARK). Exécutez le consensus tokonomix fondé que lepromptde la charge utile demande (proposeurs parallèles + aveugles, un juge disjoint) — ne demandez jamais un texte libre « dois-je continuer ? », c'est le cadrage dangereux que l'invite interdit explicitement. Ensuite, rapportez le verdict structuré, en renvoyant leattempt_idde la charge utile d'offre :... resolve-park --ticket-id <id> --attempt-id <attempt_id depuis la charge utile d'offre> --resolved \ --chosen-reading "<la lecture>" --evidence "<preuves exactes citées>" --dissent-count <N> \ --synthesis-text "<synthèse du juge>"ou
--not-resolvedsi le consensus n'a pas pu lever l'ambiguïté sur les preuves citées. La porte déterministe du harnais est le SEUL arbitre — un verdict résolu achemine vers le flux normalPROCEED(implémenter, puiscompletecomme d'habitude) ; un verdict refusé parque le ticket avec une piste d'audit et passe à autre chose. Unresolve-parken double sur le même ticket est toujours un no-op sûr (ALREADY_RESOLVED). (Détails : la section F5 ci-dessous.) -
DRAINED/HALTED/LOW_YIELD→ l'exécution est terminée ; le rapport d'exécution est écrit. Arrêtez. -
NON_DESTRUCTIVE→ non supervisé sans configuration enregistrée ; effectuez d'abord une exécution interactive de configuration.
N'inventez jamais votre propre boucle et ne vous arrêtez pas prématurément. next possède la sentinelle .unattended/run-incomplete que le hook Stop utilise pour bloquer un arrêt prématuré ; continuez à appeler next jusqu'à ce qu'il renvoie un état terminal. Le harnais gère l'instantané avant modification, la porte après modification, le retour arrière en cas d'échec, la limite de tentatives, la détection de boucle et le disjoncteur de faible rendement — votre seul travail est les modifications.
Contrat de chemin de sentinelle (porteur, appliqué). Le hook Stop vérifie
${UE_RUN_INCOMPLETE:-$PWD/.unattended/run-incomplete}et le pilote écrit le même chemin. Ils s'accordent automatiquement uniquement lorsque l'agent s'exécute depuis la racine du dépôt (donc$PWD == --repo; utilisez--repo .). Pour une exécution non supervisée où le répertoire de travail courant peut différer de--repo(cron /claude-run), exportezUE_RUN_INCOMPLETE=<repo>/.unattended/run-incompleteau lancement. Pour empêcher le non-arrêt de se briser silencieusement,nextéchoue durement (status:"ERROR", exit 2) lorsqu'il est non supervisé + CWD ≠--repo+UE_RUN_INCOMPLETEnon défini — corrigez le lancement (cd dans le dépôt, ou définissez la variable d'environnement).
La première exécution interactive déclenche un assistant minimal par projet (.claude/agents-never-sleep.json).
Le skill ne se planifie jamais tout seul — l'exécution non supervisée (cron / claude-run) est toujours un acte explicite
de l'utilisateur, donc l'assistant s'exécute toujours en premier. Non supervisé sans configuration → non destructif uniquement
- une note bien visible dans le rapport.
La démonstration d'acceptation hermétique (
acceptance/run_acceptance.py) pilote la boucle en cours de processus avec unDemoWorkerdéterministe pour les autotests uniquement — il n'y a pas de sous-commanderunen cours de processus. Les vraies exécutions utilisent toujours le fluxnext/completeci-dessus.
Lancer une exécution — bin/ans-run (vérification préalable avant jetons + verrouillage de l'arbre de travail)
agents_never_sleep/preflight.py mesure les capacités APRÈS le démarrage de la session de l'agent — à ce moment-là, les premiers
jetons sont déjà dépensés et une exécution vouée à l'échec a déjà coûté de l'argent. Pour les lancements sans tête/cron,
passez plutôt par le lanceur :
bin/ans-run [--repo <project>] [--agent <preset>] [--fg] [--check] [--trust] "<prompt>"
C'est une porte GO/NO-GO déterministe qui s'exécute AVANT le démarrage du CLI de l'agent :
- confiance dans la configuration (TOFU) —
.claude/agents-never-sleep.jsonvoyage avec le dépôt et décrit les commandes que le lanceur exécute (argv de l'agent, vérifications de l'hôte). Une configuration nouvelle ou modifiée doit être approuvée une fois par utilisateur — de manière interactive à l'invite, ou explicitement viaans-run --trustaprès révision. Sans tête + non approuvé = NO-GO. La confiance est enregistrée en dehors du dépôt (~/.config/agents-never-sleep/trusted.json, indexée par le SHA-256 de la configuration) — le dépôt ne peut pas se porter garant de lui-même. N'exécutez jamais ans-run dans un dépôt auquel vous faites moins confiance qu'à sonmake install. - identité —
launcher.target_userconfigurable + garde racine : démarré en tant que root avec un utilisateur cible configuré → réexécuter en tant que cet utilisateur ; en tant que root sans aucun configuré → NO-GO (une exécution non supervisée ne doit jamais s'exécuter en tant que root), - sélection de l'agent — préréglages nommés sous
launcher.agents, sélectionnés par--agentoulauncher.default_agent. Aucune détection de plateforme au moment du lancement (les marqueurs d'environnement de session sont falsifiables et disparaissent sous cron) ; l'assistant est l'endroit où la détection — comme indice de préremplissage — et la décision humaine se trouvent. Trois portes par préréglage : argv[0] doit être un CLI d'agent connu (claude/codex/gemini/copilot; remplacement uniquement vialauncher.allow_custom_agentdans une configuration approuvée), le binaire doit passer une **sonde de capacité**--versionde 5 s (détecte la dérive des indicateurs avant que les jetons ne soient dépensés), etautonomy_confirmed` doit être vrai (voir ci-dessous), - informations d'identification —
launcher.credentials_pathsest bloquant lorsqu'il est configuré, avertissement uniquement lorsqu'il ne l'est pas (les configurations de trousseau de clés et de clé API n'ont aucun fichier d'informations d'identification), - santé du dépôt — git utilisable (capture dubious-ownership), dépôt inscriptible, espace disque
(
launcher.min_disk_mb), arbre sale/stocké signalé comme avertissements, - vérifications de l'hôte — les sondes de services/BD proviennent EXCLUSIVEMENT de
launcher.checks([{"name", "command", "blocking"}]) ; rien de spécifique au site n'est codé en dur dans le lanceur.
Codes de sortie : 0 démarré/GO · 64 NO-GO · 65 arbre de travail occupé.
Les indicateurs d'autonomie sont une décision humaine explicite — jamais une valeur par défaut
Une exécution détachée avec le système d'autorisation du CLI complètement activé se bloque à sa première invite d'approbation
(stdin est fermé, personne ne regarde) ; l'indicateur qui empêche cela accorde un vrai pouvoir. La carte
livrée (agents_never_sleep/agent_clis.py, source unique pour l'assistant + le lanceur) garde les deux variantes séparées et
l'assistant montre ce que l'indicateur accorde avant de vous demander de confirmer — alors seulement le préréglage
enregistre autonomy_confirmed et devient lançable.