Checker de calidad para equipos de software

Mirá el resultado

El mismo código, con un estándar visible

El checker no se queda en un número rojo: muestra qué estaba desordenado y cómo queda cuando cada decisión tiene un lugar. Este es el tipo de salida que recibe una persona y también un agente de IA.

src/services/users.ts

membrete actualizado por ArduMaker Checker

escaneo listo

Ver comparación

Antes · desordenado

Después · ordenado

4 hallazgos

sin bloqueos

Sin tipos claros, sin contrato documentado y con responsabilidades mezcladas.

Contrato explícito, validación en el borde y una salida que se puede revisar rápido.

estructura

cada cosa en su lugar

entrega

menos contexto perdido

lectura

10 líneas, una intención

El cambio

Dejar de confiar en que alguien se acuerde.

Antes

• Cada persona ordena el código a su manera.
• Los errores de estructura aparecen cuando ya afectan al equipo.
• La revisión depende de memoria, criterio y tiempo disponible.
• Un agente de IA puede producir cambios correctos pero desordenados.

Después

• Las mismas normas se aplican en cada repositorio.
• Los hooks revisan el trabajo antes de que llegue al commit.
• Cada hallazgo dice qué encontró, qué esperaba y dónde está.
• La salida JSON permite integrar agentes y automatizaciones sin ambigüedad.

Qué revisa

198 reglas agrupadas por el tipo de trabajo

El catálogo nace de nuestras normas internas y se publica para que cualquier equipo pueda adoptar el mismo formato de calidad. No es una lista de consejos: cada regla tiene un identificador, una severidad y un resultado comprobable.

• Código y nombres: estructura, firmas, complejidad y convenciones.
• Seguridad: secretos, credenciales, logs sensibles y configuraciones peligrosas.
• Repositorio: README, Git, archivos raíz, nombres y documentos mínimos.
• Configuración: Django, Vite, JavaScript, infraestructura y despliegues.
• Trabajo con IA: JSON estable, contexto explícito y salida apta para agentes.
• Formato: encabezados, líneas, columnas, espacios y archivos consistentes.

Cómo trabaja

Control automático, decisión humana

El checker recorre cada archivo una sola vez, mide valores concretos y devuelve códigos de salida útiles para un hook o un deploy. Solo modifica los encabezados que mantiene la herramienta; el resto se arregla bajo demanda.

• Se instala por repositorio con `ardumaker init` y revisa cada commit.
• Los hallazgos distinguen error, aviso y regla apagada.
• Puedes activar una familia o regla concreta con `--only` y `--skip`.
• La cuenta ArduMaker autoriza la terminal sin guardar una identidad anónima.

Excepciones que se pueden entender

Un estándar útil no obliga a fingir que todos los proyectos son iguales. La configuración permite ajustar umbrales, cambiar severidades y dejar documentada la decisión del equipo.

• Las reglas se pueden activar por familia o por ID.
• Las reglas apagadas por decisión explican por qué no corren por defecto.
• Los umbrales salen de la propia regla para no desincronizar documentación y comportamiento.

Lo que no promete

Un checker no reemplaza el diseño, las pruebas ni la revisión de una persona. Puede señalar estructura y disciplina, pero no decide si un producto es valioso ni si una arquitectura es la adecuada.

Adoptarlo tiene un costo inicial: habrá hallazgos que ordenar. El beneficio aparece cuando el repositorio deja de acumular el mismo problema en cada entrega.