Codex: Regras & Hooks do Codex

# AGENTS.md

## Visão Geral do Projeto
Nome do Projeto: E-Commerce API
Stack Tecnológica: FastAPI + PostgreSQL + Redis
Padrões de Código: PEP 8 + Black formatter

## Regras de Código
- Todas as funções devem ter anotações de tipo
- Todos os endpoints de API devem ter validação de entrada
- Usar injeção de dependência
- Usar classes de exceção personalizadas para tratamento de erros

## Estrutura de Arquivos
- src/api/ - Rotas de API
- src/models/ - Modelos de dados
- src/services/ - Lógica de negócios
- src/tests/ - Arquivos de teste

## Operações Proibidas
- Não modifique arquivos .env
- Não delete testes existentes
- Não instale novas dependências (requer confirmação humana)
- Não modifique migrações existentes em database/migrations/

# AGENTS.md

## Visão Geral do Projeto
Site de e-commerce Next.js 14, usando App Router + TypeScript + Prisma

## Regras de Código
- Componentes usam componentes funcionais + TypeScript
- Use server actions em vez de rotas de API
- Busca de dados usa RSC (React Server Components)
- Estilização usa Tailwind CSS
- Formulários usam React Hook Form + validação Zod

## Convenções de Diretório
- app/ - Páginas e rotas
- components/ - Componentes reutilizáveis
- lib/ - Funções utilitárias e configuração
- types/ - Definições de tipos TypeScript

## Operações Proibidas
- Não use 'use client' a menos que necessário
- Não instale novas bibliotecas de UI (use shadcn/ui existente)
- Não modifique modelos existentes em prisma/schema.prisma (apenas adicione novos)
- Não modifique middleware.ts

# .codex/config.toml

[hooks]
# Auto-executar testes após conclusão da tarefa
post-task = "npm test"

# Auto-formatar antes do commit
pre-commit = "npm run format && npm run lint"

# Enviar notificação em caso de erro
on-error = "curl -X POST https://hooks.slack.com/xxx -d 'Codex error'"

# .codex/hooks/post-task.sh
#!/bin/bash

# Executar testes
npm test
if [ $? -ne 0 ]; then
  echo "Tests failed! Fixing..."
  codex --full-auto "Fix all failing tests"
fi

# Formatar código
npm run format

# Verificar lint
npm run lint

# Configuração de hooks de Bob
[hooks]
post-task = "bash .codex/hooks/post-task.sh"

# .codex/hooks/post-task.sh
#!/bin/bash
npm test                    # Executar testes
npm run lint -- --fix       # Corrigir lint
npm run format              # Formatar
echo "Hook: post-task completed"

project/
├── AGENTS.md              # Regras globais
├── src/
│   ├── AGENTS.md          # Regras do diretório src
│   ├── api/
│   │   └── AGENTS.md      # Regras do módulo API
│   └── auth/
│       └── AGENTS.md      # Regras do módulo Auth

AGENTS.md do subdiretório > AGENTS.md do diretório pai > AGENTS.md da raiz

<!-- src/api/AGENTS.md -->
# Regras do Módulo API
- Todos os endpoints devem ter documentação Swagger
- Use Pydantic para validação de request/response
- Retorne formato de resposta padrão: { data: ..., error: ... }

AGENTS.md subdiretório > AGENTS.md raiz > Skills > Arquivos de Config > Comportamento padrão