jarvis-ai-framework 1.0.0

package/workflows/warm-up.md

@@ -0,0 +1,574 @@
+---
+description: Fluxo para preparar a sessão com contexto personalizado por perfil
+version: "1.7"
+auto_execution_mode: 1
+env_file: "@/ENV.md"
+model_tier: low
+model_justification: Leitura seletiva de contexto e apresentação de menu — não requer raciocínio complexo
+---
+
+# warm-up — Contexto Personalizado por Perfil
+
+## Objetivo
+
+Preparar a sessão carregando **somente o contexto necessário** para o perfil do usuário,
+evitando leitura desnecessária de arquivos e economizando tokens.
+
+---
+
+## Passo 0 — Ler ENV.md (silenciosamente)
+
+Leia o arquivo `$IDE/ENV.md` e extraia as seguintes variáveis:
+
+```bash
+grep -E "^(POSITION|SQUAD|HUB|AREA|WORKSPACE|WORKSPACE_REPOS|DOCS_FOLDER|RULES_FOLDER|FLOWS_FOLDER|TEMPLATES_FOLDER|MAX_AI_EXECUTION_PERCENTAGE|ENABLE_CDD)=" $IDE/ENV.md
+```
+
+Variáveis que guiam o carregamento de contexto:
+
+| Variável | Uso |
+|----------|-----|
+| `POSITION` | Define profundidade e foco do contexto |
+| `HUB` | Define especialidade técnica prioritária |
+| `AREA` | Define domínio (ENGINEERING vs PRODUCT vs outros) |
+| `SQUAD` | Referência de squad para contexto do time |
+| `WORKSPACE` | Pasta do `$IDE/`. Vazio = nome dessa pasta |
+| `WORKSPACE_REPOS` | Allowlist. Vazio = todas as subpastas com `.git/` |
+| `DOCS_FOLDER` | Caminho base dos documentos do workspace |
+| `RULES_FOLDER` | Caminho base das regras |
+| `FLOWS_FOLDER` | Caminho base dos workflows |
+| `MAX_AI_EXECUTION_PERCENTAGE` | Calibra nível de autonomia |
+| `ENABLE_CDD` | Ativa/desativa calibração contextual |
+
+> **Não invente valores ausentes.** Se uma variável crítica não estiver definida, continue com o comportamento padrão indicado abaixo.
+>
+> `$IDE/ENV.md` pode estar num ancestral do cwd (workspace acima do repo aberto).
+> Se `WORKSPACE` estiver vazio, usar o nome da pasta que contém `$IDE/`.
+> Repos = `WORKSPACE_REPOS` ou scan de subpastas com `.git/`. Se houver mais de um, perguntar quais carregar nesta sessão (`ACTIVE_REPOS`). Um git na raiz = fluxo atual.
+
+---
+
+## Passo 0.5 — Reconhecimento do Stack Técnico (silenciosamente)
+
+Objetivo: garantir contexto completo do stack **antes** de qualquer workflow,
+para nunca inventar ou sugerir tecnologias fora do que o projeto usa.
+
+### 1. Extrair variáveis de stack do ENV.md
+
+Além das variáveis de perfil (Passo 0), extrair todas as variáveis de tecnologia
+definidas no ENV.md — qualquer variável não relacionada a perfil de usuário com
+valor não vazio. Exemplos de padrões comuns:
+
+- Mensageria  : `MESSAGE_BROKER`, `MESSAGE_BROKER_URL_API`, `MESSAGE_BROKER_API_AUTH`
+- Banco       : `DB_*`, `DATABASE_*`
+- Cache       : `CACHE_*`, `REDIS_*`
+- Outros serviços: qualquer var com `_URL`, `_HOST`, `_API` no nome
+
+> Não hardcode nomes de tecnologias. Leia o que está definido e infira a tech
+> pelo valor da variável (ex: `MESSAGE_BROKER=rabbitmq` → tech = RabbitMQ).
+
+### 2. Para cada tecnologia identificada
+
+**a) Carregar documentação via context7:**
+```
+mcp__context7__resolve-library-id → query: {nome da tecnologia}
+mcp__context7__query-docs         → carregar docs relevantes
+```
+→ Usar a documentação como referência para toda a sessão.
+
+**b) Se houver URL de API de gerenciamento + credenciais:**
+- Consultar a API para entender a topologia real do serviço
+  (ex: exchanges, filas e bindings ativos para RabbitMQ via management API)
+- Usar as variáveis `*_URL_API` + `*_API_AUTH` correspondentes
+- Registrar o que foi encontrado como contexto da sessão
+
+### 3. Invariante de sessão — crítica
+
+> 🔒 A partir deste passo, para toda a sessão:
+> - Trabalhar **somente** com as tecnologias identificadas aqui
+> - **Nunca sugerir alternativas tecnológicas** não presentes no stack identificado
+> - **Nunca inventar** configurações, topologias ou comportamentos não confirmados
+>   via ENV, API ou codebase
+> - Exceção: **somente se o usuário solicitar explicitamente**
+
+> Se nenhuma variável de stack for encontrada no ENV.md, pular silenciosamente.
+
+---
+
+## Passo 1 — Determinar Perfil de Comunicação
+
+O perfil de comunicação é derivado de `POSITION` (conforme definido no `$IDE/taxonomy.md`).
+**Não use a lista abaixo como hardcode** — use-a como referência de interpretação semântica:
+
+| Categoria semântica | Exemplos de POSITION | Perfil de comunicação |
+|---------------------|---------------------|----------------------|
+| Técnico iniciante | JUNIOR, PLENO | `didático` — explicar decisões, incluir contexto |
+| Técnico sênior | SENIOR, TECH LEAD, SPECIALIST | `direto` — foco em trade-offs e riscos |
+| Gestão de produto | PM, TPM, GPM | `estratégico` — impacto e visão de produto |
+| Executivo | CTO e equivalentes | `estratégico` — visão de alto nível |
+| Não definido | — | `didático` (padrão conservador) |
+
+> O mapeamento exato de quais POSITIONs existem vem do `$IDE/taxonomy.md` — não assuma valores fora desse arquivo.
+
+---
+
+## Passo 2 — Sincronizar Documentação Central (condicional)
+
+Se `CENTRAL_DOCS_REPO` estiver configurado no ENV.md, invocar o skill `docs-central` via Skill tool para carregar docs do produto.
+
+> ⚠️ **IMPORTANTE**: NÃO executar `jarvis docs sync` diretamente via Bash.
+> Usar sempre: **Skill tool → docs-central (Modo 1: Buscar Docs)**
+
+O skill `docs-central` gerencia:
+- Extração de token do `.npmrc`
+- Fallback quando `index.md` não existe (navegação por árvore)
+- Tratamento de erros
+
+**Invocação:**
+```
+Skill tool: docs-central
+Modo: 1 (Buscar Docs)
+Contexto: warm-up - sincronização inicial
+```
+
+**Output esperado:**
+```
+🔄 Sincronizando docs de {SQUAD}/{WORKSPACE}...
+✅ Docs sincronizados
+📊 5 documentos disponíveis:
+   - 1 PRD(s)
+   - 1 FRD(s)
+   - 2 ARD(s)
+   - 1 RFC(s)
+```
+
+**Comportamento:**
+- Se `CENTRAL_DOCS_REPO` vazio → pula silenciosamente
+- Se erro de token → exibe aviso mas continua
+- Se `index.md` não existe → navega estrutura do repo e lista docs disponíveis
+- Se erro genérico → exibe mensagem clara e continua sem bloquear
+
+Após sincronizar, exibir resumo dos documentos disponíveis:
+- PRDs compartilhados do produto
+- ARDs gerais e específicos do repo atual
+- RFCs relevantes
+- Dependências externas (outros produtos/squads)
+
+---
+
+## Passo 3 — Carregar Contexto Seletivo por AREA e HUB
+
+**Regra fundamental**: os caminhos são construídos **dinamicamente** a partir dos valores lidos do ENV.md.
+Não use caminhos hardcoded. Não escaneie pastas inteiras.
+
+### 3.1 — Construir caminhos base a partir do ENV e taxonomy
+
+```bash
+# 1. Ler AREA e HUB do ENV
+AREA=$(grep "^AREA=" $IDE/ENV.md | cut -d= -f2)
+HUB=$(grep "^HUB=" $IDE/ENV.md | cut -d= -f2)
+
+# 2. Ler prefixo da AREA no taxonomy (linha "prefix: xxx" abaixo do ### AREA)
+{prefix}   = valor de "prefix:" definido sob ### {AREA} em $IDE/taxonomy.md
+{area}     = lowercase(AREA)
+
+ex: AREA=ENGINEERING → prefix="eng",  area="engineering"
+    AREA=PRODUCT     → prefix="prod", area="product"
+```
+
+> Se o prefixo não estiver definido no taxonomy, usar `lowercase(AREA)` como fallback.
+
+### 2.2 — Sequência de leitura (executar nessa ordem)
+
+**Sempre leia:**
+```
+git log --oneline -3             ← commits recentes (independente de perfil)
+git status --short               ← estado atual do repositório
+```
+
+**Docs da área (tentar em ordem, parar no primeiro encontrado):**
+```
+1. $DOCS_FOLDER/{area}/index.md  ← índice de docs da área (ex: docs/engineering/index.md)
+2. $DOCS_FOLDER/index.md         ← índice geral (fallback)
+2. $DOCS_FOLDER/AGENTS.md        ← resumo para agents geral (fallback)
+(não ler os docs em si — apenas o índice para mapear o que existe)
+```
+
+**Regras da área:**
+```
+$RULES_FOLDER/{area}/{prefix}-rules.md
+ex: $RULES_FOLDER/engineering/eng-rules.md
+    $RULES_FOLDER/product/prod-rules.md
+```
+
+**Regras do hub (adicionar ao contexto base, se existir):**
+```
+$RULES_FOLDER/{area}/{hub}/{hub}-rules.md
+ex: $RULES_FOLDER/engineering/qa/qa-rules.md
+    $RULES_FOLDER/engineering/ai/ai-rules.md
+```
+
+**README (apenas para perfil didático ou quando não há docs/index.md):**
+```
+README.md (raiz do projeto)      ← visão geral do projeto
+```
+
+### 2.3 — Exemplos de caminhos gerados (ilustrativo)
+
+| AREA | prefix | HUB | Caminhos tentados |
+|------|--------|-----|-------------------|
+| ENGINEERING | eng | QA | `docs/engineering/index.md` → `rules/engineering/eng-rules.md` → `rules/engineering/qa/qa-rules.md` |
+| ENGINEERING | eng | AI | `docs/engineering/index.md` → `rules/engineering/eng-rules.md` → `rules/engineering/ai/ai-rules.md` |
+| PRODUCT | prod | — | `docs/product/index.md` → `rules/product/prod-rules.md` |
+
+> **Importante**: Se um arquivo ou pasta não existir, ignore silenciosamente — não errar, não inventar.
+> Novos valores de AREA ou HUB adicionados ao taxonomy.md funcionam automaticamente sem alterar este workflow.
+
+---
+
+## Passo 3 — Resumo de Contexto Carregado
+
+Após as leituras, exiba **somente** um resumo compacto:
+
+```
+── Sessão iniciada ──────────────────────────────────────
+  Workspace: {WORKSPACE}
+  Perfil   : {POSITION} · {HUB} · {SQUAD}
+  Autonomia: {MAX_AI_EXECUTION_PERCENTAGE}%
+  Stack    : {lista das techs identificadas no ENV}
+  Docs     : {context7 carregado para cada tech + docs de área}
+  Topologia: {resumo da consulta à API de gerenciamento, se disponível}
+  Commits  : {N} commits recentes carregados
+─────────────────────────────────────────────────────────
+```
+
+---
+
+## Passo 4 — Menu Adaptado por AREA
+
+O menu é determinado pelos valores de `POSITION`, `AREA` e `HUB` lidos do ENV.md.
+
+> ⚠️ **Ordem de precedência — verificar SEMPRE nesta sequência:**
+> 1. **POSITION** — se houver menu dedicado para o POSITION, usá-lo diretamente (ignora AREA+HUB)
+> 2. **AREA + HUB** — combinações específicas (DATA, QA, RPA)
+> 3. **AREA** — menu genérico da área
+> 4. **Genérico** — fallback para AREAs sem menu próprio
+>
+> **Nunca avaliar menus de AREA antes de verificar se o POSITION tem menu dedicado.**
+
+> Se o valor de AREA não tiver menu definido abaixo, use o **menu genérico**.
+> Novos valores de AREA adicionados ao taxonomy.md devem ganhar um menu correspondente aqui.
+
+---
+
+### Menu para POSITION=TECH ANALYST (sobrepõe AREA=ENGINEERING)
+
+> ℹ️ O Tech Analyst é transversal — não pertence a nenhuma squad de desenvolvimento.
+> Seu `SQUAD` no ENV.md deve ser `SUPPORT`. Interfaces com todas as squads.
+
+Quando `POSITION=TECH ANALYST`, ignorar o menu de ENGINEERING e exibir:
+
+```
+Como você quer continuar?
+
+A: Atender chamado técnico (ta.atendimento)
+B: Outro
+```
+
+Roteamento:
+- A → `$FLOWS_FOLDER/engineering/ta/eng.ta.atendimento.md`
+- B → perguntar e rotear dinamicamente
+
+---
+
+### Menu para POSITION=TECH LEAD (sobrepõe menu genérico de ENGINEERING)
+
+> ℹ️ Usar este menu quando `POSITION=TECH LEAD` e `AREA=ENGINEERING`.
+> O Tech Lead é responsável pelos gates de qualidade e segurança do time — workflows de segurança aparecem em destaque.
+
+```
+Como você quer continuar?
+
+── Engenharia ──────────────────────────────────────────────
+A: Iniciar sessão para codar (eng.start)
+B: Debug / Investigar problema (eng.debug)
+C: Criar ou iterar ARD (eng.create-ard)
+D: Criar ou iterar ARD desde o codebase (eng.create-ard-from-code)
+E: Abrir ou iterar RFC (eng.create-rfc)
+F: Fazer tech spec (eng.build-tech-spec)
+G: Revisar código / PR (eng.review)
+H: Documentar (eng.docs)
+── Segurança ───────────────────────────────────────────────
+I: Auditar segurança do repositório (eng.security-audit)
+J: Revisar PR com foco em segurança (eng.security-review)
+K: Responder incidente de segurança (eng.security-incident)
+L: Outro
+```
+
+Roteamento:
+- A → `$FLOWS_FOLDER/engineering/eng.start.md`
+- B → `$FLOWS_FOLDER/engineering/eng.debug.md`
+- C → `$FLOWS_FOLDER/engineering/eng.create-ard.md`
+- D → `$FLOWS_FOLDER/engineering/eng.create-ard-from-code.md`
+- E → `$FLOWS_FOLDER/engineering/eng.create-rfc.md`
+- F → `$FLOWS_FOLDER/engineering/eng.build-tech-spec.md`
+- G → `$FLOWS_FOLDER/engineering/eng.review.md`
+- H → `$FLOWS_FOLDER/engineering/eng.docs.md`
+- I → `$FLOWS_FOLDER/engineering/eng.security-audit.md`
+- J → `$FLOWS_FOLDER/engineering/eng.security-review.md`
+- K → `$FLOWS_FOLDER/engineering/eng.security-incident.md`
+- L → perguntar e rotear dinamicamente
+
+---
+
+### Menu para POSITION=CTO (sobrepõe AREA)
+
+> ℹ️ Usar este menu para qualquer `AREA` quando `POSITION` é equivalente a CTO.
+> Foco estratégico: segurança, arquitetura, risco e decisões de alto impacto — sem granularidade operacional.
+
+```
+Como você quer continuar?
+
+── Segurança & Risco ────────────────────────────────────────
+A: Auditar segurança do repositório (eng.security-audit)
+B: Responder incidente de segurança (eng.security-incident)
+── Arquitetura & Estratégia ────────────────────────────────
+C: Revisar código / PR estratégico (eng.review)
+D: Criar ou iterar ARD (eng.create-ard)
+E: Abrir ou iterar RFC (eng.create-rfc)
+F: Fazer tech spec (eng.build-tech-spec)
+G: Outro
+```
+
+Roteamento:
+- A → `$FLOWS_FOLDER/engineering/eng.security-audit.md`
+- B → `$FLOWS_FOLDER/engineering/eng.security-incident.md`
+- C → `$FLOWS_FOLDER/engineering/eng.review.md`
+- D → `$FLOWS_FOLDER/engineering/eng.create-ard.md`
+- E → `$FLOWS_FOLDER/engineering/eng.create-rfc.md`
+- F → `$FLOWS_FOLDER/engineering/eng.build-tech-spec.md`
+- G → perguntar e rotear dinamicamente
+
+---
+
+### Menu para AREA=ENGINEERING e HUB=DATA
+
+> ℹ️ Usar este menu quando `AREA=ENGINEERING` **e** `HUB=DATA`.
+
+```
+Como você quer continuar?
+
+A: Criar pipeline novo (data.new-pipeline)
+B: Integrar fonte de dados nova (eng-data-onboard)
+C: Diagnosticar falha em pipeline (eng-data-debug)
+D: Dashboard ou query analítica (eng-data-bi)
+E: Criar ou depurar DAG / orquestração (eng-data-orchestrator)
+F: Criar contrato de dados (data.contract)
+G: Outro
+```
+
+Roteamento:
+- A → `$FLOWS_FOLDER/engineering/data/data.new-pipeline.md`
+- B → skill `eng-data-onboard`
+- C → skill `eng-data-debug`
+- D → skill `eng-data-bi`
+- E → skill `eng-data-orchestrator`
+- F → `$FLOWS_FOLDER/engineering/data/data.contract.md`
+- G → perguntar e rotear dinamicamente
+
+---
+
+### Menu para AREA=ENGINEERING e (HUB=QA ou Quality Champion)
+
+> ℹ️ Usar este menu quando `AREA=ENGINEERING` **e** uma das condições:
+> - `HUB=QA`
+> - O usuário atual (`USER` do ENV.md) constar em `members.md` com `Quality Champion` no campo Posição
+>
+> Para verificar se o usuário é Quality Champion:
+> ```bash
+> grep -i "$USER" members.md | grep -i "Quality Champion"
+> ```
+> Se retornar resultado → usuário é Quality Champion → usar este menu.
+
+```
+Como você quer continuar?
+
+A: Mapear estratégia de testes para uma feature (qa.refinement-entry)
+B: Gerar testes E2E para uma feature (qa.e2e-test-generation)
+C: Sessão de teste exploratório (qa.exploratory-session)
+D: Validar quality gate de uma spec (eng-qa-quality-gate-validation)
+E: Gerar relatório de qualidade (qa.quality-report)
+F: Orientar dev sobre cobertura de testes (qa.dev-quality-guide)
+G: Planejar capacidade QA da sprint (qa.sprint-planning)
+H: Sign-off de release (qa.release-signoff)
+I: Outro
+```
+
+Roteamento:
+- A → `$FLOWS_FOLDER/engineering/qa/eng-qa-refinement-entry.md`
+- B → `$FLOWS_FOLDER/engineering/qa/eng-qa-e2e-test-generation.md`
+- C → `$FLOWS_FOLDER/engineering/qa/eng-qa-exploratory-session.md`
+- D → `$FLOWS_FOLDER/engineering/qa/eng-qa-quality-gate-validation.md`
+- E → `$FLOWS_FOLDER/engineering/qa/eng-qa-quality-report.md`
+- F → `$FLOWS_FOLDER/engineering/qa/eng-qa-dev-quality-guide.md`
+- G → `$FLOWS_FOLDER/engineering/qa/eng-qa-sprint-planning.md`
+- H → `$FLOWS_FOLDER/engineering/qa/eng-qa-release-signoff.md`
+- I → perguntar e rotear dinamicamente
+
+---
+
+### Menu para AREA=ENGINEERING (qualquer HUB)
+
+```
+Como você quer continuar?
+
+A: Iniciar sessão para codar (eng.start)
+B: Debug / Investigar problema (eng.debug)
+C: Criar ou iterar um ARD do zero ou desde um PRD (eng.create-ard)
+D: Criar ou iterar um ARD desde o codebase (eng.create-ard-from-code)
+E: Abrir ou iterar um RFC (eng.create-rfc)
+F: Fazer uma tech spec (eng.build-tech-spec)
+G: Revisar código / PR (eng.review)
+H: Documentar (eng.docs)
+I: Criar ou manter robô RPA (eng.rpa.robot) — skill técnica, não depende de squad
+J: Outro
+```
+
+Roteamento:
+- A → `$FLOWS_FOLDER/engineering/eng.start.md`
+- B → `$FLOWS_FOLDER/engineering/eng.debug.md`
+- C → `$FLOWS_FOLDER/engineering/eng.create-ard.md`
+- D → `$FLOWS_FOLDER/engineering/eng.create-ard-from-code.md`
+- E → `$FLOWS_FOLDER/engineering/eng.create-rfc.md`
+- F → `$FLOWS_FOLDER/engineering/eng.build-tech-spec.md`
+- G → `$FLOWS_FOLDER/engineering/eng.review.md`
+- H → `$FLOWS_FOLDER/engineering/eng.docs.md`
+- I → `$FLOWS_FOLDER/engineering/eng.rpa.robot.md`
+- J → perguntar e rotear dinamicamente
+
+### Menu para AREA=PRODUCT
+
+```
+Como você quer continuar?
+
+A: Criar nova PRD (prod.spec.prd)
+B: Criar novo FRD (prod.spec.frd)
+C: Criar story, task ou issue (prod.spec.issue)
+D: Detalhar épico (prod.spec.epic)
+E: Outro
+```
+
+Roteamento:
+- A → `$FLOWS_FOLDER/product/prod.spec.prd.md`
+- B → `$FLOWS_FOLDER/product/prod.spec.frd.md`
+- C → `$FLOWS_FOLDER/product/prod.spec.issue.md`
+- D → `$FLOWS_FOLDER/product/prod.spec.epic.md`
+- E → perguntar e rotear dinamicamente
+
+### Menu genérico (qualquer AREA além de ENGINEERING/PRODUCT)
+
+```
+Como você quer continuar?
+
+A: Perguntar algo sobre o projeto
+B: Criar documentação
+C: Outro
+```
+
+Roteamento:
+- A → responder com base no contexto carregado
+- B → `$FLOWS_FOLDER/engineering/eng.docs.md` (se existir) ou criar diretamente
+- C → perguntar qual atividade e rotear dinamicamente
+
+### Ajuste de menu por POSITION (sobrepõe AREA quando aplicável)
+
+| POSITION semântico | Ajuste no menu |
+|-------------------|----------------|
+| CTO e equivalentes | Menu estratégico com segurança em destaque — ver seção "Menu para POSITION=CTO" acima |
+| TECH LEAD em AREA=ENGINEERING | Menu completo de engenharia + workflows de segurança — ver seção "Menu para POSITION=TECH LEAD" acima |
+| PM, TPM, GPM em AREA=ENGINEERING | Mostrar menu PRODUCT mesmo estando na área ENGINEERING |
+| TECH ANALYST | Mostrar menu de atendimento técnico (ta.atendimento) em vez do menu ENGINEERING |
+
+---
+
+## Passo 5 — Limite de Execução (MAX_AI_EXECUTION_PERCENTAGE)
+
+`MAX_AI_EXECUTION_PERCENTAGE` é um **limite hard de execução** — a IA para obrigatoriamente quando atinge esse percentual do plano e **sempre pergunta** antes de continuar, mesmo com valores altos.
+
+**Regra de cálculo:**
+```
+tarefas_executáveis = floor(total_tarefas × (MAX_AI_EXECUTION_PERCENTAGE / 100))
+
+ex: 10 tarefas, MAX=70  → IA executa 7, para, pergunta ao usuário
+ex: 10 tarefas, MAX=90  → IA executa 9, para, pergunta ao usuário
+ex: 10 tarefas, MAX=100 → IA executa todas, mas ainda reporta e pergunta ao final
+```
+
+**Ao atingir o limite — sempre, sem exceção:**
+1. Parar a execução imediatamente
+2. Reportar o que foi feito
+3. Listar o que resta com sugestões de como o humano pode executar
+4. Perguntar explicitamente como o usuário deseja prosseguir
+5. Nunca continuar sem resposta explícita do usuário
+
+**Tarefas restantes (acima do limite):**
+- A IA **nunca executa** as tarefas restantes de forma autônoma — nem que o usuário peça "continua tudo"
+- A IA **pode assistir**: explicar, sugerir comandos, preparar código para revisão
+- Quem executa é o humano
+
+**O nível de autonomia calibra o comportamento *dentro* do limite, mas não o substitui:**
+
+| Valor | Nível | O que muda dentro do limite |
+|-------|-------|-----------------------------|
+| ≥ 90% | alto | Executa sem pedir confirmação a cada passo |
+| 70–89% | médio | Pausa em decisões críticas antes de continuar |
+| 60–69% | baixo | Apresenta opções e aguarda aprovação a cada passo |
+| Não definido | médio | Usa 80% como padrão |
+
+Declare ao usuário: limite configurado, quantas tarefas isso representa e o que ficará para execução humana.
+
+---
+
+## Regras do Warm-up
+
+### Nunca faça
+- Ler uma pasta inteira para mapear contexto — use o índice ou leia arquivos específicos
+- Inventar valores de ENV não definidos
+- Recusar contexto de outra área: Dev/TL/PM podem carregar rules de engenharia **e** de produto (autonomia ponta-a-ponta)
+- Perguntar informações que já constam no ENV.md
+- Sugerir tecnologia alternativa não presente no stack identificado no Passo 0.5
+- Assumir topologia de serviços sem consultar ENV ou API de gerenciamento
+
+### Sempre faça
+- Ler ENV.md primeiro, antes de qualquer outra coisa
+- Carregar stack técnico do ENV antes de qualquer workflow (Passo 0.5)
+- Usar context7 para documentação das tecnologias identificadas no stack
+- Consultar API de gerenciamento quando disponível (`*_URL_API` + `*_API_AUTH` no ENV)
+- Usar `$RULES_FOLDER`, `$DOCS_FOLDER`, `$FLOWS_FOLDER` em vez de caminhos hardcoded
+- Exibir o resumo de contexto antes do menu
+- Rotear para o workflow correto sem repetir perguntas já respondidas
+- Ignorar silenciosamente arquivos que não existem
+
+---
+
+## Integração com CDD
+
+Se `ENABLE_CDD=true` no ENV.md, **após o usuário selecionar a opção do menu**,
+execute `/context-detect` antes de iniciar o workflow escolhido.
+
+Se `ENABLE_CDD=false` ou não definido, prossiga diretamente para o workflow.
+
+---
+
+## Notas de Versão
+
+| Versão | Mudança |
+|--------|---------|
+| 1.0 | Leitura genérica de `$RULES_FOLDER/` e `$DOCS_FOLDER/` — sem filtro por perfil |
+| 1.1 | Carregamento seletivo por `POSITION` + `HUB`; menu adaptado; integração com CDD |
+| 1.2 | Menu específico para `AREA=ENGINEERING` + `HUB=QA` com roteamento para workflows `eng-qa-*` |
+| 1.3 | Menu QA expandido: sprint planning (G) + release sign-off (H); condição estendida para `POSITION=QUALITY_CHAMPION` |
+| 1.4 | Menu específico para `AREA=ENGINEERING` + `HUB=DATA`: pipeline novo, onboarding de fonte, debug, dashboard, contrato |
+| 1.5 | Opção de robô RPA no menu de ENGINEERING (skill técnica, sem squad dedicado) |
+| 1.6 | Menu específico para `POSITION=TECH LEAD`: engenharia completa + workflows de segurança em destaque; Menu para `POSITION=CTO`: foco estratégico em segurança, arquitetura e risco |
+| 1.7 | **Bugfix**: menus de POSITION movidos para antes dos menus de AREA — corrige TL recebendo menu genérico sem opções de segurança; bloco de precedência explícita no início do Passo 4 |