AI Development Guide

Criteri di code-review backend: anti-pattern, errori fail-fast, Rule of Three, quality gates

di shinpr · shinpr/claude-code-workflows

Promosso ★ 8.8/10

AI Development Guide — Criteri di code-review backend: anti-pattern, errori fail-fast, Rule of Three, quality gates

Cosa fa

Una guida in prosa che fornisce a Claude criteri di decisione tecnici agnostici al linguaggio e backend: un catalogo di anti-pattern, rilevamento di error-masking fail-fast, regole di duplicazione Rule-of-Three, analisi d'impatto e un workflow universale di controllo qualità. Si attiva durante la revisione di scelte di implementazione backend/generali, code smell, catene di fallimento o la valutazione della completezza dell'implementazione. Pura guida, nessun script o dipendenza esterna.

Rapporto di test

Recuperato tramite GitHub API; trovate 5 copie byte-identiche di SKILL.md (skills/ di primo livello e quattro directory plugin dev-workflows*) — usata quella di primo livello. Il frontmatter si analizza con name+description; il corpo è pura prosa con zero riferimenti a script/file, nessun percorso hardcoded, nessun security smell. Installato pulitamente in una HOME temporanea. Test trigger: 3 frasi di revisione/debug/completezza lo hanno caricato, 2 adiacenti (costruire un dropdown React; scrivere un post API) correttamente no — 5/5. Test di output: revisionato un campione Python di 3 funzioni con fallback silenziosi except-returns-default e un quasi-duplicato utente/admin. La revisione baseline raccomandava "estrarre un helper condiviso per rimuovere la duplicazione"; la revisione con la skill ha dato la raccomandazione opposta e tracciabile — "NON estrarre ancora un helper condiviso" secondo la tabella Rule-of-Three (2a occorrenza = considerare solo) più l'avvertenza users-vs-admins-may-diverge — e ha riformulato il fallback dello sconto come inaccettabile in assenza di un contratto di recupero definito piuttosto che il "just log it" della baseline.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

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.).

Comandi e prompt di esempio

/ai-development-guideCriteri di code-review backend: anti-pattern, errori fail-fast, Rule of Three, quality gates

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →