@luanpdd/kit-mcp 1.21.0 → 1.22.0

package/kit/commands/perfil-usuario.md

@@ -1,46 +1,46 @@
----
-name: perfil-usuario
-description: Gera perfil comportamental do desenvolvedor e cria artefatos descobríveis pelo Claude
-argument-hint: "[--questionnaire] [--refresh]"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - Glob
-  - Grep
-  - AskUserQuestion
-  - Task
----
-
-<objective>
-Gerar um perfil comportamental do desenvolvedor a partir de análise de sessão (ou questionário) e produzir artefatos (USER-PROFILE.md, /preferencias-dev, seção CLAUDE.md) que personalizam as respostas do Claude.
-
-Encaminha para o workflow profile-user que orquestra o fluxo completo: gate de consentimento, análise de sessão ou fallback de questionário, geração de perfil, exibição de resultados e seleção de artefatos.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/profile-user.md
-@./.claude/framework/references/ui-brand.md
-</execution_context>
-
-<context>
-Flags de $ARGUMENTS:
-- `--questionnaire` -- Pular análise de sessão completamente, usar apenas questionário
-- `--refresh` -- Reconstruir perfil mesmo quando existe, fazer backup do perfil antigo, mostrar diff de dimensão
-</context>
-
-<process>
-Execute o workflow profile-user do início ao fim.
-
-O workflow cuida de toda a lógica, incluindo:
-1. Inicialização e detecção de perfil existente
-2. Gate de consentimento antes da análise de sessão
-3. Escaneamento de sessão e verificações de suficiência de dados
-4. Análise de sessão (agente profiler) ou fallback de questionário
-5. Resolução de divisão entre projetos
-6. Escrita do perfil em USER-PROFILE.md
-7. Exibição de resultado com card de relatório e destaques
-8. Seleção de artefato (preferencias-dev, seções CLAUDE.md)
-9. Geração sequencial de artefatos
-10. Resumo com diff de atualização (se aplicável)
+---
+name: perfil-usuario
+description: Gera perfil comportamental do desenvolvedor e cria artefatos descobríveis pelo Claude
+argument-hint: "[--questionnaire] [--refresh]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+  - Task
+---
+
+<objective>
+Gerar um perfil comportamental do desenvolvedor a partir de análise de sessão (ou questionário) e produzir artefatos (USER-PROFILE.md, /preferencias-dev, seção CLAUDE.md) que personalizam as respostas do Claude.
+
+Encaminha para o workflow profile-user que orquestra o fluxo completo: gate de consentimento, análise de sessão ou fallback de questionário, geração de perfil, exibição de resultados e seleção de artefatos.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/profile-user.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<context>
+Flags de $ARGUMENTS:
+- `--questionnaire` -- Pular análise de sessão completamente, usar apenas questionário
+- `--refresh` -- Reconstruir perfil mesmo quando existe, fazer backup do perfil antigo, mostrar diff de dimensão
+</context>
+
+<process>
+Execute o workflow profile-user do início ao fim.
+
+O workflow cuida de toda a lógica, incluindo:
+1. Inicialização e detecção de perfil existente
+2. Gate de consentimento antes da análise de sessão
+3. Escaneamento de sessão e verificações de suficiência de dados
+4. Análise de sessão (agente profiler) ou fallback de questionário
+5. Resolução de divisão entre projetos
+6. Escrita do perfil em USER-PROFILE.md
+7. Exibição de resultado com card de relatório e destaques
+8. Seleção de artefato (preferencias-dev, seções CLAUDE.md)
+9. Geração sequencial de artefatos
+10. Resumo com diff de atualização (se aplicável)
 </process>

package/kit/commands/pesquisar-fase.md

@@ -1,195 +1,195 @@
----
-name: pesquisar-fase
-description: Pesquisa como implementar uma fase (standalone — geralmente use /planejar-fase)
-argument-hint: "[fase]"
-allowed-tools:
-  - Read
-  - Bash
-  - Task
----
-
-<objective>
-Pesquisa como implementar uma fase. Invoca o agente phase-researcher com o contexto da fase.
-
-**Nota:** Este é um comando de pesquisa standalone. Para a maioria dos fluxos, use `/planejar-fase` que integra a pesquisa automaticamente.
-
-**Use este comando quando:**
-- Você quer pesquisar sem planejar ainda
-- Você quer re-pesquisar após o planejamento estar completo
-- Você precisa investigar antes de decidir se uma fase é viável
-
-**Papel do orquestrador:** Analisar fase, validar contra o roadmap, verificar pesquisa existente, reunir contexto, invocar agente pesquisador, apresentar resultados.
-
-**Por que subagente:** Pesquisa consome contexto rapidamente (WebSearch, consultas Context7, verificação de fontes). Contexto fresco de 200k para investigação. Contexto principal fica enxuto para interação com o usuário.
-</objective>
-
-<available_agent_types>
-Tipos de subagentes framework válidos (use nomes exatos — não use 'general-purpose' como fallback):
-- phase-researcher — Pesquisa abordagens técnicas para uma fase
-</available_agent_types>
-
-<context>
-Número da fase: $ARGUMENTS (obrigatório)
-
-Normalizar entrada da fase no passo 1 antes de qualquer busca de diretório.
-</context>
-
-<process>
-
-## 0. Inicializar Contexto
-
-```bash
-INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "$ARGUMENTS")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
-
-Extrair do JSON de init: `phase_dir`, `phase_number`, `phase_name`, `phase_found`, `commit_docs`, `has_research`, `state_path`, `requirements_path`, `context_path`, `research_path`.
-
-Resolver modelo do pesquisador:
-```bash
-RESEARCHER_MODEL=$(node "./.claude/framework/bin/tools.cjs" resolve-model phase-researcher --raw)
-```
-
-## 1. Validar Fase
-
-```bash
-PHASE_INFO=$(node "./.claude/framework/bin/tools.cjs" roadmap get-phase "${phase_number}")
-```
-
-**Se `found` for false:** Erro e sair. **Se `found` for true:** Extrair `phase_number`, `phase_name`, `goal` do JSON.
-
-## 2. Verificar Pesquisa Existente
-
-```bash
-ls .planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null
-```
-
-**Se existir:** Oferecer: 1) Atualizar pesquisa, 2) Ver existente, 3) Pular. Aguardar resposta.
-
-**Se não existir:** Continuar.
-
-## 3. Reunir Contexto da Fase
-
-Usar caminhos do INIT (não colocar conteúdo de arquivos inline no contexto do orquestrador):
-- `requirements_path`
-- `context_path`
-- `state_path`
-
-Apresentar resumo com descrição da fase e quais arquivos o pesquisador vai carregar.
-
-## 4. Invocar Agente phase-researcher
-
-Modos de pesquisa: ecosystem (padrão), feasibility, implementation, comparison.
-
-```markdown
-<research_type>
-Pesquisa de Fase — investigando COMO implementar uma fase específica bem.
-</research_type>
-
-<key_insight>
-A questão NÃO é "qual biblioteca devo usar?"
-
-A questão é: "O que eu não sei que não sei?"
-
-Para esta fase, descobrir:
-- Qual é o padrão de arquitetura estabelecido?
-- Quais bibliotecas formam o stack padrão?
-- Quais problemas as pessoas comumente encontram?
-- Qual é o SOTA vs o que o treinamento do Claude acha que é SOTA?
-- O que NÃO deve ser feito manualmente?
-</key_insight>
-
-<objective>
-Pesquisar abordagem de implementação para Fase {phase_number}: {phase_name}
-Modo: ecosystem
-</objective>
-
-<files_to_read>
-- {requirements_path} (Requisitos)
-- {context_path} (Contexto da fase do discutir-fase, se existir)
-- {state_path} (Decisões e bloqueadores anteriores do projeto)
-</files_to_read>
-
-<additional_context>
-**Descrição da fase:** {phase_description}
-</additional_context>
-
-<downstream_consumer>
-Seu RESEARCH.md será carregado pelo `/planejar-fase` que usa seções específicas:
-- `## Standard Stack` → Planos usam essas bibliotecas
-- `## Architecture Patterns` → Estrutura de tarefas segue esses padrões
-- `## Don't Hand-Roll` → Tarefas NUNCA constroem soluções customizadas para problemas listados
-- `## Common Pitfalls` → Etapas de verificação checam por esses problemas
-- `## Code Examples` → Ações de tarefas referenciam esses padrões
-
-Seja prescritivo, não exploratório. "Use X" não "Considere X ou Y."
-</downstream_consumer>
-
-<quality_gate>
-Antes de declarar completo, verificar:
-- [ ] Todos os domínios investigados (não apenas alguns)
-- [ ] Afirmações negativas verificadas com documentação oficial
-- [ ] Múltiplas fontes para afirmações críticas
-- [ ] Níveis de confiança atribuídos honestamente
-- [ ] Nomes de seções correspondem ao que o planejar-fase espera
-</quality_gate>
-
-<output>
-Escrever em: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
-</output>
-```
-
-```
-Task(
-  prompt=filled_prompt,
-  subagent_type="phase-researcher",
-  model="{researcher_model}",
-  description="Pesquisar Fase {phase}"
-)
-```
-
-## 5. Tratar Retorno do Agente
-
-**`## RESEARCH COMPLETE`:** Exibir resumo, oferecer: Planejar fase, Aprofundar, Revisar completo, Concluído.
-
-**`## CHECKPOINT REACHED`:** Apresentar ao usuário, obter resposta, invocar continuação.
-
-**`## RESEARCH INCONCLUSIVE`:** Mostrar o que foi tentado, oferecer: Adicionar contexto, Tentar modo diferente, Manual.
-
-## 6. Invocar Agente de Continuação
-
-```markdown
-<objective>
-Continuar pesquisa para Fase {phase_number}: {phase_name}
-</objective>
-
-<prior_state>
-<files_to_read>
-- .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md (Pesquisa existente)
-</files_to_read>
-</prior_state>
-
-<checkpoint_response>
-**Tipo:** {checkpoint_type}
-**Resposta:** {user_response}
-</checkpoint_response>
-```
-
-```
-Task(
-  prompt=continuation_prompt,
-  subagent_type="phase-researcher",
-  model="{researcher_model}",
-  description="Continuar pesquisa Fase {phase}"
-)
-```
-
-</process>
-
-<success_criteria>
-- [ ] Fase validada contra o roadmap
-- [ ] Pesquisa existente verificada
-- [ ] phase-researcher invocado com contexto
-- [ ] Checkpoints tratados corretamente
-- [ ] Usuário sabe os próximos passos
-</success_criteria>
+---
+name: pesquisar-fase
+description: Pesquisa como implementar uma fase (standalone — geralmente use /planejar-fase)
+argument-hint: "[fase]"
+allowed-tools:
+  - Read
+  - Bash
+  - Task
+---
+
+<objective>
+Pesquisa como implementar uma fase. Invoca o agente phase-researcher com o contexto da fase.
+
+**Nota:** Este é um comando de pesquisa standalone. Para a maioria dos fluxos, use `/planejar-fase` que integra a pesquisa automaticamente.
+
+**Use este comando quando:**
+- Você quer pesquisar sem planejar ainda
+- Você quer re-pesquisar após o planejamento estar completo
+- Você precisa investigar antes de decidir se uma fase é viável
+
+**Papel do orquestrador:** Analisar fase, validar contra o roadmap, verificar pesquisa existente, reunir contexto, invocar agente pesquisador, apresentar resultados.
+
+**Por que subagente:** Pesquisa consome contexto rapidamente (WebSearch, consultas Context7, verificação de fontes). Contexto fresco de 200k para investigação. Contexto principal fica enxuto para interação com o usuário.
+</objective>
+
+<available_agent_types>
+Tipos de subagentes framework válidos (use nomes exatos — não use 'general-purpose' como fallback):
+- phase-researcher — Pesquisa abordagens técnicas para uma fase
+</available_agent_types>
+
+<context>
+Número da fase: $ARGUMENTS (obrigatório)
+
+Normalizar entrada da fase no passo 1 antes de qualquer busca de diretório.
+</context>
+
+<process>
+
+## 0. Inicializar Contexto
+
+```bash
+INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "$ARGUMENTS")
+if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
+```
+
+Extrair do JSON de init: `phase_dir`, `phase_number`, `phase_name`, `phase_found`, `commit_docs`, `has_research`, `state_path`, `requirements_path`, `context_path`, `research_path`.
+
+Resolver modelo do pesquisador:
+```bash
+RESEARCHER_MODEL=$(node "./.claude/framework/bin/tools.cjs" resolve-model phase-researcher --raw)
+```
+
+## 1. Validar Fase
+
+```bash
+PHASE_INFO=$(node "./.claude/framework/bin/tools.cjs" roadmap get-phase "${phase_number}")
+```
+
+**Se `found` for false:** Erro e sair. **Se `found` for true:** Extrair `phase_number`, `phase_name`, `goal` do JSON.
+
+## 2. Verificar Pesquisa Existente
+
+```bash
+ls .planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null
+```
+
+**Se existir:** Oferecer: 1) Atualizar pesquisa, 2) Ver existente, 3) Pular. Aguardar resposta.
+
+**Se não existir:** Continuar.
+
+## 3. Reunir Contexto da Fase
+
+Usar caminhos do INIT (não colocar conteúdo de arquivos inline no contexto do orquestrador):
+- `requirements_path`
+- `context_path`
+- `state_path`
+
+Apresentar resumo com descrição da fase e quais arquivos o pesquisador vai carregar.
+
+## 4. Invocar Agente phase-researcher
+
+Modos de pesquisa: ecosystem (padrão), feasibility, implementation, comparison.
+
+```markdown
+<research_type>
+Pesquisa de Fase — investigando COMO implementar uma fase específica bem.
+</research_type>
+
+<key_insight>
+A questão NÃO é "qual biblioteca devo usar?"
+
+A questão é: "O que eu não sei que não sei?"
+
+Para esta fase, descobrir:
+- Qual é o padrão de arquitetura estabelecido?
+- Quais bibliotecas formam o stack padrão?
+- Quais problemas as pessoas comumente encontram?
+- Qual é o SOTA vs o que o treinamento do Claude acha que é SOTA?
+- O que NÃO deve ser feito manualmente?
+</key_insight>
+
+<objective>
+Pesquisar abordagem de implementação para Fase {phase_number}: {phase_name}
+Modo: ecosystem
+</objective>
+
+<files_to_read>
+- {requirements_path} (Requisitos)
+- {context_path} (Contexto da fase do discutir-fase, se existir)
+- {state_path} (Decisões e bloqueadores anteriores do projeto)
+</files_to_read>
+
+<additional_context>
+**Descrição da fase:** {phase_description}
+</additional_context>
+
+<downstream_consumer>
+Seu RESEARCH.md será carregado pelo `/planejar-fase` que usa seções específicas:
+- `## Standard Stack` → Planos usam essas bibliotecas
+- `## Architecture Patterns` → Estrutura de tarefas segue esses padrões
+- `## Don't Hand-Roll` → Tarefas NUNCA constroem soluções customizadas para problemas listados
+- `## Common Pitfalls` → Etapas de verificação checam por esses problemas
+- `## Code Examples` → Ações de tarefas referenciam esses padrões
+
+Seja prescritivo, não exploratório. "Use X" não "Considere X ou Y."
+</downstream_consumer>
+
+<quality_gate>
+Antes de declarar completo, verificar:
+- [ ] Todos os domínios investigados (não apenas alguns)
+- [ ] Afirmações negativas verificadas com documentação oficial
+- [ ] Múltiplas fontes para afirmações críticas
+- [ ] Níveis de confiança atribuídos honestamente
+- [ ] Nomes de seções correspondem ao que o planejar-fase espera
+</quality_gate>
+
+<output>
+Escrever em: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
+</output>
+```
+
+```
+Task(
+  prompt=filled_prompt,
+  subagent_type="phase-researcher",
+  model="{researcher_model}",
+  description="Pesquisar Fase {phase}"
+)
+```
+
+## 5. Tratar Retorno do Agente
+
+**`## RESEARCH COMPLETE`:** Exibir resumo, oferecer: Planejar fase, Aprofundar, Revisar completo, Concluído.
+
+**`## CHECKPOINT REACHED`:** Apresentar ao usuário, obter resposta, invocar continuação.
+
+**`## RESEARCH INCONCLUSIVE`:** Mostrar o que foi tentado, oferecer: Adicionar contexto, Tentar modo diferente, Manual.
+
+## 6. Invocar Agente de Continuação
+
+```markdown
+<objective>
+Continuar pesquisa para Fase {phase_number}: {phase_name}
+</objective>
+
+<prior_state>
+<files_to_read>
+- .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md (Pesquisa existente)
+</files_to_read>
+</prior_state>
+
+<checkpoint_response>
+**Tipo:** {checkpoint_type}
+**Resposta:** {user_response}
+</checkpoint_response>
+```
+
+```
+Task(
+  prompt=continuation_prompt,
+  subagent_type="phase-researcher",
+  model="{researcher_model}",
+  description="Continuar pesquisa Fase {phase}"
+)
+```
+
+</process>
+
+<success_criteria>
+- [ ] Fase validada contra o roadmap
+- [ ] Pesquisa existente verificada
+- [ ] phase-researcher invocado com contexto
+- [ ] Checkpoints tratados corretamente
+- [ ] Usuário sabe os próximos passos
+</success_criteria>

package/kit/commands/planejar-fase.md

@@ -1,67 +1,67 @@
----
-name: planejar-fase
-description: Cria plano detalhado da fase (PLAN.md) com loop de verificação
-argument-hint: "[phase] [--auto] [--research] [--skip-research] [--gaps] [--skip-verify] [--prd <file>] [--reviews] [--text]"
-agent: planner
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - Glob
-  - Grep
-  - Task
-  - WebFetch
-  - mcp__context7__*
----
-<objective>
-Criar prompts de fase executáveis (arquivos PLAN.md) para uma fase do roadmap com pesquisa e verificação integradas.
-
-**Fluxo padrão:** Pesquisa (se necessário) → Planejar → Verificar → Concluído
-
-**Papel do orquestrador:** Analisar argumentos, validar fase, pesquisar domínio (a menos que pulado), invocar planner, verificar com plan-checker, iterar até aprovação ou máximo de iterações, apresentar resultados.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/plan-phase.md
-@./.claude/framework/references/ui-brand.md
-</execution_context>
-
-<context>
-Número da fase: $ARGUMENTS (opcional — auto-detecta a próxima fase não planejada se omitido)
-
-**Flags:**
-- `--research` — Forçar re-pesquisa mesmo que RESEARCH.md exista
-- `--skip-research` — Pular pesquisa, ir direto para planejamento
-- `--gaps` — Modo de fechamento de lacunas (lê VERIFICATION.md, pula pesquisa)
-- `--skip-verify` — Pular loop de verificação
-- `--prd <file>` — Usar um arquivo PRD/critérios de aceite em vez de discutir-fase. Analisa requisitos em CONTEXT.md automaticamente. Pula discutir-fase completamente.
-- `--reviews` — Replanejar incorporando feedback de revisão cross-AI do REVIEWS.md (produzido por `/revisar`)
-- `--text` — Usar listas numeradas em texto simples em vez de menus TUI (necessário para sessões remotas `/rc`)
-
-Normalizar entrada da fase no passo 2 antes de qualquer pesquisa de diretório.
-</context>
-
-<process>
-Execute o workflow plan-phase de @./.claude/framework/workflows/plan-phase.md do início ao fim.
-Preserve todos os checkpoints do workflow (validação, pesquisa, planejamento, loop de verificação, roteamento).
-</process>
-
-<observability_integration>
-**Integração com ODD plan-checker gate (v1.9):**
-
-Quando `workflow.observability_plan_gate = true` (default para fases voltadas ao usuário), o `plan-checker` invocado neste workflow inclui uma checagem extra:
-
-1. Lê `<observability>` section do CONTEXT.md (criado por `/discutir-fase` ou `/instrumentar-fase`)
-2. Verifica que as 4 perguntas pré-PR estão respondidas (consulta skill [`observability-driven-development`](../skills/observability-driven-development/SKILL.md)):
-   - Faz o que esperei? → INSTRUMENTATION.md tem `result.success` documentado?
-   - Compara à versão anterior? → `build_id` em todo span planejado?
-   - Usuários estão usando? → identidade (`user.id`/`tenant_id`/`customer.tier`) presente?
-   - Anomalias emergem? → `error.type` enum + `branch_taken` planejados?
-3. Se alguma pergunta ausente: VERIFICATION.md status = `gaps_found`, sugerindo invocar `/instrumentar-fase` para gerar INSTRUMENTATION.md.
-
-**Fases de infraestrutura pura** (skip discuss already detectou): pula gate silenciosamente.
-
-**Quando há observability gate enabled e gap encontrado:** o user pode (a) `/instrumentar-fase` antes de prosseguir; ou (b) editar manualmente CONTEXT.md `<observability>` section; ou (c) override via `--skip-observability-gate`.
-
-**REQ:** INT-FW-02.
-</observability_integration>
+---
+name: planejar-fase
+description: Cria plano detalhado da fase (PLAN.md) com loop de verificação
+argument-hint: "[phase] [--auto] [--research] [--skip-research] [--gaps] [--skip-verify] [--prd <file>] [--reviews] [--text]"
+agent: planner
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - WebFetch
+  - mcp__context7__*
+---
+<objective>
+Criar prompts de fase executáveis (arquivos PLAN.md) para uma fase do roadmap com pesquisa e verificação integradas.
+
+**Fluxo padrão:** Pesquisa (se necessário) → Planejar → Verificar → Concluído
+
+**Papel do orquestrador:** Analisar argumentos, validar fase, pesquisar domínio (a menos que pulado), invocar planner, verificar com plan-checker, iterar até aprovação ou máximo de iterações, apresentar resultados.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/plan-phase.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<context>
+Número da fase: $ARGUMENTS (opcional — auto-detecta a próxima fase não planejada se omitido)
+
+**Flags:**
+- `--research` — Forçar re-pesquisa mesmo que RESEARCH.md exista
+- `--skip-research` — Pular pesquisa, ir direto para planejamento
+- `--gaps` — Modo de fechamento de lacunas (lê VERIFICATION.md, pula pesquisa)
+- `--skip-verify` — Pular loop de verificação
+- `--prd <file>` — Usar um arquivo PRD/critérios de aceite em vez de discutir-fase. Analisa requisitos em CONTEXT.md automaticamente. Pula discutir-fase completamente.
+- `--reviews` — Replanejar incorporando feedback de revisão cross-AI do REVIEWS.md (produzido por `/revisar`)
+- `--text` — Usar listas numeradas em texto simples em vez de menus TUI (necessário para sessões remotas `/rc`)
+
+Normalizar entrada da fase no passo 2 antes de qualquer pesquisa de diretório.
+</context>
+
+<process>
+Execute o workflow plan-phase de @./.claude/framework/workflows/plan-phase.md do início ao fim.
+Preserve todos os checkpoints do workflow (validação, pesquisa, planejamento, loop de verificação, roteamento).
+</process>
+
+<observability_integration>
+**Integração com ODD plan-checker gate (v1.9):**
+
+Quando `workflow.observability_plan_gate = true` (default para fases voltadas ao usuário), o `plan-checker` invocado neste workflow inclui uma checagem extra:
+
+1. Lê `<observability>` section do CONTEXT.md (criado por `/discutir-fase` ou `/instrumentar-fase`)
+2. Verifica que as 4 perguntas pré-PR estão respondidas (consulta skill [`observability-driven-development`](../skills/observability-driven-development/SKILL.md)):
+   - Faz o que esperei? → INSTRUMENTATION.md tem `result.success` documentado?
+   - Compara à versão anterior? → `build_id` em todo span planejado?
+   - Usuários estão usando? → identidade (`user.id`/`tenant_id`/`customer.tier`) presente?
+   - Anomalias emergem? → `error.type` enum + `branch_taken` planejados?
+3. Se alguma pergunta ausente: VERIFICATION.md status = `gaps_found`, sugerindo invocar `/instrumentar-fase` para gerar INSTRUMENTATION.md.
+
+**Fases de infraestrutura pura** (skip discuss already detectou): pula gate silenciosamente.
+
+**Quando há observability gate enabled e gap encontrado:** o user pode (a) `/instrumentar-fase` antes de prosseguir; ou (b) editar manualmente CONTEXT.md `<observability>` section; ou (c) override via `--skip-observability-gate`.
+
+**REQ:** INT-FW-02.
+</observability_integration>