error — capturer les diagnostics d'échec du navigateur

Capturez des artefacts quand le navigateur affiche un échec, puis restituez le contrôle au skill appelant. Ne doit jamais arrêter la run appelante de lui-même.

Quand invoquer

N'importe quel agent-browser snapshot qui révèle :

un titre "Something went wrong"
"Authentication Error" ou similaire
une page vierge ou redirection inattendue
tout contenu indiquant que le rendu de la page a échoué

Étapes

1. Résoudre le slug

Utilisez CARBON_WORKTREE de .env.local s'il est présent ; sinon le nom de branche actuel :

SLUG=$(grep '^CARBON_WORKTREE' .env.local | cut -d= -f2)
[ -z "$SLUG" ] && SLUG=$(git branch --show-current | tr '/' '-')

2. Capturer les deux artefacts

Enregistrez dans .ai/scratch/e2e/ — il est gitignored (.ai/scratch/ dans .gitignore). Ne sauvegardez jamais les captures sous docs/ (c'est l'app de documentation, et elle est tracée).

mkdir -p .ai/scratch/e2e/${SLUG}
STAMP=$(date +%Y%m%d-%H%M%S)
agent-browser screenshot .ai/scratch/e2e/${SLUG}/${module}-${STAMP}.png
agent-browser snapshot -i > .ai/scratch/e2e/${SLUG}/${module}-${STAMP}.txt

${module} = un nom court pour la route/fonctionnalité en test (ex. accounting). Le snapshot .txt vous permet de déboguer la structure des éléments sans rouvrir un navigateur.

3. Signaler et retourner

Enregistrez les deux chemins de fichiers et continuez — l'appelant décide s'il faut abandonner. Incluez les chemins dans le rapport final de l'appelant pour qu'un humain puisse les ouvrir.

Sortie

.ai/scratch/e2e/{slug}/{module}-{timestamp}.png — capture d'écran
.ai/scratch/e2e/{slug}/{module}-{timestamp}.txt — snapshot d'éléments