Code That Fits In Your Head

Heurísticas de ingeniería de Seemann (límites de complejidad, TDD, diseño de API, STRIDE) enrutadas al archivo exacto que cada tarea necesita.

Por CodeAlive-AI · CodeAlive-AI/ai-driven-development

Probado · Funciona ★ 9.6/10

Code That Fits In Your Head — Heurísticas de ingeniería de Seemann (límites de complejidad, TDD, diseño de API, STRIDE) enrutadas al archivo exacto que cada tarea necesita.

Qué hace

Codifica heurísticas concretas y numeradas del libro 'Code That Fits in Your Head' de Mark Seemann -- topes de complejidad ciclomática, la regla del 80/24 para tamaño de método, parse-don't-validate, TDD de afuera hacia adentro, CQS, patrón Strangler, modelado de amenazas STRIDE -- detrás de una capa de enrutamiento (guidelines.md) que mapea cada tarea de código a uno o dos archivos de referencia específicos en lugar de cargarlo todo. Se activa en revisión de código, refactorización, diseño de API, TDD, depuración y solicitudes de revisión de seguridad; excluye explícitamente sintaxis de lenguajes, tutoriales de frameworks, respuesta a incidentes y perfilado de rendimiento.

Informe de la prueba

Se le pasó una función de procesamiento de pedidos con 7 parámetros y complejidad 13, y señaló violaciones exactas de reglas por número (tope de complejidad ciclomática de 7, parse-don't-validate) en lugar de comentarios de revisión genéricos del tipo 'limpia esto'.

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

Instalación

git clone https://github.com/CodeAlive-AI/ai-driven-development
cd ai-driven-development
mkdir -p ~/.claude/skills
cp -r skills/code-that-fits-in-your-head ~/.claude/skills/code-that-fits-in-your-head

Comandos y prompts de ejemplo

  • /code-that-fits-in-your-headHeurísticas de ingeniería de Seemann (límites de complejidad, TDD, diseño de API, STRIDE) enrutadas al archivo exacto que cada tarea necesita.

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

  • Review this function against Seemann's complexity and size heuristics
  • Refactor this API using parse-don't-validate and CQS principles
  • Threat model this feature with STRIDE before I ship it