O que o agente
nunca esquece.

Regras são instruções permanentes que entram no contexto de toda sessão. Vivem no AGENTS.md do projeto — versionado, revisável, compartilhado com o time.

01Criando com /init

/init

O comando varre os arquivos importantes do repositório — e pergunta quando o código não responde sozinho — para criar ou melhorar em vez de substituir o AGENTS.md, focando no que sessões futuras vão precisar:

• Comandos de build, lint e teste — e a ordem em que importam.
• Arquitetura e estrutura que não são óbvias pelos nomes de arquivo.
• Convenções do projeto, pegadinhas de setup, gotchas operacionais.
• Referências a fontes de instrução existentes (regras de Cursor, Copilot).

02Um bom AGENTS.md

# Monorepo SST v3

Monorepo TypeScript com workspaces bun.

## Estrutura
- `packages/` — workspaces (functions, core, web)
- `infra/` — infraestrutura por serviço

## Padrões
- TypeScript strict; código compartilhado em `packages/core/`
- Imports por workspace: `@my-app/core/example`

Curto, específico, operacional. Regra boa é a que evita uma pergunta ou um erro — não um manifesto.

03Escopos

Na inicialização, o MVCode sobe da pasta atual até o repositório procurando o arquivo local; o global entra em seguida.

04Instruções adicionais

A chave instructions da config soma outros arquivos ao contexto — reaproveite o que já existe em vez de duplicar:

{
  "instructions": [
    "CONTRIBUTING.md",
    "docs/guidelines.md",
    ".cursor/rules/*.md",
    "packages/*/AGENTS.md",
    "https://raw.githubusercontent.com/my-org/shared-rules/main/style.md"
  ]
}

Globs cobrem monorepos; URLs remotas são buscadas com timeout de 5 segundos. Tudo se combina com o AGENTS.md.

05Regras modulares, carregadas sob demanda

O agente não segue referências de arquivo automaticamente — mas você pode instruí-lo a carregar módulos quando a tarefa pedir:

## Carregamento externo

Ao encontrar uma referência (ex.: @rules/general.md), use a
ferramenta Read para carregá-la quando for relevante à tarefa.
Não carregue tudo preventivamente.

Estilo TypeScript: @docs/typescript-guidelines.md
Padrões de API: @docs/api-standards.md

Mantém o AGENTS.md enxuto e as diretrizes detalhadas em arquivos próprios. Para conhecimento maior e reutilizável, o formato certo são as skills.