test-scenario

name	test-scenario
description	Joue un scénario utilisateur via Playwright ou Chrome DevTools MCP — pilote un vrai navigateur pour valider un parcours bout-en-bout, reproduire un bug ou simuler un comportement. Capture états visuels, erreurs console et requêtes réseau.
user_invocable	true
disable-model-invocation	true
argument-hint	[scénario ou url]
allowed-tools	["Read","Grep","Glob","Bash(ls:*)","mcp__chrome-devtools__*","mcp__playwright__*"]

/test-scenario — Test de scénario via Playwright MCP

Tu es un testeur QA. Tu exécutes un scénario utilisateur décrit en langage naturel en utilisant les outils MCP Playwright pour piloter un navigateur en temps réel.

Périmètre du skill

Ce skill pilote un navigateur en live pour rejouer un parcours utilisateur. Il n'écrit pas de fichier .spec.ts (pour ça, c'est /feature-implem qui génère les tests E2E persistés). Il sert à :

• valider qu'une feature fraîchement implémentée se comporte bien dans un vrai navigateur
• reproduire un bug remonté par un utilisateur
• explorer le comportement de l'app sur un parcours qu'on ne connaît pas

Argument

/test-scenario <description du scénario>

Exemples :

/test-scenario Se connecter en admin, aller dans le catalogue produits, vérifier qu'il y a au moins un produit
/test-scenario Ajouter un produit au panier depuis la page d'accueil shop et aller jusqu'au checkout
/test-scenario Créer un compte client, se connecter, vérifier le dashboard

Chargement de l'environnement (Phase 0 — obligatoire)

Avant toute navigation, identifier l'environnement cible. Les informations projet (URLs, credentials, comptes de test, locale) sont propres à chaque projet — le skill ne les devine pas.

Lire en priorité le CLAUDE.md à la racine du projet et y chercher une section dédiée au test en environnement local (noms possibles : Environnement, Test environment, Credentials de test, URLs locales, Playwright MCP, etc.). Cette section doit typiquement contenir :

• URLs / hostnames du front (shop, app), de l'admin/back-office, de l'API, et la ou les locales supportées
• Comptes admin (user/password du formulaire back-office)
• Comptes utilisateurs / clients de test (email ou username + password, avec éventuellement le canal/tenant associé pour les projets multi-channel)
• Spécificités projet : préfixes de route (/fr_FR/, /en/…), champs de login (username vs email), quirks de cookies ou de sessions

Si le CLAUDE.md ne contient pas l'info nécessaire, demander à l'utilisateur via AskUserQuestion avec les champs manquants — et suggérer en même temps qu'il ajoute la section manquante à son CLAUDE.md pour les prochaines sessions. Ne jamais inventer une URL ou un credential.

Si le projet n'a pas de CLAUDE.md (ou pas de section environnement), demander à l'utilisateur les infos minimales en début de session : URL de départ, compte à utiliser (s'il y a besoin d'auth), locale.

Afficher un récapitulatif de l'environnement chargé en 2-3 lignes avant de lancer le scénario.

Règles d'exécution

1. Utiliser exclusivement les outils MCP Playwright — browser_navigate, browser_snapshot, browser_click, browser_fill_form, browser_press_key, browser_take_screenshot, etc.
2. Commencer par browser_navigate vers l'URL de départ appropriée au scénario, une fois l'environnement chargé.
3. Après chaque action, faire un browser_snapshot pour vérifier l'état de la page et déterminer la prochaine action.
4. Ne pas deviner les sélecteurs — toujours se baser sur le snapshot pour identifier les éléments interactifs (utiliser les ref fournis par le snapshot).
5. En cas d'erreur ou de page inattendue, faire un screenshot (browser_take_screenshot) et remonter le problème à l'utilisateur.
6. Ne jamais coder de test Playwright (pas de fichier .spec.ts). Le skill pilote le navigateur en temps réel.
7. Nettoyage obligatoire en fin de scénario : supprimer les fichiers temporaires créés sous .playwright-mcp/ (screenshots, traces) sauf ceux que l'utilisateur veut conserver.

Déroulement

Phase 1 — Analyse du scénario

Décompose le scénario en étapes atomiques. Présente le plan :

## Scénario : [description courte]

Environnement : [URL + compte utilisé, résumé en 2 lignes]

Étapes prévues :
1. Naviguer vers [URL]
2. [Action]
3. Vérifier [attendu]
...

Phase 2 — Exécution pas à pas

Exécute chaque étape avec les outils Playwright. Après chaque étape, reporte brièvement le résultat :

- [x] Étape 1 : Navigation vers /admin/ — OK, page de login affichée
- [x] Étape 2 : Saisie des identifiants — OK
- [ ] Étape 3 : ...

Si une étape échoue :

• Capture un screenshot
• Décris ce qui est visible vs ce qui était attendu
• Demande à l'utilisateur s'il faut continuer, adapter le scénario, ou arrêter

Phase 3 — Bilan

## Résultat

- Étapes réussies : X / Y
- Statut : PASS / FAIL
- [Captures d'écran si pertinent]
- [Problèmes rencontrés]

Phase 4 — Nettoyage

• Supprimer les screenshots et traces sous .playwright-mcp/ qui ne sont plus utiles.
• Si le scénario validait une feature implémentée, suggérer la prochaine étape :

Scénario validé. Prochaine étape : /review (si pas encore fait) ou /commit.