testacode-cursor-rules/README.md

CLI tool to install Testacode's Cursor Rules

# Cursor Rules

Este repositorio contiene mis reglas personalizadas para [Cursor](https://cursor.sh), un IDE potenciado por IA diseñado para mejorar la productividad en el desarrollo de software.

## ¿Qué es Cursor?

Cursor es un editor de código basado en VSCode que integra modelos de lenguaje avanzados para asistir en la programación. Permite personalizar su comportamiento mediante reglas específicas que mejoran la experiencia de desarrollo.

## Propósito de este repositorio

Este espacio está dedicado a compartir mis configuraciones y reglas personalizadas para Cursor. El objetivo es:

- Documentar mis ajustes personales para referencia futura
- Compartir configuraciones útiles con la comunidad
- Explorar nuevas formas de mejorar la interacción con Cursor

## Estructura de reglas

Las reglas están organizadas en categorías temáticas para facilitar su mantenimiento y uso:

- **code-style/**: Reglas relacionadas con el formato y estilo del código

  - Convenciones de nomenclatura de archivos (kebab-case)
  - Orden de importaciones

- **architecture/**: Reglas relacionadas con la estructura y arquitectura del código

  - Uso de types vs interfaces
  - Exportaciones nombradas

- **domain-specific/**: Reglas específicas para diferentes áreas de desarrollo

  - Frontend (componentes React, estilos)
  - Backend (APIs, manejo de errores)

- **general/**: Reglas generales y prácticas de desarrollo
  - Directrices generales de código
  - Prácticas de debugging

## Herramienta CLI

Este repositorio incluye una herramienta CLI interactiva que permite instalar selectivamente las reglas que necesites:

```bash
# Ejecutar directamente en tu proyecto (sin instalación)
npx testacode-cursor-rules
```

La herramienta te guiará a través de un proceso interactivo para seleccionar:

- Todas las reglas
- Categorías específicas
- Reglas individuales

## Ejemplos de uso

### Uso con Cursor

Una vez instaladas las reglas en tu proyecto, puedes referenciarlas en tus conversaciones con Cursor:

## Uso libre

**Por favor, sigue las reglas de 'frontend' al crear este componente.**

```bash
$ npx testacode-cursor-rules

🚀 Instalador de Reglas de Cursor
Selecciona las reglas que deseas instalar en tu proyecto

¿Cómo quieres instalar las reglas?
> Instalar todas las reglas
  Seleccionar categorías
  Seleccionar reglas individuales
```

### Instalación selectiva

Las reglas se instalarán en la carpeta `.cursor/rules/` de tu proyecto, donde Cursor podrá acceder a ellas automáticamente.

## Contribuciones

Aunque este es principalmente un repositorio personal, las sugerencias y mejoras son bienvenidas. Si tienes ideas para optimizar alguna regla, no dudes en abrir un issue o enviar un pull request.

## Recursos adicionales

- [Documentación oficial de Cursor](https://cursor.sh/docs)
- [Comunidad de Cursor](https://discord.gg/cursor)

---

_Este repositorio no está afiliado oficialmente con Cursor._

## Features

- 🔍 Detects and dynamically includes all rule categories in your `.cursor/rules` directory
- 📋 Provides several installation options (all rules, by category, or individual selection)
- 💡 Easy to use CLI interface with interactive prompts
- 🚀 Installs rules directly to your project