AI Development Guide

Backend Code-Review-Kriterien: Anti-Patterns, Fail-Fast-Fehler, Rule of Three, Quality Gates

von shinpr · shinpr/claude-code-workflows

Getestet · Funktioniert ★ 8.8/10

AI Development Guide — Backend Code-Review-Kriterien: Anti-Patterns, Fail-Fast-Fehler, Rule of Three, Quality Gates

Was es kann

Ein Prosa-Leitfaden, der Claude sprachunabhängige und technische Backend-Entscheidungskriterien liefert: einen Anti-Pattern-Katalog, Fail-Fast-Fehler-Maskierungs-Erkennung, Rule-of-Three-Duplikationsregeln, Impact-Analyse und einen universellen Qualitätsprüfungs-Workflow. Wird ausgelöst beim Überprüfen von Backend-/allgemeinen Implementierungsentscheidungen, Code Smells, Fehlerketten oder beim Beurteilen der Implementierungsvollständigkeit. Reine Anleitung, keine Skripte oder externen Abhängigkeiten.

Testbericht

Über GitHub API abgerufen; 5 byte-identische Kopien von SKILL.md (Top-Level skills/ und vier dev-workflows*-Plugin-Verzeichnisse) – die Top-Level-Kopie verwendet. Frontmatter wird mit name+description geparst; der Inhalt ist reine Prosa ohne Skript-/Dateireferenzen, keine fest codierten Pfade, keine Sicherheitslücken. Sauber in ein temporäres HOME installiert. Trigger-Test: 3 Review-/Debug-/Vollständigkeits-Phrasierungen luden es, 2 angrenzende (ein React-Dropdown erstellen; einen API-Blogbeitrag schreiben) taten dies korrekt nicht – 5/5. Output-Test: Ein 3-Funktionen-Python-Beispiel mit stillen except-returns-default-Fallbacks und einem fast identischen Benutzer/Admin-Duplikat überprüft. Die Baseline-Überprüfung empfahl "einen gemeinsamen Helfer zu extrahieren, um die Duplizierung zu entfernen"; die Skill-basierte Überprüfung gab die gegenteilige, nachvollziehbare Empfehlung – "Extrahieren Sie noch KEINEN gemeinsamen Helfer" gemäß der Rule-of-Three-Tabelle (2. Vorkommen = nur berücksichtigen) plus dem Hinweis, dass Benutzer vs. Admins divergieren könnten – und formulierte den Rabatt-Fallback als inakzeptabel um, da kein definierter Wiederherstellungsvertrag vorlag, anstatt der Baseline "einfach protokollieren".

Getestet am: 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.).

Befehle & Beispiel-Prompts

  • /ai-development-guideBackend Code-Review-Kriterien: Anti-Patterns, Fail-Fast-Fehler, Rule of Three, Quality Gates

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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