---
title: Reglas
description: "Controlar el comportamiento de Verdent mediante archivos de reglas"
---

Los archivos de reglas son documentos Markdown que definen cómo se comporta Verdent durante las sesiones de programación. Guían el comportamiento del agente de IA, el formato de salida y el cumplimiento de los estándares del proyecto.

## Lo que aprenderás

- Comprender las reglas de usuario y las reglas de proyecto
- Cuándo usar cada tipo de regla
- Escribir reglas efectivas

---

## Tipos de reglas

| Tipo de regla | Archivo | Alcance | Propósito |
|-----------|------|-------|---------|
| **Reglas de usuario** | VERDENT.md | Global (todos los proyectos) | Preferencias personales de programación |
| **Reglas de proyecto** | AGENTS.md | Proyecto actual | Convenciones del equipo, estándares del proyecto |

**Ubicación:**
- Reglas de usuario: `~/.verdent/VERDENT.md`
- Reglas de proyecto: `<project>/AGENTS.md`

---

## Reglas de usuario (VERDENT.md)

Las reglas de usuario te permiten personalizar el comportamiento de Verdent en todos los proyectos.

**Acceso:** Settings → User Rules

**Guardado automático:** los cambios se guardan automáticamente después de 500 ms

<Tabs>
  <Tab title="Propósito">
    - **Preferencias de estilo de programación:** indentación, convenciones de nombres
    - **Convenciones de frameworks:** React, Vue, estándares de lenguaje
    - **Formato de respuesta:** nivel de detalle, estilo de explicación
    - **Preferencias personales de flujo de trabajo:** tono, estilo de comunicación
  </Tab>
  <Tab title="Ejemplo">
    ```markdown
    # User Rules

    ## Code Style
    - Always use TypeScript with strict mode
    - Prefer functional components over class components
    - Use Tailwind CSS for styling
    - Follow the project's existing naming conventions

    ## Communication
    - Provide brief explanations
    - Show code first, explain after
    - Write concise commit messages in conventional format
    ```
  </Tab>
</Tabs>

---

## Reglas de proyecto (AGENTS.md)

Las reglas de proyecto definen estándares específicos del proyecto actual. Súbelas al control de versiones para compartirlas con todo el equipo.

**Acceso:** panel de Project Settings

**Ubicación:** raíz del proyecto (`<project>/AGENTS.md`)

<Tabs>
  <Tab title="Casos de uso">
    - **Convenciones del equipo:** estándares de programación compartidos
    - **Arquitectura:** patrones de diseño, gestión de estado
    - **Pruebas:** requisitos de cobertura, frameworks
    - **Flujos de trabajo:** comandos de compilación, directrices de PR
  </Tab>
  <Tab title="Ejemplo">
    ```markdown
    # AGENTS.md

    ## Dev Environment
    - Run `pnpm install` to set up
    - Use `pnpm dev` for local development

    ## Testing
    - Run `pnpm test` before committing
    - Minimum 80% coverage required

    ## PR Guidelines
    - Use conventional commit format
    - Include tests for new features
    ```
  </Tab>
</Tabs>

<Tip>
Comparte AGENTS.md con tu equipo mediante el control de versiones para garantizar un comportamiento de IA coherente entre todos los integrantes del equipo.
</Tip>

---

## Escribir reglas efectivas

**Sé específico:**
```markdown
# Good
- Use async/await for asynchronous operations
- Include JSDoc comments for exported functions

# Avoid
- Try to use modern JavaScript features
- Add comments when necessary
```

**Mejores prácticas:**
- Usa un lenguaje claro y directivo ("Siempre...", "Nunca...", "Prefiere...")
- Agrupa las reglas relacionadas bajo encabezados de sección
- Mantén las reglas concisas (un concepto por viñeta)
- Revisa y actualiza las reglas a medida que el proyecto evoluciona

---

## Preguntas frecuentes

<AccordionGroup>
<Accordion title="¿Cómo creo archivos de reglas?">
Ve a Settings → User Rules para editar `VERDENT.md` con tus preferencias personales. Crea `AGENTS.md` en la raíz de tu proyecto para reglas específicas del proyecto. Usa Markdown simple con viñetas.
</Accordion>

<Accordion title="¿Cuándo surten efecto los cambios en las reglas?">
Los cambios en las reglas se aplican de inmediato en las conversaciones nuevas e influyen en las respuestas de la conversación actual.
</Accordion>

<Accordion title="¿Puedo anular las reglas temporalmente?">
Puedes proporcionar instrucciones específicas en tu prompt para anular las reglas en una sola solicitud.
</Accordion>
</AccordionGroup>