Coding Standards

Taalonafhankelijke anti-pattern, type-safety en test-first standaarden voor reviews en refactors

Door shinpr · shinpr/ai-coding-project-boilerplate

Werkt met setup ★ 8.4/10

Coding Standards — Taalonafhankelijke anti-pattern, type-safety en test-first standaarden voor reviews en refactors

Wat het doet

Een universele coding-standards referentie die anti-pattern detectie (Rule of Three, SRP, DRY, error suppression, excessive type assertions), type-safety regels (unknown + type guards over any/as), fail-fast error handling, Red-Green-Refactor testing, impact-analysis gates, en secure defaults codificeert. Activeert bij het implementeren van features, het beoordelen van code, of refactoring. Past toe als guidance in het context window in plaats van een tool uit te voeren.

Testrapport

SKILL.md opgehaald op .claude/skills-en/coding-standards/; frontmatter heeft name+description. 3 gerefereerde paths steekproefsgewijs gecontroleerd via raw fetch — references/security-checks.md, implementation-approach/SKILL.md, typescript-rules/SKILL.md allemaal HTTP 200; geen security smells (de "Knowledge Cutoff Supplement" is informatief, geen injection). Voor OUTPUT heb ik twee fetchUser() implementaties geschreven: baseline retourneerde `data as User` (geen validatie); skill-following gebruikte `unknown` + een isUser type guard + fail-fast InvalidUserError. De guard uitgevoerd in node tegen `{id:42}`: baseline geeft het verkeerd gevormde object door getypeerd als User, skill guard retourneert false zodat het een error werpt — een concreet waargenomen verschil dat overeenkomt met de type-safety en fail-fast regels van de skill.

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

Installatie

# Copies the coding-standards skill (SKILL.md + references/) into ~/.claude/skills
git clone --depth 1 https://github.com/shinpr/ai-coding-project-boilerplate.git /tmp/coding-standards-src
mkdir -p ~/.claude/skills
cp -R /tmp/coding-standards-src/.claude/skills-en/coding-standards ~/.claude/skills/coding-standards
# Japanese variant also exists at .claude/skills-ja/coding-standards if preferred
# No external deps, scripts, or API keys required — pure guidance document

Commando's en voorbeeldprompts

/coding-standardsTaalonafhankelijke anti-pattern, type-safety en test-first standaarden voor reviews en refactors

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

Check this function for code smells
Review my pull request for anti-patterns
Refactor this module for readability

Volledig rapport (Engels) →