Generador de Plantillas de Reglas de Codificación Vibe

Cree y personalice plantillas de reglas de codificación vibe que pueden aplicarse a su equipo y proyectos.

Editor de Plantilla de Reglas de Codificación

# Conjunto de Reglas de Codificación Vibe

## Reglas de Estilo de Código
**Nomenclatura de Variables y Funciones**
 - Nombres intuitivos y claros
 - Variables: forma nominal, usar prefijos is, has, can para estado
 - Funciones: comenzar con verbo, usar prefijos is, has, can para retornos booleanos
 - Constantes: UPPER_SNAKE_CASE
 - Evitar abreviaciones (excepto las ampliamente conocidas como URL, API)

**Reglas de Desarrollo y Calidad de Código**
 - Una función debe tener solo una responsabilidad
 - Mantener funciones bajo 15 líneas (separar lógica compleja)
 - Priorizar funciones puras
 - La profundidad de anidamiento no debe exceder 3 niveles

**Escritura de Comentarios**
 - Explicar 'por qué' en lugar de 'qué' hace el código
 - Agregar comentarios explicativos para lógica de negocio compleja
 - Agregar descripciones breves para cada endpoint de API
 - Usar activamente etiquetas TODO, FIXME, HACK

## Directrices de Pruebas
**Prioridades de Prueba**
 - Lógica de negocio principal - debe probar
 - Interacciones de usuario - solo flujos importantes
 - Funciones de utilidad - solo lógica compleja
 - Componentes UI - enfoque en renderizado condicional

**Estándares de Prueba**
 - Objetivo de cobertura de prueba: 80% o más (lógica principal 100%)
 - Seguir patrón Given-When-Then
 - Usar mocks solo para dependencias externas

## Seguridad y Manejo de Errores
**Lista de Verificación de Seguridad**
 - Gestionar información sensible con variables de entorno
 - Validar tanto en frontend como backend
 - Mensajes de error amigables para el usuario
 - Seguir consideraciones básicas de seguridad: prevención XSS, CSRF, inyección SQL

## Diseño Responsivo y Accesibilidad
**Principios Básicos de Accesibilidad**
 - Usar etiquetas HTML semánticas significativas
 - Proporcionar etiquetas ARIA apropiadas
 - Soportar navegación por teclado
 - No depender únicamente del color para información

## Despliegue y Monitoreo
**Registro y Monitoreo**
 - Desarrollo: registros detallados
 - Producción: solo errores y eventos importantes
 - Nunca registrar información personal del usuario

## Principios de Documentación
**Elementos Esenciales del README**
 - Descripción y propósito del proyecto
 - Instrucciones de instalación y ejecución
 - Introducción a características clave
 - Documentación de API (si aplica)

**Documentación de Código**
 - Explicación de lógica de negocio compleja
 - Especificaciones de interfaz de API

## Guía de Refactorización
**Señales de Refactorización**
 - Cuando el mismo código se repite 3+ veces
 - Cuando las funciones exceden 20 líneas
 - Cuando las condiciones se anidan 3+ niveles profundo
 - Cuando los nombres de variables o funciones no son claros

**Principios de Refactorización**
 - Mejora gradual en unidades pequeñas
 - Escribir código de prueba primero
 - Separar cambios de funcionalidad de refactorización
 - Comunicación suficiente con miembros del equipo

## Reglas de Commit Git
**Convención de Mensaje de Commit**
 - feat: agregar nueva característica
 - fix: corrección de error
 - docs: cambios de documentación
 - style: cambios de estilo de código (sin cambios funcionales)
 - refactor: refactorización de código
 - test: agregar/modificar código de prueba
 - chore: cambios de proceso de construcción o herramientas auxiliares

Plantilla de Reglas de Codificación Vibe

Edite la plantilla anterior para crear reglas de codificación que se ajusten a su equipo y proyecto. Puede utilizar las funciones de copiar, descargar y restablecer.

¿Qué es la Codificación Vibe?

La Codificación Vibe se refiere a estilos de codificación y cultura de desarrollo que reflejan la atmósfera y filosofía de un equipo de desarrollo. Va más allá de las simples reglas de sintaxis para abarcar directrices de desarrollo integrales que incorporan los valores y la filosofía de desarrollo del equipo.

Las buenas reglas de codificación vibe ayudan a los miembros del equipo a escribir código en un estilo consistente, reducen el tiempo de revisión de código y facilitan la incorporación de nuevos miembros del equipo.

Guía de Mejora de Calidad del Código

Consistencia: Todos los miembros del equipo escriben código en el mismo estilo para mejorar la legibilidad.
Claridad: Los nombres de variables y funciones expresan claramente la intención para mejorar la comprensión del código.
Simplicidad: La lógica compleja se separa en unidades pequeñas para mejorar la mantenibilidad.
Capacidad de Prueba: El código se escribe en una estructura fácil de probar para asegurar la estabilidad.

Cómo Usar

Editar Plantilla: Modifique la plantilla básica proporcionada para satisfacer las necesidades de su equipo.
Discusión de Equipo: Revise las reglas con los miembros del equipo y encuentren puntos en común.
Guardar y Compartir: Copie las reglas completadas o descárguelas como archivo markdown para compartir con su equipo.
Mejora Continua: Actualice las reglas según sea necesario durante el progreso del proyecto.

Beneficios de la Codificación Vibe

Eficiencia de Desarrollo Mejorada: Reduzca el tiempo de revisión de código con estilos de codificación consistentes.
Colaboración de Equipo Mejorada: Fortalezca la cohesión del equipo con filosofía de desarrollo compartida.
Aseguramiento de Calidad del Código: Reduzca errores y mejore la mantenibilidad con reglas sistemáticas.
Incorporación de Nuevos Desarrolladores: Ayude a los nuevos miembros del equipo a adaptarse con directrices claras.

Características Principales

Edición en Tiempo Real: Modifica y previsualiza plantillas en tiempo real.
Copia con Un Clic: Copia fácilmente las reglas completadas al portapapeles.
Descarga de Markdown: Descarga como archivo .md para guardar y compartir.
Reinicio de Plantilla: Vuelve a la plantilla por defecto en cualquier momento.
Personalización: Modifica libremente para adaptarse a las características de tu equipo.