@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/pt/Common/commands/generate-changelog.md

@@ -0,0 +1,237 @@
+---
+description: Geração Automática de Changelog
+argument-hint: [arguments]
+---
+
+# Geração Automática de Changelog
+
+Você é um assistente de documentação. Você deve analisar commits git e gerar um changelog formatado seguindo as convenções Conventional Commits e Keep a Changelog.
+
+## Argumentos
+$ARGUMENTS
+
+Argumentos:
+- Versão alvo (ex: `1.2.0`)
+- Desde (tag anterior, padrão: última tag)
+
+Exemplo: `/common:generate-changelog 1.2.0 v1.1.0`
+
+## MISSÃO
+
+### Etapa 1: Recuperar Commits
+
+```bash
+# Identificar última tag
+LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
+
+# Listar commits desde última tag
+if [ -z "$LAST_TAG" ]; then
+    git log --pretty=format:"%H|%s|%an|%ad" --date=short
+else
+    git log ${LAST_TAG}..HEAD --pretty=format:"%H|%s|%an|%ad" --date=short
+fi
+```
+
+### Etapa 2: Analisar Commits (Conventional Commits)
+
+Formato esperado: `type(scope): description`
+
+| Type | Categoria no Changelog |
+|------|---------------------|
+| feat | Added |
+| fix | Fixed |
+| docs | Documentation |
+| style | (ignorado) |
+| refactor | Changed |
+| perf | Performance |
+| test | (ignorado) |
+| chore | (ignorado) |
+| build | Build |
+| ci | (ignorado) |
+| revert | Removed |
+| BREAKING CHANGE | Breaking Changes |
+
+### Etapa 3: Analisar PRs (se disponível)
+
+```bash
+# Recuperar PRs mergeados
+gh pr list --state merged --base main --json number,title,labels,author
+```
+
+### Etapa 4: Gerar Changelog
+
+Formato Keep a Changelog:
+
+```markdown
+# Changelog
+
+Todas as mudanças notáveis neste projeto serão documentadas neste arquivo.
+
+O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/),
+e este projeto adere ao [Semantic Versioning](https://semver.org/lang/pt-BR/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [{VERSÃO}] - {DATA}
+
+### Breaking Changes
+- **{scope}**: {descrição} ({autor}) - #{PR}
+
+### Added
+- **{scope}**: {descrição} ({autor}) - #{PR}
+- **{scope}**: {descrição} ({autor}) - #{PR}
+
+### Changed
+- **{scope}**: {descrição} ({autor}) - #{PR}
+
+### Deprecated
+- **{scope}**: {descrição} ({autor}) - #{PR}
+
+### Removed
+- **{scope}**: {descrição} ({autor}) - #{PR}
+
+### Fixed
+- **{scope}**: {descrição} ({autor}) - #{PR}
+
+### Security
+- **{scope}**: {descrição} ({autor}) - #{PR}
+
+### Performance
+- **{scope}**: {descrição} ({autor}) - #{PR}
+
+## [{VERSÃO_ANTERIOR}] - {DATA}
+...
+
+[Unreleased]: https://github.com/{owner}/{repo}/compare/v{VERSÃO}...HEAD
+[{VERSÃO}]: https://github.com/{owner}/{repo}/compare/v{VERSÃO_ANTERIOR}...v{VERSÃO}
+```
+
+### Etapa 5: Exemplo de Saída
+
+```markdown
+## [1.2.0] - 2024-01-15
+
+### Breaking Changes
+- **api**: Mudança de autenticação de session para JWT (#123) - @joao
+
+### Added
+- **auth**: Adicionar suporte a login OAuth2 social (#145) - @maria
+- **users**: Adicionar upload de foto de perfil (#142) - @joao
+- **dashboard**: Adicionar notificações em tempo real (#138) - @alice
+
+### Changed
+- **api**: Atualizar API Platform para v3.2 (#150) - @bob
+- **ui**: Migrar para TailwindCSS v3 (#148) - @maria
+
+### Fixed
+- **auth**: Corrigir email de reset de senha não enviando (#141) - @joao
+- **orders**: Corrigir cálculo de total com descontos (#139) - @alice
+- **mobile**: Corrigir crash no iOS 17 (#137) - @bob
+
+### Security
+- **deps**: Atualizar symfony/http-kernel para CVE-2024-1234 (#146) - @security-bot
+
+### Performance
+- **api**: Adicionar cache Redis para sessões de usuário (#144) - @alice
+- **db**: Otimizar consultas N+1 na lista de pedidos (#140) - @bob
+
+---
+
+**Changelog Completo**: https://github.com/org/repo/compare/v1.1.0...v1.2.0
+
+### Contribuidores
+- @joao (4 commits)
+- @maria (3 commits)
+- @alice (3 commits)
+- @bob (3 commits)
+
+### Estatísticas
+- Commits: 13
+- Arquivos alterados: 87
+- Linhas adicionadas: +2,345
+- Linhas removidas: -876
+```
+
+### Etapa 6: Ações Sugeridas
+
+```
+══════════════════════════════════════════════════════════════
+📝 CHANGELOG GERADO
+══════════════════════════════════════════════════════════════
+
+Versão: 1.2.0
+Período: 2024-01-01 → 2024-01-15
+Commits analisados: 13
+
+──────────────────────────────────────────────────────────────
+📊 RESUMO POR CATEGORIA
+──────────────────────────────────────────────────────────────
+
+| Categoria | Contagem |
+|-----------|--------|
+| Added | 3 |
+| Changed | 2 |
+| Fixed | 3 |
+| Security | 1 |
+| Performance | 2 |
+| Breaking | 1 |
+
+──────────────────────────────────────────────────────────────
+⚠️ PONTOS DE ATENÇÃO
+──────────────────────────────────────────────────────────────
+
+1. ⚠️ BREAKING CHANGE detectado - requer versão MAJOR?
+2. 🔒 1 correção de segurança - mencionar nas notas de release
+3. 📝 5 commits sem formato conventional (a melhorar)
+
+──────────────────────────────────────────────────────────────
+🎯 PRÓXIMOS PASSOS
+──────────────────────────────────────────────────────────────
+
+1. Verificar e editar changelog gerado
+2. Criar ou atualizar arquivo CHANGELOG.md
+3. Commit: git commit -am "docs: atualizar changelog para v1.2.0"
+4. Criar tag: git tag -a v1.2.0 -m "Release v1.2.0"
+```
+
+## Comandos Associados
+
+```bash
+# Salvar o changelog
+# O conteúdo será exibido, você pode copiá-lo para CHANGELOG.md
+
+# Ferramentas recomendadas para automação
+# - git-cliff: https://github.com/orhun/git-cliff
+# - conventional-changelog: https://github.com/conventional-changelog/conventional-changelog
+# - release-please: https://github.com/googleapis/release-please
+```
+
+## Lembrete de Conventional Commits
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+
+# Tipos padrão
+feat:     Nova funcionalidade
+fix:      Correção de bug
+docs:     Apenas documentação
+style:    Formatação (sem mudança de código)
+refactor: Refatoração (sem nova feature ou fix)
+perf:     Melhoria de performance
+test:     Adicionar/modificar testes
+chore:    Manutenção (deps, config, etc.)
+build:    Sistema de build, deps externas
+ci:       Configuração CI/CD
+revert:   Reverter commit anterior
+
+# Breaking change
+feat!: descrição
+# ou
+feat: descrição
+
+BREAKING CHANGE: explicação da mudança quebrada
+```

package/Dev/i18n/pt/Common/commands/pre-commit-check.md

@@ -0,0 +1,205 @@
+---
+description: Verificação Pré-Commit
+argument-hint: [arguments]
+---
+
+# Verificação Pré-Commit
+
+Você é um assistente de qualidade de código. Você deve realizar todas as verificações necessárias ANTES de criar um commit, para garantir que o código atenda aos padrões do projeto.
+
+## Argumentos
+$ARGUMENTS
+
+Opções:
+- `--fix`: Corrige automaticamente problemas corrigíveis
+- `--staged`: Verifica apenas arquivos preparados
+
+## MISSÃO
+
+### Etapa 1: Identificar Arquivos Modificados
+
+```bash
+# Arquivos preparados
+git diff --cached --name-only
+
+# Arquivos modificados (não preparados)
+git diff --name-only
+```
+
+### Etapa 2: Detectar Tecnologia por Arquivo
+
+| Extensão | Tecnologia | Ferramentas |
+|-----------|-------------|--------|
+| `.php` | PHP/Symfony | php-cs-fixer, phpstan |
+| `.dart` | Flutter | dart format, dart analyze |
+| `.py` | Python | ruff, mypy |
+| `.ts`, `.tsx` | React/RN | eslint, prettier |
+| `.js`, `.jsx` | React/RN | eslint, prettier |
+
+### Etapa 3: Executar Verificações
+
+#### Para arquivos PHP
+```bash
+# Formatação
+docker compose exec php vendor/bin/php-cs-fixer fix --dry-run --diff [arquivos]
+
+# Análise estática
+docker compose exec php vendor/bin/phpstan analyse [arquivos]
+
+# Sintaxe Twig (se modificado)
+docker compose exec php php bin/console lint:twig templates/
+
+# Container Symfony
+docker compose exec php php bin/console lint:container
+```
+
+#### Para arquivos Dart/Flutter
+```bash
+# Formatação
+docker run --rm -v $(pwd):/app -w /app dart dart format --set-exit-if-changed [arquivos]
+
+# Análise
+docker run --rm -v $(pwd):/app -w /app dart dart analyze [arquivos]
+
+# Testes afetados
+docker run --rm -v $(pwd):/app -w /app dart flutter test --coverage
+```
+
+#### Para arquivos Python
+```bash
+# Linting + formatação
+docker compose exec app ruff check [arquivos]
+docker compose exec app ruff format --check [arquivos]
+
+# Tipos
+docker compose exec app mypy [arquivos]
+```
+
+#### Para arquivos JS/TS
+```bash
+# Linting
+docker compose exec node npx eslint [arquivos]
+
+# Formatação
+docker compose exec node npx prettier --check [arquivos]
+
+# Tipos (se TypeScript)
+docker compose exec node npx tsc --noEmit
+```
+
+### Etapa 4: Verificações Globais
+
+#### Segredos
+```bash
+# Buscar padrões de segredos
+grep -rE "(password|secret|api_key|token)\s*[:=]\s*['\"][^'\"]+['\"]" --include="*.{php,py,ts,js,dart}" .
+grep -rE "sk_live_|pk_live_|ghp_|gho_|AKIA" .
+```
+
+#### Arquivos proibidos
+```bash
+# Verificar ausência de arquivos sensíveis
+git diff --cached --name-only | grep -E "\.(env|pem|key|p12)$"
+```
+
+#### Tamanho de arquivo
+```bash
+# Arquivos > 1MB
+find . -type f -size +1M -name "*.{php,py,ts,js,dart}"
+```
+
+### Etapa 5: Gerar Relatório
+
+```
+══════════════════════════════════════════════════════════════
+🔍 VERIFICAÇÃO PRÉ-COMMIT
+══════════════════════════════════════════════════════════════
+
+📁 Arquivos verificados: X
+📅 Data: YYYY-MM-DD HH:MM
+
+──────────────────────────────────────────────────────────────
+✅ VERIFICAÇÕES BEM-SUCEDIDAS
+──────────────────────────────────────────────────────────────
+
+✅ Formatação PHP (php-cs-fixer)
+✅ Análise estática PHP (phpstan)
+✅ Formatação TypeScript (prettier)
+✅ Linting TypeScript (eslint)
+✅ Nenhum segredo detectado
+
+──────────────────────────────────────────────────────────────
+⚠️ PROBLEMAS DETECTADOS
+──────────────────────────────────────────────────────────────
+
+❌ [PHP] src/Controller/UserController.php:45
+   PHPStan: Parameter $id of method __construct() has no type hint
+
+⚠️ [TS] src/components/Button.tsx:12
+   ESLint: 'unused' is defined but never used (no-unused-vars)
+
+──────────────────────────────────────────────────────────────
+📋 RESUMO
+──────────────────────────────────────────────────────────────
+
+| Categoria | Status |
+|-----------|--------|
+| Formatação | ✅ OK |
+| Linting   | ⚠️ 1 aviso |
+| Tipos     | ❌ 1 erro |
+| Segredos   | ✅ OK |
+
+──────────────────────────────────────────────────────────────
+🎯 AÇÕES NECESSÁRIAS
+──────────────────────────────────────────────────────────────
+
+1. Corrigir erro PHPStan em UserController.php
+2. (Opcional) Corrigir aviso ESLint
+
+Commit autorizado: ❌ NÃO (1 erro bloqueante)
+```
+
+### Opção --fix
+
+Se `--fix` for passado como argumento:
+
+```bash
+# PHP
+docker compose exec php vendor/bin/php-cs-fixer fix [arquivos]
+
+# Dart
+docker run --rm -v $(pwd):/app -w /app dart dart format [arquivos]
+
+# Python
+docker compose exec app ruff check --fix [arquivos]
+docker compose exec app ruff format [arquivos]
+
+# JS/TS
+docker compose exec node npx eslint --fix [arquivos]
+docker compose exec node npx prettier --write [arquivos]
+```
+
+## Regras Bloqueantes
+
+### Bloqueante (commit proibido)
+- ❌ Erros de sintaxe
+- ❌ Erros PHPStan/mypy/tsc
+- ❌ Segredos detectados
+- ❌ Arquivos .env commitados
+- ❌ Chaves privadas/certificados
+
+### Não bloqueante (aviso)
+- ⚠️ Problemas de formatação
+- ⚠️ Avisos ESLint
+- ⚠️ Cobertura de testes diminuída
+- ⚠️ TODO/FIXME adicionados
+
+## Dica
+
+Para automatizar, configure um hook pre-commit:
+
+```bash
+# .git/hooks/pre-commit
+#!/bin/sh
+claude-code "/common:pre-commit-check --staged"
+```

package/Dev/i18n/pt/Common/commands/pre-merge-check.md

@@ -0,0 +1,237 @@
+---
+description: Verificação Pré-Merge
+argument-hint: [arguments]
+---
+
+# Verificação Pré-Merge
+
+Você é um assistente de qualidade de código. Você deve realizar todas as verificações necessárias ANTES de mesclar um branch, para garantir qualidade e evitar regressões.
+
+## Argumentos
+$ARGUMENTS
+
+Argumentos esperados:
+- Branch de origem (padrão: branch atual)
+- Branch de destino (padrão: main ou master)
+
+Exemplo: `/common:pre-merge-check feature/auth main`
+
+## MISSÃO
+
+### Etapa 1: Analisar o Diff
+
+```bash
+# Identificar branches
+SOURCE_BRANCH=$(git branch --show-current)
+TARGET_BRANCH=${2:-main}
+
+# Commits a mesclar
+git log $TARGET_BRANCH..$SOURCE_BRANCH --oneline
+
+# Arquivos modificados
+git diff $TARGET_BRANCH...$SOURCE_BRANCH --stat
+
+# Linhas adicionadas/removidas
+git diff $TARGET_BRANCH...$SOURCE_BRANCH --shortstat
+```
+
+### Etapa 2: Verificações de Qualidade
+
+#### 2.1 Testes Completos
+```bash
+# Executar TODOS os testes
+# Symfony
+docker compose exec php vendor/bin/phpunit --coverage-text
+
+# Flutter
+docker run --rm -v $(pwd):/app -w /app dart flutter test --coverage
+
+# Python
+docker compose exec app pytest --cov --cov-report=term
+
+# React/RN
+docker compose exec node npm run test -- --coverage
+```
+
+#### 2.2 Análise Estática Completa
+```bash
+# PHPStan (nível máximo)
+docker compose exec php vendor/bin/phpstan analyse -l max
+
+# Dart Analyzer
+docker run --rm -v $(pwd):/app -w /app dart dart analyze --fatal-infos
+
+# Mypy (strict)
+docker compose exec app mypy --strict .
+
+# TypeScript
+docker compose exec node npx tsc --noEmit
+```
+
+#### 2.3 Verificação de Dependências
+```bash
+# Auditoria de segurança
+# PHP
+docker compose exec php composer audit
+
+# Python
+docker compose exec app pip-audit
+
+# Node
+docker compose exec node npm audit
+
+# Flutter
+docker run --rm -v $(pwd):/app -w /app dart dart pub outdated
+```
+
+### Etapa 3: Verificações Específicas
+
+#### Migrações de BD (se presentes)
+```bash
+# Verificar migrações Doctrine
+git diff $TARGET_BRANCH...$SOURCE_BRANCH -- migrations/
+
+# Se migrações presentes
+docker compose exec php php bin/console doctrine:migrations:diff --no-interaction
+docker compose exec php php bin/console doctrine:schema:validate
+```
+
+#### Breaking Changes na API
+```bash
+# Comparar especificações OpenAPI
+git diff $TARGET_BRANCH...$SOURCE_BRANCH -- openapi.yaml docs/api/
+```
+
+#### Alterações de Configuração
+```bash
+# Arquivos de configuração modificados
+git diff $TARGET_BRANCH...$SOURCE_BRANCH -- config/ .env.example docker-compose*.yml
+```
+
+### Etapa 4: Análise de Commits
+
+```bash
+# Verificar mensagens de commit
+git log $TARGET_BRANCH..$SOURCE_BRANCH --pretty=format:"%s" | while read msg; do
+    # Padrão convencional: type(scope): description
+    if ! echo "$msg" | grep -qE "^(feat|fix|docs|style|refactor|test|chore)(\(.+\))?: .+"; then
+        echo "⚠️ Mensagem não convencional: $msg"
+    fi
+done
+```
+
+### Etapa 5: Verificação de Cobertura
+
+```bash
+# Comparar cobertura antes/depois
+# A cobertura não deve diminuir
+```
+
+### Etapa 6: Gerar Relatório
+
+```
+══════════════════════════════════════════════════════════════
+🔀 VERIFICAÇÃO PRÉ-MERGE
+══════════════════════════════════════════════════════════════
+
+📌 Origem: feature/user-auth
+📌 Destino: main
+📅 Data: YYYY-MM-DD HH:MM
+
+──────────────────────────────────────────────────────────────
+📊 ESTATÍSTICAS
+──────────────────────────────────────────────────────────────
+
+Commits: 12
+Arquivos modificados: 45
+Linhas adicionadas: +1,234
+Linhas removidas: -567
+
+──────────────────────────────────────────────────────────────
+🧪 TESTES
+──────────────────────────────────────────────────────────────
+
+| Suite | Testes | Passou | Falhou | Ignorado |
+|-------|-------|--------|---------|---------|
+| Unit  | 234   | 234    | 0       | 0       |
+| Integ | 45    | 45     | 0       | 0       |
+| E2E   | 12    | 12     | 0       | 0       |
+
+Cobertura: 85.2% (anterior: 84.8%) ✅ +0.4%
+
+──────────────────────────────────────────────────────────────
+🔍 ANÁLISE ESTÁTICA
+──────────────────────────────────────────────────────────────
+
+| Ferramenta | Erros | Avisos | Status |
+|-------|---------|----------|--------|
+| PHPStan | 0 | 2 | ✅ |
+| ESLint | 0 | 5 | ⚠️ |
+| Mypy | 0 | 0 | ✅ |
+
+──────────────────────────────────────────────────────────────
+🔒 SEGURANÇA
+──────────────────────────────────────────────────────────────
+
+Auditoria de dependências: ✅ Sem vulnerabilidades
+Segredos detectados: ✅ Nenhum
+Arquivos sensíveis: ✅ Nenhum
+
+──────────────────────────────────────────────────────────────
+📦 MIGRAÇÕES
+──────────────────────────────────────────────────────────────
+
+Novas migrações: 2
+  - Version20240115_AddUserRoles.php
+  - Version20240116_CreateAuditLog.php
+
+Validação de esquema: ✅ OK
+Rollback possível: ✅ Sim
+
+──────────────────────────────────────────────────────────────
+⚠️ PONTOS DE ATENÇÃO
+──────────────────────────────────────────────────────────────
+
+1. [MÉDIO] 5 avisos ESLint para corrigir
+2. [BAIXO] 2 TODOs adicionados no código
+3. [INFO] 2 novas migrações - verificar no staging primeiro
+
+──────────────────────────────────────────────────────────────
+📋 CHECKLIST FINAL
+──────────────────────────────────────────────────────────────
+
+- [x] Todos os testes passam
+- [x] Cobertura mantida ou melhorada
+- [x] Sem erros de análise estática
+- [x] Sem vulnerabilidades de segurança
+- [x] Nenhum segredo commitado
+- [ ] Code review aprovado (verificar manualmente)
+- [ ] Testado em staging (verificar manualmente)
+
+──────────────────────────────────────────────────────────────
+🎯 VEREDICTO
+──────────────────────────────────────────────────────────────
+
+Merge autorizado: ✅ SIM
+
+Recomendações antes do merge:
+1. Resolver 5 avisos ESLint
+2. Testar migrações em staging
+3. Obter aprovação do code review
+```
+
+## Regras Bloqueantes
+
+### Bloqueante (merge proibido)
+- ❌ Testes falhando
+- ❌ Queda significativa de cobertura (> 2%)
+- ❌ Erros de análise estática
+- ❌ Vulnerabilidades críticas/altas
+- ❌ Segredos no código
+- ❌ Migrações não reversíveis
+
+### Não bloqueante (aviso)
+- ⚠️ Avisos de análise estática
+- ⚠️ TODO/FIXME adicionados
+- ⚠️ Vulnerabilidades baixas/médias
+- ⚠️ Cobertura ligeiramente diminuída (< 2%)