CLAUDE.md

# 1. Global — carregado em TODAS as sessões, qualquer diretório
~/.claude/CLAUDE.md

# 2. Projeto — carregado quando você inicia Claude Code na raiz do projeto
/seu/projeto/CLAUDE.md

# 3. Subdiretório — carregado apenas quando você trabalha naquele subdiretório
/seu/projeto/src/CLAUDE.md
/seu/projeto/packages/api/CLAUDE.md

# Exemplo de estrutura em monorepo
meu-monorepo/
├── CLAUDE.md                    # Contexto geral do monorepo
├── packages/
│   ├── api/
│   │   └── CLAUDE.md            # Contexto específico da API
│   └── web/
│       └── CLAUDE.md            # Contexto específico do frontend
└── docs/
    └── CLAUDE.md                # Instruções para documentação

# Project Context
Este é um app Next.js para gestão de tarefas empresariais.
O backend é uma API REST com autenticação JWT.

## Tech Stack
- Next.js 15 App Router (TypeScript)
- Prisma ORM + PostgreSQL
- NextAuth.js para autenticação
- shadcn/ui + Tailwind CSS v4
- Jest + Testing Library para testes
- pnpm como package manager

## Architecture
- `src/app/` — rotas e páginas (App Router)
- `src/components/` — componentes reutilizáveis
- `src/lib/` — utilitários e configurações
- `src/server/` — lógica server-side e Server Actions
- `prisma/` — schema e migrations do banco

## Code Conventions
- TypeScript strict mode (sem `any` explícito)
- Use `async/await`, nunca `.then()/.catch()` encadeados
- Componentes em PascalCase, funções em camelCase
- Sem default exports — sempre use named exports
- Server Actions em `src/server/actions/`
- Validação de input com Zod sempre

## Important Commands
- `pnpm dev` — inicia servidor de desenvolvimento (porta 3000)
- `pnpm build` — build de produção
- `pnpm test` — executa todos os testes
- `pnpm test:watch` — testes em modo watch
- `pnpm db:migrate` — aplica migrations do Prisma
- `pnpm db:seed` — popula banco com dados de desenvolvimento
- `pnpm lint` — verifica linting

## Critical Files
- `src/lib/db.ts` — instância do Prisma Client (singleton)
- `src/lib/auth.ts` — configuração do NextAuth
- `src/types/index.ts` — tipos TypeScript compartilhados
- `prisma/schema.prisma` — schema do banco de dados
- `.env.example` — template de variáveis de ambiente

## Do Not
- Não faça commit de arquivos `.env` ou segredos
- Não use `npm` — sempre use `pnpm`
- Não modifique `prisma/migrations/` manualmente

# CLAUDE.md — com imports de outros arquivos

# Projeto: Plataforma de E-commerce

## Contexto Geral
Este arquivo combina contexto do projeto com documentação existente.

## Documentação Importada
@docs/api-reference.md
@.claude/team-conventions.md
@.claude/architecture-decisions.md

## Contexto Adicional
Além da documentação acima, sempre:
- Verifique os testes antes de modificar código de produção
- Consulte o CHANGELOG.md para entender mudanças recentes

# Team Conventions

## Git Workflow
- Branches: `feat/`, `fix/`, `chore/`, `docs/`
- Commits: Conventional Commits (feat, fix, refactor, test, docs)
- PRs: sempre requerem pelo menos 1 review
- Never force push to `main` or `develop`

## Code Review Checklist
- [ ] Testes adicionados/atualizados
- [ ] Sem `console.log` de debugging
- [ ] Tipos TypeScript corretos (sem `any`)
- [ ] Componentes acessíveis (WCAG 2.1 AA)
- [ ] Performance considerada (lazy loading, memoization)

## Naming Conventions
- Arquivos de componente: `ComponentName.tsx`
- Hooks: `use-hook-name.ts`
- Utilitários: `kebab-case.ts`
- Constantes: `UPPER_SNAKE_CASE`
- Tipos/Interfaces: `PascalCase` (sem prefixo I)

# Global Instructions — Minhas preferências pessoais

## Preferred Tools
- Git: use `gh` CLI para operações GitHub (não `git push origin` manual)
- Package manager: prefira `pnpm` sobre `npm` ou `yarn`
- Shell: zsh, então scripts devem ser compatíveis com zsh

## Code Style Preferences
- TypeScript strict mode por padrão
- Sem default exports — sempre named exports
- Nomes descritivos (sem `tmp`, `data`, `result` genéricos)
- Comentários em inglês, comunicação comigo em português

## GitHub Access
- GitHub CLI (`gh`) está instalado e autenticado como @meu-usuario
- Use `gh` para todas as operações remotas: PRs, issues, releases
- Sempre confirme antes de ações destrutivas (force push, deletar branches)

## Workflow Preferences
- Antes de modificar código, leia os arquivos relevantes primeiro
- Explique o que vai fazer antes de fazer
- Prefiro edições cirúrgicas (Edit) a reescritas completas (Write)
- Quando encontrar bugs, explique a causa raiz antes de corrigir

# [Nome do Projeto]
[Uma frase descrevendo o que o projeto faz e para quem]

## Tech Stack
- [Framework principal + versão]
- [Banco de dados + ORM]
- [Autenticação]
- [UI library]
- [Package manager]

## Project Structure
- `src/` — código fonte principal
- [Outras pastas importantes]

## Code Conventions
- [Convenção 1]
- [Convenção 2]

## Key Commands
- `[comando]` — [o que faz]
- `[comando]` — [o que faz]

## Critical Files
- `[arquivo]` — [por que é crítico]

## Do Not
- [Restrição importante]
- [Restrição importante]