jarvis-ai-framework 2.0.0 → 2.1.1

package/AGENTS.md

@@ -46,10 +46,9 @@ prompts/
 │   │   ├── engineering/          # 25 workflows de engenharia
 │   │   │   ├── data/             # 2 workflows de dados (data.new-pipeline, data.contract)
 │   │   │   └── frontend/         # 3 workflows de frontend (component, review, perf-audit)
-│   │   └── product/              # 9 workflows de produto
+│   │   └── product/              # 10 workflows de produto
 │   │
 │   ├── skills/                   # Skills (todos com metadata.area)
-│   │   ├── claude-plugin-creator/
 │   │   ├── jarvis-context-detect/
 │   │   ├── jarvis-docs-index/
 │   │   ├── eng-ai-engineer/
@@ -78,13 +77,11 @@ prompts/
 │   │   ├── eng-qa-test-plan/
 │   │   ├── eng-qa-testsprite/
 │   │   ├── eng-qa-unit-test/
-│   │   ├── skill-creator/
-│   │   ├── taxonomy-manager/
-│   │   ├── workflow-creator/
 │   │   ├── jarvis-report-issue/          # Auto-report de bugs no repo do Jarvis (GitLab/GitHub/Bitbucket)
 │   │   ├── eng-global-task-comment/      # Comentário no card (Jira/Linear/GitHub/Asana)
 │   │   ├── jarvis-list-specializations/ # Lista especializações de stack instaladas e registradas
 │   │   ├── jarvis-create-specialization/ # Cria uma especialização de stack a partir do código do projeto e a registra
+│   │   ├── jarvis-evolution-architect/ # Mentor de arquitetura para a evolução do Jarvis
 │   │
 │   ├── templates/                # Templates de documentos
 │   │   ├── engineering/          # ARD, RFC, Tech Spec
@@ -96,6 +93,8 @@ prompts/
 │   │   │   └── frontend/         # eng.frontend-rules.md (HUB: FRONTEND)
 │   │   └── product/              # prod-rules.md (AREA=PRODUCT)
 │   │
+│   ├── rules-on-demand/          # Rules de uma etapa so (start, plan, work, pre-pr, pr, tech-spec, breakdown): o workflow manda ler
+│   │
 │   ├── scripts/                  # Scripts utilitarios
 │   └── docs/                     # Documentacao adicional
 │
@@ -212,6 +211,8 @@ jarvis logout                                       # Remover auth.json legado (
 jarvis init                                         # Bootstrap do framework no projeto
 jarvis list                                         # Listar agents, skills e workflows
 jarvis install-rtk                                  # Instalar RTK (token killer — economia 60-90% em tokens de shell)
+jarvis tokens    [--hub X --position Y --area Z --squad W] [--rtk] [--json]   # Estimar o que carrega no início da sessão (perfil do ENV.md se sem flags)
+jarvis map       <nome> [--depth N] [--reverse]      # Mapa de chamadas de um workflow, skill ou agente (lê só as tabelas padronizadas)
 ```
 
 Quando atuar em um projeto alvo, detectar comandos em:
@@ -230,7 +231,8 @@ Quando atuar em um projeto alvo, detectar comandos em:
 1. `.windsurfrules` / `.cursorrules` - Regras globais do framework
 2. `$IDE/ENV.md` - Contexto do ambiente
 3. `$IDE/JARVIS.md` - Guia principal de uso
-4. `$IDE/rules/` - Regras especificas por dominio
+4. `$IDE/rules/` - Regras especificas por dominio (carregadas no inicio)
+   `$IDE/rules-on-demand/` - Regras de uma etapa so, lidas pelo workflow
 5. `$IDE/agents/` - Definicoes de agentes
 6. `$IDE/skills/` - Playbooks operacionais
 7. `$IDE/workflows/` - Templates de execucao
@@ -296,6 +298,7 @@ Quando um agente atua em tema com skill correspondente, o skill e a fonte de ver
 | Comentário no card | `eng-global-task-comment` |
 | Listar especializações de stack (instaladas e registradas) | `jarvis-list-specializations` |
 | Criar uma especialização de stack (backend ou frontend) a partir do código do projeto | `jarvis-create-specialization` |
+| Decisão de arquitetura do Jarvis (agent, skill, workflow ou rule?), simplificação, tendências | `jarvis-evolution-architect` |
 | `jarvis docs sync` | `jarvis-docs-central` |
 | `jarvis docs publish` | `jarvis-docs-central` |
 | QA validation | `eng-qa-gate` |
@@ -303,7 +306,6 @@ Quando um agente atua em tema com skill correspondente, o skill e a fonte de ver
 | Inicializacao | `jarvis-init` |
 | Testes unitarios | `eng-qa-unit-test` |
 | Testes TestSprite | `eng-qa-testsprite` |
-| Taxonomia | `taxonomy-manager` |
 | Mensageria / RabbitMQ | `eng-backend-rabbitmq` (especialização de backend) |
 | APIs, auth, workers, caching | `eng-backend` (base) + `BACKEND_SPECIALIZATIONS` |
 | Componentes, UI, frontend | `eng-frontend` (base) + `FRONTEND_SPECIALIZATIONS` |
@@ -323,8 +325,8 @@ Quando um agente atua em tema com skill correspondente, o skill e a fonte de ver
 | Testes de acessibilidade WCAG 2.1 AA: integra jest-axe em testes unitários existentes | `eng-qa-a11y-audit` |
 | Testes de contrato GraphQL: valida queries frontend contra schema do BFF | `eng-qa-graphql-contract` |
 | Spec E2E para handoff: cenários, Page Objects, fixtures, intercepts, setup de ambiente | `eng-qa-e2e-spec-writer` |
-| Planejar capacidade QA da sprint: risco por task, alocação entre QAs e Quality Champions | `eng-qa-sprint-planning` |
-| Sign-off QA pré-deploy: verifica cobertura, bugs abertos, produz GO/NO-GO + snippet CI para TL | `eng-qa-release-signoff` |
+| Planejar capacidade QA da sprint: risco por task, alocação entre QAs e Quality Champions | workflow `eng.qa-sprint-planning` |
+| Sign-off QA pré-deploy: verifica cobertura, bugs abertos, produz GO/NO-GO + snippet CI para TL | workflow `eng.qa-release-signoff` |
 | Pipelines ETL/ELT, Glue, Airflow, PySpark, Athena, Metabase, bronze/silver/gold, contratos de dados, Great Expectations | `eng-data-engineer` |
 | Criar pipeline novo (docs, qualidade, idempotência, gold) | `data.new-pipeline` |
 | Criar contrato de dados para squad requisitante | `data.contract` |
@@ -402,6 +404,7 @@ Uso especializado quando necessário.
 - `$IDE/skills/AGENTS.md` - Skills disponiveis
 - `$IDE/rules/engineering/` - Regras de engenharia
 - `$IDE/rules/product/` - Regras de produto
+- `$IDE/rules-on-demand/engineering/` - Regras de etapa (lidas pelo workflow)
 
 ---
 

package/agents/AGENTS.md

@@ -65,7 +65,9 @@ Todo arquivo de agente deve conter:
 3. **Objetivo** - O que o agente faz
 4. **Quando Usar** - Cenarios de ativacao
 5. **Entrada/Saida** - O que recebe e produz
-6. **Restricoes** - O que NAO deve fazer
+6. **Skills Disponiveis** - Cabecalho exato `## Skills Disponíveis`, com uma subsecao `### {skill}` por skill que o agente usa (linha de contexto e `- Arquivo: $IDE/skills/{skill}/SKILL.md`). So skills: workflows e agentes relacionados ficam em `## Workflows e Agentes Relacionados`. Sem skill, uma linha `Nenhuma — agente autocontido, não depende de skill`. Modelo: `engineering/eng.rpa.agent.md`
+   O `jarvis map` e o `npm run test:comandos` leem so essa tabela (e, nos agentes, `## Skills Disponíveis` e `## Workflows e Agentes Relacionados`): chamada que existir so no texto corrido nao aparece no mapa, e nome citado que nao existir faz o teste falhar.
+7. **Restricoes** - O que NAO deve fazer
 
 ### Exemplo de Estrutura
 
@@ -89,6 +91,12 @@ Descricao curta do agente.
 ## Saida
 ...
 
+## Skills Disponíveis
+
+### nome-da-skill
+Para que serve e quando usar:
+- Arquivo: `$IDE/skills/nome-da-skill/SKILL.md`
+
 ## Restricoes
 ...
 ```

package/agents/README.md

@@ -194,8 +194,8 @@ para revisar a arquitetura de microservices"
 # Opção 2: Ativar permanentemente
 mv agents/archive/architecture-design/backend-architect.md agents/engineering/
 
-# Opção 3: Criar skill customizado
-/skill-creator  # criar skill que usa agent arquivado
+# Opção 3: Criar skill customizado que usa o agent arquivado
+# (passos em "Criando um Novo Skill", no skills/AGENTS.md)
 ```
 
 ### Invocação Manual

package/agents/engineering/data/eng.data-engineer.agent.md

@@ -190,7 +190,7 @@ CONTEXT_PROFILE:
 
 ---
 
-## Skills
+## Skills Disponíveis
 
 ### eng-data-engineer
 Skill principal para construção de pipelines, modelagem e contratos de dados:
@@ -271,7 +271,7 @@ Para detecção automática de contexto de tarefas:
 | `$IDE/workflows/engineering/eng.pr.md` | PR de scripts de pipeline (colaborar com ATHENA) |
 
 > Se os workflows `data.new-pipeline.md` e `data.contract.md` ainda não existirem,
-> orientar o usuário a criá-los via `/work-jarvis` ou seguir o fluxo do skill `eng-data-engineer`.
+> orientar o usuário a criá-los via `/eng.work` ou seguir o fluxo do skill `eng-data-engineer`.
 
 ---
 

package/agents/engineering/eng.agent.md

@@ -167,7 +167,7 @@ Identifique palavras-chave na mensagem do usuário para ajuste imediato:
   - testes a serem rodados
   - pontos que precisam de validação do usuário
  
-## Skills
+## Skills Disponíveis
 
 ### jarvis-context-detect (CDD)
 Para detecção automática de contexto de tarefas:
@@ -246,14 +246,12 @@ Quando a tarefa envolver segurança de aplicação, auditoria OWASP, secrets man
 
 ## Fluxo de Cards no Board
 
-> Referência completa: `$IDE/rules/engineering/eng.downstream-flow-rules.md`
-
-Ao orientar o usuário sobre movimentação de cards, seguir estritamente o fluxo downstream definido em taxonomy:
+Ao orientar o usuário sobre movimentação de cards, siga o princípio de autonomia no card do `eng-rules.md`:
 
 | Momento | Ação esperada do agente |
 |---|---|
-| Profissional assume o card (`eng.start`) | Orientar mover para **"Em progresso"** |
-| Profissional abre MR (`eng.pr`) | Orientar mover para **"Review de código"** |
+| Profissional assume o card (`eng.start`) | Orientar mover para a etapa equivalente a "em andamento" |
+| Profissional abre MR (`eng.pr`) | Orientar mover para a etapa equivalente a "em revisão" |
 | Qualquer outra transição | Orientar o **owner do card** a avançar. TL/PM revisam e apoiam — não são gate. |
 
 **Regra crítica:** o agente não move cards automaticamente. Ele **orienta** o profissional que está com o card. Autonomia: DEV, TECH LEAD e Produto podem conduzir a entrega ponta-a-ponta.

package/agents/engineering/eng.bug-hunter.md

@@ -191,17 +191,17 @@ CONTEXT_PROFILE:
   - Priorize:
     - `$IDE/workflows/engineering/eng.debug.md` (Resolution Mode)
     - `$IDE/workflows/engineering/eng.bug-audit.md` (Audit Mode)
-    - `$IDE/skills/bug-report/SKILL.md` (geração de relatórios)
+    - `$IDE/skills/eng-qa-bug-report/SKILL.md` (geração de relatórios)
   - Não acione workflows de outros domínios sem autorização explícita do usuário
 
 ---
 
-## Skills
+## Skills Disponíveis
 
-### bug-report
+### eng-qa-bug-report
 Para geração de relatórios estruturados de bugs encontrados:
-- Arquivo: `$IDE/skills/bug-report/SKILL.md`
-- Uso: `/bug-report [modo] [argumentos]`
+- Arquivo: `$IDE/skills/eng-qa-bug-report/SKILL.md`
+- Uso: `/eng-qa-bug-report [modo] [argumentos]`
 - Integração com Jira para criação automática de cards
 
 ### jarvis-context-detect (CDD)
@@ -218,6 +218,11 @@ Para rastreamento automático de bugs em arquitetura de microsserviços, use a e
 - Mapeia cadeia de chamadas HTTP + AMQP, analisa contratos em cada boundary e rankeia hipóteses por risco
 - Sem a especialização registrada, siga a investigação cross-service manualmente
 
+### eng-security-cybersecurity
+Quando o bug tiver impacto de segurança (injection, auth bypass, data exposure), como referência na escalação ao SENTINEL:
+- Arquivo: `$IDE/skills/eng-security-cybersecurity/SKILL.md`
+- Agente dedicado: `$IDE/agents/engineering/eng.cybersecurity.agent.md` (SENTINEL)
+
 ---
 
 ## Responsabilidades Principais

package/agents/engineering/eng.cybersecurity.agent.md

@@ -227,7 +227,7 @@ CONTEXT_PROFILE:
 
 ---
 
-## Skills
+## Skills Disponíveis
 
 ### eng-security-cybersecurity
 Playbook operacional de seguranca — fonte de verdade para padroes, checklists e exemplos:
@@ -362,14 +362,12 @@ Para gerar diffs candidatos por achado confirmado — fechar o loop técnico do
 
 ## Fluxo de Cards no Board
 
-> Referencia completa: `$IDE/rules/engineering/eng.downstream-flow-rules.md`
-
 | Momento | Acao |
 |---------|------|
 | Vulnerabilidade critica encontrada | Criar card com label `security` e prioridade maxima |
 | CVE afeta o projeto | Criar card de incidente, orientar TL sobre urgencia |
 | Security review reprova PR | Solicitar correcoes com evidencia, nao bloquear sem justificativa |
-| Qualquer outra transicao | Consultar a rule — nunca mover card de responsabilidade do TECH LEAD ou PM |
+| Qualquer outra transicao | Orientar o owner do card a avancar; nunca mover card de outra pessoa |
 
 ---
 

package/agents/engineering/eng.dev-code-reviewer.md

@@ -67,6 +67,10 @@ Avalie os testes:
 - A cobertura de testes foi mantida ou melhorada?
 - Os testes são significativos ou apenas “para cobertura”?
 
+## Skills Disponíveis
+
+Nenhuma — agente autocontido, não depende de skill
+
 ## Formato da Resposta
 Forneça uma revisão estruturada no seguinte formato:
 

package/agents/engineering/eng.docs-writer.md

@@ -9,10 +9,10 @@ model: sonnet
 Você é um **especialista em documentação** focado em manter a documentação do projeto **sincronizada com as mudanças de código**.  
 Sua missão é garantir que a documentação reflita com precisão o **estado atual do codebase**.
 
-## Skill de referência
-
-Use o skill `eng-global-docs-write` como fonte de verdade do processo e formato de entrega:
+## Skills Disponíveis
 
+### eng-global-docs-write
+Fonte de verdade do processo e do formato de entrega da documentação:
 - Arquivo: `$IDE/skills/eng-global-docs-write/SKILL.md`
 
 ---

package/agents/engineering/eng.frontend.agent.md

@@ -49,16 +49,25 @@ Não criar abstração para reutilização hipotética.
 
 ---
 
-## Mapeamento de Skills
+## Skills Disponíveis
 
-| Tarefa | Skill |
-|--------|-------|
-| Criar/refatorar componente, estado ou estilos | regra `eng.specializations-rules.md` (área frontend: `eng-frontend` + `FRONTEND_SPECIALIZATIONS`) |
-| Auditoria de performance | `eng-frontend` (seção Performance) |
-| Testes E2E de fluxo de usuário | `eng-qa-e2e` |
-| Testes Cypress (Page Objects, intercept) | `eng-qa-cypress-e2e` |
+### Frontend (skill base + especializações)
+Para criar ou refatorar componente, estado ou estilos, aplique a regra `eng.specializations-rules.md` para a área frontend (skill base `eng-frontend` + itens de `FRONTEND_SPECIALIZATIONS`):
+- Arquivo da regra: `$IDE/rules/engineering/eng.specializations-rules.md`
+- Skill base: `$IDE/skills/eng-frontend/SKILL.md` + itens de `FRONTEND_SPECIALIZATIONS`
+- Auditoria de performance: seção Performance do `eng-frontend`
 
-**Workflow de referência**: ver `workflows/engineering/frontend/`
+### eng-qa-e2e
+Para testes E2E de fluxo de usuário:
+- Arquivo: `$IDE/skills/eng-qa-e2e/SKILL.md`
+
+### eng-qa-cypress-e2e
+Para testes Cypress (Page Objects, intercept):
+- Arquivo: `$IDE/skills/eng-qa-cypress-e2e/SKILL.md`
+
+## Workflows e Agentes Relacionados
+
+- Workflow de referência: ver `workflows/engineering/frontend/`
 
 ---
 

package/agents/engineering/eng.rpa.agent.md

@@ -175,13 +175,11 @@ Para criar um robô novo ou manter um existente:
 
 ## Fluxo de Cards no Board
 
-> Referência completa: `$IDE/rules/engineering/eng.downstream-flow-rules.md`
-
 | Momento | Ação |
 |---------|------|
-| DEV assume o card (`eng.rpa.robot`) | Orientar mover para **"Em progresso"** |
-| DEV abre MR (`eng.pr`) | Orientar mover para **"Review de código"** |
-| Qualquer outra transição | Consultar a rule — nunca orientar DEV a mover card de responsabilidade do TECH LEAD ou PM |
+| DEV assume o card (`eng.rpa.robot`) | Orientar mover para a etapa equivalente a "em andamento" |
+| DEV abre MR (`eng.pr`) | Orientar mover para a etapa equivalente a "em revisão" |
+| Qualquer outra transição | Orientar o owner do card a avançar; nunca orientar a mover card de outra pessoa |
 
 ---
 

package/agents/engineering/eng.ux-designer.agent.md

@@ -53,6 +53,10 @@ de implementação. Classificar feedback por impacto × esforço.
 
 ---
 
+## Skills Disponíveis
+
+Nenhuma — agente autocontido, não depende de skill
+
 ## Mapeamento de Atividades
 
 | Atividade | Quando usar |

package/agents/engineering/qa/eng.qa.cypress-specialist.md

@@ -15,12 +15,15 @@ de testes E2E: desde escrita de specs até configuração de CI e debugging de t
 
 ---
 
-## Skills de Referência
+## Skills Disponíveis
 
-| Situação | Skill |
-|----------|-------|
-| Gerar nova spec Cypress | `eng-qa-cypress-e2e` |
-| Orientar dev sobre cobertura | `eng-qa-dev-guide` |
+### eng-qa-cypress-e2e
+Para gerar uma nova spec Cypress:
+- Arquivo: `$IDE/skills/eng-qa-cypress-e2e/SKILL.md`
+
+### eng-qa-dev-guide
+Para orientar o dev sobre cobertura:
+- Arquivo: `$IDE/skills/eng-qa-dev-guide/SKILL.md`
 
 ---
 

package/agents/engineering/qa/eng.qa.quality-champion-task-agent.md

@@ -83,3 +83,7 @@ Use o seguinte formato em comentários Jira:
 - Mentalidade de coaching, não punitiva
 
 Seu sucesso é medido pela **prevenção de trabalho mal definido de entrar em desenvolvimento** e pela **elevação da qualidade geral dos tickets Jira** em todo o time.
+
+## Skills Disponíveis
+
+Nenhuma — agente autocontido, não depende de skill

package/agents/engineering/qa/eng.qa.quality-strategist.md

@@ -19,14 +19,24 @@ Você responde perguntas como:
 
 ---
 
-## Skills de Referência
-
-| Situação | Skill / Workflow |
-|----------|----------------|
-| Planejar testes de uma feature específica | `eng-qa-test-plan` |
-| Entrada no refinamento de uma feature | `qa.refinement-entry` |
-| Gerar relatório de qualidade do período | `qa.quality-report` |
-| Análise de risco pré-release | `eng-qa-gate` |
+## Skills Disponíveis
+
+### eng-qa-test-plan
+Para planejar os testes de uma feature específica:
+- Arquivo: `$IDE/skills/eng-qa-test-plan/SKILL.md`
+
+### eng-qa-gate
+Para a análise de risco pré-release:
+- Arquivo: `$IDE/skills/eng-qa-gate/SKILL.md`
+
+### eng-qa-dev-guide
+Para features de médio risco: o QA orienta e o dev implementa os testes:
+- Arquivo: `$IDE/skills/eng-qa-dev-guide/SKILL.md`
+
+## Workflows e Agentes Relacionados
+
+- `eng.qa-refinement-entry` (workflow): entrada no refinamento de uma feature
+- `eng.qa-quality-report` (workflow): gerar o relatório de qualidade do período
 
 ---
 

package/agents/engineering/qa/eng.qa.test-architect.md

@@ -85,13 +85,24 @@ Este agente foca em:
 
 ---
 
-## Skills de Referência
+## Skills Disponíveis
 
-| Skill | Quando Usar |
-|-------|-------------|
-| **eng-qa-testsprite** | Execução automatizada E2E/API |
-| **eng-qa-test-plan** | Análise de cobertura |
-| **eng-qa-unit-test** | Padrões de testes unitários |
+### eng-qa-testsprite
+Para execução automatizada E2E/API:
+- Arquivo: `$IDE/skills/eng-qa-testsprite/SKILL.md`
+
+### eng-qa-test-plan
+Para análise de cobertura:
+- Arquivo: `$IDE/skills/eng-qa-test-plan/SKILL.md`
+
+### eng-qa-unit-test
+Para padrões de testes unitários:
+- Arquivo: `$IDE/skills/eng-qa-unit-test/SKILL.md`
+
+### jarvis-context-detect (CDD)
+Para detecção automatizada do contexto (calibração contextual do agente):
+- Arquivo: `$IDE/skills/jarvis-context-detect/SKILL.md`
+- Uso: `/jarvis-context-detect {TASK_MANAGER_KEY}`
 
 ---
 

package/agents/engineering/qa/eng.qa.test-planner.md

@@ -14,7 +14,7 @@ Você é um **especialista em planejamento e cobertura de testes** com dois modo
 Antes de qualquer ação, determine qual modo aplicar:
 
 **Modo A — Estratégia a partir da Tech Spec (pré-código)**
-Aplicar quando invocado via `eng-qa-refinement-entry` ou quando o argumento recebido for um ID de card ou caminho de spec e não houver código implementado na branch ainda.
+Aplicar quando invocado via `eng.qa-refinement-entry` ou quando o argumento recebido for um ID de card ou caminho de spec e não houver código implementado na branch ainda.
 - Fonte de dados: card no $TASK_MANAGER via integração disponível (Jira MCP)
 - Não executar `git diff`, `git log` ou qualquer comando que dependa de código
 - Saída: `$DOCS_FOLDER/engineering/qa/strategies/{task-id}-test-strategy.md`
@@ -26,15 +26,24 @@ Aplicar quando invocado via `eng-qa-unit-test`, `eng-qa-test-plan` ou quando hou
 
 Regra de decisão: se `git diff origin/main...HEAD` retornar vazio, operar em Modo A. Se retornar código, operar em Modo B.
 
-## Skills e Agentes de Referência
+## Skills Disponíveis
 
 Use os recursos abaixo como fonte de verdade do processo:
 
-**Skills:**
-- **eng-qa-test-plan**: análise de cobertura e planejamento de testes
-  - Arquivo: `$IDE/skills/eng-qa-test-plan/SKILL.md`
-- **eng-qa-testsprite**: execução automatizada de testes com TestSprite MCP
-  - Arquivo: `$IDE/skills/eng-qa-testsprite/SKILL.md`
+### eng-qa-test-plan
+Para análise de cobertura e planejamento de testes:
+- Arquivo: `$IDE/skills/eng-qa-test-plan/SKILL.md`
+
+### eng-qa-testsprite
+Para execução automatizada de testes com TestSprite MCP:
+- Arquivo: `$IDE/skills/eng-qa-testsprite/SKILL.md`
+
+### jarvis-context-detect (CDD)
+Para detecção automatizada do contexto (calibração contextual do agente):
+- Arquivo: `$IDE/skills/jarvis-context-detect/SKILL.md`
+- Uso: `/jarvis-context-detect {TASK_MANAGER_KEY}`
+
+## Workflows e Agentes Relacionados
 
 **Agentes complementares:**
 - **eng.qa.testing-engineer**: para escrever os testes identificados como ausentes
@@ -112,7 +121,7 @@ CONTEXT_PROFILE:
 
 ## Fluxo de Trabalho — Modo A (Estratégia a partir da Spec)
 
-Usar quando: invocado via `eng-qa-refinement-entry`, ou quando git diff retornar vazio.
+Usar quando: invocado via `eng.qa-refinement-entry`, ou quando git diff retornar vazio.
 
 ### A.1. Buscar o Card
 

package/agents/engineering/qa/eng.qa.testing-engineer.md

@@ -10,15 +10,32 @@ model: sonnet
 Você é um **engenheiro de testes** focado em escrever testes práticos que verificam se o código
 realmente funciona como pretendido — tanto testes unitários quanto E2E Cypress.
 
-## Skills de Referência
-
-| Skill | Quando Usar | Arquivo |
-|-------|-------------|---------|
-| **eng-qa-cypress-e2e** | Para gerar specs Cypress + TypeScript para fluxos de usuário | `$IDE/skills/eng-qa-cypress-e2e/SKILL.md` |
-| **eng-qa-unit-test** | Para templates e padrões ao **escrever** testes unitários | `$IDE/skills/eng-qa-unit-test/SKILL.md` |
-| **eng-qa-test-plan** | Para **analisar** cobertura antes de escrever | `$IDE/skills/eng-qa-test-plan/SKILL.md` |
-| **eng-qa-testsprite** | Para testes E2E/API em linguagem natural via Stagehand | `$IDE/skills/eng-qa-testsprite/SKILL.md` |
-| **eng-qa-dev-guide** | Para orientar devs sobre cobertura sem escrever o teste | `$IDE/skills/eng-qa-dev-guide/SKILL.md` |
+## Skills Disponíveis
+
+### eng-qa-cypress-e2e
+Para gerar specs Cypress + TypeScript para fluxos de usuário:
+- Arquivo: `$IDE/skills/eng-qa-cypress-e2e/SKILL.md`
+
+### eng-qa-unit-test
+Para templates e padrões ao **escrever** testes unitários:
+- Arquivo: `$IDE/skills/eng-qa-unit-test/SKILL.md`
+
+### eng-qa-test-plan
+Para **analisar** cobertura antes de escrever:
+- Arquivo: `$IDE/skills/eng-qa-test-plan/SKILL.md`
+
+### eng-qa-testsprite
+Para testes E2E/API em linguagem natural via Stagehand:
+- Arquivo: `$IDE/skills/eng-qa-testsprite/SKILL.md`
+
+### eng-qa-dev-guide
+Para orientar devs sobre cobertura sem escrever o teste:
+- Arquivo: `$IDE/skills/eng-qa-dev-guide/SKILL.md`
+
+### jarvis-context-detect (CDD)
+Para detecção automatizada do contexto (calibração contextual do agente):
+- Arquivo: `$IDE/skills/jarvis-context-detect/SKILL.md`
+- Uso: `/jarvis-context-detect {TASK_MANAGER_KEY}`
 
 > **Stack E2E primária**: Cypress + TypeScript com Page Objects, `data-testid` e `cy.intercept`.
 > Consultar `$RULES_FOLDER/engineering/qa/eng.qa.cypress-standards-rules.md` para convenções do projeto.

package/agents/product/prod.discovery-interviewer.md

@@ -70,10 +70,29 @@ Não use quando já existe uma spec (use `/prod.spec.clarify`) ou quando o escop
 - Uma **lacuna crítica nunca** resulta em `proceed`: o veredito é `investigate_more`
 - Quando a viabilidade técnica depende de bibliotecas, APIs ou serviços, consulte a documentação atual (por exemplo via Context7) em vez de responder de memória
 
-## Apoio de skills (apoio, nunca a fonte da decisão)
+## Skills Disponíveis
 
-- **Sempre:** busca em `$PROD_DOCS`; `jarvis-docs-central` quando `CENTRAL_DOCS_REPO` estiver configurado; `jarvis-context-detect` para calibrar a profundidade da entrevista
-- **Só com a confirmação do usuário:** `eng-backend-arch-c4` (arquitetura atual) e `eng-security-cybersecurity` (quando a ideia envolve autenticação, dados pessoais ou fluxo financeiro). São skills de engenharia: pergunte antes de consultá-las, e o que retornarem entra no discovery como **suposição a validar**, não como fato
+As skills são apoio, nunca a fonte da decisão. A busca em `$PROD_DOCS` não é uma skill: é feita sempre, antes de perguntar.
+
+### jarvis-docs-central
+Para buscar documentação do produto no repositório central, quando `CENTRAL_DOCS_REPO` estiver configurado:
+- Arquivo: `$IDE/skills/jarvis-docs-central/SKILL.md`
+- Confiança: sempre
+
+### jarvis-context-detect
+Para calibrar a profundidade da entrevista:
+- Arquivo: `$IDE/skills/jarvis-context-detect/SKILL.md`
+- Confiança: sempre
+
+### eng-backend-arch-c4
+Para consultar a arquitetura atual:
+- Arquivo: `$IDE/skills/eng-backend-arch-c4/SKILL.md`
+- Confiança: só com a confirmação do usuário (skill de engenharia: pergunte antes de consultá-la; o que ela retornar entra no discovery como **suposição a validar**, não como fato)
+
+### eng-security-cybersecurity
+Para quando a ideia envolve autenticação, dados pessoais ou fluxo financeiro:
+- Arquivo: `$IDE/skills/eng-security-cybersecurity/SKILL.md`
+- Confiança: só com a confirmação do usuário (skill de engenharia: pergunte antes de consultá-la; o que ela retornar entra no discovery como **suposição a validar**, não como fato)
 
 ## Restrições
 

package/agents/product/prod.pm-checker.md

@@ -50,3 +50,7 @@ Você deve fornecer sua resposta exatamente no seguinte formato:
 
 Regras Importantes
 Não faça nenhuma alteração no código ou nos requisitos, a menos que o usuário solicite explicitamente. Seu papel é avaliar e reportar, não corrigir.
+
+## Skills Disponíveis
+
+Nenhuma — agente autocontido, não depende de skill

package/bin/commands/map.js

@@ -0,0 +1,43 @@
+import { buildGraph, forwardTree, reverseEdges, suggest, DEFAULT_DEPTH } from "../lib/flow-map/tree.js";
+import { renderTree, renderReverse } from "../lib/flow-map/render.js";
+import { getFrameworkRoot } from "../lib/utils/paths.js";
+import { logger } from "../lib/utils/logger.js";
+
+const USAGE = "Uso: jarvis map <nome> [--depth N] [--reverse]   (nome de um workflow, skill ou agente)";
+
+/**
+ * Monta a saída do mapa. Separado de `map` para ser testável.
+ * @param {string | undefined} name
+ * @param {Record<string, unknown>} flags
+ * @param {string} [root]
+ * @returns {{ code: number, lines: string[] }}
+ */
+export function runMap(name, flags = {}, root = getFrameworkRoot()) {
+  if (!name) return { code: 1, lines: ["❌ Informe o nome de um workflow, skill ou agente.", USAGE] };
+
+  let depth = DEFAULT_DEPTH;
+  if (flags.depth !== undefined) {
+    depth = Number.parseInt(String(flags.depth), 10);
+    if (!Number.isInteger(depth) || depth < 1) return { code: 1, lines: ["❌ --depth precisa ser um número inteiro maior que zero.", USAGE] };
+  }
+
+  const graph = buildGraph(root);
+  if (!graph.items.has(name)) {
+    const similar = suggest(graph.items, name);
+    const lines = [`❌ Não encontrado: ${name}`];
+    if (similar.length) lines.push("Você quis dizer:", ...similar.map((s) => `  - ${s}`));
+    lines.push("Use `jarvis list` para ver o que existe.");
+    return { code: 1, lines };
+  }
+
+  if (flags.reverse) {
+    return { code: 0, lines: renderReverse(name, graph.items.get(name).type, reverseEdges(graph, name)) };
+  }
+  return { code: 0, lines: renderTree(forwardTree(graph, name, { depth })) };
+}
+
+export async function map(flags) {
+  const { code, lines } = runMap(flags._?.[0], flags);
+  for (const line of lines) (code === 0 ? logger.info : logger.error)(line);
+  if (code !== 0) process.exit(code);
+}