Coding Rules

Set di regole concrete per clean-code: max 2 parametri, nessuna soppressione errori, early returns, YAGNI.

di shinpr · shinpr/agentic-code

Promosso ★ 9.6/10

Coding Rules — Set di regole concrete per clean-code: max 2 parametri, nessuna soppressione errori, early returns, YAGNI.

Cosa fa

Applica un set di regole clean-code specifico e opinionato durante la scrittura, revisione o refactoring del codice: 0-2 parametri di funzione (oggetti strutturati oltre a questo), una regola assoluta contro la soppressione degli errori con gestione specifica del layer, YAGNI, early returns rispetto all'annidamento profondo e piccole funzioni a responsabilità singola. Include un riferimento specifico per TypeScript che copre unknown+type guards, l'operatore satisfies, const assertions e branded types. Si attiva durante la scrittura di funzioni, la gestione degli errori, il refactoring o la revisione dello stile del codice.

Rapporto di test

La revisione di una funzione deliberatamente disordinata con 6 parametri rispetto al set di regole ha rilevato un catch(e){} silenzioso, due numeri magici non documentati e i 6 parametri posizionali che una revisione generica aveva trascurato, quindi ha prodotto una riscrittura conforme con object-param e early-return.

Testato il: 2026-07-14 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/shinpr/agentic-code
cd agentic-code
mkdir -p ~/.claude/skills
cp -r .agents/skills/coding-rules ~/.claude/skills/coding-rules

Comandi e prompt di esempio

  • /coding-rulesSet di regole concrete per clean-code: max 2 parametri, nessuna soppressione errori, early returns, YAGNI.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Refactor this function to use early returns instead of nesting
  • Review this code against our clean-code ruleset
  • Split this function's five parameters into a structured object