Regras

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 o seu projeto específico.

Inicializar

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

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

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

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

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

Exemplo

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

# Projeto Monorepo SST v3

Este é um monorepo SST v3 com TypeScript. O projeto usa bun workspaces para gerenciamento de pacotes.

## Estrutura do Projeto

- `packages/` - Contém todos os pacotes do workspace (functions, core, web, etc.)
- `infra/` - Definições de infraestrutura divididas por serviço (storage.ts, api.ts, web.ts)
- `sst.config.ts` - Configuração principal do SST com imports dinâmicos

## Padrões de Código

- Use TypeScript com modo estrito habilitado
- Código compartilhado vai em `packages/core/` com configuração de exports adequada
- Funções vão em `packages/functions/`
- A infraestrutura deve ser dividida em arquivos lógicos em `infra/`

## Convenções do Monorepo

- Importe módulos compartilhados usando nomes de workspace: `@my-app/core/example`

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

Tipos

O dropstone também suporta a leitura do arquivo AGENTS.md de vários locais. E isso serve a propósitos diferentes.

Projeto

Coloque um AGENTS.md na raiz do seu projeto para regras específicas do projeto. Elas se aplicam apenas quando você está trabalhando neste diretório ou em 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 é enviado para o Git nem compartilhado com sua equipe, recomendamos usá-lo para especificar quaisquer regras pessoais que o LLM deve seguir.

Compatibilidade com Claude Code

Para usuários que estão migrando do Claude Code, o Dropstone lê as convenções de arquivos do Claude Code como fallback:

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

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

Precedência

Quando o Dropstone inicia, ele procura 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 acima estiver presente)

O primeiro arquivo correspondente vence em cada categoria. Por exemplo, se você tiver tanto AGENTS.md quanto CLAUDE.md, apenas AGENTS.md será 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 no seu dropstone.json ou no ~/.config/dropstone/dropstone.json global. Isso permite que você e sua equipe reutilizem regras existentes em vez de duplicá-las no 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 o dropstone não analise automaticamente referências de arquivos no AGENTS.md, você pode obter funcionalidade semelhante de duas maneiras:

Usando dropstone.json

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

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

Instruções Manuais no AGENTS.md

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

# Regras do Projeto TypeScript

## Carregamento de Arquivos Externos

CRÍTICO: Quando você encontrar uma referência de arquivo (por exemplo, @rules/general.md), use sua ferramenta de Leitura para carregá-la conforme a necessidade. Elas são relevantes para a TAREFA ESPECÍFICA em questão.

Instruções:

- NÃO carregue todas as referências preventivamente - use carregamento preguiçoso com base na necessidade real
- Quando carregado, trate o conteúdo como instruções obrigatórias que substituem os padrões
- Siga referências recursivamente quando necessário

## Diretrizes de Desenvolvimento

Para estilo de código TypeScript e melhores práticas: @docs/typescript-guidelines.md
Para arquitetura de componentes React e padrões de hooks: @docs/react-patterns.md
Para design de API REST e tratamento de erros: @docs/api-standards.md
Para estratégias de teste e requisitos de cobertura: @test/testing-guidelines.md

## Diretrizes Gerais

Leia o seguinte arquivo imediatamente, pois é relevante para todos os fluxos de trabalho: @rules/general-guidelines.md.

Essa abordagem permite que você:

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