AI Development Guide

Critères de révision de code backend : anti-patterns, erreurs fail-fast, Règle de Trois, portes de qualité.

par shinpr · shinpr/claude-code-workflows

Testé · Fonctionne ★ 8.8/10

AI Development Guide — Critères de révision de code backend : anti-patterns, erreurs fail-fast, Règle de Trois, portes de qualité.

Ce que fait

Un guide en prose qui fournit à Claude des critères de décision techniques agnostiques au langage et spécifiques au backend : un catalogue d'anti-patterns, la détection de masquage d'erreurs fail-fast, les règles de duplication de la Règle de Trois, l'analyse d'impact et un workflow universel de contrôle qualité. Se déclenche lors de la révision des choix d'implémentation backend/généraux, des 'code smells', des chaînes de défaillance ou de l'évaluation de l'exhaustivité de l'implémentation. Pure guidance, aucun script ou dépendance externe.

Rapport de test

Récupéré via l'API GitHub ; 5 copies identiques en octets de SKILL.md ont été trouvées (skills/ de niveau supérieur et quatre répertoires de plugins dev-workflows*) — la version de niveau supérieur a été utilisée. Le frontmatter est analysé avec name+description ; le corps est de la prose pure sans aucune référence de script/fichier, aucun chemin codé en dur, aucune faille de sécurité. Installé proprement dans un HOME temporaire. Test de déclenchement : 3 phrases de révision/débogage/exhaustivité l'ont chargé, 2 adjacentes (construire un menu déroulant React ; écrire un article de blog sur une API) ne l'ont pas fait correctement — 5/5. Test de sortie : un échantillon Python de 3 fonctions avec des retours par défaut silencieux en cas d'exception et un quasi-doublon utilisateur/administrateur a été examiné. La révision de base a recommandé "extraire un helper partagé pour supprimer la duplication" ; la révision suivant la compétence a donné la recommandation opposée et traçable — "NE PAS extraire un helper partagé pour l'instant" selon la table de la Règle de Trois (2ème occurrence = considérer seulement) plus la mise en garde selon laquelle les utilisateurs vs administrateurs peuvent diverger — et a recadré le fallback de réduction comme inacceptable en l'absence d'un contrat de récupération défini plutôt que le "juste le logger" de la base.

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/shinpr/claude-code-workflows.git /tmp/ai-development-guide-src
mkdir -p ~/.claude/skills
cp -R /tmp/ai-development-guide-src/skills/ai-development-guide ~/.claude/skills/ai-development-guide
# Pure-prose SKILL.md (~293 lines), no scripts, no external deps, no API keys.
# Repo ships 5 identical copies (top-level skills/ + four dev-workflows* plugin dirs);
# the top-level skills/ copy above is the clean standalone install.
# Plugin-marketplace alternative: install the `dev-workflows` plugin from this repo
# to get the full recipe workflow (/recipe-implement, /recipe-design, etc.).

Commandes et exemples de prompts

/ai-development-guideCritères de révision de code backend : anti-patterns, erreurs fail-fast, Règle de Trois, portes de qualité.

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

Check this code for common anti-patterns
Help me decide between these two architecture options
Run a quality check workflow on this feature

Rapport complet →