Reglas

Puedes proporcionar instrucciones personalizadas a dropstone creando un archivo AGENTS.md. Esto es similar a las reglas de Cursor. Contiene instrucciones que se incluirán en el contexto del LLM para personalizar su comportamiento para tu proyecto específico.

Inicializar

Para crear un nuevo archivo AGENTS.md, puedes ejecutar el comando /init en dropstone.

/init escanea los archivos importantes en tu repositorio, puede hacer un par de preguntas específicas cuando la base de código no puede responderlas, y luego crea o actualiza AGENTS.md con orientación concisa específica del proyecto.

Se enfoca en las cosas que las futuras sesiones del agente probablemente necesitarán:

• comandos de compilación, linting y pruebas
• orden de comandos y pasos de verificación enfocados cuando importan
• arquitectura y estructura del repositorio que no son obvias solo por los nombres de archivo
• convenciones específicas del proyecto, peculiaridades de configuración y trampas operacionales
• referencias a fuentes de instrucciones existentes como reglas de Cursor o Copilot

Si ya tienes un AGENTS.md, /init lo mejorará en su lugar en lugar de reemplazarlo ciegamente.

Ejemplo

También puedes crear este archivo manualmente. Aquí hay un ejemplo de algunas cosas que puedes poner en un archivo AGENTS.md.

# Proyecto Monorepo SST v3

Este es un monorepo SST v3 con TypeScript. El proyecto utiliza espacios de trabajo de bun para la gestión de paquetes.

## Estructura del Proyecto

- `packages/` - Contiene todos los paquetes del espacio de trabajo (functions, core, web, etc.)
- `infra/` - Definiciones de infraestructura divididas por servicio (storage.ts, api.ts, web.ts)
- `sst.config.ts` - Configuración principal de SST con importaciones dinámicas

## Estándares de Código

- Usa TypeScript con modo estricto habilitado
- El código compartido va en `packages/core/` con configuración de exportaciones adecuada
- Las funciones van en `packages/functions/`
- La infraestructura debe dividirse en archivos lógicos en `infra/`

## Convenciones de Monorepo

- Importa módulos compartidos usando nombres de espacios de trabajo: `@my-app/core/example`

Estamos agregando instrucciones específicas del proyecto aquí y esto se compartirá con tu equipo.

Tipos

dropstone también admite la lectura del archivo AGENTS.md desde múltiples ubicaciones. Y esto sirve para diferentes propósitos.

Proyecto

Coloca un AGENTS.md en la raíz de tu proyecto para reglas específicas del proyecto. Estas solo se aplican cuando trabajas en este directorio o sus subdirectorios.

Global

También puedes tener reglas globales en un archivo ~/.config/dropstone/AGENTS.md. Esto se aplica en todas las sesiones de dropstone.

Como esto no se confirma en Git ni se comparte con tu equipo, recomendamos usarlo para especificar cualquier regla personal que el LLM deba seguir.

Compatibilidad con Claude Code

Para usuarios que migran desde Claude Code, Dropstone lee las convenciones de archivos de Claude Code como alternativas:

• Reglas del proyecto: CLAUDE.md en tu directorio de proyecto (se usa si no existe AGENTS.md)
• Reglas globales: ~/.claude/CLAUDE.md (se usa si no existe ~/.config/dropstone/AGENTS.md)
• Habilidades: ~/.claude/skills/ (ver Habilidades para más detalles)

Para evitar que Dropstone lea las ubicaciones de Claude Code, elimina o renombra esos archivos (o confirma el contenido equivalente en AGENTS.md para que el proyecto tenga prioridad).

Precedencia

Cuando Dropstone se inicia, busca archivos de reglas en este orden:

1. Archivos locales atravesando hacia arriba desde el directorio actual (AGENTS.md, CLAUDE.md)
2. Archivo global en ~/.config/dropstone/AGENTS.md
3. Archivo de Claude Code en ~/.claude/CLAUDE.md (si ninguno de los anteriores está presente)

El primer archivo coincidente gana en cada categoría. Por ejemplo, si tienes tanto AGENTS.md como CLAUDE.md, solo se usa AGENTS.md. De manera similar, ~/.config/dropstone/AGENTS.md tiene prioridad sobre ~/.claude/CLAUDE.md.

Instrucciones Personalizadas

Puedes especificar archivos de instrucciones personalizadas en tu dropstone.json o en el ~/.config/dropstone/dropstone.json global. Esto te permite a ti y a tu equipo reutilizar reglas existentes en lugar de tener que duplicarlas en AGENTS.md.

Ejemplo:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "instructions": ["CONTRIBUTING.md", "docs/guidelines.md", ".cursor/rules/*.md"]
}

También puedes usar URLs remotas para cargar instrucciones desde la web.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "instructions": ["https://raw.githubusercontent.com/my-org/shared-rules/main/style.md"]
}

Las instrucciones remotas se obtienen con un tiempo de espera de 5 segundos.

Todos los archivos de instrucciones se combinan con tus archivos AGENTS.md.

Referenciando Archivos Externos

Aunque dropstone no analiza automáticamente referencias de archivos en AGENTS.md, puedes lograr una funcionalidad similar de dos formas:

Usando dropstone.json

El enfoque recomendado es usar el campo instructions en dropstone.json:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "instructions": ["docs/development-standards.md", "test/testing-guidelines.md", "packages/*/AGENTS.md"]
}

Instrucciones Manuales en AGENTS.md

Puedes enseñar a dropstone a leer archivos externos proporcionando instrucciones explícitas en tu AGENTS.md. Aquí hay un ejemplo práctico:

# Reglas del Proyecto TypeScript

## Carga de Archivos Externos

CRÍTICO: Cuando encuentres una referencia de archivo (p. ej., @rules/general.md), usa tu herramienta Read para cargarlo según sea necesario. Son relevantes para la TAREA ESPECÍFICA en cuestión.

Instrucciones:

- NO cargues preemptivamente todas las referencias - usa carga perezosa basada en necesidad real
- Cuando se cargue, trata el contenido como instrucciones obligatorias que anulan los valores predeterminados
- Sigue referencias recursivamente cuando sea necesario

## Directrices de Desarrollo

Para estilo de código TypeScript y mejores prácticas: @docs/typescript-guidelines.md
Para arquitectura de componentes React y patrones de hooks: @docs/react-patterns.md
Para diseño de API REST y manejo de errores: @docs/api-standards.md
Para estrategias de pruebas y requisitos de cobertura: @test/testing-guidelines.md

## Directrices Generales

Lee el siguiente archivo inmediatamente ya que es relevante para todos los flujos de trabajo: @rules/general-guidelines.md.

Este enfoque te permite:

• Crear archivos de reglas modulares y reutilizables
• Compartir reglas entre proyectos mediante enlaces simbólicos o submódulos de git
• Mantener AGENTS.md conciso mientras referencias directrices detalladas
• Asegurar que dropstone cargue archivos solo cuando sea necesario para la tarea específica