Cargando…

Esto está tardando más de lo esperado.

Leer los estándares

Dónde viven las reglas, cómo leer una en cualquiera de los dos idiomas y cómo saber cuáles revisa el analizador por ti.

Los estándares son las reglas contra las que se revisa tu código. Nadie las copia dentro de un proyecto: viven en el servidor y se leen cuando hacen falta, así que una regla que cambia hoy es la regla que mañana sigue cualquier proyecto.

Cada regla dice qué revisa y por qué existe. La segunda mitad es la que vale la pena leer. Un veredicto sin motivo no enseña nada y no se puede discutir, así que antes de rodear una regla, léela completa.

Leerlos en el panel

Abre Estándares en el menú lateral. La página abre en el catálogo: una tarjeta por estándar, cada una con el número de reglas que contiene y un enlace Ver las reglas. Abre una tarjeta y tienes ese estándar completo, regla por regla, con el código incorrecto y el correcto uno al lado del otro.

El panel se lee en el idioma de tu cuenta, así que lo cambias en tu perfil y las reglas cambian contigo.

La pantalla Estándares, una tarjeta por categoría con el número de reglas que tiene

Leerlos en el sitio público

Los estándares son públicos. Cada idioma tiene su propia dirección:

Idioma Dirección
Inglés /standards
Español /estandares

Ahí no hay nada detrás del inicio de sesión, así que puedes mandarle una regla a alguien que todavía no tiene cuenta. Abrir una de esas direcciones también es elegir idioma: el resto del sitio te sigue en lugar de volver atrás en el siguiente clic.

Un hallazgo enlaza directo a la regla de la que viene, en su propia ancla, así que pocas veces tienes que ir a buscarla a mano.

Leer una desde tu asistente

Un asistente con el toolkit instalado lee los estándares por la conexión y no desde una copia en disco:

  • list_standards devuelve los estándares y cuántas reglas tiene cada uno.
  • get_standard devuelve uno completo.

Así es como el asistente resuelve una duda sobre la redacción exacta de una regla mientras escribe. Cómo dejar conectado un cliente está en Conectar Claude Code.

Qué cubre cada estándar

Estándar Qué cubre
PHP Idioma y textos, estructuras de control, helpers, tamaño de clase, comentarios
Laravel Policies Cómo se escribe y se registra una policy
Laravel Front Campos, filtros, acciones, autorización y orden de métodos de un recurso
Laravel Models $guarded, orden de secciones, scopes, casts, enums, accessors, relaciones
Laravel Observers Qué puede hacer un observer y en qué orden van sus hooks
Laravel Traits Reutilización, orden de secciones, relaciones
Laravel Routes Controladores y la arquitectura de CRUD
Laravel Migrations Cómo se escribe una migración
Laravel Notifications De qué base extiende una notificación y qué declara
Services Qué puede hacer un servicio y cómo reporta un resultado
Application Classes Dónde va el código cuando no tiene un lugar obvio
Livewire Orden de la estructura, autorización, render(), propiedades, validación, modales
Blade Markup legible, los componentes de formulario del proyecto, feedback y estados de error
Alpine.js and Livewire Cuál de los dos es dueño de cada comportamiento
Tailwind CSS Colores, modo oscuro, hover, cursor, anidamiento, repetición, diseño responsivo
Documentation El idioma en el que se escribe cada archivo Markdown de un repositorio, y que una traducción diga lo mismo que su fuente
Queues and Time Budget El tope de cinco segundos para cualquier trabajo, y cómo el trabajo pesado corre en la cola en jobs chicos mientras la persona ve cómo avanza

Qué reglas revisa el analizador por ti

No todas las reglas de un estándar tienen una revisión automática detrás. list_rules devuelve las reglas configuradas hoy y marca las que puede decidir una revisión determinista. Esas son las que puede reportar una ejecución.

Una regla sin esa revisión sigue siendo el estándar. Está publicada, se lee y se cumple a mano. Cuatro revisiones no la van a tener nunca, y son justo las que conviene saberse de memoria: Lo que el analizador no puede revisar.

Una revisión hecha por una persona nunca se reporta como una pasada del analizador. Son cosas distintas y responden preguntas distintas.

Las mismas reglas en dos idiomas

El inglés es la fuente. El español se traduce desde ahí y lleva una huella del inglés del que salió, así que una regla cuya fuente cambió se reporta en lugar de quedarse desfasada en silencio.

Los dos idiomas son una sola regla, no dos documentos. Reescribir el español para que se lea como escrito y no como traducido es bienvenido; cambiar lo que dice no lo es, porque quien lo lee no tiene manera de saber cuál de las dos versiones es la verdadera. Agregar o cambiar una regla está en Escribir una regla nueva.