Dropstone Docs

Regras

Defina instruções personalizadas para dropstone.

Você pode fornecer instruções personalizadas ao dropstone criando um arquivo AGENTS.md. Isso é semelhante às regras do Cursor. Ele contém instruções que serão incluídas no contexto do LLM para personalizar seu comportamento para seu projeto específico.

Inicializar

Para criar um novo arquivo AGENTS.md, você pode executar o comando /init no dropstone.

Dica:

Faça commit do arquivo AGENTS.md do seu projeto no Git para que o resto do seu time adote as mesmas regras.

/init verifica os arquivos importantes do seu repositório, pode fazer algumas perguntas direcionadas quando a base de código não consegue respondê-las, e então cria ou atualiza AGENTS.md com orientações concisas específicas do projeto.

Ele se concentra nas coisas que futuras sessões de agente provavelmente precisarão:

  • comandos de build, lint e test
  • ordem de comandos e etapas de verificação focadas quando importam
  • arquitetura e estrutura do repositório que não são óbvias apenas pelos nomes de arquivo
  • convenções específicas do projeto, peculiaridades de configuração e armadilhas operacionais
  • referências a fontes de instruções existentes como regras do Cursor ou Copilot

Se você já tem um AGENTS.md, /init o melhorará no local em vez de substituí-lo cegamente.

Exemplo

Você também pode criar este arquivo manualmente. Aqui está um exemplo de algumas coisas que você pode colocar em um arquivo AGENTS.md.

# SST v3 Monorepo Project

This is an SST v3 monorepo with TypeScript. The project uses bun workspaces for package management.

## Project Structure

- `packages/` - Contains all workspace packages (functions, core, web, etc.)
- `infra/` - Infrastructure definitions split by service (storage.ts, api.ts, web.ts)
- `sst.config.ts` - Main SST configuration with dynamic imports

## Code Standards

- Use TypeScript with strict mode enabled
- Shared code goes in `packages/core/` with proper exports configuration
- Functions go in `packages/functions/`
- Infrastructure should be split into logical files in `infra/`

## Monorepo Conventions

- Import shared modules using workspace names: `@my-app/core/example`

Estamos adicionando instruções específicas do projeto aqui e isso será compartilhado com seu time.

Tipos

dropstone também suporta leitura do arquivo AGENTS.md de múltiplos locais. E isso serve diferentes propósitos.

Projeto

Coloque um AGENTS.md na raiz do seu projeto para regras específicas do projeto. Estas se aplicam apenas quando você está trabalhando neste diretório ou seus subdiretórios.

Global

Você também pode ter regras globais em um arquivo ~/.config/dropstone/AGENTS.md. Isso é aplicado em todas as sessões do dropstone.

Como isso não é feito commit no Git ou compartilhado com seu time, recomendamos usar isso para especificar qualquer regra pessoal que o LLM deve seguir.

Compatibilidade com Claude Code

Para usuários migrando do Claude Code, Dropstone lê as convenções de arquivo do Claude Code como fallbacks:

  • Regras do projeto: CLAUDE.md no seu diretório de projeto (usado se nenhum AGENTS.md existir)
  • Regras globais: ~/.claude/CLAUDE.md (usado se nenhum ~/.config/dropstone/AGENTS.md existir)
  • Skills: ~/.claude/skills/ (veja Skills para detalhes)

Para impedir que Dropstone leia os locais do Claude Code, remova ou renomeie esses arquivos (ou faça commit do conteúdo equivalente em AGENTS.md para que o projeto tenha precedência).

Precedência

Quando Dropstone inicia, ele procura por arquivos de regras nesta ordem:

  1. Arquivos locais percorrendo para cima a partir do diretório atual (AGENTS.md, CLAUDE.md)
  2. Arquivo global em ~/.config/dropstone/AGENTS.md
  3. Arquivo do Claude Code em ~/.claude/CLAUDE.md (se nenhum dos anteriores estiver presente)

O primeiro arquivo correspondente em cada categoria vence. Por exemplo, se você tem tanto AGENTS.md quanto CLAUDE.md, apenas AGENTS.md é usado. Da mesma forma, ~/.config/dropstone/AGENTS.md tem precedência sobre ~/.claude/CLAUDE.md.

Instruções Personalizadas

Você pode especificar arquivos de instruções personalizadas em seu dropstone.json ou no ~/.config/dropstone/dropstone.json global. Isso permite que você e seu time reutilizem regras existentes em vez de ter que duplicá-las em AGENTS.md.

Exemplo:

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

Você também pode usar URLs remotas para carregar instruções da web.

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

Instruções remotas são buscadas com um timeout de 5 segundos.

Todos os arquivos de instruções são combinados com seus arquivos AGENTS.md.

Referenciando Arquivos Externos

Embora dropstone não analise automaticamente referências de arquivo em AGENTS.md, você pode alcançar funcionalidade semelhante de duas maneiras:

Usando dropstone.json

A abordagem recomendada é usar o campo instructions em dropstone.json:

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

Instruções Manuais em AGENTS.md

Você pode ensinar dropstone a ler arquivos externos fornecendo instruções explícitas em seu AGENTS.md. Aqui está um exemplo prático:

# TypeScript Project Rules

## External File Loading

CRITICAL: When you encounter a file reference (e.g., @rules/general.md), use your Read tool to load it on a need-to-know basis. They're relevant to the SPECIFIC task at hand.

Instructions:

- Do NOT preemptively load all references - use lazy loading based on actual need
- When loaded, treat content as mandatory instructions that override defaults
- Follow references recursively when needed

## Development Guidelines

For TypeScript code style and best practices: @docs/typescript-guidelines.md
For React component architecture and hooks patterns: @docs/react-patterns.md
For REST API design and error handling: @docs/api-standards.md
For testing strategies and coverage requirements: @test/testing-guidelines.md

## General Guidelines

Read the following file immediately as it's relevant to all workflows: @rules/general-guidelines.md.

Esta abordagem permite que você:

  • Crie arquivos de regras modulares e reutilizáveis
  • Compartilhe regras entre projetos via symlinks ou git submodules
  • Mantenha AGENTS.md conciso enquanto referencia diretrizes detalhadas
  • Garanta que dropstone carregue arquivos apenas quando necessário para a tarefa específica

Dica:

Para monorepos ou projetos com padrões compartilhados, usar dropstone.json com padrões glob (como packages/*/AGENTS.md) é mais sustentável do que instruções manuais.

Ctrl+I