jarvis-ai-framework 2.1.0 → 3.0.0

package/AGENTS.md

@@ -21,10 +21,9 @@ prompts/
 │   ├── MCPs.md                   # Integracoes MCP
 │   ├── LEGACY_PROJECTS.md        # Guia para projetos legados
 │   │
-│   ├── agents/                   # 17 ativos + 5 arquivados
-│   │   ├── engineering/          # Agentes de engenharia (15 ativos: 8 main + 6 QA + 1 Data)
+│   ├── agents/                   # 16 agentes ativos
+│   │   ├── engineering/          # Agentes de engenharia (13 ativos: 7 main + 5 QA + 1 Data)
 │   │   │   ├── eng.agent.md
-│   │   │   ├── eng.cybersecurity.agent.md  # Cybersecurity e AppSec (SENTINEL)
 │   │   │   ├── eng.bug-hunter.md
 │   │   │   ├── eng.dev-code-reviewer.md
 │   │   │   ├── eng.docs-writer.md
@@ -33,54 +32,36 @@ prompts/
 │   │   │   ├── eng.rpa.agent.md   # Agente RPA/Scraping (ARACHNE) — skill técnica
 │   │   │   ├── data/             # 1 agente de Data
 │   │   │   │   └── eng.data-engineer.agent.md
-│   │   │   └── qa/               # 6 agentes de QA
-│   │   ├── product/              # Agentes de produto (2 ativos)
-│   │   │   ├── prod.pm-checker.md
-│   │   │   └── prod.discovery-interviewer.md
-│   │   └── archive/              # Agentes arquivados (uso especializado)
-│   │       ├── architecture-design/   # 2 agentes
-│   │       ├── implementation/        # 2 agentes
-│   │       └── product/               # 5 agentes (WIP)
+│   │   │   └── qa/               # 5 agentes de QA
+│   │   └── product/              # Agentes de produto (2 ativos)
+│   │       ├── prod.pm-checker.md
+│   │       └── prod.discovery-interviewer.md
 │   │
 │   ├── workflows/                # Templates de execucao
 │   │   ├── 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/
+│   │   ├── eng-ai/
 │   │   ├── eng-backend-arch-c4/
 │   │   ├── eng-backend/           # Base neutra de backend (+ especializações em BACKEND_SPECIALIZATIONS)
 │   │   ├── eng-backend-microservices-trace/          # Rastreamento de bugs cross-service (HTTP + AMQP)
-│   │   ├── eng-global-browser-extension-builder/
 │   │   ├── eng-global-docs-write/
-│   │   ├── eng-frontend/          # Base neutra de frontend (+ especializações em FRONTEND_SPECIALIZATIONS)
-│   │   ├── eng-frontend-microfrontend/     # Module Federation, shell/remote, contratos, event bus
-│   │   ├── eng-frontend-design-system/     # Tokens, CVA, Storybook, versionamento, auditoria visual
+│   │   ├── eng-frontend/          # Base neutra de frontend (design system/tokens e micro frontend inclusos; + especializações em FRONTEND_SPECIALIZATIONS)
 │   │   ├── eng-backend-nestjs/            # Framework NestJS: módulos, DI, guards, interceptors
-│   │   ├── eng-devops-performance-engineer/
 │   │   ├── eng-global-pr/
 │   │   ├── eng-backend-rabbitmq/          # Mensageria RabbitMQ
-│   │   ├── eng-data-engineer/     # Pipelines ETL/ELT, Athena, MySQL, Metabase, contratos de dados
-│   │   ├── eng-scraper/           # Web scraping, Puppeteer, ETL
+│   │   ├── eng-data/              # Base neutra de dados (+ especializações em DATA_SPECIALIZATIONS)
+│   │   ├── eng-automation/           # Web scraping, Puppeteer, ETL
 │   │   ├── jarvis-init/
 │   │   ├── product-specs/
 │   │   ├── product-specs-update/
-│   │   ├── eng-qa-bug-report/
-│   │   ├── eng-qa-cypress-e2e/          # Testes E2E Cypress + TypeScript (Page Objects, data-testid, intercept)
-│   │   ├── eng-qa-dev-guide/            # Orienta devs a escreverem seus próprios testes Cypress
-│   │   ├── eng-qa-exploratory/          # Sessões de teste exploratório estruturadas
-│   │   ├── eng-qa-gate/
-│   │   ├── eng-qa-test-plan/
-│   │   ├── eng-qa-testsprite/
-│   │   ├── eng-qa-unit-test/
-│   │   ├── skill-creator/
-│   │   ├── taxonomy-manager/
-│   │   ├── workflow-creator/
+│   │   ├── eng-qa/                 # Base neutra de QA (+ especializações em QA_SPECIALIZATIONS)
+│   │   ├── eng-qa-planner/         # Planejamento de testes e análise de gaps de cobertura
 │   │   ├── 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
@@ -97,6 +78,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
 │
@@ -213,6 +196,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:
@@ -231,7 +216,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
@@ -287,62 +273,7 @@ Quando um agente atua em tema com skill correspondente, o skill e a fonte de ver
 
 ### Mapeamento
 
-| Comando/Workflow | Skill |
-|------------------|-------|
-| `/warm-up` | `jarvis-docs-central` (sync) |
-| `eng.start` | `jarvis-docs-central` (buscar PRD/ARD) |
-| `eng.docs` | `eng-global-docs-write`, `jarvis-docs-index` |
-| `eng.pre-pr` | `eng-qa-test-plan`, `eng-global-docs-write`, `jarvis-docs-central` (detectar docs) |
-| `eng.pr` | `eng-global-pr` (MR/PR via `VERSION_CONTROL`) |
-| 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` |
-| Arquitetura C4 | `eng-backend-arch-c4` |
-| 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` |
-| Micro frontend, Module Federation, shell/remote | `eng-frontend-microfrontend` (especialização de frontend) |
-| Design system, tokens, CVA, Storybook, versionamento | `eng-frontend-design-system` (especialização de frontend) |
-| Revisão de PR frontend (tipagem, a11y, tokens, itens da stack) | `eng.frontend-review` |
-| Auditoria de performance frontend (Core Web Vitals, pacote entregue) | `eng.frontend-perf-audit` |
-| Framework NestJS (módulos, DI, guards) | `eng-backend-nestjs` (especialização de backend) |
-| Web scraping, Puppeteer, ETL | `eng-scraper` |
-| Converter fluxo manual (produto/dev) em robô Playwright via Stagehand | `eng-scraper-robot-builder` |
-| Criar ou manter robô RPA (ciclo completo) | `eng.rpa.robot` |
-| Testes E2E em linguagem natural, fluxos de usuário, regressão de UI, smoke tests pós-deploy | `eng-qa-e2e` |
-| Gerar specs Cypress + TypeScript (Page Objects, data-testid, cy.intercept, fixtures) | `eng-qa-cypress-e2e` |
-| Sessão de teste exploratório (charter, roteiro de risco, achados, bug cards) | `eng-qa-exploratory` |
-| Orientar dev sobre cobertura de testes Cypress sem escrever o teste | `eng-qa-dev-guide` |
-| Consolidar sessões exploratórias, bugs e quality gates e gerar relatório de qualidade por sprint/release | `eng-qa-quality-report` |
-| 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` |
-| 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` |
-| Dashboards BI, queries SQL analíticas, compartilhamento com squads | `eng-data-bi` |
-| Diagnóstico de falhas em pipelines por camada (fonte→bronze→silver→gold) | `eng-data-debug` |
-| Onboarding de fonte nova: schema discovery, bronze, Expectation Suite, doc | `eng-data-onboard` |
-| Criar/manter DAGs, retry strategies, alertas, troubleshooting de orquestração | `eng-data-orchestrator` |
-| Documentação central (GitLab/GitHub/Bitbucket) | `jarvis-docs-central` |
-| Bug cross-service (HTTP + AMQP) | `eng-backend-microservices-trace` |
-| Auditoria de segurança OWASP, secrets, supply chain, headers, compliance | `eng-security-cybersecurity` |
-| Resposta a incidentes de segurança, CVEs, vulnerabilidades | `eng.security-incident` |
-| Review de segurança em PRs (gate pré-merge) | `eng.security-review` |
-| Pipeline defensivo completo: threat-model → audit → triage → patch (fluxo guiado) | `eng.security-pipeline` |
-| Produzir threat model estruturado do projeto (bootstrap/interview) | `eng-security-threat-model` |
-| Deduplicar, verificar com multi-voto e rankear achados de segurança | `eng-security-triage` |
-| Gerar diffs candidatos para achados confirmados de segurança (fechar o loop do triage) | `eng-security-patch` |
+Tabela completa de mapeamento comando/trigger → skill: ver `$IDE/skills/AGENTS.md`, seção "Mapeamento Comando → Skill".
 
 ---
 
@@ -358,39 +289,7 @@ Quando um agente atua em tema com skill correspondente, o skill e a fonte de ver
 
 ## 8) Agentes Disponiveis
 
-### Engenharia (Ativos)
-- `eng.agent.md` - Agente principal de engenharia
-- `eng.bug-hunter.md` - Caça e análise de bugs
-- `eng.dev-code-reviewer.md` - Revisao de codigo
-- `eng.docs-writer.md` - Documentacao tecnica
-- `eng.rpa.agent.md` - Automação e scraping RPA (ARACHNE) — robôs resilientes, análise de sistemas externos
-- `eng.frontend.agent.md` - Especialista frontend (neutro de stack): UI, estado, performance, a11y
-- `eng.ux-designer.agent.md` - Especialista UX/UI: auditoria heurística, fluxos, microcopy, arquitetura de informação
-- `eng.cybersecurity.agent.md` - Especialista em cybersecurity e AppSec (SENTINEL) — OWASP Top 10, secrets, supply chain, incident response
-
-### Data (Ativo)
-- `data/eng.data-engineer.agent.md` - Engenharia de dados: pipelines, contratos, qualidade (HEPHAESTUS)
-
-### QA (Ativos)
-- `eng.qa.test-planner.md` - Planejamento de testes
-- `eng.qa.testing-engineer.md` - Implementacao de testes
-- `eng.qa.test-architect.md` - Arquitetura de testes
-- `eng.qa.quality-champion-task-agent.md` - Qualidade de tickets
-- `eng.qa.cypress-specialist.md` - Page Objects, Custom Commands, CI, debugging de testes flaky
-- `eng.qa.quality-strategist.md` - Priorização de esforço QA, risco de feature, distribuição QA/dev
-
-### Produto (Ativo)
-- `prod.pm-checker.md` - Validacao de requisitos
-- `prod.discovery-interviewer.md` - Entrevistador de discovery: investiga uma ideia sem chutar e gera um rascunho estruturado
-
-### Arquivados
-Disponiveis em `$IDE/agents/archive/` organizados por categoria.
-Uso especializado quando necessário.
-
-**Categorias:**
-- Product WIP (5): prod.wip.collect, prod.wip.refine, prod.wip.spec.breakdown, etc.
-
-📖 **Ver detalhes:** `agents/archive/README.md` para lista completa e instruções de ativação.
+Lista completa de agentes: ver `$IDE/agents/README.md`.
 
 ---
 
@@ -404,6 +303,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

@@ -14,10 +14,9 @@ A pasta `agents/` contem **definicoes de agentes especializados** que atuam no f
 
 ```
 agents/
-├── engineering/           # Agentes ativos de engenharia (15 agents)
+├── engineering/           # Agentes ativos de engenharia (13 agents)
 │   ├── eng.agent.md
 │   ├── eng.bug-hunter.md
-│   ├── eng.cybersecurity.agent.md
 │   ├── eng.dev-code-reviewer.md
 │   ├── eng.docs-writer.md
 │   ├── eng.frontend.agent.md
@@ -25,20 +24,15 @@ agents/
 │   ├── eng.ux-designer.agent.md
 │   ├── data/              # Agentes de Data (1 agent)
 │   │   └── eng.data-engineer.agent.md
-│   └── qa/                # Agentes de QA (6 agents)
+│   └── qa/                # Agentes de QA (5 agents)
 │       ├── eng.qa.test-planner.md
 │       ├── eng.qa.testing-engineer.md
 │       ├── eng.qa.test-architect.md
 │       ├── eng.qa.quality-champion-task-agent.md
-│       ├── eng.qa.cypress-specialist.md
 │       └── eng.qa.quality-strategist.md
-├── product/               # Agentes ativos de produto (2 agents)
-│   ├── prod.pm-checker.md
-│   └── prod.discovery-interviewer.md
-└── archive/              # Biblioteca de agentes arquivados (9 agents)
-    ├── architecture-design/  # 2 agents
-    ├── implementation/       # 2 agents
-    └── product/              # 5 agents
+└── product/               # Agentes ativos de produto (2 agents)
+    ├── prod.pm-checker.md
+    └── prod.discovery-interviewer.md
 ```
 
 ---
@@ -50,7 +44,7 @@ agents/
 | Engenharia | `eng.{componente}.md` | `eng.agent.md`, `eng.docs-writer.md` |
 | QA | `eng.qa.{componente}.md` | `eng.qa.test-planner.md` |
 | Produto | `prod.{componente}.md` | `prod.pm-checker.md` |
-| Generico | `{nome-descritivo}.md` | `backend-architect.md` |
+| Generico | `{nome-descritivo}.md` | `meu-agente-customizado.md` |
 
 ---
 
@@ -65,7 +59,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 +85,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
 ...
 ```
@@ -122,7 +124,7 @@ Descricao curta do agente.
 
 ```bash
 @eng.qa.test-planner "analisar cobertura"
-@backend-architect "design de API"
+@eng.data-engineer "design de contrato de dados"
 @eng.dev-code-reviewer "revisar PR #123"
 ```
 
@@ -174,27 +176,21 @@ ENABLE_CDD=true
 
 ---
 
-## Agentes Ativos vs Arquivados
+## Agentes Ativos
 
-### Ativos (em uso regular)
-- `engineering/` - Agentes de engenharia (15 agents: 8 main + 6 QA + 1 Data)
+- `engineering/` - Agentes de engenharia (14 agents: 8 main + 5 QA + 1 Data)
 - `product/` - Agentes de produto (2 agents)
 
-### Arquivados (biblioteca de referência)
-- `archive/` - Agentes genéricos organizados por área funcional (11 agents)
-- Podem ser ativados manualmente quando necessário
-- Servem como referência para criar novos agentes
-
 ---
 
 ## Fluxo de Trabalho Tipico
 
 ```
 1. ARQUITETURA
-   └─> @backend-architect, @frontend-architect
+   └─> @eng.agent coordena
 
 2. IMPLEMENTACAO
-   └─> @backend-python-specialist, @react-developer
+   └─> @eng.agent, @eng.frontend.agent (se a feature envolver UI)
 
 3. TESTES
    └─> @eng.qa.test-planner, @eng.qa.testing-engineer

package/agents/README.md

@@ -1,9 +1,6 @@
 # README
 
-Este diretório contém **agentes especializados** organizados por domínio.
-
-**Agentes ativos:** Usados automaticamente pelos workflows
-**Agentes arquivados:** Disponíveis para uso especializado quando necessário
+Este diretório contém **agentes especializados** organizados por domínio, usados automaticamente pelos workflows.
 
 ---
 
@@ -11,7 +8,7 @@ Este diretório contém **agentes especializados** organizados por domínio.
 
 ```
 agents/
-├── engineering/                  # ⚙️ Agentes do domínio de Engenharia (ATIVOS)
+├── engineering/                  # ⚙️ Agentes do domínio de Engenharia
 │   ├── eng.agent.md              # Agent principal de engenharia
 │   ├── eng.bug-hunter.md         # Caça e análise de bugs
 │   ├── eng.dev-code-reviewer.md  # Code reviewer
@@ -21,24 +18,19 @@ agents/
 │   ├── eng.ux-designer.agent.md  # Especialista UX/UI: heurísticas, jornada, microcopy
 │   ├── data/                     # Data Engineering (1 agent)
 │   │   └── eng.data-engineer.agent.md
-│   └── qa/                       # QA específico de engenharia (6 agents)
-├── product/                      # 🎯 Agentes do domínio de Produto (ATIVOS)
-│   ├── prod.pm-checker.md        # Product Manager checker
-│   └── prod.discovery-interviewer.md  # Entrevistador de discovery
-└── archive/                      # 📦 Biblioteca de agentes arquivados
-    └── product/                  # Product WIP (5)
+│   └── qa/                       # QA específico de engenharia (5 agents)
+└── product/                      # 🎯 Agentes do domínio de Produto
+    ├── prod.pm-checker.md        # Product Manager checker
+    └── prod.discovery-interviewer.md  # Entrevistador de discovery
 ```
 
-**📊 Total:**
-- **17 agents ativos** (prontos para uso)
-  - Engineering main: 8 (6 main + 1 data + subpasta qa)
-  - QA: 6
-  - Product: 2
-- **5 agents arquivados** (uso especializado quando necessário)
+**📊 Total: 16 agents**
+- Engineering: 14 (8 main + 1 data + 5 QA)
+- Product: 2
 
 ---
 
-## ⚙️ 1. Engenharia (15 agents)
+## ⚙️ 1. Engenharia (14 agents)
 
 **Pasta**: `engineering/`
 
@@ -52,7 +44,6 @@ Agentes específicos para fluxos e regras do domínio de Engenharia.
 - `eng.rpa.agent.md` - `@eng.rpa` - Automação e scraping RPA (ARACHNE)
 - `eng.frontend.agent.md` - `@eng.frontend` - Especialista frontend (neutro de stack): UI, estado, performance, a11y
 - `eng.ux-designer.agent.md` - `@eng.ux-designer` - Especialista UX/UI: heurísticas Nielsen, jornada, microcopy
-- `eng.cybersecurity.agent.md` - `@eng.cybersecurity` - Especialista em cybersecurity e AppSec (SENTINEL): OWASP Top 10, secrets, supply chain, incident response
 
 
 ### Data Agents (1)
@@ -60,14 +51,13 @@ Agentes específicos para fluxos e regras do domínio de Engenharia.
 
 - `eng.data-engineer.agent.md` - `@eng.data-engineer` - Pipelines ETL/ELT, contratos de dados, qualidade (HEPHAESTUS)
 
-### QA Agents (6)
+### QA Agents (5)
 **Subpasta**: `engineering/qa/`
 
 - `eng.qa.quality-champion-task-agent.md` - `@eng.qa.quality-champion-task-agent`
 - `eng.qa.test-planner.md` - `@eng.qa.test-planner`
-- `eng.qa.testing-engineer.md` - `@eng.qa.testing-engineer` _(stack primária: Cypress + TypeScript)_
+- `eng.qa.testing-engineer.md` - `@eng.qa.testing-engineer` _(stack primária: Cypress + TypeScript — inclui domínio e debugging Cypress)_
 - `eng.qa.test-architect.md` - `@eng.qa.test-architect`
-- `eng.qa.cypress-specialist.md` - `@eng.qa.cypress-specialist` — Page Objects, Custom Commands, CI, debugging
 - `eng.qa.quality-strategist.md` - `@eng.qa.quality-strategist` — priorização de esforço, risco de feature, distribuição QA/dev
 
 ---
@@ -83,57 +73,16 @@ Agentes específicos para fluxos e validações do domínio de Produto.
 
 ---
 
-## 📦 3. Agentes Arquivados
-
-**Pasta**: `archive/`
-
-**Total:** 9 agentes especializados para uso quando necessário
-
-⚠️ **Importante:** Estes agentes estão **desativados por padrão** para simplificar o onboarding.
-
-**Quando usar:**
-- ✅ Caso de uso específico e bem definido
-- ✅ Necessidade de especialização profunda
-- ✅ Agents ativos não cobrem a necessidade
-
-**📖 [Ver guia completo →](archive/README.md)**
-
-### Categorias disponíveis:
-
-| Categoria | Agents | Exemplos |
-|-----------|--------|----------|
-| 🏗️ **Arquitetura & Design** | 2 | frontend-architect, ux-ui-design-expert |
-| 💻 **Implementação** | 2 | react-developer, frontend-react-specialist |
-| 🎯 **Produto WIP** | 5 | prod.wip.collect, prod.wip.refine, prod.wip.spec.breakdown, etc. |
-
-**Como ativar:** Ver `archive/README.md` para instruções detalhadas
-
----
-
 ## 📊 Distribuição dos Agentes
 
-### Agentes Ativos (9)
-
 | Domínio | Agentes | Uso |
 |---------|---------|-----|
-| ⚙️ **Engineering** | 4 | Agent principal, bug hunter, code review, docs |
-| 🧪 **QA** (sub-eng) | 6 | Test planning, testing, quality gate, Cypress specialist, quality strategist |
+| ⚙️ **Engineering** (main) | 7 | Agent principal, bug hunter, code review, docs, RPA, frontend, UX |
+| 🧪 **QA** (sub-eng) | 5 | Test planning, testing (+Cypress), test architect, quality champion, quality strategist |
 | 📊 **Data** (sub-eng) | 1 | Pipelines, contratos de dados, qualidade |
-| 🎯 **Product** | 1 | PM checker |
-
-**Total ativos:** 13 agents
-
-### Agentes Arquivados (9)
+| 🎯 **Product** | 2 | PM checker, discovery interviewer |
 
-| Categoria | Agentes | Quando usar |
-|-----------|---------|-------------|
-| 🏗️ **Arquitetura** | 2 | Frontend architecture, UX/UI design |
-| 💻 **Implementação** | 2 | React especializado |
-| 🎯 **Produto WIP** | 5 | Product workflows em desenvolvimento |
-
-**Total arquivados:** 9 agents
-
-**📖 Detalhes completos:** `archive/README.md`
+**Total: 15 agents**
 
 ---
 
@@ -149,20 +98,14 @@ Quando um agente estiver atuando em um tema que possui skill correspondente, ele
 ### Mapeamento recomendado (Workflows/Comandos → Skills)
 
 - **eng.docs** → `eng-global-docs-write` (principal) e `jarvis-docs-index` (quando houver índice).
-- **eng.pre-pr** → `eng-qa-test-plan` (cobertura) e `eng-global-docs-write` (docs).
+- **eng.pre-pr** → `eng-qa-planner` (cobertura) e `eng-global-docs-write` (docs).
 - **eng.pr** → `eng-global-pr`.
-- **qa-quality-gate-validation** → `eng-qa-gate`.
-- **Sessão de teste exploratório (charter, risco, achados, bug cards)** → `eng-qa-exploratory`.
-- **Gerar specs Cypress + TypeScript (Page Objects, data-testid, intercept)** → `eng-qa-cypress-e2e`.
-- **Orientar dev sobre cobertura Cypress sem escrever o teste** → `eng-qa-dev-guide`.
-- **Consolidar sessões, bugs e quality gates e gerar relatório de qualidade por período** → `eng-qa-quality-report`.
+- **Estratégia de testes, design de casos, automação, não funcionais, E2E, gestão de defeitos** → `eng-qa` (base) + `QA_SPECIALIZATIONS`.
 - **APIs, auth, workers, filas, caching, banco de dados** → regra `eng.specializations-rules.md` (área backend: `eng-backend` + `BACKEND_SPECIALIZATIONS`).
 - **Componentes, UI, estado, estilos, performance, acessibilidade** → regra `eng.specializations-rules.md` (área frontend: `eng-frontend` + `FRONTEND_SPECIALIZATIONS`).
-- **Web scraping, Puppeteer, extração de dados, ETL** → `eng-scraper`.
-- **Converter fluxo manual (produto/dev) em robô Playwright via Stagehand** → `eng-scraper-robot-builder`.
+- **RPA, web scraping, Puppeteer, extração de dados, ETL** → `eng-automation` (base) + `AUTOMATION_SPECIALIZATIONS`.
 - **Criar ou manter robô RPA** → `eng.rpa.robot new|update {card}` (workflow).
-- **Testes E2E em linguagem natural, fluxos de usuário, smoke tests pós-deploy** → `eng-qa-e2e`.
-- **Pipelines de dados, ETL/ELT, Glue, Airflow, Athena, bronze/silver/gold, contratos de dados, Great Expectations** → `eng-data-engineer`.
+- **Pipelines de dados, modelagem, qualidade, BI/dashboards, governança, onboarding de fonte, orquestração** → `eng-data` (base) + `DATA_SPECIALIZATIONS`.
 
 ### Ativação Automática (Agents Ativos)
 
@@ -175,27 +118,7 @@ Os agentes ativos ativam automaticamente baseado no contexto dos workflows:
 
 # Exemplo: /eng.pre-pr ativa múltiplos agentes de qualidade
 /eng.pre-pr JIRA-123
-# → @eng.dev-code-reviewer, @eng.qa.test-planner, @eng.docs-writer
-
-# Exemplo: /eng-qa-gate ativa agentes de QA
-/eng-qa-gate
-# → @eng.qa.quality-champion-task-agent valida qualidade
-```
-
-### Uso de Agents Arquivados
-
-Agents arquivados precisam ser invocados explicitamente:
-
-```bash
-# Opção 1: Invocar pontualmente
-"Use o agent backend-architect (agents/archive/architecture-design/backend-architect.md)
-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
+# → @eng.dev-code-reviewer, @eng.qa.test-planner (base eng-qa), @eng.docs-writer
 ```
 
 ### Invocação Manual
@@ -207,10 +130,9 @@ Você também pode invocar agentes manualmente usando `@`:
 @eng.qa.test-planner "analisar cobertura de testes da branch"
 
 # Múltiplos agentes em paralelo
-@backend-architect @database-architect "design de API para sistema multi-tenant"
+@eng.frontend.agent @eng.ux-designer.agent "revisar fluxo de checkout"
 
 # Agentes especializados
-@lovable-frontend-prompt-generator
 @eng.qa.testing-engineer
 ```
 
@@ -223,7 +145,7 @@ Você também pode invocar agentes manualmente usando `@`:
    └─> /eng.start, /eng.plan → @eng.agent coordena
 
 2. 💻 IMPLEMENTAÇÃO
-   └─> /eng.work → @eng.agent (+ @react-developer se archived ativado)
+   └─> /eng.work → @eng.agent
 
 3. 🧪 TESTES
    └─> @eng.qa.test-planner, @eng.qa.testing-engineer, @eng.qa.test-architect
@@ -277,31 +199,5 @@ Você também pode invocar agentes manualmente usando `@`:
 
 ---
 
----
-
-## 🎯 Recomendação de Uso
-
-### Para times PEQUENOS (< 5 devs):
-```
-✅ Use apenas agents ativos (9 agents)
-❌ Mantenha arquivados sem ativar
-```
-
-### Para times MÉDIOS (5-15 devs):
-```
-✅ Use agents ativos
-⚠️  Ative 1-2 agents arquivados SE necessário
-```
-
-### Para times GRANDES (> 15 devs):
-```
-✅ Use agents ativos
-✅ Ative agents arquivados por especialização/squad
-```
-
----
-
-**Última atualização**: 2026-04-26
-**Agents ativos:** 13 (Engineering: 5 main + 6 QA + 1 Data, Product: 1)
-**Agents arquivados:** 9 (Architecture: 2, Implementation: 2, Product WIP: 5)
-**Total:** 22 agents
+**Última atualização**: 2026-10-04
+**Agents ativos:** 16 (Engineering: 8 main + 5 QA + 1 Data, Product: 2)