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 según las necesidades específicas de tu proyecto.

Inicialización

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

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

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

• comandos de compilación, lint y pruebas
• orden de comandos y pasos de verificación enfocados cuando sean importantes
• arquitectura y estructura del repositorio que no sean obvias solo por los nombres de los archivos
• convenciones específicas del proyecto, peculiaridades de configuración y errores operativos
• referencias a fuentes de instrucciones existentes como las 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 simplemente crear este archivo manualmente. Aquí tienes un ejemplo de algunas cosas que puedes incluir en un archivo AGENTS.md.

# Proyecto Monorepo SST v3

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

## Estructura del Proyecto

- `packages/` - Contiene todos los paquetes del workspace (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 el modo estricto habilitado
- El código compartido va en `packages/core/` con la configuración de exportaciones adecuada
- Las funciones van en `packages/functions/`
- La infraestructura debe dividirse en archivos lógicos en `infra/`

## Convenciones del Monorepo

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

Estamos añadiendo instrucciones específicas del proyecto aquí y esto se compartirá en todo 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.

Dado que esto no se hace commit 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 respaldo:

• Reglas del proyecto: CLAUDE.md en el directorio de tu 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/ (consulta Habilidades para más detalles)

Para evitar que Dropstone lea las ubicaciones de Claude Code, elimina o renombra esos archivos (o haz commit del 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 recorriendo 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 que coincida 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 global ~/.config/dropstone/dropstone.json. 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.

Referencia a Archivos Externos

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

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í tienes un ejemplo práctico:

# Reglas del Proyecto TypeScript

## Carga de Archivos Externos

CRÍTICO: Cuando encuentres una referencia a un archivo (por ejemplo, @rules/general.md), usa tu herramienta de Lectura para cargarlo según sea necesario. Son relevantes para la TAREA específica en cuestión.

Instrucciones:

- NO cargues todas las referencias de forma preventiva: usa carga diferida según la necesidad real
- Cuando se carguen, trata el contenido como instrucciones obligatorias que anulan los valores predeterminados
- Sigue las referencias de forma recursiva cuando sea necesario

## Directrices de Desarrollo

Para el estilo de código TypeScript y las mejores prácticas: @docs/typescript-guidelines.md
Para la arquitectura de componentes React y los patrones de hooks: @docs/react-patterns.md
Para el diseño de API REST y el manejo de errores: @docs/api-standards.md
Para las estrategias de prueba y los 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 se hace referencia a directrices detalladas
• Asegurar que dropstone cargue los archivos solo cuando sea necesario para la tarea específica