@the-bearded-bear/claude-craft 8.22.0 → 8.23.0

package/Dev/i18n/pt/Common/rules/11-security.md

@@ -9,7 +9,7 @@ A seguranca e uma **prioridade absoluta**. Este documento apresenta os principio
 **Referencias:**
 - **OWASP Top 10:2025** (publicado novembro 2025)
 - CWE/SANS Top 25
-- SLSA 1.0
+- SLSA 1.2
 
 ---
 
@@ -31,9 +31,11 @@ A seguranca e uma **prioridade absoluta**. Este documento apresenta os principio
 ## OWASP Top 10:2025
 
 > **Fonte:** [OWASP Top 10:2025](https://owasp.org/Top10/2025/) — publicado novembro 2025.
-> Principais mudancas vs 2021: SSRF consolidado em #1, Supply Chain Failures novo em #6, Mishandling Exceptional Conditions novo em #7.
+> Principais mudancas vs 2021: SSRF consolidado em A01, Security Misconfiguration sobe para A02, Software Supply Chain Failures novo em A03 (absorve o antigo "Vulnerable and Outdated Components"), Software or Data Integrity Failures em A08, Mishandling of Exceptional Conditions novo em A10.
 
-### 1. Broken Access Control (inclui SSRF consolidado)
+> **Listas relacionadas:** OWASP Top 10 for Agentic Applications 2026 (publicado em 2025-12-09) e OWASP Top 10 for LLM Applications 2025 ([genai.owasp.org](https://genai.owasp.org/)) para codigo de agentes IA/LLM; OWASP ASVS 5.0.0 para requisitos de verificacao.
+
+### A01. Broken Access Control (inclui SSRF consolidado)
 
 ```
 RISCO
@@ -50,7 +52,41 @@ PROTECAO
 - Sem acesso a rede interna a partir dos inputs do usuario
 ```
 
-### 2. Cryptographic Failures
+### A02. Security Misconfiguration
+
+```
+RISCO
+- Configuracoes padrao nao modificadas
+- Funcionalidades desnecessarias ativadas
+- Mensagens de erro detalhadas
+- Permissoes muito amplas
+
+PROTECAO
+- Hardening das configuracoes
+- Desativar o desnecessario
+- Mensagens de erro genericas em producao
+- Principio do menor privilegio
+```
+
+### A03. Software Supply Chain Failures (novo em 2025)
+
+```
+RISCO
+- Dependencias com vulnerabilidades conhecidas
+- Componentes sem procedencia verificavel
+- CI/CD nao seguro
+- Artefatos nao assinados
+
+PROTECAO
+- SLSA 1.2 niveis 1-3 (fontes verificaveis, builds reproduziveis, procedencia)
+- SBOM automatico (SPDX 3 ou CycloneDX 1.7) em cada build
+- Sigstore keyless signing (cosign) para artefatos e imagens
+- Dependabot / Renovate com scan de CVE (Trivy, Grype)
+- Versoes fixadas em todas as dependencias (sem "latest")
+- Componentes desatualizados ou vulneraveis (antes A06:2021): inventario, atualizacoes regulares, `npm audit --omit=dev --audit-level=moderate`
+```
+
+### A04. Cryptographic Failures
 
 ```
 RISCO
@@ -62,12 +98,12 @@ RISCO
 PROTECAO
 - Criptografar dados sensiveis em repouso
 - Utilizar TLS 1.3 em transito
-- Hash de senhas: Argon2id (128 MiB RAM, t=3-5, p=1) — NUNCA MD5/SHA1/bcrypt
+- Hash de senhas: Argon2id (minimo OWASP 19 MiB RAM, t=2, p=1; recomendacao interna 128 MiB RAM, t≥3, p=1) — NUNCA MD5/SHA1 ; bcrypt apenas como alternativa legacy se Argon2id/scrypt nao estiverem disponiveis (work factor OWASP ≥ 10; ≥ 12 aqui)
 - JWT: EdDSA (Ed25519) preferido > ES256 > RS256
 - Segredos em um vault (nao no codigo)
 ```
 
-### 3. Injection
+### A05. Injection
 
 ```
 RISCO
@@ -82,7 +118,7 @@ PROTECAO
 - Escape das saidas
 ```
 
-### 4. Insecure Design
+### A06. Insecure Design
 
 ```
 RISCO
@@ -97,55 +133,7 @@ PROTECAO
 - Rate limiting
 ```
 
-### 5. Security Misconfiguration
-
-```
-RISCO
-- Configuracoes padrao nao modificadas
-- Funcionalidades desnecessarias ativadas
-- Mensagens de erro detalhadas
-- Permissoes muito amplas
-
-PROTECAO
-- Hardening das configuracoes
-- Desativar o desnecessario
-- Mensagens de erro genericas em producao
-- Principio do menor privilegio
-```
-
-### 6. Software Supply Chain Failures (novo em 2025)
-
-```
-RISCO
-- Dependencias com vulnerabilidades conhecidas
-- Componentes sem procedencia verificavel
-- CI/CD nao seguro
-- Artefatos nao assinados
-
-PROTECAO
-- SLSA 1.0 niveis 1-3 (fontes verificaveis, builds reproduziveis, procedencia)
-- SBOM automatico (SPDX 3 ou CycloneDX) em cada build
-- Sigstore keyless signing (cosign) para artefatos e imagens
-- Dependabot / Renovate com scan de CVE (Trivy, Grype)
-- Versoes fixadas em todas as dependencias (sem "latest")
-```
-
-### 7. Mishandling of Exceptional Conditions (novo em 2025)
-
-```
-RISCO
-- Stack traces expostos em producao
-- Excecoes nao tratadas que vazam dados internos
-- Comportamento indefinido em inputs mal formados
-
-PROTECAO
-- Registrar erros em log, nunca expor stack traces em producao
-- Gestores de excecoes globais (error boundaries)
-- Mensagens de erro genericas no lado do cliente
-- Fail fast com erros de negocio claros
-```
-
-### 8. Authentication Failures
+### A07. Authentication Failures
 
 ```
 RISCO
@@ -162,7 +150,21 @@ PROTECAO
 - Deteccao de brute force
 ```
 
-### 9. Logging & Monitoring Failures
+### A08. Software or Data Integrity Failures
+
+```
+RISCO
+- Dependencias nao verificadas
+- CI/CD nao seguro
+- Atualizacoes nao assinadas
+
+PROTECAO
+- Verificacao de assinaturas
+- CI/CD seguro
+- Verificacoes de integridade (checksums)
+```
+
+### A09. Security Logging and Alerting Failures
 
 ```
 RISCO
@@ -177,18 +179,19 @@ PROTECAO
 - Retencao apropriada
 ```
 
-### 10. Data Integrity Failures
+### A10. Mishandling of Exceptional Conditions (novo em 2025)
 
 ```
 RISCO
-- Dependencias nao verificadas
-- CI/CD nao seguro
-- Atualizacoes nao assinadas
+- Stack traces expostos em producao
+- Excecoes nao tratadas que vazam dados internos
+- Comportamento indefinido em inputs mal formados
 
 PROTECAO
-- Verificacao de assinaturas
-- CI/CD seguro
-- Verificacoes de integridade (checksums)
+- Registrar erros em log, nunca expor stack traces em producao
+- Gestores de excecoes globais (error boundaries)
+- Mensagens de erro genericas no lado do cliente
+- Fail fast com erros de negocio claros
 ```
 
 ---
@@ -251,8 +254,8 @@ Regras OWASP 2026:
 - Minimo 12 caracteres
 - Maiusculas, minusculas, numeros, especiais
 - Nao estar em listas de senhas comprometidas
-- Hash com Argon2id (128 MiB RAM, t=3-5, p=1)
-- NUNCA MD5/SHA1/bcrypt em novo codigo
+- Hash com Argon2id (minimo OWASP 19 MiB RAM, t=2, p=1; recomendacao interna 128 MiB RAM, t≥3, p=1)
+- NUNCA MD5/SHA1 ; bcrypt apenas como alternativa legacy se Argon2id/scrypt nao estiverem disponiveis (work factor OWASP ≥ 10; ≥ 12 aqui)
 - Salt unico por usuario (gerenciado pelo Argon2id)
 
 // BOM
@@ -390,9 +393,9 @@ function getOrder(orderId, currentUser):
 
 ```
 Senhas:
-  -> Hash com Argon2id (128 MiB RAM, t=3-5, p=1)
+  -> Hash com Argon2id (minimo OWASP 19 MiB RAM, t=2, p=1; recomendacao interna 128 MiB RAM, t≥3, p=1)
   -> NUNCA em texto plano
-  -> NUNCA bcrypt/MD5/SHA1 em novo codigo
+  -> NUNCA MD5/SHA1 ; bcrypt apenas como alternativa legacy se Argon2id/scrypt nao estiverem disponiveis (work factor OWASP ≥ 10; ≥ 12 aqui)
 
 Dados pessoais (LGPD):
   -> Criptografia em repouso (AES-256-GCM)
@@ -483,7 +486,7 @@ Content-Security-Policy:
 
 > **Referencia:** [Supply Chain Security 2026](https://kawaldeepsingh.medium.com/practical-software-supply-chain-security-2026-sboms-signing-slsa-reproducible-builds-a-0416cfac32dc)
 
-### SLSA 1.0 (Supply-chain Levels for Software Artifacts)
+### SLSA 1.2 (Supply-chain Levels for Software Artifacts)
 
 | Nivel | Requisitos | Impacto |
 |-------|------------|---------|
@@ -495,7 +498,7 @@ Content-Security-Policy:
 
 ```
 Gerar automaticamente em cada build:
-- Formato SPDX 3 ou CycloneDX
+- Formato SPDX 3 ou CycloneDX 1.7
 - Listar todas as dependencias diretas e transitivas
 - Incluir versoes, licencas, CVEs conhecidos
 - Publicar no registro de artefatos
@@ -517,7 +520,7 @@ cosign sign --identity-token=$(cat $ACTIONS_ID_TOKEN_REQUEST_TOKEN) \
 
 ### Checklist Supply Chain
 
-- [ ] SBOM gerado automaticamente (SPDX 3 ou CycloneDX)
+- [ ] SBOM gerado automaticamente (SPDX 3 ou CycloneDX 1.7)
 - [ ] Artefatos assinados com Sigstore/cosign
 - [ ] Procedencia SLSA 1+ documentada
 - [ ] Dependencias com versoes fixadas (hash ou versao exata)
@@ -653,7 +656,7 @@ Antes de instalar um servidor MCP de terceiros:
 - [ ] Validacao de entradas do lado do servidor
 - [ ] Consultas parametrizadas (sem concatenacao SQL)
 - [ ] Escape das saidas (prevencao XSS)
-- [ ] Senhas com hash usando **Argon2id** (128 MiB, t=3-5, p=1)
+- [ ] Senhas com hash usando **Argon2id** (minimo OWASP 19 MiB, t=2, p=1; recomendacao interna 128 MiB, t≥3, p=1)
 - [ ] Sessoes seguras (httpOnly, secure, sameSite)
 - [ ] Verificacao de permissoes a cada requisicao
 - [ ] Segredos em variaveis de ambiente ou Vault
@@ -672,7 +675,7 @@ Antes de instalar um servidor MCP de terceiros:
 
 ### Supply Chain
 
-- [ ] SBOM gerado (SPDX 3 ou CycloneDX)
+- [ ] SBOM gerado (SPDX 3 ou CycloneDX 1.7)
 - [ ] Artefatos assinados (Sigstore/cosign)
 - [ ] Procedencia SLSA 1+ documentada
 - [ ] Dependencias fixadas na versao exata

package/Dev/i18n/pt/Common/rules/12-context-management.md

@@ -41,15 +41,15 @@ A janela de contexto e **O recurso critico** no Claude Code. Cada token conta. U
 
 ### Limite recomendado
 
-> **CLAUDE.md principal: 150-200 linhas maximo.**
+> **CLAUDE.md principal: menos de 200 linhas (meta da Anthropic).**
 > Cada instrucao adicional dilui a atencao nas instrucoes existentes.
 
 ### Estrategia de modularidade
 
 ```
 .claude/
-  CLAUDE.md              <- Resumo (150-200 linhas max)
-  rules/                 <- Regras detalhadas (carregadas sob demanda)
+  CLAUDE.md              <- Resumo (menos de 200 linhas)
+  rules/                 <- Regras detalhadas (carregadas no arranque; a pedido com frontmatter `paths:`)
     01-workflow-analysis.md
     04-solid-principles.md
     05-kiss-dry-yagni.md
@@ -58,6 +58,8 @@ A janela de contexto e **O recurso critico** no Claude Code. Cada token conta. U
   skills/                <- Competencias sob demanda
 ```
 
+> **Nota:** os arquivos `.claude/rules/*.md` sem frontmatter `paths:` são carregados no arranque com a mesma prioridade que `.claude/CLAUDE.md`. Apenas as regras com globs `paths:` são carregadas a pedido, quando Claude trabalha em arquivos correspondentes.
+
 ### Boas praticas
 
 | Pratica | Descricao |
@@ -352,11 +354,14 @@ Ajustar o nível de esforço do modelo de acordo com a complexidade da tarefa:
 
 | Comando | Modelo | Uso |
 |---------|--------|-----|
-| `/effort low` | Haiku 4.5 | Tarefas simples, lookups, classificação |
-| `/effort medium` | Sonnet 4.6 | Implementação padrão |
-| `/effort high` | Opus 4.8 | Raciocínio complexo, arquitetura |
-| `/effort xhigh` | Opus 4.8 (extended thinking, v2.1.111+) | Decisões críticas, migrações complexas, ADR |
-| `/effort ultracode` | Opus 4.8 (v2.1.154+, Dynamic Workflows) | Modo de máximo débito de código — pipelines automatizados, geração massiva |
+| `/effort low` | Haiku 5.5 | Tarefas simples, lookups, classificação |
+| `/effort medium` | Sonnet 5.5 | Implementação padrão |
+| `/effort high` | Opus 5.5 | Raciocínio complexo, arquitetura |
+| `/effort xhigh` | Opus 5.5 (extended thinking) | Decisões críticas, migrações complexas, ADR |
+| `/effort ultracode` | Opus 5.5 (toggle separado desde v2.1.284, Dynamic Workflows) | Modo de máximo débito de código — pipelines automatizados, geração massiva |
+
+> **Esforço padrão por modelo:** medium no Opus 5.5 e Haiku 5.5; high no Sonnet 5.5, Fable 5.1 e modelos legacy.
+> **Fable 5.1** (`claude-fable-5-1`, $10/$50 por Mtok) é um modelo atual, adequado para agentes criativos/narrativos. **Mythos** tem disponibilidade limitada (apenas Cyber Verification Program).
 
 ### Alerta de inatividade (v2.1.84+)
 
@@ -539,17 +544,17 @@ CLAUDE.local.md
 
 ### Preferir ponteiros sobre copias
 
-Nao copiar codigo no CLAUDE.md — ele se torna obsoleto. Usar a sintaxe `@caminho` para referenciar arquivos:
+Não copiar código no CLAUDE.md — ele se torna obsoleto. Atenção: os imports `@caminho` são carregados no arranque junto com o arquivo que os importa: evitam duplicação mas **não reduzem** o custo de contexto. Para carga a pedido, citar o caminho sem `@`, ou usar uma regra com frontmatter `paths:` / um skill:
 
 ```markdown
 # No CLAUDE.md:
-Ver @.claude/references/symfony/CLAUDE.md para as convencoes Symfony.
-Ver @docs/API.md para a documentacao da API.
+Ver @.claude/references/symfony/CLAUDE.md para as convencoes Symfony.   # sempre necessário: import @
+Documentação da API pontual: docs/API.md                                 # a pedido: caminho simples, sem @
 ```
 
 ### Enfase para regras criticas
 
-Usar `IMPORTANT`, `VOCE DEVE`, `NUNCA` para restricoes nao negociaveis:
+Usar `IMPORTANT`, `VOCE DEVE`, `NUNCA` com moderação, reservados para as poucas restrições realmente não negociáveis — se tudo é enfatizado, nada se destaca (recomendação da Anthropic):
 
 ```markdown
 IMPORTANT: Nunca modificar as migracoes existentes.
@@ -617,10 +622,10 @@ Usar `/model` para trocar de modelo de acordo com a complexidade da tarefa:
 
 | Comando | Modelo | Uso |
 |---------|--------|-----|
-| `/model haiku` | Haiku 4.5 | Tarefas simples, classificação |
-| `/model sonnet` | Sonnet 4.6 | Tarefas padrão, implementação |
-| `/model opus` | Opus 4.8 | Raciocínio complexo, arquitetura |
-| `/model opusplan` | Opus 4.8 (plano) / Sonnet 4.6 (execução) | **Tiering dinâmico**: Opus para o Plan Mode, Sonnet para a execução — otimiza a relação custo/qualidade em tarefas longas |
+| `/model haiku` | Haiku 5.5 | Tarefas simples, classificação |
+| `/model sonnet` | Sonnet 5.5 | Tarefas padrão, implementação |
+| `/model opus` | Opus 5.5 | Raciocínio complexo, arquitetura |
+| `/model opusplan` | Opus 5.5 (plano) / Sonnet 5.5 (execução) | **Tiering dinâmico**: Opus para o Plan Mode, Sonnet para a execução — otimiza a relação custo/qualidade em tarefas longas |
 
 ### Filtragem de saida via hooks PostToolUse
 
@@ -631,12 +636,17 @@ Usar hooks PostToolUse para filtrar saidas verbosas antes que Claude as processe
   "hooks": {
     "PostToolUse": [{
       "matcher": "Bash",
-      "command": "echo '$TOOL_OUTPUT' | grep -A 5 -E '(FAIL|ERROR|WARN)' || echo 'All clear'"
+      "hooks": [{
+        "type": "command",
+        "command": "jq -r '.tool_response.stdout // empty' | grep -A 5 -E '(FAIL|ERROR|WARN)' || echo 'All clear'"
+      }]
     }]
   }
 }
 ```
 
+> O payload do hook chega como JSON via stdin (`$TOOL_OUTPUT` / `$TOOL_INPUT` não são variáveis de ambiente); lê-lo com `jq`.
+
 Reducao potencial: 90%+ para logs verbosos.
 
 ### Plugins Code Intelligence
@@ -737,7 +747,7 @@ Os arquivos sao fundidos em ordem alfabetica, permitindo que as equipes sobrepon
 Configuração de **confiabilidade + custo**: até 3 modelos de fallback tentados em ordem quando o primário está sobrecarregado/indisponível (flag equivalente `--fallback-model`, aplica-se também a sessões interativas).
 
 ```json
-{ "fallbackModel": ["claude-sonnet-4-6", "claude-haiku-4-5"] }
+{ "fallbackModel": ["claude-sonnet-5-5", "claude-haiku-5-5"] }
 ```
 
 Para os 5 agentes `opus` (security-auditor, database-architect, migration-specialist, ralph-conductor, tdd-coach), este fallback `opus → sonnet → haiku` evita interrupções em picos de carga do Opus sem degradar o trabalho atual. Exemplo pronto em `.claude/settings.local.json.example`.
@@ -792,7 +802,7 @@ Além do RTK e dos hooks nativos, o ecossistema do Claude Code oferece ferrament
 
 | Ferramenta | Licença | Ângulo | Rec |
 |------------|---------|--------|-----|
-| **caveman** | MIT | Compressão das respostas (output) ~65 % | ✅ Integrar |
+| **caveman** | Apache-2.0 | Compressão das respostas (output) ~65 % | ✅ Integrar |
 | **code-review-graph** | MIT | Grafo AST, leitura do blast radius (−38× a −528×) | ✅ Integrar |
 | **token-savior** | MIT | Índice simbólico + compactação do Bash (−80 %) | ✅ Integrar |
 | **claude-token-efficient** | MIT | Regras CLAUDE.md anti-verbosidade (~63 % output) | ✅ Integrar |

package/Dev/i18n/pt/Common/templates/settings.json.template

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-settings.json",
 
   "env": {
-    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-4-6",
+    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-5-5",
     "CLAUDE_CODE_FORK_SUBAGENT": "1"
   },
 
@@ -47,7 +47,7 @@
     ]
   },
 
-  "model": "claude-opus-4-8",
+  "model": "claude-opus-5-5",
 
   "plansDirectory": ".claude/plans",
 
@@ -59,7 +59,7 @@
           {
             "type": "command",
             "command": "if [ -f .claude/context-essentials.md ]; then echo 'Context preserved for restoration after compaction'; else echo 'No context-essentials.md found'; fi",
-            "timeout": 5000
+            "timeout": 5
           }
         ]
       }
@@ -102,7 +102,7 @@
           {
             "type": "command",
             "command": "OUTPUT_SIZE=$(jq -r '.tool_response.stdout? // .tool_response? // .tool_result? // empty' | wc -c); if [ \"$OUTPUT_SIZE\" -gt 50000 ]; then echo 'NOTICE: Large output (>50KB). Extract only the relevant information and summarize in under 20 lines.'; elif [ \"$OUTPUT_SIZE\" -gt 10000 ]; then echo 'NOTICE: Moderate output (>10KB). Focus on errors, warnings, and key results.'; fi; exit 0",
-            "timeout": 3000
+            "timeout": 3
           }
         ]
       },
@@ -112,7 +112,7 @@
           {
             "type": "command",
             "command": "OUTPUT_SIZE=$(jq -r '.tool_response.stdout? // .tool_response? // .tool_result? // empty' | wc -c); if [ \"$OUTPUT_SIZE\" -gt 50000 ]; then echo 'NOTICE: Large output (>50KB). Summarize key findings in under 20 lines.'; fi; exit 0",
-            "timeout": 3000
+            "timeout": 3
           }
         ]
       }
@@ -124,7 +124,7 @@
           {
             "type": "command",
             "command": "if [ -f .claude/context-essentials.md ]; then jq -n --rawfile c .claude/context-essentials.md '{\"systemMessage\": (\"CONTEXT RESTORED AFTER COMPACTION:\\n\" + $c)}'; else echo '{}'; fi",
-            "timeout": 5000
+            "timeout": 5
           }
         ]
       }

package/Dev/i18n/pt/Flutter/agents/flutter-reviewer.md

@@ -1,6 +1,6 @@
 ---
 name: flutter-reviewer
-description: Especialista em revisao de codigo Flutter 3.44 / Dart 3.12 — BLoC, Riverpod, otimizacao de widgets, codigo platform-specific
+description: Especialista em revisao de codigo Flutter 3.47 / Dart 3.13 — BLoC, Riverpod, otimizacao de widgets, codigo platform-specific
 model: haiku
 effort: low
 maxTurns: 6
@@ -10,11 +10,11 @@ permissionMode: default
 skills: [solid-principles, testing-flutter, security-flutter]
 ---
 
-# Agente Auditor Flutter 3.44 / Dart 3.12
+# Agente Auditor Flutter 3.47 / Dart 3.13
 
 ## Identidade
 
-Sou um especialista em revisao de codigo Flutter 3.44 e Dart 3.12. Minha abordagem foca nos problemas especificos do desenvolvimento mobile multiplataforma: a qualidade da gestao de estado (BLoC/Riverpod), a otimizacao do widget tree, o codigo platform-specific, e a performance de renderizacao. Nao faco uma auditoria generica -- eu detecto o que provoca janks, memory leaks, rebuilds desnecessarios ou crashes platform-specific em producao.
+Sou um especialista em revisao de codigo Flutter 3.47 e Dart 3.13. Minha abordagem foca nos problemas especificos do desenvolvimento mobile multiplataforma: a qualidade da gestao de estado (BLoC/Riverpod), a otimizacao do widget tree, o codigo platform-specific, e a performance de renderizacao. Nao faco uma auditoria generica -- eu detecto o que provoca janks, memory leaks, rebuilds desnecessarios ou crashes platform-specific em producao.
 
 ## Sistema de pontuacao (100 pontos)
 
@@ -554,7 +554,7 @@ context.pushRoute(UserRoute(id: user.id)); // auto_route
 ## Formato do relatorio de auditoria
 
 ```markdown
-# Relatorio de auditoria Flutter 3.44 / Dart 3.12
+# Relatorio de auditoria Flutter 3.47 / Dart 3.13
 
 ## Projeto: [Nome do projeto]
 **Data:** [Data]

package/Dev/i18n/pt/Flutter/rules/06-tooling.md

@@ -82,8 +82,6 @@ CMD ["flutter", "test"]
 ### docker-compose.yml
 
 ```yaml
-version: '3.8'
-
 services:
   flutter:
     build:
@@ -539,11 +537,11 @@ make build-apk
 
 ---
 
-## Pontos de atenção Flutter 3.44 (2026)
+## Pontos de atenção Flutter 3.47 (2026)
 
 ### SwiftPM padrão no iOS
 
-Flutter 3.44+ usa **Swift Package Manager (SwiftPM)** como gerenciador de plugins iOS padrão, substituindo o CocoaPods (ainda suportado, mas deprecado para novos projetos).
+Flutter 3.47+ usa **Swift Package Manager (SwiftPM)** como gerenciador de plugins iOS padrão, substituindo o CocoaPods (ainda suportado, mas deprecado para novos projetos).
 
 ```bash
 # Verificar migração SwiftPM
@@ -566,7 +564,7 @@ flutter:
 
 ### Android Gradle Plugin (AGP) 9
 
-Flutter 3.44 requer **AGP 9.0+**. Atualizar `android/build.gradle`:
+Flutter 3.47 requer **AGP 9.0+**. Atualizar `android/build.gradle`:
 
 ```groovy
 // android/build.gradle
@@ -584,7 +582,7 @@ distributionUrl=https\://services.gradle.org/distributions/gradle-9.0-bin.zip
 
 **Breaking AGP 9:** `android.enableR8.fullMode=true` por padrão (proguard mais agressivo); verificar regras de keep para reflexão.
 
-### Deprecações Material / Cupertino (Flutter 3.44)
+### Deprecações Material / Cupertino (Flutter 3.47)
 
 Vários componentes legacy estão deprecados:
 
@@ -608,6 +606,14 @@ MaterialButton(onPressed: () {}, child: Text('OK'));
 
 Executar `dart fix --apply` para migrar automaticamente as deprecações detectáveis.
 
+### Breaking changes do Flutter 3.44 e 3.47
+
+- **3.44**: ordem de fechamento do `RawMenuAnchor` alterada; `onReorder` obsoleto; `TextInputConnection.setStyle` obsoleto; `cacheExtent` / `cacheExtentStyle` obsoletos; `IconData` passa a ser `final`; o Android 17 ignora restrições de orientação e redimensionamento em telas grandes; `ListTile` relata um erro em debug quando envolvido por um widget colorido; projetos Android migram para Kotlin integrado; reorganização dos page transition builders.
+- **3.47**: o conteúdo OpenGL ES render-to-texture é armazenado de cima para baixo; comportamento de `Semantics` header / `headingLevel` atualizado no iOS e no Android; `describeEnum` removido (usar `Enum.name`).
+- **Anunciado, ainda não em stable**: migração para os pacotes independentes `material_ui` / `cupertino_ui`.
+
+**Fonte:** https://docs.flutter.dev/release/breaking-changes
+
 ---
 
 *Essas ferramentas e configurações otimizam o fluxo de trabalho de desenvolvimento Flutter.*

package/Dev/i18n/pt/Flutter/rules/08-quality-tools.md

@@ -139,7 +139,7 @@ include: package:very_good_analysis/analysis_options.yaml
 
 ```yaml
 dev_dependencies:
-  flutter_lints: ^5.0.0  # Flutter 3.44 / Dart 3.12+ (v3.x não cobre sealed classes e dot shorthands)
+  flutter_lints: ^5.0.0  # Flutter 3.47 / Dart 3.13+ (v3.x não cobre sealed classes e dot shorthands)
 ```
 
 ---

package/Dev/i18n/pt/PHP/agents/php-reviewer.md

@@ -1,6 +1,6 @@
 ---
 name: php-reviewer
-description: Especialista em revisao de codigo PHP 8.5 e Clean Architecture — DDD, hexagonal, PSR-12, PHPStan, analise de seguranca
+description: Especialista em revisao de codigo PHP 8.5 e Clean Architecture — DDD, hexagonal, PER-CS 3.0, PHPStan, analise de seguranca
 model: haiku
 effort: low
 maxTurns: 6
@@ -21,7 +21,7 @@ Sou um especialista em revisao de codigo PHP 8.5 e Clean Architecture. Minha abo
 | Categoria | Pontos | Foco |
 |-----------|--------|------|
 | Arquitetura e Clean Code | 30 | Clean Architecture, hexagonal, DDD, CQRS |
-| PHP 8.5 e Qualidade | 20 | PSR-12, PHPStan level 10, strict_types, funcionalidades modernas |
+| PHP 8.5 e Qualidade | 20 | PER-CS 3.0, PHPStan level 10, strict_types, funcionalidades modernas |
 | Testes | 25 | Pest PHP, PHPUnit, mutation testing, cobertura |
 | Seguranca e Performance | 25 | OWASP, SQL injection, N+1, cache |
 
@@ -211,7 +211,7 @@ $first = array_first($items);
 $last = array_last($items);
 ```
 
-### Convencoes PSR-12
+### Convencoes PER-CS 3.0
 
 | Criterio | Esperado |
 |----------|----------|
@@ -229,7 +229,7 @@ $last = array_last($items);
 |----------|--------|
 | strict_types=1 em todo lugar, PHPStan level 10 sem erros | 6 |
 | Zero `mixed` injustificado, tipagem completa (params + retornos) | 5 |
-| PSR-12 respeitado, nomenclatura explicita, readonly utilizado | 5 |
+| PER-CS 3.0 respeitado, nomenclatura explicita, readonly utilizado | 5 |
 | Funcionalidades PHP 8.5: enums, pipe operator, clone with | 4 |
 
 ---
@@ -414,7 +414,7 @@ $orders = $repository->findAllWithItems(); // JOIN ou batch loading
 
 1. Verificar strict_types=1 em cada arquivo
 2. Executar PHPStan level 10 mentalmente (tipos, mixed, any)
-3. Verificar a conformidade PSR-12
+3. Verificar a conformidade PER-CS 3.0
 4. Examinar o uso das funcionalidades PHP 8.5
 5. Verificar enums, readonly, match expressions
 
@@ -531,7 +531,7 @@ $orders = $repository->findAllWithItems(); // JOIN ou batch loading
 | Ferramenta | Uso |
 |------------|-----|
 | **PHPStan** (level 10) | Analise estatica, type safety |
-| **PHP-CS-Fixer** | Conformidade PSR-12 |
+| **PHP-CS-Fixer** | Conformidade PER-CS 3.0 |
 | **Pest PHP** | Testes modernos e expressivos |
 | **Infection** | Mutation testing (MSI >= 80%) |
 | **Deptrac** | Verificacao das dependencias entre camadas |

package/Dev/i18n/pt/PHP/commands/check-compliance.md

@@ -9,7 +9,7 @@ Verify that the PHP project follows established coding standards and best practi
 ## What This Command Does
 
 1. **Standards Verification**
-   - Check PSR-1/PSR-12 compliance
+   - Check PSR-1/PER-CS 3.0 compliance
    - Verify naming conventions
    - Validate file organization
    - Check import order
@@ -440,7 +440,7 @@ parameters:
 <?php
 return (new PhpCsFixer\Config())
     ->setRules([
-        '@PSR12' => true,
+        '@PER-CS3x0' => true,
         '@PHP85Migration' => true,
         'declare_strict_types' => true,
         'final_class' => true,
@@ -450,7 +450,7 @@ return (new PhpCsFixer\Config())
 ## Compliance Checklist
 
 - [ ] `declare(strict_types=1)` in all files
-- [ ] PSR-12 formatting applied
+- [ ] PER-CS 3.0 formatting applied
 - [ ] PSR-4 autoloading configured
 - [ ] Naming conventions followed
 - [ ] Files properly organized (Clean Architecture)

package/Dev/i18n/pt/PHP/rules/03-coding-standards.md

@@ -29,7 +29,9 @@ class UserAccount
 }
 ```
 
-### PSR-12: Extended Coding Style
+### PER-CS 3.0: Extended Coding Style
+
+> PER Coding Style 3.0 estende, amplia e substitui o PSR-12 (PSR-1 continua obrigatório). Ruleset do PHP-CS-Fixer: `@PER-CS3x0` (`@PER-CS3.0` está obsoleto).
 
 ```php
 <?php
@@ -629,7 +631,7 @@ interface UserRepositoryInterface
 ## Coding Standards Checklist
 
 - [ ] `declare(strict_types=1)` at top of every file
-- [ ] PSR-12 formatting applied
+- [ ] PER-CS 3.0 formatting applied
 - [ ] PSR-4 autoloading configured
 - [ ] All methods have return type declarations
 - [ ] All parameters have type declarations