AI Development Guide

Criterios de revisión de código backend: antipatrones, errores fail-fast, Regla de Tres, puertas de calidad

Por shinpr · shinpr/claude-code-workflows

Probado · Funciona ★ 8.8/10

AI Development Guide — Criterios de revisión de código backend: antipatrones, errores fail-fast, Regla de Tres, puertas de calidad

Qué hace

Una guía en prosa que proporciona a Claude criterios de decisión técnicos agnósticos al lenguaje y de backend: un catálogo de antipatrones, detección de enmascaramiento de errores fail-fast, reglas de duplicación de la Regla de Tres, análisis de impacto y un flujo de trabajo universal de verificación de calidad. Se activa al revisar opciones de implementación backend/generales, "code smells", cadenas de fallos o al juzgar la completitud de la implementación. Pura guía, sin scripts ni dependencias externas.

Informe de la prueba

Obtenido a través de la API de GitHub; se encontraron 5 copias idénticas en bytes de SKILL.md (skills/ de nivel superior y cuatro directorios de plugins dev-workflows*) — se usó la de nivel superior. El frontmatter se analiza con name+description; el cuerpo es prosa pura sin referencias a scripts/archivos, sin rutas codificadas, sin problemas de seguridad. Se instaló limpiamente en un HOME temporal. Prueba de activación: 3 frases de revisión/depuración/completitud lo cargaron, 2 adyacentes (construir un menú desplegable de React; escribir una publicación de blog de API) correctamente no lo hicieron — 5/5. Prueba de salida: se revisó una muestra de Python de 3 funciones con fallbacks silenciosos de except-returns-default y un casi duplicado de usuario/administrador. La revisión de referencia recomendó "extraer un ayudante compartido para eliminar la duplicación"; la revisión siguiendo la habilidad dio la recomendación opuesta y rastreable — "NO extraer un ayudante compartido todavía" según la tabla de la Regla de Tres (segunda ocurrencia = solo considerar) más la advertencia de que usuarios vs administradores pueden divergir — y replanteó el fallback de descuento como inaceptable en ausencia de un contrato de recuperación definido en lugar del "simplemente registrarlo" de la referencia.

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

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

Comandos y prompts de ejemplo

/ai-development-guideCriterios de revisión de código backend: antipatrones, errores fail-fast, Regla de Tres, puertas de calidad

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

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

Informe completo →