Assistant

Un assistant est un script bash qui guide un humain, étape par étape, à travers une procédure manuelle fastidieuse à exécuter à la main et fastidieuse à réexpliquer à une IA à chaque fois. Il ouvre chaque URL, indique exactement sur quoi cliquer et copier, capture les valeurs, les écrit à leur place (.env, secrets GitHub), confirme à chaque étape et montre combien d'étapes il reste. Il peut configurer des services tiers, exécuter une migration ponctuelle ou déplacer le projet d'un état à un autre.

template.sh fournit déjà une expérience utilisateur soignée : progression étape par étape, confirmations, ouverture d’URL multiplateforme — y compris sous WSL —, saisie masquée des secrets, mise à jour idempotente de .env, écriture via gh secret et gh variable, puis résumé final. Votre travail consiste uniquement à définir le périmètre de la procédure et à créer ses étapes. La bibliothèque placée au-dessus du marqueur STAGES est identique dans chaque assistant ; cette cohérence est essentielle, ne la modifiez jamais manuellement.

Un assistant est éphémère par défaut : construit pour une seule exécution, enregistré dans un chemin de travail ou scripts/ , supprimé une fois le travail terminé. Validez-le uniquement lorsque l'utilisateur souhaite un chemin de configuration reproductible qui doit résider dans le dépôt.

Processus

1. Portée de la procédure

Déterminez chaque étape manuelle que l'humain doit suivre et chaque valeur qui est capturée en cours de route. Lisez d'abord le dépôt - ne demandez pas froidement :

• Pour la configuration : .env, .env.example, .env.*, README, docker-compose*, configuration du framework, et .github/workflows/* (chaque secrets.* / vars.* référence est une valeur que l'assistant doit produire).
• Pour une migration ou une transition : l'état actuel, l'état cible et les actions irréversibles entre eux.

Montrez ensuite à l'utilisateur la liste ordonnée des étapes et les valeurs que chacune produit, et confirmez - ils peuvent ajouter, supprimer ou réorganiser.