Convenções de código¶

Fonte: AGENTS.md.

Branches (Git Flow)¶

feat/feature-name — nova funcionalidade
fix/bug-description — correção
docs/update-readme — documentação
Sem commits direto em main — sempre via PR.

Commits (Conventional Commits)¶

feat(auth): add 2FA with TOTP support
fix(crm): resolve WebSocket timeout issue
docs(readme): update installation steps
refactor(processor): simplify agent orchestration
test(services): add contact sync tests
chore(deps): upgrade Rails to 7.1.4

Ruby/Rails¶

Elemento	Convenção
Classes	`PascalCase`
Arquivos	`snake_case.rb`
Métodos	`snake_case` (público), `_private_method`
Constantes	`SCREAMING_SNAKE_CASE`
Migrations	`YYYYMMDDHHMMSS_description.rb`
Specs	espelham a estrutura de `app/`

TypeScript/JavaScript¶

Elemento	Convenção
Componentes	`PascalCase.tsx`
Arquivos	`kebab-case.ts` ou `PascalCase.tsx`
Funções/variáveis	`camelCase`
Tipos/Interfaces	`PascalCase`
Hooks	`use*`
Constantes	`SCREAMING_SNAKE_CASE`

Python¶

Elemento	Convenção
Módulos	`snake_case.py`
Classes	`PascalCase`
Funções/variáveis	`snake_case`
Constantes	`SCREAMING_SNAKE_CASE`
Docstrings	reStructuredText ou Google style
Type hints	obrigatórios (PEP 484)

Go¶

Elemento	Convenção
Packages	`lowercase`
Types	`PascalCase`
Funções	`PascalCase` (exportadas), `camelCase` (internas)
Variáveis	`camelCase`
Constantes	`PascalCase`
Arquivos	`snake_case.go`