Communitygithub.com

TokonoMix/agents-never-sleep

Gouvernance d'exécution autonome pour les agents de codage : exécuter un backlog de tickets jusqu'à son achèvement sans supervision. Contrat d'autonomie ASK/PARK/HALT, machine d'état durable par ticket, portes de test déterministes, réversibilité basée sur Git, watchdog par battement de cœur, rapport matinal. Uniquement la bibliothèque standard Python.

Qu'est-ce que agents-never-sleep ?

Le skill **Agents Never Sleep (ANS)** fournit un cadre de gouvernance d'exécution autonome pour les agents de codage tels que Claude Code, Codex, Gemini et Copilot. Il permet d'exécuter un backlog de tickets de manière ininterrompue, sans jamais faire de pause pour poser une question à un humain. Au cœur du système se trouve un contrat d'autonomie à trois états distincts (ASK, PARK, HALT) qui empêche l'arrêt prématuré d'une session non supervisée, notamment en bloquant structurellement l'utilisation de `AskUserQuestion`. Un moteur de machine d'état par ticket assure la durabilité des états (DONE, PARKED, BLOCKED_ENV, etc.) et permet la reprise après interruption. Les portes de test déterministes classifient les échecs (introduits par le diff, préexistants, ou environnementaux) pour ne jamais cacher un régressif. La réversibilité est garantie par des snapshots Git avant chaque modification risquée, et un mécanisme anti-famine empêche de gaspiller la session sur un ticket problématique. Le skill est livré avec un lanceur (`bin/ans-run`) qui effectue une vérification préalable complète (confiance dans la configuration, identité, santé du dépôt, etc.) avant de démarrer l'agent. L'ensemble ne dépend que de la bibliothèque standard Python, ce qui le rend léger et facile à intégrer dans n'importe quel projet.

Compatible avec✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓Windsurf
npx skills add TokonoMix/agents-never-sleep

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 sous agents_never_sleep/ (l'ancien nom d'importation harness fonctionne toujours via un shim de rétrocompatibilité pour toute la version 1.x) et est prouvée par acceptance/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 PreToolUse deny_ask.sh (correspondant AskUserQuestion, conditionné par l'environnement CLAUDE_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)

  1. 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.
  2. Décider ASK/PARK/HALT pour le ticket (ci-dessus). Non supervisé : ASK→PARK.
  3. 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.
  4. 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.
  5. 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.
  6. 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 que review_feedback_opt_in n'est pas encore défini — détectable car feedback_invite est 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.json afin 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 UNIQUEMENT ticket.body en modifiant les fichiers dans le dépôt (ne touchez PAS aux autres tickets, ne vous arrêtez PAS, ne demandez PAS). Ensuite, appelez complete :

    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 --attempted expliquant pourquoi) si vous ne pouvez vraiment pas le faire — le harnais annule vos modifications partielles et enregistre BLOCKED_ENV. Après complete, appelez à nouveau next.

    Si la charge utile PROCEED contenait un bloc council ou specialists, vous avez effectué des révisions — vous DEVEZ renvoyer les résultats sur complete, 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 le prompt de 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 le attempt_id de 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-resolved si 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 normal PROCEED (implémenter, puis complete comme d'habitude) ; un verdict refusé parque le ticket avec une piste d'audit et passe à autre chose. Un resolve-park en 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), exportez UE_RUN_INCOMPLETE=<repo>/.unattended/run-incomplete au 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_INCOMPLETE non 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 un DemoWorker déterministe pour les autotests uniquement — il n'y a pas de sous-commande run en cours de processus. Les vraies exécutions utilisent toujours le flux next/complete ci-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.json voyage 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 via ans-run --trust aprè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'à son make install.
  • identité — launcher.target_user configurable + 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 --agent ou launcher.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_paths est 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.

Skills associés