Gabriel Santana de Menezes 1868d069c2 chore: enforce coding standards and add project guidelines

- Replace JPQL queries in TaskRepositoryImpl with Panache shorthand and Java filtering
- Replace == null / != null with Objects.isNull() / Objects.nonNull() across all layers
- Add CLAUDE.md with project conventions, architecture rules, and coding standards
- Add .github/PULL_REQUEST_TEMPLATE.md for standardized PR descriptions in Portuguese
- Add .claude/skills/new-task.md workflow guide (issue reading → branch → commit → PR)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-12 20:04:45 -04:00

2.3 KiB

Raw Blame History

trigger	description
manual	Workflow completo para iniciar e concluir uma nova tarefa a partir de uma issue do GitHub

Workflow de Nova Tarefa

Siga estes passos em ordem para executar uma tarefa do início ao PR.

Passo 1 — Ler a issue

gh issue view <número> --repo <owner/repo>

Leia o título e a descrição completa da issue antes de qualquer ação.

Passo 2 — Criar a branch

Escolha o prefixo de acordo com o tipo de mudança:

Tipo	Prefixo	Quando usar
Nova funcionalidade	`feat/`	Algo novo que o usuário percebe
Correção de bug	`fix/`	Comportamento errado corrigido
Manutenção/chore	`chore/`	Refactor, config, padrões, docs
Teste	`test/`	Apenas adição/correção de testes

Formato do nome: <prefixo><descricao-em-kebab-case>

git checkout main
git pull origin main
git checkout -b feat/nome-descritivo-da-tarefa

Passo 3 — Executar a tarefa

Implemente as mudanças seguindo os padrões definidos no CLAUDE.md do projeto.

Lembre-se de:

Não usar SQL nativo nem JPQL nas repositories
Usar Objects.isNull() / Objects.nonNull() ao invés de == null / != null
Seguir a Clean Architecture (entities → use cases → interface adapters → frameworks)
Não importar frameworks nas camadas de domínio

Passo 4 — Commit

Formato obrigatório: <tipo>: <descrição em inglês no imperativo>

git add <arquivos específicos>
git commit -m "feat: add null check using Objects utility methods"

Tipos válidos: feat, fix, chore, docs, test, refactor

Exemplos:

feat: add task filtering by organization
fix: prevent duplicate user organization entries
chore: replace JPQL queries with Panache shorthand

Passo 5 — Criar o Pull Request

git push origin <nome-da-branch>
gh pr create \
  --title "<tipo>: <descrição curta em inglês>" \
  --body "$(cat <<'EOF'
## Descrição
...

## Tipo de mudança
- [x] Nova funcionalidade

## Issue relacionada
Fecha #<número>

## O que foi feito
- ...

## Como testar
1. ...

## Checklist
- [x] Código segue padrões do projeto
- [x] Build passa sem erros
EOF
)"

A descrição do PR deve ser em português, detalhada e seguir o template em .github/PULL_REQUEST_TEMPLATE.md.

2.3 KiB Raw Blame History