testacode-cursor-rules/.cursor/rules/README.md

CLI tool to install Testacode's Cursor Rules

# Cursor Rules

Este directorio contiene reglas para el asistente de IA de Cursor, organizadas por categorías para facilitar su mantenimiento y referencia.

## Estructura

Las reglas están organizadas en las siguientes categorías:

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

  - `code-style.mdc`: Convenciones de nomenclatura de archivos y orden de importaciones

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

  - `architecture.mdc`: Uso de types vs interfaces y exportaciones nombradas

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

  - `frontend.mdc`: Estándares para desarrollo frontend
  - `backend.mdc`: Estándares para desarrollo backend

- **general/**: Reglas generales y prácticas de desarrollo
  - `general.mdc`: Directrices generales para todo el código
  - `debugging.mdc`: Prácticas para debugging efectivo

## Cómo usar estas reglas

Las reglas de Cursor se utilizan para proporcionar contexto y guía al asistente de IA. Puedes referenciar reglas específicas en tus conversaciones con el asistente usando el nombre de la regla.

Por ejemplo:

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

O también puedes referenciar categorías completas:

```text
Asegúrate de aplicar las reglas de 'general' al escribir este código.
```

## Formato de las reglas

Cada archivo de reglas tiene un formato simple en Markdown:

````text
# Título de la regla

- Punto 1
- Punto 2
- ...

## Ejemplos (opcional)
```código de ejemplo```
````

## Instalación mediante CLI

Estas reglas pueden ser instaladas fácilmente mediante el CLI:

```bash
npx testacode-cursor-rules
```

## Mantenimiento

Para añadir nuevas reglas, crea un archivo `.mdc` en la categoría apropiada usando el formato de Markdown. Si necesitas crear una nueva categoría, añade un directorio nuevo y actualiza este README.

## Recomendación para visualización de reglas

Para asegurar una correcta interpretación y evitar posibles problemas al generar reglas automáticamente, se recomienda configurar Cursor para visualizar los archivos `.mdc` como texto plano. Añade el siguiente snippet a tu archivo `settings.json` del IDE:

```json
"workbench.editorAssociations": {
    "*.mdc": "default"
  }
```

Esto garantizará que el contenido de las reglas se muestre sin formato adicional que pueda interferir con los procesos automáticos.