Pattern	Action	Exemple
URL seule	Analyse complète	`/opquast https://example.com`
URL + `--theme <t>`	Analyse par thématique	`/opquast https://example.com --theme seo`
URL + `--rubrique <r>`	Analyse par rubrique	`/opquast https://example.com --rubrique formulaires`
`--regle <N>`	Consulter une règle	`/opquast --regle 42`
`--list [--page N]`	Liste paginée	`/opquast --list --page 3`
`--search <mot>`	Recherche par mot-clé	`/opquast --search image`
`--severity <s>`	Filtrer par sévérité	`/opquast --severity critical`

Valeurs acceptées : voir references/rubriques-dimensions.md

Contraintes

Impératifs

TOUJOURS afficher le disclaimer lors de la première analyse de la session
TOUJOURS détecter le profil du site avant de lancer l'audit
TOUJOURS mentionner les règles non vérifiables (DOM, interaction) dans le rapport
TOUJOURS charger rules/opquast-v5.json comme source de vérité pour les règles
JAMAIS inventer un numéro de règle ou une sévérité non présente dans le JSON
JAMAIS afficher les règles conformes ou non applicables dans le rapport
JAMAIS analyser sans avoir récupéré le HTML via WebFetch (ou HTML fourni par l'utilisateur)
JAMAIS analyser plus de 5 pages par invocation. Au-delà, proposer une analyse par lots

Règles d'affichage

Grouper les non-conformités par tag principal (Accessibilité > SEO > autres)
Quick Wins en premier (corrections CSS simples à fort impact)
Section "Règles non vérifiables" avec les règles requires_dom
Si tout est conforme : "Toutes les règles vérifiables sont respectées."

Couverture

193/245 règles (79%) via static + DOM combinés. Détails, catégories et limitations SPA : voir references/couverture-limitations.md

Ressources

rules/opquast-v5.json : 245 règles enrichies (id, title, category, rubrique, tags, objectives, solution, verification, severity)
rules/site-profiles.json : Détection et filtrage par type de site (6 profils)
schemas/audit-report.json : Schéma JSON pour les rapports structurés
references/regles-v5/ : 245 règles détaillées individuelles (regle-001.md à regle-245.md)
references/V5/ : Fichiers par rubrique (14) et dimension transversale (6)
references/rubriques-dimensions.md : Valeurs acceptées pour thématiques, rubriques et sévérités
references/explorateur-exemples.md : Exemples de sortie pour l'explorateur de règles

Intelligence contextuelle

Lors de l'analyse, détecter automatiquement le profil du site via rules/site-profiles.json :

Profil	Indicateurs clés
`e-commerce`	panier, prix, checkout, product schema
`saas`	login, dashboard, pricing, subscription
`blog`	article, post, author, published date
`vitrine`	contact, about, services, team
`institutionnel`	démarches, services publics, délibérations
`newsletter`	formulaire newsletter, subscribe

Pour chaque profil, le fichier définit rubriques_prioritaires, regles_critiques, regles_exclues et pages_a_analyser.

Format de sortie

Template complet, ordre de priorité et exemple condensé : voir references/format-sortie.md

Structure du rapport : Couverture -> Quick Wins -> Non-conformités par priorité (Accessibilité > SEO > UX) -> Règles non vérifiables (DOM).

Exemple `/opquast <URL>` (condensé)

/opquast https://boutique.example.com

# Analyse Opquast : Boutique Example
**Profil** : e-commerce | **Non conformes** : 14 | **DOM** : 33 non vérifiables
Quick Wins : règle 191 (justify), 237 (user-select) | Accessibilité : règle 111 (alt images)

Rapport complet et template : voir references/format-sortie.md

Exemple `/opquast --regle`

/opquast --regle 42

# Règle 42 : Les liens sont visuellement différenciés du reste du contenu
**Rubrique** : Liens | **Sévérité** : critical | **Tags** : Accessibilité
**Solution** : Utiliser couleur + soulignement (pas la couleur seule)
→ https://checklists.opquast.com/fr/qualite-numerique/42

Exemple `/opquast --search`

/opquast --search formulaire

# 30 règles contenant "formulaire"
| ID | Titre | Sévérité |
|----|-------|----------|
| 67 | Chaque champ associé à une étiquette | critical |
| 69 | Champs obligatoires indiqués | critical |

Exemple `/opquast --theme`

/opquast https://example.com --theme seo

# Analyse Opquast : Example — SEO (37 règles)
**Non conformes** : 5 | Règle 3 : meta description absente | Règle 130 : URL non signifiantes

Exemples complets pour --list, --rubrique, --severity : voir references/explorateur-exemples.md

Gestion d'erreurs

Situation	Comportement
WebFetch échoue (URL inaccessible)	Proposer des captures d'écran, préciser les limitations, demander de vérifier l'URL
`rules/opquast-v5.json` introuvable	STOPPER l'analyse. Signaler : "Fichier de règles manquant. Vérifier l'installation du skill."
`rules/site-profiles.json` introuvable	Continuer sans profilage. Appliquer toutes les règles static sans filtrage
Profil de site non reconnu	Utiliser le profil `vitrine` par défaut. Mentionner dans le rapport : "Profil non détecté, analyse généraliste appliquée"
HTML source quasi-vide (SPA détectée)	Avertir l'utilisateur. Proposer de fournir le HTML rendu ou d'utiliser le DOM Analyzer
`scripts/bridge.js` échoue ou absent	Continuer sans analyse DOM. Classer toutes les règles `requires_dom` dans la section "Non vérifiables"
Argument `$ARGUMENTS` non reconnu	Lister les commandes disponibles avec exemples

Workflow

Parser $ARGUMENTS (URL, flags, commandes)
Afficher disclaimer (première fois)
Récupérer page principale avec WebFetch + pages secondaires (contact, mentions légales, CGV)
Détecter le profil via rules/site-profiles.json (défaut : vitrine)
Charger rules/opquast-v5.json, filtrer par category: "static", exclure regles_exclues du profil, prioriser regles_critiques
Si le DOM Analyzer est disponible (scripts/bridge.js), lancer l'analyse des règles requires_dom applicables au profil
Pour chaque règle : appliquer verification comme méthode de test, solution pour les recommandations
Analyser les pages définies dans pages_a_analyser du profil
Générer rapport avec profil détecté (voir references/format-sortie.md)
Proposer analyse complémentaire

Checklist finale

Disclaimer affiché
HTML récupéré avec succès (ou limitation SPA signalée)
Profil de site détecté et mentionné dans le rapport
Règles filtrées selon profil et scope
Quick Wins listés en premier
Non-conformités groupées par priorité (Accessibilité > SEO > UX)
Règles non vérifiables (DOM) listées séparément
Lien vers chaque règle citée sur checklists.opquast.com
Analyse complémentaire proposée

Opquast V5 (Qualité Numérique) — 245 règles

opquast

Opquast Checker

Arguments