Communitygithub.com

Omar-Obando/qwen-orchestrator

Compétence de détection et de prévention des anti-patrons. Détecte les données codées en dur, les éléments d'interface non fonctionnels, le code factice, les requêtes N+1 et autres anti-patrons de développement courants avant leur mise en production.

Qu'est-ce que qwen-orchestrator ?

Cette compétence est conçue pour les développeurs et les agents d'IA travaillant sur des projets de développement web et logiciel, en particulier lors de la création de sites web, d'applications ou de composants d'interface. Elle applique une politique de tolérance zéro contre les anti-patrons UI/UX, d'architecture, de code, de requêtes N+1 et SQL, dans le but de garantir que le code livré est prêt pour la production, professionnel et fonctionnel. Son utilité réside dans le fait d'éviter les pièges courants qui rendent un logiciel inachevé ou non professionnel, comme les sections 'À venir', les boutons non fonctionnels, les données factices codées en dur, ou les architectures de site web à page unique. La compétence comprend une liste de vérification détaillée pour valider les livrables, couvrant tout, de la fonctionnalité au design, en passant par le référencement (SEO). Elle est conçue pour être utilisée avec des agents comme Claude Code, Cursor ou Codex en tant que garde-fou automatisé pendant le développement, empêchant les anti-patrons d'atteindre la production en les détectant au moment de la rédaction du code ou lors des révisions. Les plates-formes prises en charge incluent n'importe quel environnement de développement piloté par un agent, et elle fonctionne en analysant le code et la structure par rapport à des règles et motifs prédéfinis.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Omar-Obando/qwen-orchestrator/tree/HEAD/skills/anti-pattern

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence Anti-Patron — Code Réel, Pas des Décorations

Cette compétence détecte et prévient les anti-patrons les plus courants qui donnent à un logiciel un aspect inachevé ou non professionnel.

Anti-Patrons Interdits (TOLÉRANCE ZÉRO)

Anti-Patrons UI/UX

❌ INTERDITS :
- Sections ou étiquettes "Bientôt disponible"
- Boutons non fonctionnels (doivent fonctionner ou être supprimés)
- Formulaires qui ne soumettent rien
- Données factices codées en dur dans les composants de production
- Tableaux statiques se faisant passer pour dynamiques
- Liens qui ne mènent nulle part (href="#")
- Bannières "En construction"
- Indicateurs de fonctionnalité (feature flags) définitivement désactivés
- Champs désactivés sans explication claire
- États vides sans message utile
- Pagination qui ne pagine pas réellement
- Barres de recherche qui ne recherchent pas réellement
- Filtres qui renvoient les mêmes résultats
- PAGE D'ACCUEIL UNIQUE lorsque l'utilisateur demande "un site web" (DOIT être multi-page)
- Aucune palette de couleurs définie avant d'écrire le CSS
- Couleurs hexadécimales aléatoires sans système de conception documenté
- Couleurs incohérentes entre les pages (différents bleus, différents espacements)
- ÉMOJIS n'importe où sur le site (utiliser des icônes SVG de Lucide/Heroicons/Phosphor)
- Sections qui se touchent (aucun espace entre les blocs de contenu)
- Pied de page collé directement à la section au-dessus (pas d'espace de respiration)
- Navigation avec plus de 7 éléments de premier niveau (encombré, écrasant)
- Pages de service sans pages de détail individuelles (/services uniquement, pas /services/conception-web)
- Pages de produits sans pages de détail individuelles (/produits uniquement, pas /produits/[slug])
- Descriptions de service génériques (2-3 lignes par service ne suffisent PAS)

✅ OBLIGATOIRE :
- Chaque bouton visible déclenche un gestionnaire réel ou est supprimé
- Chaque formulaire a un véritable onSubmit connecté à un appel API
- Chaque liste se charge à partir d'une source de données réelle avec des états de chargement
- Chaque lien navigue vers une destination réelle
- Les états vides expliquent pourquoi et suggèrent les prochaines actions
- Les états d'erreur affichent de véritables messages d'erreur du serveur
- Les états de chargement apparaissent pendant les opérations asynchrones réelles
- Site web multi-page avec des routes séparées (Accueil, À propos, Services, Contact, Produits)
- Palette professionnelle de 6 couleurs (--color-primary, secondary, accent, bg, surface, text)
- Système de conception cohérent sur TOUTES les pages
- ZÉRO émojis — utiliser des icônes SVG (Lucide, Heroicons, Phosphor)
- Espacement des sections : minimum 80px de marge entre les sections
- Pied de page : minimum 128px de marge supérieure (ne jamais toucher le contenu au-dessus)
- Navigation : maximum 7 éléments, menus déroulants pour les groupes, liens secondaires dans le pied de page
- Services : page de liste + pages de détail individuelles par service
- Produits : page de liste + pages de détail individuelles par produit
- Chaque détail de service : description, processus, livrables, tarification, FAQ, CTA
- Chaque détail de produit : galerie, spécifications, tarification, avis, produits associés

Anti-Patrons d'Architecture de Site Web

❌ INTERDITS (lorsque l'utilisateur dit "crée un site web") :
- Créer index.html comme SEUL fichier
- Mettre tout le contenu sur une seule page défilante
- Utiliser des liens d'ancrage (#about, #services) au lieu de pages séparées
- Appeler cela un "site web" alors que ce n'est qu'une page d'accueil
- Pas de menu de navigation entre les sections/pages
- Pas d'en-tête/pied de page partagé entre les pages
- Pas de titre ou description meta unique par page

✅ OBLIGATOIRE :
- Route/page séparée pour chaque section (par exemple, /about, /services, /contact)
- Menu de navigation liant toutes les pages
- Composants d'en-tête et de pied de page partagés
- Chaque page a un <title> et une <meta description> uniques
- Palette de couleurs et typographie cohérentes sur TOUTES les pages
- Minimum 5 pages pour toute demande de "site web" (Accueil, À propos, Services, Produits/Portfolio, Contact)

Anti-Patrons de Code

❌ INTERDITS :
- return []; // TODO: implémenter
- throw new Error('Pas implémenté');
- // placeholder
- Tableaux codés en dur se faisant passer pour des réponses API
- Fonctions avec des corps vides
- Blocs catch qui avalent silencieusement les erreurs
- Code commenté en production
- Nombres magiques sans constantes nommées
- Code copié-collé (violation DRY)
- Fonctions obèses (>100 lignes)
- Callbacks profondément imbriqués (>3 niveaux)
- Requêtes N+1 dans des boucles

✅ OBLIGATOIRE :
- Chaque fonction a une implémentation réelle et fonctionnelle
- Chaque erreur est correctement gérée avec un retour utilisateur
- Les constantes sont nommées et documentées
- Le code est DRY — extraire la logique partagée
- Les fonctions sont ciblées et font moins de 40 lignes

Détection des Requêtes N+1

❌ INTERDITS (N+1) :
// Cela déclenche 1 requête par utilisateur = problème N+1
for (const user of users) {
  const orders = await db.query('SELECT * FROM orders WHERE user_id = ?', [user.id]);
}

✅ OBLIGATOIRE (Par lot) :
// Cela déclenche 1 requête au total
const userIds = users.map(u => u.id);
const orders = await db.query(
  'SELECT * FROM orders WHERE user_id IN (?)',
  [userIds]
);
// Puis regrouper en mémoire
const ordersByUser = groupBy(orders, 'user_id');

Anti-Patrons SQL

❌ INTERDITS :
SELECT * FROM users                    -- Pas de SELECT *
WHERE name LIKE '%" + input + "%'     -- Injection SQL
ORDER BY RAND()                        -- Tueur de performances
HAVING COUNT(*) > 0                    -- Utiliser WHERE à la place
WHERE YEAR(created_at) = 2024          -- Casse l'utilisation de l'index

✅ OBLIGATOIRE :
SELECT id, name, email FROM users      -- Colonnes explicites
WHERE name LIKE ?                      -- Paramétré
ORDER BY id DESC LIMIT 20              -- Tri déterministe
WHERE created_at >= '2024-01-01'       -- Favorable aux index
  AND created_at < '2025-01-01'

Liste de Vérification

Avant que TOUT livrable soit marqué comme terminé :

Général

  • Aucun "bientôt disponible" ou "en construction" nulle part
  • Tous les boutons sont fonctionnels ou supprimés
  • Tous les formulaires soumettent vers des points de terminaison réels
  • Toutes les listes se chargent à partir de sources de données réelles
  • Aucune donnée de démonstration codée en dur dans les chemins de production
  • Aucune requête N+1 (vérifier chaque boucle avec une requête)
  • Aucun commentaire TODO sans référence de problème
  • Les états d'erreur gèrent les erreurs réelles
  • Les états de chargement s'affichent pendant les opérations réelles

Anti-Patrons de Conception et d'Interface Utilisateur

  • Zéro émoji n'importe où sur le site (utiliser uniquement des icônes SVG)
  • Les sections ont un espacement minimum de 80px entre elles (pas de contact)
  • Le pied de page a un espacement supérieur minimum de 128px (pas collé au contenu)
  • La navigation principale a un maximum de 7 éléments de premier niveau
  • Liens secondaires dans le pied de page, pas dans la navigation principale
  • Les services ont des pages de détail individuelles (pas seulement une page de liste)
  • Les produits ont des pages de détail individuelles (pas seulement une page de liste)
  • Chaque détail de service comprend : description, processus, livrables, CTA
  • Chaque détail de produit comprend : galerie, spécifications, tarification, avis
  • Arrière-plans de section alternés pour la séparation visuelle

Anti-Patrons SEO (pour les projets de site web)

  • Aucune page sans un et une uniques
  • Aucune page sans balises Open Graph (og:title, og:description, og:image)
  • Aucune page sans données structurées JSON-LD (<script type="application/ld+json">)
  • Aucune page autre que la page d'accueil sans schéma BreadcrumbList
  • Aucun bloc JSON-LD en double (utiliser les références @id à la place)
  • Aucun fichier robots.txt ou sitemap.xml manquant
  • Aucune image sans texte alt
  • Aucune page sans URL canonique
  • Aucun attribut <html lang="xx"> manquant
  • Aucune page avec plus d'un <h1>

Quand NE PAS Utiliser

N'utilisez PAS cette compétence lorsque :

  • Vous effectuez des révisions générales de qualité de code (utilisez la compétence de révision de code pour une analyse plus large)
  • Vous concevez des schémas de base de données (utilisez la compétence de conception de base de données pour la planification de schéma)
  • Vous écrivez la logique métier d'une application (utilisez la compétence métier pour des modules complets)
  • Vous révisez des implémentations de points de terminaison API (utilisez la compétence de conception d'API pour les motifs de point de terminaison)
  • Vous effectuez des audits de sécurité (utilisez la compétence d'auditeur de sécurité pour l'analyse des vulnérabilités)
  • Vous analysez des configurations de déploiement (utilisez la compétence de déploiement pour les pipelines CI/CD)
  • Vous révisez des workflows git ou le contrôle de version (utilisez la compétence de workflow git pour les branches/commits)
  • Vous écrivez des requêtes SQL (utilisez la compétence de bonnes pratiques SQL pour l'optimisation des requêtes)
  • Vous concevez des mises en page de sites web multi-pages (utilisez la compétence de système de conception pour une UI/UX professionnelle)
  • Vous révisez du code existant pour des besoins de réusinage (utilisez la compétence de réusinage pour des transformations sûres)

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills associés