Coding Rules

Conjunto de reglas de código limpio concretas: máximo 2 parámetros, sin supresión de errores, retornos tempranos, YAGNI.

Por shinpr · shinpr/agentic-code

Probado · Funciona ★ 9.6/10

Coding Rules — Conjunto de reglas de código limpio concretas: máximo 2 parámetros, sin supresión de errores, retornos tempranos, YAGNI.

Qué hace

Aplica un conjunto de reglas de código limpio específico y con opinión al escribir, revisar o refactorizar código: 0-2 parámetros de función (objetos estructurados más allá de eso), una regla absoluta contra la supresión de errores con manejo específico de capa, YAGNI, retornos tempranos sobre anidamiento profundo y funciones pequeñas de responsabilidad única. Incluye una referencia específica de TypeScript que cubre unknown+type guards, el operador satisfies, const assertions y branded types. Se activa al escribir funciones, manejar errores, refactorizar o revisar el estilo del código.

Informe de la prueba

Revisar una función deliberadamente desordenada de 6 parámetros contra el conjunto de reglas detectó un `catch(e){}` silencioso, dos números mágicos indocumentados y los 6 parámetros posicionales que una revisión genérica pasó por alto, luego produjo una reescritura compatible con parámetros de objeto y retorno temprano.

Probado el: 2026-07-14 · Claude Code 2.x (agent harness)

Instalación

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

Comandos y prompts de ejemplo

  • /coding-rulesConjunto de reglas de código limpio concretas: máximo 2 parámetros, sin supresión de errores, retornos tempranos, YAGNI.

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • 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