Sous-agents et orchestration

Les sous-agents sont des agents d'arrière-plan de courte durée qui s'exécutent en parallèle de votre conversation principale. Utilisez-les pour effectuer des recherches, prototyper ou investiguer quelque chose sans bloquer votre travail en cours.

Demandez dans n'importe quelle session de clavardage :

• « Recherchez ces trois options en parallèle et recommandez-en une. »
• « Vérifiez mes CR ouvertes, l'état du pipeline et si le déploiement a été effectué — tout en même temps. »
• « En parallèle, exécutez ce test en 6 langues. »

Crew lance des sous-agents isolés et rapporte leurs résultats dans votre conversation. Vous n'avez pas besoin d'invoquer une commande — l'agent décide quand le travail parallèle est pertinent.

Vous pouvez aussi observer les sous-agents en cours d'exécution dans le panneau Activity : chacun affiche sa tâche, le temps écoulé et un bouton Stop.

kirocrew spawn run "check my open CRs"        # blocking — waits for the result
kirocrew spawn run --async "check CRs"        # fire-and-forget
kirocrew spawn list                           # see running subagents

Lorsque des sous-agents sont en cours d'exécution :

• Le panneau Activity affiche chacun d'eux avec la description de sa tâche, le temps écoulé et son état (running / done / failed / stalled)
• Lorsqu'un sous-agent termine, son résultat est injecté dans votre conversation — l'agent le résume dans sa prochaine réponse
• Pour un lot de travaux parallèles, les résultats arrivent progressivement à mesure que chaque sous-agent se termine

Vous n'avez pas besoin de vérifier ou de revenir périodiquement — les résultats viennent à vous.

Chaque sous-agent obtient sa propre session indépendante avec injection complète de la mémoire (vos préférences, leçons, contexte du projet). Mais il ne voit pas le travail en cours de votre conversation actuelle — cela permet de garder votre session principale légère et d'empêcher les sous-agents d'interférer les uns avec les autres.

• Arrêter un — cliquez sur le bouton Stop dans sa rangée du panneau Activity
• Arrêter tous — commande Stop-all dans l'en-tête du panneau Activity
• Réessayer un échec — cliquez sur « Retry » dans la rangée d'un sous-agent échoué (lance une nouvelle tentative avec la même tâche)

L'arrêt est neutre — le résultat partiel est conservé et marqué comme « arrêté par l'utilisateur », et non comme un échec.

Les contrôles d'exécution accessibles aux agents sont limités à la session qui a lancé le sous-agent. Une session peut uniquement répertorier, inspecter, réorienter, poursuivre, réessayer, libérer ou supprimer ses propres exécutions. Le panneau Activity du tableau de bord demeure la surface de contrôle du propriétaire pour toutes les exécutions. Un appelant interne sans identité de session ne peut voir ou contrôler que les exécutions CLI sans session parente; exécutez kirocrew doctor si une session signale une identité manquante.

• Concurrence : Crew dimensionne automatiquement le plafond de concurrence en fonction de la mémoire et du CPU disponibles de l'hôte. Un plafond configuré peut le restreindre davantage. resource_status signale le plafond en vigueur en temps réel.
• Disponibilité en direct : resource_status signale la mémoire disponible, la charge CPU, la posture actuelle et le plafond de sous-agents actuellement appliqué. Il est consultatif et ne réserve rien.
• Délai d'expiration : chaque sous-agent peut s'exécuter pendant au plus trois heures et effectuer jusqu'à 1000 appels d'outils. Consultez Configuration pour les paramètres connexes.
• Détection d'inactivité : une rangée qui cesse de produire de l'activité est marquée comme bloquée afin que vous puissiez l'inspecter ou l'arrêter; Crew ne traite pas le silence seul comme une preuve que le travail utile s'est terminé.

Vérifiez resource_status avant un large déploiement en éventail ou une build coûteuse. Lorsque la posture est tight ou critical, réduisez le parallélisme ou reportez l'étape lourde plutôt que de concurrencer le travail déjà en cours. Sous pression mémoire, un lancement est refusé en tant que contre-pression — ce refus est un signal pour prendre le chemin moins exigeant, pas une erreur transitoire à réessayer.

Crew écrit le travail accepté des sous-agents dans une file d'attente de tâches durable avant de l'acquitter. Le travail mis en file d'attente survit à un redémarrage de la passerelle et réintègre la planification lorsque la capacité est disponible après le démarrage. Une entrée récupérée est réconciliée de façon prudente afin que le travail avec des effets secondaires incertains ne soit pas répété silencieusement.

Utilisez plusieurs sous-agents pour du travail indépendant pouvant s'exécuter en parallèle. Un seul sous-agent ajoute un saut de contexte sans parallélisme, donc spawn_run refuse la délégation à une seule tâche sauf si elle nomme un agent, un modèle ou un Crew véritablement différent, ou fournit l'une de ces raisons :

• parent_parallel : le parent maintient un flux de travail prêt distinct pendant que cet enfant asynchrone s'exécute
• bulk_data : une grande entrée nécessite une distillation isolée
• fresh_context : une révision indépendante ou une reproduction propre ne doit pas hériter du raisonnement actuel
• specialist : l'enfant possède une capacité spécifique que le parent n'a pas
• user_requested : l'utilisateur a explicitement demandé un worker isolé

La valeur de modèle auto n'est pas une justification de modèle différent. Les raisons qui dépendent du contexte nécessitent aussi des détails concrets et sont conservées dans l'enregistrement d'exécution comme affirmation du modèle, pas comme preuve d'autorisation.

Les membres de Crew peuvent démarrer des sessions Worker depuis leur propre fil avec les backends Claude Code et KAS. Chaque Worker hérite de la posture de confiance du membre, afin que le Worker d'un membre de confiance ne s'arrête pas à son premier appel d'outil. Cette capacité de contrôle des sessions est activée par défaut. Pour la modifier pour tous les agents, consultez Configuration.

Les sous-agents héritent du mode d'approbation de votre session :

• Autopilot activé — les appels d'outils du sous-agent sont approuvés automatiquement (les règles de refus s'appliquent toujours)
• Autopilot désactivé — les appels d'outils nécessitant une approbation sont soit refusés par défaut (canaux sans interface) soit vous les demandent (tableau de bord)

Vous ne configurez pas l'approbation par sous-agent — elle suit ce qui est défini pour votre session principale. Lorsqu'un sous-agent attend l'approbation de son lancement, Crew affiche cet état en attente dans ses vues de travail en cours afin que vous puissiez l'approuver ou modifier le plan.

Lorsque la sortie d'un sous-agent est longue, votre conversation reçoit un résumé. Pour lire la transcription complète :

• Cliquez sur le sous-agent dans le panneau Activity pour développer sa sortie
• Ou demandez : « montre-moi la sortie complète du sous-agent X »

Les résultats sont conservés pendant environ une heure après leur livraison, puis supprimés.