AI Development Guide

Backend code-review criteria: anti-patronen, fail-fast errors, Rule of Three, quality gates

Door shinpr · shinpr/claude-code-workflows

Getest · Werkt ★ 8.8/10

AI Development Guide — Backend code-review criteria: anti-patronen, fail-fast errors, Rule of Three, quality gates

Wat het doet

Een proza-gids die Claude taal-agnostische en backend technische beslissingscriteria geeft: een anti-patroon catalogus, fail-fast error-masking detectie, Rule-of-Three duplicatieregels, impactanalyse, en een universele kwaliteitscontrole workflow. Activeert bij het reviewen van backend/algemene implementatiekeuzes, code smells, failure chains, of het beoordelen van implementatievolledigheid. Pure begeleiding, geen scripts of externe afhankelijkheden.

Testrapport

Opgehaald via GitHub API; 5 byte-identieke kopieën van SKILL.md gevonden (top-level skills/ en vier dev-workflows* plugin dirs) — de top-level versie gebruikt. Frontmatter parset met name+description; body is puur proza zonder script/bestandverwijzingen, geen hardgecodeerde paden, geen beveiligingsrisico's. Schoon geïnstalleerd in een tijdelijke HOME. Trigger test: 3 review/debug/completeness zinsneden laadden het, 2 aangrenzende (bouw een React dropdown; schrijf een API blogpost) deden dat correct niet — 5/5. Output test: een Python-voorbeeld met 3 functies beoordeeld met stille except-returns-default fallbacks en een bijna-duplicaat van gebruiker/admin. Baseline review adviseerde "extract a shared helper to remove the duplication"; de skill-volgende review gaf de tegenovergestelde, traceerbare aanbeveling — "Do NOT extract a shared helper yet" per de Rule-of-Three tabel (2e voorkomst = alleen overwegen) plus de users-vs-admins-may-diverge caveat — en herformuleerde de kortingsfallback als onacceptabel bij afwezigheid van een gedefinieerd herstelcontract in plaats van baseline's "just log it."

Getest op: 2026-07-21 · Claude Code 2.x (agent harness)

Installatie

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

Commando's en voorbeeldprompts

/ai-development-guideBackend code-review criteria: anti-patronen, fail-fast errors, Rule of Three, quality gates

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

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

Volledig rapport (Engels) →