AI Development Guide

Kriterier för kodgranskning av backend: anti-mönster, fail-fast-fel, Rule of Three, kvalitetsgrindar.

av shinpr · shinpr/claude-code-workflows

Testad · Fungerar ★ 8.8/10

AI Development Guide — Kriterier för kodgranskning av backend: anti-mönster, fail-fast-fel, Rule of Three, kvalitetsgrindar.

Vad den gör

En prosaguide som ger Claude språkagnostiska och tekniska beslutskriterier för backend: en anti-mönsterkatalog, fail-fast felmaskeringsdetektering, Rule-of-Three dupliceringsregler, konsekvensanalys och ett universellt kvalitetskontrollflöde. Utlöses vid granskning av backend/allmänna implementeringsval, kodlukter, felkedjor eller bedömning av implementeringens fullständighet. Ren vägledning, inga skript eller externa beroenden.

Testrapport

Hämtades via GitHub API; hittade 5 byte-identiska kopior av SKILL.md (top-level skills/ och fyra dev-workflows*-plugin-kataloger) — använde den översta. Frontmatter parsas med name+description; innehållet är ren prosa utan skript/filreferenser, inga hårdkodade sökvägar, inga säkerhetsbrister. Installerad rent i en temporär HOME. Utlösningstest: 3 review/debug/completeness-fraser laddade den, 2 intilliggande (build a React dropdown; write an API blog post) gjorde det korrekt inte — 5/5. Utdata-test: granskade ett Python-exempel med 3 funktioner med tysta except-returns-default fallbacks och en nästan-duplikat för användare/admin. Baslinjegranskningen rekommenderade "extract a shared helper to remove the duplication"; den skill-följande granskningen gav den motsatta, spårbara rekommendationen — "Do NOT extract a shared helper yet" enligt Rule-of-Three-tabellen (andra förekomsten = överväg endast) plus användare-vs-admin-kan-divergera-varningen — och omformulerade rabatt-fallbacken som oacceptabel i avsaknad av ett definierat återställningskontrakt snarare än baslinjens "just log it."

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

Kommandon och exempelprompter

  • /ai-development-guideKriterier för kodgranskning av backend: anti-mönster, fail-fast-fel, Rule of Three, kvalitetsgrindar.

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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