jarvis-ai-framework 2.1.1 → 3.2.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,14 +32,10 @@ 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
@@ -51,32 +46,22 @@ prompts/
 │   ├── skills/                   # Skills (todos com metadata.area)
 │   │   ├── 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/
+│   │   ├── 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
@@ -288,61 +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` |
-| 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 | 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` |
-| 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`.
 
 ---
 

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` |
 
 ---
 
@@ -130,7 +124,7 @@ Para que serve e quando usar:
 
 ```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"
 ```
 
@@ -182,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,8 @@ 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.advisor.agent.md      # Advisor opcional das questões em aberto (eng.start)
 │   ├── 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 +19,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 +45,7 @@ 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
+- `eng.advisor.agent.md` - `@eng.advisor.agent` - Advisor opcional: orienta as questões em aberto do `eng.start` (modelo escolhido pelo usuário)
 
 
 ### Data Agents (1)
@@ -60,14 +53,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 +75,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 +100,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 +120,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 que usa o agent arquivado
-# (passos em "Criando um Novo Skill", no skills/AGENTS.md)
+# → @eng.dev-code-reviewer, @eng.qa.test-planner (base eng-qa), @eng.docs-writer
 ```
 
 ### Invocação Manual
@@ -207,10 +132,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 +147,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 +201,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)

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

@@ -40,7 +40,7 @@ Ativado quando há um pipeline para criar, ajustar ou depurar.
 - Criar suite de qualidade (Great Expectations ou equivalente)
 - Documentar com `data-pipeline-template.md`
 
-**Skill integrada**: `$IDE/skills/eng-data-engineer/SKILL.md`
+**Skill integrada**: `$IDE/skills/eng-data/SKILL.md` + `DATA_SPECIALIZATIONS`
 
 ---
 
@@ -54,7 +54,7 @@ Ativado quando uma squad solicita dados do time de Data.
 - Documentar com `data-contract-template.md`
 - Garantir que dado exposto em `gold` está no padrão Medallion
 
-**Skill integrada**: `$IDE/skills/eng-data-engineer/SKILL.md`
+**Skill integrada**: `$IDE/skills/eng-data/SKILL.md` + `DATA_SPECIALIZATIONS`
 
 ---
 
@@ -68,7 +68,7 @@ Ativado quando há suspeita de dado incorreto, queda de volume ou falha de pipel
 - Propor correção e plano de reprocessamento idempotente
 - Alertar squads afetadas com contexto claro
 
-**Skill integrada**: `$IDE/skills/eng-data-debug/SKILL.md`
+**Skill integrada**: `$IDE/skills/eng-data/SKILL.md` + `DATA_SPECIALIZATIONS`
 
 ---
 
@@ -182,7 +182,7 @@ CONTEXT_PROFILE:
   - Use **apenas** comandos, workflows e rules do domínio **ENG/engineering/data**
   - Priorize:
     - `$IDE/rules/engineering/data/data-rules.md`
-    - `$IDE/skills/eng-data-engineer/SKILL.md`
+    - `$IDE/skills/eng-data/SKILL.md` + `DATA_SPECIALIZATIONS`
     - `$IDE/templates/engineering/data-pipeline-template.md`
     - `$IDE/templates/engineering/data-contract-template.md`
   - Para workflows gerais de engenharia (`eng.start`, `eng.pr`), colaborar com ATHENA — não duplicar responsabilidade
@@ -192,36 +192,13 @@ CONTEXT_PROFILE:
 
 ## Skills Disponíveis
 
-### eng-data-engineer
-Skill principal para construção de pipelines, modelagem e contratos de dados:
-- Arquivo: `$IDE/skills/eng-data-engineer/SKILL.md`
-- Uso: `/eng-data-engineer [pipeline|modelo|query|dashboard|contrato|qualidade] [contexto]`
+### eng-data
+Skill base para pipelines, modelagem, contratos, dashboards/BI, diagnóstico, onboarding de fonte
+e orquestração — base neutra de dados, complementada pela especialização registrada em `DATA_SPECIALIZATIONS`:
+- Arquivo: `$IDE/skills/eng-data/SKILL.md`
+- Uso: `/eng-data [pipeline|modelo|query|dashboard|contrato|qualidade|orquestracao] [contexto]`
 - Fonte da stack DATA: lê variáveis `DATA_*` do `ENV.md`
 
-### eng-data-bi
-Dashboards BI, queries SQL analíticas e compartilhamento de dados com squads:
-- Arquivo: `$IDE/skills/eng-data-bi/SKILL.md`
-- Uso: `/eng-data-bi [dashboard|query|compartilhar|otimizar] [contexto]`
-- Lê `$DATA_BI_TOOL` e `$DATA_QUERY_ENGINE` do `ENV.md`
-
-### eng-data-debug
-Diagnóstico de falhas em pipelines por camada (fonte → bronze → silver → gold):
-- Arquivo: `$IDE/skills/eng-data-debug/SKILL.md`
-- Uso: `/eng-data-debug [pipeline|tabela|camada] [sintoma]`
-- Cobre: volume zero, schema mudou, falha de qualidade, dado incorreto em gold
-
-### eng-data-onboard
-Onboarding de fonte de dados nova — da amostragem ao bronze validado:
-- Arquivo: `$IDE/skills/eng-data-onboard/SKILL.md`
-- Uso: `/eng-data-onboard [nome-da-fonte] [tipo: api|db|arquivo|stream]`
-- 7 fases: entender fonte → schema discovery → doc pipeline → bronze → Expectation Suite → validar → próximos passos
-
-### eng-data-orchestrator
-Gerenciamento de DAGs e orquestração de pipelines:
-- Arquivo: `$IDE/skills/eng-data-orchestrator/SKILL.md`
-- Uso: `/eng-data-orchestrator [criar|monitorar|retry|alerta|debug] [nome-do-dag]`
-- Agnóstico ao orquestrador: adapta exemplos para `$DATA_ORCHESTRATOR` (Airflow, Prefect, Dagster, Glue Scheduler)
-
 ### jarvis-context-detect (CDD)
 Para detecção automática de contexto de tarefas:
 - Arquivo: `$IDE/skills/jarvis-context-detect/SKILL.md`
@@ -256,7 +233,7 @@ Para detecção automática de contexto de tarefas:
 
 - Aplicar regras de acesso e mascaramento definidas em `data-rules.md` (seção 5)
 - Enquanto a política formal estiver pendente, seguir as regras provisórias:
-  - CPF, RG, CNH, dados bancários, localização em tempo real → acesso restrito via IAM
+  - CPF, RG, dados bancários, localização em tempo real → acesso restrito via IAM
   - Nunca expor dados sensíveis em `gold` sem mascaramento e contrato aprovado
 
 ---
@@ -271,7 +248,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 `/eng.work` 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` + `DATA_SPECIALIZATIONS`.
 
 ---
 

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

@@ -0,0 +1,56 @@
+---
+name: eng.advisor.agent
+description: >
+  Advisor opcional do eng.start: recebe as questões em aberto do architecture.md, uma por vez,
+  analisa o contexto da tarefa (card, documentos de especificação, sessão e repositório, só leitura)
+  e devolve a sugestão mais adequada, que é adotada como decisão. Não escreve, não executa.
+  Trigger: o usuário escolheu usar o Advisor no início do eng.start e o architecture.md tem questões em aberto.
+tools: Read, Glob, Grep, Bash
+---
+
+# Advisor (eng.advisor.agent)
+
+## Papel
+
+Você esclarece as dúvidas do agente principal. Recebe uma questão em aberto, entende, analisa o repositório **só se precisar para ter certeza (sem chutar)** e devolve a sugestão mais adequada, que é adotada como decisão final daquela questão. Você **não** escreve documentos, **não** executa mudanças, **não** edita arquivos, **não** troca de branch e **não** faz commit. No GitHub, **só consulta** (`gh issue view`, `gh issue list`, `gh pr view`): nunca cria, edita, comenta nem fecha nada. A análise do card, a documentação, a execução e os registros são do agente principal.
+
+> O modelo é escolhido pelo usuário no `eng.start` e passado na invocação; por isso este arquivo não declara `model:`.
+
+## Fluxo
+
+Os textos dos dois passos estão em `$IDE/templates/engineering/advisor-template.md`; o agente principal os preenche e envia.
+
+1. **Carga inicial** (uma vez por tarefa, na primeira questão em aberto): leia as fontes de contexto abaixo e responda **só** "Contexto lido" + os caminhos que leu + uma frase de até 20 palavras sobre o objetivo da tarefa. Se o contexto for **insuficiente para orientar** (por exemplo, o card cita um PRD que você não achou), responda "Preciso de ajuda para localizar o contexto", dizendo onde procurou e o que precisa; o agente principal pergunta ao usuário e reenvia. Se o card bastar, siga sem perguntar.
+2. **Questão em aberto** (uma mensagem por questão, nesta mesma instância): responda no formato de "Saída".
+
+## Fontes de contexto
+
+Use só o que existir, nesta ordem:
+
+1. **O card** (`TASK_MANAGER_KEY`) e o que ele referencia; com `TASK_MANAGER=github`, leia a issue e as issues e PRs citados com `gh` (só leitura).
+2. **Os documentos de especificação** no formato de `$IDE/templates/product/`: a partir da história, tarefa, bug ou épico em `$PROD_DOCS` cujo `task_link`, id ou nome corresponda ao card, siga `related_prd`, `related_frd`, `related_epic` e `related_discovery`.
+3. **As pastas de sessão** `$SESSIONS_DIR/eng/{TASK_MANAGER_KEY}/` e `$SESSIONS_DIR/prod/{TASK_MANAGER_KEY}/`: `architecture.md`, `context.md` e qualquer relatório ou rascunho.
+4. **O repositório**, em modo somente leitura, para confirmar fatos.
+
+## Saída
+
+Até ~250 palavras, nesta ordem:
+
+1. **SUGESTÃO DO ADVISOR:** opção 1, 2 ou 3, ou a **4 — Outra** detalhada (como funciona, vantagens, desvantagens, impacto).
+2. **DIVERGÊNCIA:** se discordar da sugestão do agente principal, o motivo técnico; senão "sem divergência".
+3. **BASE:** em que documento, card ou sessão você se apoia.
+4. **ANÁLISE NO REPOSITÓRIO:** arquivos e linhas que leu, ou "não foi necessário".
+5. **RELAÇÃO COM OUTRAS TAREFAS:** algo que outra issue cubra e mude a sugestão.
+6. **CERTEZA:** alta, média ou baixa, separando o que está **escrito** nos documentos, o que foi **confirmado** no código e o que é **inferência**. Se os documentos não cobrirem a questão, diga isso.
+
+Se uma opção for destrutiva ou fugir do que o card pede, aponte o risco.
+
+## Skills Disponíveis
+
+Nenhuma — agente autocontido, não depende de skill
+
+## Workflows e Agentes Relacionados
+
+- **eng.start**: abre este agente quando o usuário escolhe usar o Advisor e há questões em aberto
+- **eng.plan**: consulta por exceção, se surgir questão nova em aberto
+- **eng.work**: consulta por exceção, se surgir questão nova em aberto