Crie um arquivo AGENTS.md de alta qualidade

Você é um agente de código. Sua tarefa é criar um arquivo AGENTS.md completo e preciso na raiz deste repositório, seguindo as orientações públicas em https://agents.md/.

AGENTS.md é um formato aberto projetado para fornecer aos agentes de codificação o contexto e as instruções de que precisam para trabalhar efetivamente em um projeto.

O que é AGENTS.md?

AGENTS.md é um arquivo Markdown que serve como um "README para agentes" - um local dedicado e previsível para fornecer contexto e instruções que ajudem os agentes de codificação de IA a trabalhar em seu projeto. Ele complementa o README.md contendo contexto técnico detalhado que os agentes de codificação precisam, mas que pode poluir um README focado em humanos.

Princípios Chave

• Focado no Agente: Contém instruções técnicas detalhadas para ferramentas automatizadas
• Complementa o README.md: Não substitui a documentação humana, mas adiciona contexto específico para agentes
• Localização Padronizada: Colocado na raiz do repositório (ou nas raízes de subprojetos para monorepos)
• Formato Aberto: Usa Markdown padrão com estrutura flexível
• Compatibilidade com Ecossistema: Funciona em mais de 20 ferramentas e agentes de codificação de IA diferentes

Estrutura do Arquivo e Diretrizes de Conteúdo

1. Configuração Necessária

• Crie o arquivo como AGENTS.md na raiz do repositório
• Use formatação Markdown padrão
• Sem campos obrigatórios - estrutura flexível baseada nas necessidades do projeto

2. Seções Essenciais a Incluir

Visão Geral do Projeto

• Breve descrição do que o projeto faz
• Visão geral da arquitetura, se complexa
• Principais tecnologias e frameworks utilizados

Comandos de Configuração

• Instruções de instalação
• Passos para configuração do ambiente
• Comandos de gerenciamento de dependências
• Configuração de banco de dados, se aplicável

Fluxo de Desenvolvimento

• Como iniciar o servidor de desenvolvimento
• Comandos de build
• Configuração de watch/hot-reload
• Especificidades do gerenciador de pacotes (npm, pnpm, yarn, etc.)

Instruções de Teste

• Como executar testes (unitários, de integração, e2e)
• Localização e convenções de nomenclatura de arquivos de teste
• Requisitos de cobertura
• Padrões ou frameworks de teste específicos utilizados
• Como executar um subconjunto de testes ou focar em áreas específicas

Diretrizes de Estilo de Código

• Convenções específicas da linguagem
• Regras de linting e formatação
• Padrões de organização de arquivos
• Convenções de nomenclatura
• Padrões de importação/exportação

Build e Implantação

• Comandos de build e saídas
• Configurações de ambiente
• Passos e requisitos de implantação
• Informações do pipeline de CI/CD

3. Seções Opcionais, mas Recomendadas

Considerações de Segurança

• Requisitos de testes de segurança
• Gerenciamento de segredos
• Padrões de autenticação
• Modelos de permissão

Instruções de Monorepo (se aplicável)

• Como trabalhar com múltiplos pacotes
• Dependências entre pacotes
• Build/teste seletivo
• Comandos específicos de pacotes

Diretrizes de Pull Request

• Requisitos de formato do título
• Verificações necessárias antes da submissão
• Processo de revisão
• Convenções de mensagens de commit

Depuração e Solução de Problemas

• Problemas comuns e soluções
• Padrões de logging
• Configuração de depuração
• Considerações de desempenho

Exemplo de Template

Use este como um template inicial e personalize com base no projeto específico:

# AGENTS.md

## Project Overview

[Brief description of the project, its purpose, and key technologies]

## Setup Commands

- Install dependencies: `[package manager] install`
- Start development server: `[command]`
- Build for production: `[command]`

## Development Workflow

- [Development server startup instructions]
- [Hot reload/watch mode information]
- [Environment variable setup]

## Testing Instructions

- Run all tests: `[command]`
- Run unit tests: `[command]`
- Run integration tests: `[command]`
- Test coverage: `[command]`
- [Specific testing patterns or requirements]

## Code Style

- [Language and framework conventions]
- [Linting rules and commands]
- [Formatting requirements]
- [File organization patterns]

## Build and Deployment

- [Build process details]
- [Output directories]
- [Environment-specific builds]
- [Deployment commands]

## Pull Request Guidelines

- Title format: [component] Brief description
- Required checks: `[lint command]`, `[test command]`
- [Review requirements]

## Additional Notes

- [Any project-specific context]
- [Common gotchas or troubleshooting tips]
- [Performance considerations]

Exemplo de Trabalho do agents.md

Aqui está um exemplo real do site agents.md:

# Arquivo AGENTS.md de Amostra

## Dicas de ambiente de desenvolvimento


…