@the-bearded-bear/claude-craft 8.26.0 → 8.27.0

package/Dev/i18n/pt/Symfony/commands/check-security.md

@@ -55,7 +55,7 @@ docker run --rm -v $(pwd):/app php:8.5-cli cat /app/config/packages/security.yam
 
 ### Step 3 : OWASP Top 10 - Injection
 
-#### A03:2021 – Injection (SQL, NoSQL, OS, LDAP) (3 points)
+#### A05:2025 – Injection (SQL, NoSQL, OS, LDAP) (3 points)
 
 ```bash
 # Vérifier l'utilisation de requêtes préparées
@@ -79,9 +79,9 @@ docker run --rm -v $(pwd):/app php:8.5-cli grep -rE "\"SELECT.*\\..*\$" /app/src
 
 **Points obtained** : ___/3
 
-### Step 4 : OWASP Top 10 - Broken Authentication
+### Step 4 : OWASP Top 10 - Authentication Failures
 
-#### A07:2021 – Identification and Authentication Failures (3 points)
+#### A07:2025 – Authentication Failures (3 points)
 
 ```bash
 # Vérifier la configuration des mots de passe
@@ -104,9 +104,9 @@ docker run --rm -v $(pwd):/app php:8.5-cli grep -r "RateLimiter" /app/config --i
 
 **Points obtained** : ___/3
 
-### Step 5 : OWASP Top 10 - Sensitive Data Exposure
+### Step 5 : OWASP Top 10 - Cryptographic Failures
 
-#### A02:2021 – Cryptographic Failures (3 points)
+#### A04:2025 – Cryptographic Failures (3 points)
 
 ```bash
 # Vérifier les secrets dans le code
@@ -131,7 +131,7 @@ docker run --rm -v $(pwd):/app php:8.5-cli grep -r "SECURE_SCHEME" /app/.env.exa
 
 ### Step 6 : OWASP Top 10 - Broken Access Control
 
-#### A01:2021 – Broken Access Control (3 points)
+#### A01:2025 – Broken Access Control (3 points)
 
 ```bash
 # Vérifier les Voters
@@ -156,7 +156,7 @@ docker run --rm -v $(pwd):/app php:8.5-cli grep -r "@IsGranted" /app/src --inclu
 
 ### Step 7 : OWASP Top 10 - XSS et CSRF
 
-#### A03:2021 – XSS (Cross-Site Scripting) (2 points)
+#### A05:2025 – Injection : XSS (Cross-Site Scripting) (2 points)
 
 ```bash
 # Vérifier l'auto-échappement Twig
@@ -179,7 +179,7 @@ docker run --rm -v $(pwd):/app php:8.5-cli grep -r "|raw" /app/templates --inclu
 
 **Points obtained** : ___/2
 
-#### A08:2021 – CSRF (Cross-Site Request Forgery) (2 points)
+#### A01:2025 – Broken Access Control : CSRF (Cross-Site Request Forgery) (2 points)
 
 ```bash
 # Vérifier CSRF protection
@@ -201,7 +201,7 @@ docker run --rm -v $(pwd):/app php:8.5-cli grep -r "csrf_protection" /app/config
 
 ### Step 8 : OWASP Top 10 - Autres Vulnérabilités
 
-#### A05:2021 – Security Misconfiguration (2 points)
+#### A02:2025 – Security Misconfiguration (2 points)
 
 ```bash
 # Vérifier le mode debug
@@ -224,7 +224,7 @@ docker run --rm -v $(pwd):/app php:8.5-cli composer audit
 
 **Points obtained** : ___/2
 
-#### A06:2021 – Vulnerable and Outdated Components (1 point)
+#### A03:2025 – Software Supply Chain Failures (1 point)
 
 ```bash
 # Audit de sécurité Composer
@@ -398,16 +398,16 @@ Fixed in: 5.4.25
    OWASP TOP 10 - RÉSUMÉ
 =================================================
 
-A01:2021 - Broken Access Control          : [✅|⚠️|❌]
-A02:2021 - Cryptographic Failures         : [✅|⚠️|❌]
-A03:2021 - Injection                      : [✅|⚠️|❌]
-A04:2021 - Insecure Design                : [✅|⚠️|❌]
-A05:2021 - Security Misconfiguration      : [✅|⚠️|❌]
-A06:2021 - Vulnerable Components          : [✅|⚠️|❌]
-A07:2021 - Authentication Failures        : [✅|⚠️|❌]
-A08:2021 - Software and Data Integrity    : [✅|⚠️|❌]
-A09:2021 - Security Logging Failures      : [✅|⚠️|❌]
-A10:2021 - Server-Side Request Forgery    : [✅|⚠️|❌]
+A01:2025 - Broken Access Control                 : [✅|⚠️|❌]
+A02:2025 - Security Misconfiguration             : [✅|⚠️|❌]
+A03:2025 - Software Supply Chain Failures        : [✅|⚠️|❌]
+A04:2025 - Cryptographic Failures                : [✅|⚠️|❌]
+A05:2025 - Injection                             : [✅|⚠️|❌]
+A06:2025 - Insecure Design                       : [✅|⚠️|❌]
+A07:2025 - Authentication Failures               : [✅|⚠️|❌]
+A08:2025 - Software or Data Integrity Failures   : [✅|⚠️|❌]
+A09:2025 - Logging & Alerting Failures           : [✅|⚠️|❌]
+A10:2025 - Mishandling of Exceptional Conditions : [✅|⚠️|❌]
 
 =================================================
    CONFORMITÉ RGPD

package/Dev/i18n/pt/Symfony/skills/aggregates/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: aggregates
-description: Règle 05 : Aggregates et Aggregate Roots. Use when implementing DDD patterns.
+description: "Règle 05 : Aggregates et Aggregate Roots. Use when implementing DDD patterns."
 ---
 
 # Règle 05 : Aggregates et Aggregate Roots

package/Dev/i18n/pt/Symfony/skills/async/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: async
-description: Règle 10 : Async-First avec Symfony Messenger. Use when working with async.
+description: "Règle 10 : Async-First avec Symfony Messenger. Use when working with async."
 ---
 
 # Règle 10 : Async-First avec Symfony Messenger

package/Dev/i18n/pt/Symfony/skills/cqrs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cqrs
-description: Règle 07 : CQRS - Command Query Responsibility Segregation. Use when implementing DDD patterns.
+description: "Règle 07 : CQRS - Command Query Responsibility Segregation. Use when implementing DDD patterns."
 ---
 
 # Règle 07 : CQRS - Command Query Responsibility Segregation

package/Dev/i18n/pt/Symfony/skills/domain-events/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: domain-events
-description: Règle 06 : Domain Events. Use when implementing DDD patterns.
+description: "Règle 06 : Domain Events. Use when implementing DDD patterns."
 ---
 
 # Règle 06 : Domain Events

package/Dev/i18n/pt/Symfony/skills/i18n/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: i18n
-description: Règle 09 : Internationalisation (i18n). Use when implementing internationalization.
+description: "Règle 09 : Internationalisation (i18n). Use when implementing internationalization."
 ---
 
 # Règle 09 : Internationalisation (i18n)

package/Dev/i18n/pt/Symfony/skills/multitenant/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: multitenant
-description: Règle 08 : Multitenant - Isolation et Sécurité. Use when working with multitenant.
+description: "Règle 08 : Multitenant - Isolation et Sécurité. Use when working with multitenant."
 ---
 
 # Règle 08 : Multitenant - Isolation et Sécurité

package/Dev/i18n/pt/Symfony/skills/value-objects/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: value-objects
-description: Règle 04 : Value Objects. Use when implementing DDD patterns.
+description: "Règle 04 : Value Objects. Use when implementing DDD patterns."
 ---
 
 # Règle 04 : Value Objects

package/Dev/i18n/pt/Team/commands/audit.md

@@ -1,6 +1,6 @@
 ---
-description: "Equipe de Auditoria Completa - Auditoria multi-tecnologia paralela usando Agent Teams"
-argument-hint: "[--techs=auto|tech1,tech2] [--max-workers=4]"
+description: "Equipe de Auditoria Completa - Auditoria multi-tecnologia paralela com subagentes (Agent Teams opcional)"
+argument-hint: "[--techs=auto|tech1,tech2] [--max-workers=4] [--engine=subagents|teams]"
 ---
 
 # Equipe de Auditoria Completa - Auditoria Multi-Tecnologia Paralela
@@ -13,6 +13,7 @@ $ARGUMENTS
 
 - `--techs=auto`: Auto-detectar tecnologias (padrao). Ou especificar separado por virgula: `--techs=symfony,react`
 - `--max-workers=4`: Maximo de workers auditores paralelos (padrao: 4, max: 4)
+- `--engine=subagents`: Motor de execução (padrão: `subagents`). Opções: `subagents` (delegação a subagentes pela ferramenta `Agent`, sem pré-requisito), `teams` (Agent Teams experimental). Ver "Motor de execução"
 - `--output-dir=<path>`: Diretorio de saida personalizado para resultados da auditoria
 - `--max-cost=<dollars>`: Orcamento maximo em dolares. Se o custo paralelo estimado ultrapassar este limiar, a execucao e bloqueada com uma mensagem OVER BUDGET
 - `--dry-run`: Mostrar composicao da equipe e custo estimado sem executar
@@ -23,10 +24,34 @@ $ARGUMENTS
 
 > O modo plano é ativado automaticamente quando o escopo abrange vários módulos ou requer investigação transversal.
 
+## Motor de execução (`--engine`)
+
+O motor padrão não depende de nenhuma funcionalidade experimental: o comando funciona mesmo que `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` não esteja definida.
+
+| Motor | Ativação | Pré-requisitos | Comportamento |
+|-------|----------|----------------|---------------|
+| `subagents` (padrão) | sem flag ou `--engine=subagents` | Nenhum (ferramenta `Agent` nativa) | A sessão atual assume o papel de líder e delega cada tarefa de worker a um subagente pela ferramenta `Agent` (modelo do worker passado pelo parâmetro `model`). Os subagentes independentes são lançados numa mesma mensagem para executar em paralelo; cada um escreve seu resultado no seu diretório isolado e devolve apenas um resumo curto. Os workers não se comunicam entre si: o líder faz a ponte. Funciona em modo interativo, com `claude -p` e em CI. |
+| `teams` | `--engine=teams` | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`, Claude Code v2.1.32+ | Equipe Agent Teams: workers persistentes coordenados por `TaskCreate` / `TaskList` / `SendMessage`, mensagens diretas entre colegas, hooks `TeammateIdle` / `TaskCompleted`. |
+
+**Fallback**: se `--engine=teams` for pedido sem que `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` esteja definida, não falhar — exibir `ℹ️ Agent Teams indisponível: fallback para --engine=subagents` e continuar com o motor `subagents`.
+
+**Limites do motor `teams`**: sem modo não interativo (`claude -p`) nem execução em CI; uma única equipe por sessão (encerrar a equipe atual antes de lançar outra); API em research preview, sujeita a mudanças.
+
+O processo abaixo é descrito com as primitivas do Agent Teams. Com `--engine=subagents`, aplicar esta correspondência:
+
+| Agent Teams (`teams`) | Subagentes (`subagents`) |
+|------------------------|---------------------------|
+| `TaskCreate` + lançamento de um worker | Uma chamada à ferramenta `Agent` cujo prompt retoma a descrição da tarefa |
+| Polling de `TaskList` / barreira de sincronização | Aguardar o retorno de todas as chamadas `Agent` do lote |
+| `SendMessage` para um worker | Retomar o subagente (`SendMessage` para seu ID) ou nova chamada `Agent` com o contexto necessário |
+| `shutdown_request` | Desnecessário: um subagente termina ao devolver seu resultado |
+
+**Específico da auditoria**: um subagente por stack, com o prompt do template de lançamento da etapa 4. `--sequential` continua disponível para processar tudo na sessão atual, sem delegação.
+
 ## Pre-requisitos
 
-- Claude Code v2.1.32+ com suporte a Agent Teams
-- Variavel de ambiente `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` definida
+- Claude Code v2.1.32+ com suporte a Agent Teams — apenas com `--engine=teams`
+- Variavel de ambiente `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` definida — apenas com `--engine=teams`
 - Projeto com 2+ stacks tecnologicos detectados (projetos de stack unico devem usar o flag `--sequential`)
 - `Tools/AgentTeams/lib/compatibility-check.sh` disponivel
 - `Tools/AgentTeams/lib/result-aggregator.sh` disponivel

package/Dev/i18n/pt/Team/commands/delivery.md

@@ -1,6 +1,6 @@
 ---
-description: Equipe de Entrega - Ciclo de vida completo do sprint (redacao + implementacao) usando Agent Teams
-argument-hint: <sprint-name|prd-path> [--phase=all|writing|implementation] [--max-workers=3]
+description: Equipe de Entrega - Ciclo de vida completo do sprint (redacao + implementacao) com subagentes (Agent Teams opcional)
+argument-hint: <sprint-name|prd-path> [--phase=all|writing|implementation] [--max-workers=3] [--engine=subagents|teams]
 ---
 
 # Equipe de Entrega - Ciclo de Vida Completo do Sprint (Redacao + Implementacao)
@@ -14,6 +14,7 @@ $ARGUMENTS
 - `<sprint-name|prd-path>`: Nome/ID do sprint ou caminho para o documento PRD
 - `--phase=all`: Fase a executar (padrao: `all`). Opcoes: `all`, `writing`, `implementation`
 - `--max-workers=3`: Maximo de workers paralelos por fase (padrao: 3, max: 3)
+- `--engine=subagents`: Motor de execução (padrão: `subagents`). Opções: `subagents` (delegação a subagentes pela ferramenta `Agent`, sem pré-requisito), `teams` (Agent Teams experimental). Ver "Motor de execução"
 - `--overnight`: Executar em modo noturno (limitado, para as 6h)
 - `--supervised`: Pausar antes de cada story para confirmacao humana
 - `--max-stories=10`: Maximo de stories a processar (padrao: 10)
@@ -27,10 +28,34 @@ $ARGUMENTS
 
 > O modo plano é ativado automaticamente quando o escopo abrange vários módulos ou requer investigação transversal.
 
+## Motor de execução (`--engine`)
+
+O motor padrão não depende de nenhuma funcionalidade experimental: o comando funciona mesmo que `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` não esteja definida.
+
+| Motor | Ativação | Pré-requisitos | Comportamento |
+|-------|----------|----------------|---------------|
+| `subagents` (padrão) | sem flag ou `--engine=subagents` | Nenhum (ferramenta `Agent` nativa) | A sessão atual assume o papel de líder e delega cada tarefa de worker a um subagente pela ferramenta `Agent` (modelo do worker passado pelo parâmetro `model`). Os subagentes independentes são lançados numa mesma mensagem para executar em paralelo; cada um escreve seu resultado no seu diretório isolado e devolve apenas um resumo curto. Os workers não se comunicam entre si: o líder faz a ponte. Funciona em modo interativo, com `claude -p` e em CI. |
+| `teams` | `--engine=teams` | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`, Claude Code v2.1.32+ | Equipe Agent Teams: workers persistentes coordenados por `TaskCreate` / `TaskList` / `SendMessage`, mensagens diretas entre colegas, hooks `TeammateIdle` / `TaskCompleted`. |
+
+**Fallback**: se `--engine=teams` for pedido sem que `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` esteja definida, não falhar — exibir `ℹ️ Agent Teams indisponível: fallback para --engine=subagents` e continuar com o motor `subagents`.
+
+**Limites do motor `teams`**: sem modo não interativo (`claude -p`) nem execução em CI; uma única equipe por sessão (encerrar a equipe atual antes de lançar outra); API em research preview, sujeita a mudanças.
+
+O processo abaixo é descrito com as primitivas do Agent Teams. Com `--engine=subagents`, aplicar esta correspondência:
+
+| Agent Teams (`teams`) | Subagentes (`subagents`) |
+|------------------------|---------------------------|
+| `TaskCreate` + lançamento de um worker | Uma chamada à ferramenta `Agent` cujo prompt retoma a descrição da tarefa |
+| Polling de `TaskList` / barreira de sincronização | Aguardar o retorno de todas as chamadas `Agent` do lote |
+| `SendMessage` para um worker | Retomar o subagente (`SendMessage` para seu ID) ou nova chamada `Agent` com o contexto necessário |
+| `shutdown_request` | Desnecessário: um subagente termina ao devolver seu resultado |
+
+**Específico da entrega**: na Fase 1, a revisão cruzada passa pelo líder, que entrega o artefato redigido a um subagente revisor e devolve os comentários ao redator. Na Fase 2, lançar cada worker desenvolvedor com `isolation: "worktree"`.
+
 ## Pre-requisitos
 
-- Claude Code v2.1.32+ com suporte a Agent Teams
-- Variavel de ambiente `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` definida
+- Claude Code v2.1.32+ com suporte a Agent Teams — apenas com `--engine=teams`
+- Variavel de ambiente `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` definida — apenas com `--engine=teams`
 - PRD ou tech spec disponivel (para Fase 1) ou backlog de sprint BMAD com stories `ready-for-dev` (somente Fase 2)
 - Metadados do sprint em `.bmad/sprint-status.yaml`
 - `Tools/AgentTeams/lib/compatibility-check.sh` disponivel

package/Dev/i18n/pt/Team/commands/security.md

@@ -1,6 +1,6 @@
 ---
-description: "Equipe de Revisao de Seguranca - Auditoria de seguranca multi-dimensao paralela usando Agent Teams"
-argument-hint: "[--scope=full|code|deps|infra] [--max-workers=3]"
+description: "Equipe de Revisao de Seguranca - Auditoria de seguranca multi-dimensao paralela com subagentes (Agent Teams opcional)"
+argument-hint: "[--scope=full|code|deps|infra] [--max-workers=3] [--engine=subagents|teams]"
 ---
 
 # Equipe de Revisao de Seguranca - Auditoria de Seguranca Multi-Dimensao Paralela
@@ -13,6 +13,7 @@ $ARGUMENTS
 
 - `--scope=full`: Escopo da auditoria (padrao: `full`). Opcoes: `full`, `code`, `deps`, `infra`
 - `--max-workers=3`: Maximo de revisores paralelos (padrao: 3, max: 3)
+- `--engine=subagents`: Motor de execução (padrão: `subagents`). Opções: `subagents` (delegação a subagentes pela ferramenta `Agent`, sem pré-requisito), `teams` (Agent Teams experimental). Ver "Motor de execução"
 - `--severity=medium`: Severidade minima a reportar: `low`, `medium`, `high`, `critical`
 - `--output-dir=<path>`: Diretorio de saida personalizado para resultados de seguranca
 - `--dry-run`: Mostrar composicao da equipe e plano de scan sem executar
@@ -23,10 +24,36 @@ $ARGUMENTS
 
 > O modo plano é ativado automaticamente quando o escopo abrange vários módulos ou requer investigação transversal.
 
+## Motor de execução (`--engine`)
+
+O motor padrão não depende de nenhuma funcionalidade experimental: o comando funciona mesmo que `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` não esteja definida.
+
+| Motor | Ativação | Pré-requisitos | Comportamento |
+|-------|----------|----------------|---------------|
+| `subagents` (padrão) | sem flag ou `--engine=subagents` | Nenhum (ferramenta `Agent` nativa) | A sessão atual assume o papel de líder e delega cada tarefa de worker a um subagente pela ferramenta `Agent` (modelo do worker passado pelo parâmetro `model`). Os subagentes independentes são lançados numa mesma mensagem para executar em paralelo; cada um escreve seu resultado no seu diretório isolado e devolve apenas um resumo curto. Os workers não se comunicam entre si: o líder faz a ponte. Funciona em modo interativo, com `claude -p` e em CI. |
+| `teams` | `--engine=teams` | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`, Claude Code v2.1.32+ | Equipe Agent Teams: workers persistentes coordenados por `TaskCreate` / `TaskList` / `SendMessage`, mensagens diretas entre colegas, hooks `TeammateIdle` / `TaskCompleted`. |
+
+**Fallback**: se `--engine=teams` for pedido sem que `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` esteja definida, não falhar — exibir `ℹ️ Agent Teams indisponível: fallback para --engine=subagents` e continuar com o motor `subagents`.
+
+**Limites do motor `teams`**: sem modo não interativo (`claude -p`) nem execução em CI; uma única equipe por sessão (encerrar a equipe atual antes de lançar outra); API em research preview, sujeita a mudanças.
+
+O processo abaixo é descrito com as primitivas do Agent Teams. Com `--engine=subagents`, aplicar esta correspondência:
+
+| Agent Teams (`teams`) | Subagentes (`subagents`) |
+|------------------------|---------------------------|
+| `TaskCreate` + lançamento de um worker | Uma chamada à ferramenta `Agent` cujo prompt retoma a descrição da tarefa |
+| Polling de `TaskList` / barreira de sincronização | Aguardar o retorno de todas as chamadas `Agent` do lote |
+| `SendMessage` para um worker | Retomar o subagente (`SendMessage` para seu ID) ou nova chamada `Agent` com o contexto necessário |
+| `shutdown_request` | Desnecessário: um subagente termina ao devolver seu resultado |
+
+**Escopo**: `--scope=full|code|deps|infra` se aplica aos dois motores (`full` = 3 reviewers em paralelo, um escopo único = um único reviewer).
+
+**Diferença com o `/security-review` nativo**: o comando integrado `/security-review` do Claude Code analisa apenas o diff (alterações pendentes da branch atual). `/team:security` audita todo o repositório conforme o escopo escolhido (código, dependências, infraestrutura). Usar `/security-review` antes de um commit ou PR, `/team:security` para uma auditoria completa.
+
 ## Pre-requisitos
 
-- Claude Code v2.1.32+ com suporte a Agent Teams
-- Variavel de ambiente `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` definida
+- Claude Code v2.1.32+ com suporte a Agent Teams — apenas com `--engine=teams`
+- Variavel de ambiente `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` definida — apenas com `--engine=teams`
 - Docker disponivel para executar scanners de seguranca
 - `Tools/AgentTeams/lib/compatibility-check.sh` disponivel
 - `Tools/AgentTeams/lib/result-aggregator.sh` disponivel

package/Dev/i18n/pt/Team/commands/sprint.md

@@ -1,6 +1,6 @@
 ---
-description: Equipe de Desenvolvimento de Sprint - Implementacao paralela de stories usando Agent Teams
-argument-hint: <sprint-name> [--max-workers=3] [--overnight]
+description: Equipe de Desenvolvimento de Sprint - Implementacao paralela de stories com subagentes (Agent Teams opcional)
+argument-hint: <sprint-name> [--max-workers=3] [--overnight] [--engine=subagents|teams]
 ---
 
 # Equipe de Desenvolvimento de Sprint - Implementacao Paralela de Stories
@@ -13,22 +13,47 @@ $ARGUMENTS
 
 - `<sprint-name>`: Nome ou ID do sprint a processar
 - `--max-workers=3`: Maximo de dev workers paralelos (padrao: 2, max: 3)
+- `--engine=subagents`: Motor de execução (padrão: `subagents`). Opções: `subagents` (delegação a subagentes pela ferramenta `Agent`, sem pré-requisito), `teams` (Agent Teams experimental). Ver "Motor de execução"
 - `--overnight`: Executar em modo noturno (limitado, para as 6h)
 - `--supervised`: Pausar antes de cada story para confirmacao humana
 - `--max-stories=10`: Maximo de stories a processar (padrao: 10)
 - `--timeout=12`: Tempo maximo de execucao em horas (padrao: 12)
 - `--dry-run`: Mostrar composicao da equipe e atribuicoes de stories sem executar
 - `--max-cost=<dollars>`: Orcamento maximo em dolares. Se o custo paralelo estimado ultrapassar este limiar, a execucao e bloqueada com uma mensagem OVER BUDGET
-- `--ralph-mode`: Ativar motor de recuperacao Ralph (classificacao de erros, auto-retry, servico de escalacao) junto com paralelismo Agent Teams.
+- `--ralph-mode`: Ativar motor de recuperacao Ralph (classificacao de erros, auto-retry, servico de escalacao) junto com paralelismo Agent Teams. Requer `--engine=teams`: o adaptador Ralph Teams se apoia em `TaskCreate` / `SendMessage`.
 
 ## Modo Plano
 
 > O modo plano é ativado automaticamente quando o escopo abrange vários módulos ou requer investigação transversal.
 
+## Motor de execução (`--engine`)
+
+O motor padrão não depende de nenhuma funcionalidade experimental: o comando funciona mesmo que `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` não esteja definida.
+
+| Motor | Ativação | Pré-requisitos | Comportamento |
+|-------|----------|----------------|---------------|
+| `subagents` (padrão) | sem flag ou `--engine=subagents` | Nenhum (ferramenta `Agent` nativa) | A sessão atual assume o papel de líder e delega cada tarefa de worker a um subagente pela ferramenta `Agent` (modelo do worker passado pelo parâmetro `model`). Os subagentes independentes são lançados numa mesma mensagem para executar em paralelo; cada um escreve seu resultado no seu diretório isolado e devolve apenas um resumo curto. Os workers não se comunicam entre si: o líder faz a ponte. Funciona em modo interativo, com `claude -p` e em CI. |
+| `teams` | `--engine=teams` | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`, Claude Code v2.1.32+ | Equipe Agent Teams: workers persistentes coordenados por `TaskCreate` / `TaskList` / `SendMessage`, mensagens diretas entre colegas, hooks `TeammateIdle` / `TaskCompleted`. |
+
+**Fallback**: se `--engine=teams` for pedido sem que `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` esteja definida, não falhar — exibir `ℹ️ Agent Teams indisponível: fallback para --engine=subagents` e continuar com o motor `subagents`.
+
+**Limites do motor `teams`**: sem modo não interativo (`claude -p`) nem execução em CI; uma única equipe por sessão (encerrar a equipe atual antes de lançar outra); API em research preview, sujeita a mudanças.
+
+O processo abaixo é descrito com as primitivas do Agent Teams. Com `--engine=subagents`, aplicar esta correspondência:
+
+| Agent Teams (`teams`) | Subagentes (`subagents`) |
+|------------------------|---------------------------|
+| `TaskCreate` + lançamento de um worker | Uma chamada à ferramenta `Agent` cujo prompt retoma a descrição da tarefa |
+| Polling de `TaskList` / barreira de sincronização | Aguardar o retorno de todas as chamadas `Agent` do lote |
+| `SendMessage` para um worker | Retomar o subagente (`SendMessage` para seu ID) ou nova chamada `Agent` com o contexto necessário |
+| `shutdown_request` | Desnecessário: um subagente termina ao devolver seu resultado |
+
+**Específico do sprint**: com `subagents`, lançar cada worker desenvolvedor com `isolation: "worktree"` para que as stories paralelas não alterem a mesma árvore de trabalho.
+
 ## Pre-requisitos
 
-- Claude Code v2.1.32+ com suporte a Agent Teams
-- Variavel de ambiente `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` definida
+- Claude Code v2.1.32+ com suporte a Agent Teams — apenas com `--engine=teams`
+- Variavel de ambiente `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` definida — apenas com `--engine=teams`
 - Backlog de sprint BMAD com stories em status `ready-for-dev`
 - Metadados do sprint em `.bmad/sprint-status.yaml`
 - Ao menos 2 stories independentes (sprints de story unica usam Ralph sequencial)

package/Dev/i18n/pt/UIUX/commands/audit.md

@@ -24,36 +24,7 @@ Exemplo: `/uiux:audit src/pages/Dashboard.tsx AAA`
 
 ### Etapa 1: Auditoria de Acessibilidade (Especialista A11y)
 
-#### 1.1 Auditoria automatizada
-```bash
-# Executar se disponível
-npx axe-cli {URL}
-npx pa11y {URL}
-# Ou verificar Lighthouse
-```
-
-#### 1.2 Verificação manual WCAG 2.2 AAA
-
-**Perceptível**
-- [ ] Imagens com texto alt
-- [ ] Estrutura semântica (h1-h6, landmarks)
-- [ ] Contraste ≥ 7:1 (AAA)
-- [ ] Reflow em 320px
-
-**Operável**
-- [ ] Navegação completa por teclado
-- [ ] Sem armadilha de teclado
-- [ ] Foco visível (≥ 2px)
-- [ ] Alvos de toque ≥ 44px
-
-**Compreensível**
-- [ ] lang no html
-- [ ] Labels nos inputs
-- [ ] Mensagens de erro claras
-
-**Robusto**
-- [ ] ARIA correto
-- [ ] aria-live para dinâmico
+Executar `/uiux:a11y-audit {URL ou caminho} {nível}` e levar o seu relatório (pontuação, critérios WCAG não conformes, correções) para a síntese. Não repetir aqui a auditoria automatizada nem a checklist WCAG: `/uiux:a11y-audit` é a fonte única.
 
 ### Etapa 2: Auditoria UX/Ergonomia (Especialista UX)
 

package/Dev/i18n/pt/UIUX/commands/component-spec.md

@@ -41,11 +41,7 @@ Definir o visual:
 
 ### Etapa 3: Especificação A11y (Especialista A11y)
 
-Definir acessibilidade:
-- Semântica HTML
-- Atributos ARIA
-- Navegação por teclado
-- Anúncios de leitor de tela
+Executar `/uiux:a11y-component {NOME}` e levar a sua especificação (semântica HTML, atributos ARIA, navegação por teclado, foco, contraste, anúncios do leitor de ecrã) para a secção ♿ da síntese. Não a redefinir aqui.
 
 ### Etapa 4: Síntese
 

package/Dev/i18n/pt/UIUX/commands/orchestrator.md

@@ -1,102 +1,9 @@
 ---
-description: Orquestrador UI/UX
-argument-hint: [arguments]
+description: "Obsoleto (removido na 9.0): use o agente @uiux-orchestrator"
+deprecated: true
+replaced-by: "@uiux-orchestrator"
 ---
 
-# Orquestrador UI/UX
+> ⚠️ `/uiux:orchestrator` está obsoleto e será removido na 9.0. Use o agente `@uiux-orchestrator`.
 
-Você é o Orquestrador UI/UX. Você deve coordenar os 3 especialistas para entregar interfaces excepcionais.
-
-## Argumentos
-$ARGUMENTS
-
-Argumentos:
-- Tipo de solicitação: componente, auditoria, fluxo, tokens
-- Objetivo ou descrição
-
-Exemplo: `/uiux:orchestrator componente "Seletor de data"` ou `/uiux:orchestrator auditoria "Página de checkout"`
-
-## Modo Plano
-
-> O modo plano é ativado automaticamente quando o escopo abrange vários módulos ou requer investigação transversal.
-
-## MISSÃO
-
-### Etapa 1: Analisar a solicitação
-
-Identificar:
-- Tipo de entregável esperado
-- Especialista(s) a envolver
-- Ordem de intervenção
-
-### Etapa 2: Delegar aos especialistas
-
-| Tipo | Especialistas | Ordem |
-|------|---------------|-------|
-| Novo componente | UI → UX → A11y | Sequencial |
-| Auditoria | A11y → UX → UI | Sequencial |
-| Fluxo de usuário | UX → UI → A11y | Sequencial |
-| Design tokens | Apenas UI | Direto |
-
-### Etapa 3: Consolidar e arbitrar
-
-Em caso de conflito, aplicar regras de prioridade:
-1. Acessibilidade AAA (não negociável)
-2. Lighthouse 100/100
-3. UX > Estética
-4. Mobile-first
-5. Coerência design system
-
-### Etapa 4: Entregar síntese
-
-```
-══════════════════════════════════════════════════════════════
-📋 SÍNTESE UI/UX: {TEMA}
-══════════════════════════════════════════════════════════════
-
-Tipo: {Componente | Auditoria | Fluxo | Tokens}
-Data: {data}
-
-──────────────────────────────────────────────────────────────
-🧠 UX
-──────────────────────────────────────────────────────────────
-
-{Resumo contribuições UX}
-
-──────────────────────────────────────────────────────────────
-🎨 UI
-──────────────────────────────────────────────────────────────
-
-{Resumo contribuições UI}
-
-──────────────────────────────────────────────────────────────
-♿ ACESSIBILIDADE
-──────────────────────────────────────────────────────────────
-
-{Resumo contribuições A11y}
-
-──────────────────────────────────────────────────────────────
-⚖️ ARBITRAGENS
-──────────────────────────────────────────────────────────────
-
-| Conflito | Decisão | Justificativa |
-|----------|---------|---------------|
-| {conflito} | {decisão} | {regra aplicada} |
-
-──────────────────────────────────────────────────────────────
-✅ CHECKLIST DE VALIDAÇÃO
-──────────────────────────────────────────────────────────────
-
-- [ ] WCAG 2.2 AAA conforme
-- [ ] Lighthouse 100/100 preservado
-- [ ] Mobile-first respeitado
-- [ ] Apenas tokens (sem hardcode)
-- [ ] Os 3 especialistas consultados
-
-──────────────────────────────────────────────────────────────
-🎯 PRÓXIMOS PASSOS
-──────────────────────────────────────────────────────────────
-
-1. {ação prioritária}
-2. {próxima ação}
-```
+Delegue "$ARGUMENTS" ao agente `uiux-orchestrator` (ferramenta Agent) e devolva a resposta.

package/Dev/i18n/pt/Workflow/commands/auto-sprint.md

@@ -1,6 +1,6 @@
 ---
 description: Orquestrador de sprint completo de ponta a ponta (início -> decomposição -> validação -> implementação -> PR -> CI -> revisão -> retro -> merge)
-argument-hint: "<N> [--from-prd] [--auto-merge] [--max-fix-attempts=2] [--max-workers=3] [--base=main] [--dry-run] [--overnight]"
+argument-hint: "<N> [--from-prd] [--auto-merge] [--max-fix-attempts=2] [--max-workers=3] [--base=main] [--dry-run] [--overnight] [--engine=subagents|teams]"
 ---
 
 # Auto Sprint — Orquestrador de Sprint de Ponta a Ponta
@@ -31,14 +31,15 @@ $ARGUMENTS
   regra 09, e o princípio Karpathy "sem auto-merge sem revisão humana").
 - `--max-fix-attempts=2` : Máximo de tentativas de correção automática por gate com falha antes de abortar (padrão: 2).
 - `--max-workers=3` : Máximo de workers de desenvolvimento em paralelo na fase de implementação (padrão: 2, máximo: 3).
+- `--engine=subagents`: Motor da fase de implementação (padrão: `subagents`, delegação pela ferramenta `Agent`). `teams`: Agent Teams experimental, com fallback para `subagents` se indisponível. Ver `/team:sprint`, seção "Motor de execução"
 - `--base=main` : Branch base para o PR (padrão: `main`).
 - `--dry-run` : Exibe as 9 fases planejadas e o contexto do sprint resolvido, depois para. **Nenhuma escrita.**
 - `--overnight` : Repassado para a fase de implementação (limitado, para às 6h).
 
 ## Pré-requisitos
 
-- Claude Code v2.1.32+ com suporte a Agent Teams
-- `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` definido
+- Claude Code v2.1.32+ com suporte a Agent Teams — apenas com `--engine=teams`
+- `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` definido — apenas com `--engine=teams`
 - CLI `gh` autenticado (criação de PR / verificações / merge)
 - Docker disponível (todos os testes são executados via Docker — veja o CLAUDE.md do projeto)
 - Projeto BMAD v6: `.bmad/sprint-status.yaml` é criado por `/workflow:start` (fase 1) se não existir
@@ -106,6 +107,8 @@ Inicie um sub-agente isolado:
 
 Assuma diretamente o **papel de maestro de `/team:sprint`** (**não** inicie um Agent Team aninhado):
 
+**Motor**: com `--engine=subagents` (padrão), na etapa 4 lançar um subagente por story pela ferramenta `Agent` (`isolation: "worktree"`, todos numa mesma mensagem) em vez de `TaskCreate`, e na etapa 5 aguardar seu retorno em vez de consultar `TaskList` (correspondência completa em `/team:sprint`, seção "Motor de execução"). Com `--engine=teams`, seguir as etapas como estão escritas.
+
 1. Leia `.bmad/sprint-status.yaml`; filtre histórias em `ready-for-dev`.
 2. Analise a independência por domínio de arquivo (sinalize sobreposições de `**/Shared/**`, `**/Common/**`, `**/Utils/**`,
    `**/Helpers/**` → sequencie no mesmo worker).
@@ -195,7 +198,7 @@ Fase             | Status | Notas
 | Falha no DoD da história após tentativas | Marcar como `blocked`, continuar, reportar ao final |
 | CI vermelha após tentativas | Abortar com relatório de verificações com falha |
 | Merge bloqueado (proteção / escopo) | Expor o erro + flag sugerida, não forçar |
-| Agent Teams indisponível | Abortar Fase 4 com dica de configuração (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`) |
+| Agent Teams indisponível com `--engine=teams` | Fallback para `--engine=subagents` (sem abortar); definir `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` para usar `--engine=teams` |
 
 ## Notas
 

package/Dev/i18n/pt/Workflow/commands/plan.md

@@ -69,7 +69,7 @@ Antigo `/workflow:plan --research`. Pesquisa, exploração e restrições antes
 | Mercado | Soluções existentes? Concorrentes? Boas práticas do setor? Tendências emergentes? |
 | Técnica | Tecnologias candidatas? Integrações? Escalabilidade? Segurança / conformidade? |
 
-Se o MCP Context7 estiver configurado, usá-lo para documentação técnica atualizada (`/common:research-context7` para pesquisa aprofundada).
+Se o MCP Context7 estiver configurado, usá-lo para documentação técnica atualizada (`/deep-research` para pesquisa web aprofundada; fora do claude.ai, o agente `@research-assistant`).
 
 **Restrições**: documentar as restrições técnicas (backend existente, banco de dados), de negócio (orçamento, prazos, retrocompatibilidade), regulatórias (LGPD/GDPR, PCI DSS) e de recursos (tamanho da equipe, sem DevOps).
 
@@ -213,4 +213,3 @@ Em caso de interrupção, `/workflow:plan --continue` detecta o que existe (PRD
 - `/workflow:status` - Verificar o progresso
 - `/project:backlog` - Adicionar, listar, editar e mover stories depois
 - `/gate:check` - Validar o backlog
-- `/common:research-context7` - Pesquisa aprofundada com Context7 MCP

package/Dev/scripts/install-common-rules.sh

@@ -465,6 +465,14 @@ install_commands() {
     done
     IFS="$OLD_IFS"
 
+    # The deprecated common:pre-commit-check|pre-merge-check|release-checklist
+    # stubs redirect to /gate:check, which otherwise ships only with the Project
+    # package: install it here too so a Dev-only install keeps them working.
+    local gate_check="$SCRIPT_DIR/../../Project/i18n/$lang/Gate/commands/check.md"
+    if [[ -f "$gate_check" ]]; then
+        copy_file "$gate_check" "$target_dir/.claude/commands/gate/check.md"
+    fi
+
     # Delete commands retired from the distribution (config/removed-commands.yaml)
     $dry_run || bash "$SCRIPT_DIR/prune-removed-commands.sh" "$target_dir"