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

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

# 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

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)

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

# 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

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

Escribir reglas efectivas

Sé específico:

# 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

¿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.

¿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.

¿Puedo anular las reglas temporalmente?

Puedes proporcionar instrucciones específicas en tu prompt para anular las reglas en una sola solicitud.

View source