jarvis-ai-framework 1.0.3 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +66 -64
- package/README.md +24 -10
- package/agents/AGENTS.md +12 -8
- package/agents/README.md +14 -16
- package/agents/engineering/data/eng.data-engineer.agent.md +6 -6
- package/agents/engineering/eng.agent.md +19 -36
- package/agents/engineering/eng.bug-hunter.md +13 -12
- package/agents/engineering/eng.cybersecurity.agent.md +20 -35
- package/agents/engineering/eng.docs-writer.md +2 -2
- package/agents/engineering/eng.frontend.agent.md +17 -22
- package/agents/engineering/eng.rpa.agent.md +5 -15
- package/agents/engineering/qa/eng.qa.test-architect.md +4 -4
- package/agents/engineering/qa/eng.qa.test-planner.md +3 -3
- package/agents/engineering/qa/eng.qa.testing-engineer.md +3 -3
- package/agents/product/prod.discovery-interviewer.md +86 -0
- package/bin/commands/init.js +6 -6
- package/bin/jarvis.js +1 -1
- package/bin/lib/config/constants.js +47 -0
- package/bin/lib/core/sync-engine.js +12 -0
- package/package.json +2 -5
- package/rules/AGENTS.md +6 -4
- package/rules/engineering/eng-rules.md +5 -3
- package/rules/engineering/eng-security-rules.md +4 -4
- package/rules/engineering/eng.breakdown-subtasks-rules.md +208 -37
- package/rules/engineering/eng.docs-scraping-rules.md +1 -1
- package/rules/engineering/eng.downstream-flow-rules.md +1 -1
- package/rules/engineering/eng.integrations-rules.md +2 -2
- package/rules/engineering/eng.pre-pr-rules.md +1 -1
- package/rules/engineering/eng.skills-rules.md +60 -0
- package/rules/engineering/eng.specializations-rules.md +69 -0
- package/rules/engineering/eng.start-rules.md +11 -11
- package/rules/engineering/eng.work-rules.md +19 -14
- package/rules/engineering/frontend/eng.frontend-rules.md +70 -69
- package/rules/product/README.md +2 -0
- package/rules/product/prod-rules.md +7 -5
- package/{skills/prod-specs/rules/prod-spec-rules.md → rules/product/prod.spec-rules.md} +55 -50
- package/skills/AGENTS.md +111 -47
- package/skills/SKILLS-ROADMAP.md +26 -45
- package/skills/eng-ai-engineer/SKILL.md +1 -0
- package/skills/eng-backend/SKILL.md +142 -644
- package/skills/eng-backend/references/1-fundamentos-programacao.md +41 -0
- package/skills/eng-backend/references/10-seguranca.md +61 -0
- package/skills/eng-backend/references/11-performance.md +49 -0
- package/skills/eng-backend/references/12-erros-logging.md +42 -0
- package/skills/eng-backend/references/13-qualidade-codigo.md +51 -0
- package/skills/eng-backend/references/2-design-arquitetura.md +48 -0
- package/skills/eng-backend/references/3-design-patterns.md +50 -0
- package/skills/eng-backend/references/4-algoritmos-estruturas.md +43 -0
- package/skills/eng-backend/references/5-banco-dados.md +53 -0
- package/skills/eng-backend/references/6-api-comunicacao.md +42 -0
- package/skills/eng-backend/references/7-concorrencia-async.md +49 -0
- package/skills/eng-backend/references/8-arquitetura-servidor.md +49 -0
- package/skills/eng-backend/references/9-testes.md +43 -0
- package/skills/{eng-arch-c4 → eng-backend-arch-c4}/SKILL.md +12 -7
- package/skills/{eng-ms-trace → eng-backend-microservices-trace}/SKILL.md +6 -4
- package/skills/{eng-nestjs → eng-backend-nestjs}/SKILL.md +3 -1
- package/skills/{eng-rabbitmq → eng-backend-rabbitmq}/SKILL.md +3 -1
- package/skills/eng-data-bi/SKILL.md +1 -0
- package/skills/eng-data-debug/SKILL.md +2 -1
- package/skills/eng-data-engineer/SKILL.md +1 -0
- package/skills/eng-data-onboard/SKILL.md +1 -0
- package/skills/eng-data-orchestrator/SKILL.md +1 -0
- package/skills/{eng-performance-engineer → eng-devops-performance-engineer}/SKILL.md +2 -1
- package/skills/eng-frontend/SKILL.md +145 -782
- package/skills/eng-frontend/references/1-fundamentos-programacao.md +37 -0
- package/skills/eng-frontend/references/10-testes.md +47 -0
- package/skills/eng-frontend/references/11-seguranca.md +56 -0
- package/skills/eng-frontend/references/12-qualidade-codigo.md +51 -0
- package/skills/eng-frontend/references/2-html-fundamentals.md +51 -0
- package/skills/eng-frontend/references/3-css-responsive.md +61 -0
- package/skills/eng-frontend/references/4-javascript-dom.md +60 -0
- package/skills/eng-frontend/references/5-state-management.md +55 -0
- package/skills/eng-frontend/references/6-uiux-design.md +59 -0
- package/skills/eng-frontend/references/7-acessibilidade.md +46 -0
- package/skills/eng-frontend/references/8-performance.md +58 -0
- package/skills/eng-frontend/references/9-browser-apis.md +54 -0
- package/skills/{eng-design-system → eng-frontend-design-system}/SKILL.md +4 -2
- package/skills/{eng-microfrontend → eng-frontend-microfrontend}/SKILL.md +4 -2
- package/skills/{eng-browser-extension-builder → eng-global-browser-extension-builder}/SKILL.md +2 -1
- package/skills/{eng-docs-write → eng-global-docs-write}/SKILL.md +8 -4
- package/skills/eng-global-jira-comment/SKILL.md +21 -0
- package/skills/{eng-pr → eng-global-pr}/SKILL.md +7 -3
- package/skills/{eng-task-comment → eng-global-task-comment}/SKILL.md +6 -2
- package/skills/eng-qa-a11y-audit/SKILL.md +1 -0
- package/skills/eng-qa-bug-report/SKILL.md +2 -1
- package/skills/eng-qa-bug-report/TASK_MANAGERS.md +1 -1
- package/skills/eng-qa-cypress-e2e/SKILL.md +1 -0
- package/skills/eng-qa-dev-guide/SKILL.md +1 -0
- package/skills/eng-qa-e2e/SKILL.md +1 -0
- package/skills/eng-qa-e2e-spec-writer/SKILL.md +1 -0
- package/skills/eng-qa-exploratory/SKILL.md +1 -0
- package/skills/eng-qa-gate/SKILL.md +3 -2
- package/skills/eng-qa-graphql-contract/SKILL.md +1 -0
- package/skills/eng-qa-quality-report/SKILL.md +3 -2
- package/skills/eng-qa-test-plan/SKILL.md +1 -0
- package/skills/eng-qa-testsprite/SKILL.md +2 -1
- package/skills/eng-qa-unit-test/SKILL.md +1 -0
- package/skills/eng-scraper/SKILL.md +1 -0
- package/skills/eng-scraper-robot-builder/SKILL.md +1 -0
- package/skills/{eng-cybersecurity → eng-security-cybersecurity}/SKILL.md +3 -2
- package/skills/eng-security-patch/SKILL.md +6 -2
- package/skills/{eng-threat-model → eng-security-threat-model}/SKILL.md +6 -2
- package/skills/eng-security-triage/SKILL.md +4 -0
- package/skills/{context-detect → jarvis-context-detect}/SKILL.md +6 -5
- package/skills/{context-detect → jarvis-context-detect}/assets/context-profile-template.md +3 -3
- package/skills/jarvis-create-specialization/SKILL.md +230 -0
- package/skills/jarvis-create-specialization/assets/referencia-template.md +39 -0
- package/skills/jarvis-create-specialization/assets/skill-especializacao-template.md +78 -0
- package/skills/{docs-central → jarvis-docs-central}/README.md +1 -1
- package/skills/{docs-central → jarvis-docs-central}/SKILL.md +3 -40
- package/skills/{docs-index → jarvis-docs-index}/SKILL.md +8 -4
- package/skills/{init-jarvis → jarvis-init}/SKILL.md +42 -19
- package/skills/{init-jarvis → jarvis-init}/assets/mcp-configs.md +3 -3
- package/skills/{init-jarvis → jarvis-init}/assets/onboarding-checklist.md +1 -1
- package/skills/jarvis-init/assets/passo-adicionar-stacks.md +163 -0
- package/skills/{init-jarvis → jarvis-init}/assets/setup-guide.md +1 -1
- package/skills/jarvis-init/assets/sinais-de-stack.md +54 -0
- package/skills/jarvis-list-specializations/SKILL.md +148 -0
- package/skills/{report-issue → jarvis-report-issue}/SKILL.md +3 -2
- package/skills/{prod-roadmap-report → product-roadmap-report}/SKILL.md +2 -1
- package/skills/product-specs/SKILL.md +45 -0
- package/skills/{prod-specs-update → product-specs-update}/SKILL.md +3 -2
- package/taxonomy.md +3 -21
- package/templates/AGENTS.md +7 -6
- package/templates/CDD aplicado a Prompts.md +5 -5
- package/templates/ENV-template.md +12 -9
- package/templates/engineering/AGENTS-template.md +1 -1
- package/templates/engineering/CONTACTS-template.md +1 -1
- package/templates/product/prod-discovery-template.md +98 -0
- package/{skills/prod-specs/templates → templates/product}/prod-epic-template.md +1 -0
- package/{skills/prod-specs/templates → templates/product}/prod-frd-template.md +1 -0
- package/{skills/prod-specs/templates → templates/product}/prod-issue-template.md +1 -0
- package/{skills/prod-specs/templates → templates/product}/prod-prd-template.md +1 -0
- package/workflows/AGENTS.md +3 -1
- package/workflows/README.md +2 -0
- package/workflows/engineering/eng.bug-audit.md +2 -2
- package/workflows/engineering/eng.build-tech-spec.md +38 -49
- package/workflows/engineering/eng.debug.md +10 -10
- package/workflows/engineering/eng.docs.md +2 -2
- package/workflows/engineering/eng.plan.md +5 -5
- package/workflows/engineering/eng.pr.md +8 -8
- package/workflows/engineering/eng.pre-pr.md +16 -20
- package/workflows/engineering/eng.review.md +5 -10
- package/workflows/engineering/eng.rpa.robot.md +3 -3
- package/workflows/engineering/eng.security-audit.md +5 -5
- package/workflows/engineering/eng.security-incident.md +2 -2
- package/workflows/engineering/eng.security-pipeline.md +2 -2
- package/workflows/engineering/eng.start.md +16 -50
- package/workflows/engineering/eng.work.md +9 -12
- package/workflows/engineering/frontend/eng.frontend-component.md +68 -96
- package/workflows/engineering/frontend/eng.frontend-perf-audit.md +90 -220
- package/workflows/engineering/frontend/eng.frontend-review.md +57 -63
- package/workflows/engineering/qa/eng.qa-quality-report.md +0 -5
- package/workflows/product/prod.roadmap.preview.md +2 -2
- package/workflows/product/prod.spec.breakdown.md +3 -8
- package/workflows/product/prod.spec.discovery.md +152 -0
- package/workflows/product/prod.spec.epic.md +3 -0
- package/workflows/product/prod.spec.frd.md +123 -8
- package/workflows/product/prod.spec.issue.md +3 -2
- package/workflows/product/prod.spec.md +2 -0
- package/workflows/product/prod.spec.prd.md +105 -6
- package/workflows/taxonomy.md +1 -1
- package/workflows/warm-up.md +5 -26
- package/agents/engineering/eng.tech-analyst.agent.md +0 -102
- package/skills/churn-audit/SKILL.md +0 -385
- package/skills/eng-jira-comment/SKILL.md +0 -17
- package/skills/eng-tech-analyst/SKILL.md +0 -529
- package/skills/lovable-prompt-generator/SKILL.md +0 -304
- package/skills/prod-specs/SKILL.md +0 -108
- package/skills/prod-specs/references/prod.spec.clarify.md +0 -176
- package/skills/prod-specs/references/prod.spec.epic.md +0 -107
- package/skills/prod-specs/references/prod.spec.frd.md +0 -135
- package/skills/prod-specs/references/prod.spec.issue.md +0 -145
- package/skills/prod-specs/references/prod.spec.prd.md +0 -118
- package/skills/prod-specs/templates/prod-prd-full-template.md +0 -159
- package/workflows/engineering/ta/eng.ta.atendimento.md +0 -93
- /package/skills/{eng-arch-c4 → eng-backend-arch-c4}/assets/example-code.md +0 -0
- /package/skills/{eng-arch-c4 → eng-backend-arch-c4}/assets/example-component.md +0 -0
- /package/skills/{eng-arch-c4 → eng-backend-arch-c4}/assets/example-container.md +0 -0
- /package/skills/{eng-arch-c4 → eng-backend-arch-c4}/assets/example-context.md +0 -0
- /package/skills/{prod-roadmap-report → product-roadmap-report}/README.md +0 -0
- /package/skills/{prod-roadmap-report → product-roadmap-report}/commands/status.compiled.single.team.md +0 -0
- /package/skills/{prod-roadmap-report → product-roadmap-report}/commands/status.list.projects.md +0 -0
- /package/skills/{prod-roadmap-report → product-roadmap-report}/commands/status.memory.md +0 -0
- /package/skills/{prod-roadmap-report → product-roadmap-report}/commands/status.roadmap.preview.md +0 -0
- /package/skills/{prod-roadmap-report → product-roadmap-report}/references/detailed-guide.md +0 -0
- /package/skills/{prod-roadmap-report → product-roadmap-report}/rules/detailed-guide.md +0 -0
- /package/skills/{prod-roadmap-report → product-roadmap-report}/rules/status-report-rules.md +0 -0
- /package/skills/{prod-roadmap-report → product-roadmap-report}/templates/template-multiple-teams-compiled-status.md +0 -0
- /package/skills/{prod-roadmap-report → product-roadmap-report}/templates/template-projects-list.md +0 -0
- /package/skills/{prod-roadmap-report → product-roadmap-report}/templates/template-single-team-compiled-status.md +0 -0
- /package/skills/{prod-roadmap-report → product-roadmap-report}/templates/template-single-team-status.md +0 -0
- /package/{skills/prod-specs/templates → templates/product}/prod-breakdown-template.md +0 -0
package/AGENTS.md
CHANGED
|
@@ -22,19 +22,21 @@ prompts/
|
|
|
22
22
|
│ ├── LEGACY_PROJECTS.md # Guia para projetos legados
|
|
23
23
|
│ │
|
|
24
24
|
│ ├── agents/ # 17 ativos + 5 arquivados
|
|
25
|
-
│ │ ├── engineering/ # Agentes de engenharia (
|
|
25
|
+
│ │ ├── engineering/ # Agentes de engenharia (15 ativos: 8 main + 6 QA + 1 Data)
|
|
26
26
|
│ │ │ ├── eng.agent.md
|
|
27
27
|
│ │ │ ├── eng.cybersecurity.agent.md # Cybersecurity e AppSec (SENTINEL)
|
|
28
28
|
│ │ │ ├── eng.bug-hunter.md
|
|
29
29
|
│ │ │ ├── eng.dev-code-reviewer.md
|
|
30
30
|
│ │ │ ├── eng.docs-writer.md
|
|
31
|
-
│ │ │ ├── eng.
|
|
31
|
+
│ │ │ ├── eng.frontend.agent.md
|
|
32
|
+
│ │ │ ├── eng.ux-designer.agent.md
|
|
32
33
|
│ │ │ ├── eng.rpa.agent.md # Agente RPA/Scraping (ARACHNE) — skill técnica
|
|
33
34
|
│ │ │ ├── data/ # 1 agente de Data
|
|
34
35
|
│ │ │ │ └── eng.data-engineer.agent.md
|
|
35
36
|
│ │ │ └── qa/ # 6 agentes de QA
|
|
36
|
-
│ │ ├── product/ # Agentes de produto (
|
|
37
|
-
│ │ │
|
|
37
|
+
│ │ ├── product/ # Agentes de produto (2 ativos)
|
|
38
|
+
│ │ │ ├── prod.pm-checker.md
|
|
39
|
+
│ │ │ └── prod.discovery-interviewer.md
|
|
38
40
|
│ │ └── archive/ # Agentes arquivados (uso especializado)
|
|
39
41
|
│ │ ├── architecture-design/ # 2 agentes
|
|
40
42
|
│ │ ├── implementation/ # 2 agentes
|
|
@@ -44,31 +46,30 @@ prompts/
|
|
|
44
46
|
│ │ ├── engineering/ # 25 workflows de engenharia
|
|
45
47
|
│ │ │ ├── data/ # 2 workflows de dados (data.new-pipeline, data.contract)
|
|
46
48
|
│ │ │ └── frontend/ # 3 workflows de frontend (component, review, perf-audit)
|
|
47
|
-
│ │ └── product/ #
|
|
49
|
+
│ │ └── product/ # 9 workflows de produto
|
|
48
50
|
│ │
|
|
49
|
-
│ ├── skills/ #
|
|
51
|
+
│ ├── skills/ # Skills (todos com metadata.area)
|
|
50
52
|
│ │ ├── claude-plugin-creator/
|
|
51
|
-
│ │ ├── context-detect/
|
|
52
|
-
│ │ ├── docs-index/
|
|
53
|
+
│ │ ├── jarvis-context-detect/
|
|
54
|
+
│ │ ├── jarvis-docs-index/
|
|
53
55
|
│ │ ├── eng-ai-engineer/
|
|
54
|
-
│ │ ├── eng-arch-c4/
|
|
55
|
-
│ │ ├── eng-backend/ #
|
|
56
|
-
│ │ ├── eng-
|
|
57
|
-
│ │ ├── eng-browser-extension-builder/
|
|
58
|
-
│ │ ├── eng-docs-write/
|
|
59
|
-
│ │ ├── eng-frontend/ #
|
|
60
|
-
│ │ ├── eng-microfrontend/ # Module Federation, shell/remote, contratos, event bus
|
|
61
|
-
│ │ ├── eng-design-system/ # Tokens, CVA, Storybook, versionamento, auditoria visual
|
|
62
|
-
│ │ ├── eng-nestjs/ # Framework NestJS: módulos, DI, guards, interceptors
|
|
63
|
-
│ │ ├── eng-performance-engineer/
|
|
64
|
-
│ │ ├── eng-pr/
|
|
65
|
-
│ │ ├── eng-rabbitmq/ # Mensageria RabbitMQ
|
|
56
|
+
│ │ ├── eng-backend-arch-c4/
|
|
57
|
+
│ │ ├── eng-backend/ # Base neutra de backend (+ especializações em BACKEND_SPECIALIZATIONS)
|
|
58
|
+
│ │ ├── eng-backend-microservices-trace/ # Rastreamento de bugs cross-service (HTTP + AMQP)
|
|
59
|
+
│ │ ├── eng-global-browser-extension-builder/
|
|
60
|
+
│ │ ├── eng-global-docs-write/
|
|
61
|
+
│ │ ├── eng-frontend/ # Base neutra de frontend (+ especializações em FRONTEND_SPECIALIZATIONS)
|
|
62
|
+
│ │ ├── eng-frontend-microfrontend/ # Module Federation, shell/remote, contratos, event bus
|
|
63
|
+
│ │ ├── eng-frontend-design-system/ # Tokens, CVA, Storybook, versionamento, auditoria visual
|
|
64
|
+
│ │ ├── eng-backend-nestjs/ # Framework NestJS: módulos, DI, guards, interceptors
|
|
65
|
+
│ │ ├── eng-devops-performance-engineer/
|
|
66
|
+
│ │ ├── eng-global-pr/
|
|
67
|
+
│ │ ├── eng-backend-rabbitmq/ # Mensageria RabbitMQ
|
|
66
68
|
│ │ ├── eng-data-engineer/ # Pipelines ETL/ELT, Athena, MySQL, Metabase, contratos de dados
|
|
67
69
|
│ │ ├── eng-scraper/ # Web scraping, Puppeteer, ETL
|
|
68
|
-
│ │ ├── init
|
|
69
|
-
│ │ ├──
|
|
70
|
-
│ │ ├──
|
|
71
|
-
│ │ ├── prod-specs-update/
|
|
70
|
+
│ │ ├── jarvis-init/
|
|
71
|
+
│ │ ├── product-specs/
|
|
72
|
+
│ │ ├── product-specs-update/
|
|
72
73
|
│ │ ├── eng-qa-bug-report/
|
|
73
74
|
│ │ ├── eng-qa-cypress-e2e/ # Testes E2E Cypress + TypeScript (Page Objects, data-testid, intercept)
|
|
74
75
|
│ │ ├── eng-qa-dev-guide/ # Orienta devs a escreverem seus próprios testes Cypress
|
|
@@ -80,14 +81,16 @@ prompts/
|
|
|
80
81
|
│ │ ├── skill-creator/
|
|
81
82
|
│ │ ├── taxonomy-manager/
|
|
82
83
|
│ │ ├── workflow-creator/
|
|
83
|
-
│ │ ├── report-issue/ # Auto-report de bugs no repo do Jarvis (GitLab/GitHub/Bitbucket)
|
|
84
|
-
│ │ ├── eng-task-comment/ # Comentário no card (Jira/Linear/GitHub/Asana)
|
|
85
|
-
│ │ ├──
|
|
84
|
+
│ │ ├── jarvis-report-issue/ # Auto-report de bugs no repo do Jarvis (GitLab/GitHub/Bitbucket)
|
|
85
|
+
│ │ ├── eng-global-task-comment/ # Comentário no card (Jira/Linear/GitHub/Asana)
|
|
86
|
+
│ │ ├── jarvis-list-specializations/ # Lista especializações de stack instaladas e registradas
|
|
87
|
+
│ │ ├── jarvis-create-specialization/ # Cria uma especialização de stack a partir do código do projeto e a registra
|
|
86
88
|
│ │
|
|
87
89
|
│ ├── templates/ # Templates de documentos
|
|
88
|
-
│ │
|
|
90
|
+
│ │ ├── engineering/ # ARD, RFC, Tech Spec
|
|
91
|
+
│ │ └── product/ # PRD, FRD, épico, issue, breakdown, discovery
|
|
89
92
|
│ │
|
|
90
|
-
│ ├── rules/ # Regras especificas (filtradas por perfil no init
|
|
93
|
+
│ ├── rules/ # Regras especificas (filtradas por perfil no jarvis-init)
|
|
91
94
|
│ │ ├── rtk-rules.md # RTK Token Killer (opt-in: RTK_ENABLED=true)
|
|
92
95
|
│ │ ├── engineering/ # eng-rules.md + eng-security-rules.md + rules com applies_to por HUB/POSITION/AREA/SQUAD
|
|
93
96
|
│ │ │ └── frontend/ # eng.frontend-rules.md (HUB: FRONTEND)
|
|
@@ -109,8 +112,8 @@ prompts/
|
|
|
109
112
|
|
|
110
113
|
### Pre-requisito: ENV.md
|
|
111
114
|
|
|
112
|
-
- Validar `$IDE/ENV.md` antes de qualquer comando; excecao: `/init
|
|
113
|
-
- Se nao existir ou estiver incompleto, orientar o usuario a executar `/init
|
|
115
|
+
- Validar `$IDE/ENV.md` antes de qualquer comando; excecao: `/jarvis-init`.
|
|
116
|
+
- Se nao existir ou estiver incompleto, orientar o usuario a executar `/jarvis-init`.
|
|
114
117
|
|
|
115
118
|
### Taxonomia Organizacional
|
|
116
119
|
|
|
@@ -120,10 +123,10 @@ O framework usa `taxonomy.md` (raiz) como fonte de verdade para opções válida
|
|
|
120
123
|
- **POSITIONS** - Cargos (JUNIOR, PLENO, SENIOR, TECH LEAD, etc.)
|
|
121
124
|
- **AREAS** - Áreas de negócio (ENGINEERING, PRODUCT)
|
|
122
125
|
|
|
123
|
-
**Relação com init
|
|
126
|
+
**Relação com jarvis-init:**
|
|
124
127
|
1. `taxonomy.md` define as opções válidas
|
|
125
|
-
2. `/init
|
|
126
|
-
3. Após modificar `taxonomy.md`, executar `/init
|
|
128
|
+
2. `/jarvis-init` LÊ `taxonomy.md` e cria `ENV.md` com essas opções
|
|
129
|
+
3. Após modificar `taxonomy.md`, executar `/jarvis-init` novamente para atualizar
|
|
127
130
|
|
|
128
131
|
**Gerenciamento via `/taxonomy`:**
|
|
129
132
|
```bash
|
|
@@ -252,7 +255,7 @@ Cada pasta pode ter seu proprio AGENTS.md com instrucoes especificas:
|
|
|
252
255
|
### Inicializacao
|
|
253
256
|
|
|
254
257
|
```bash
|
|
255
|
-
/init
|
|
258
|
+
/jarvis-init # Cria ENV.md lendo taxonomy.md (unico comando sem ENV.md); oferece o passo opcional de adicionar as stacks
|
|
256
259
|
/warm-up # Carrega contexto do projeto
|
|
257
260
|
```
|
|
258
261
|
|
|
@@ -261,7 +264,7 @@ Cada pasta pode ter seu proprio AGENTS.md com instrucoes especificas:
|
|
|
261
264
|
```bash
|
|
262
265
|
/eng.start "feature" # Investigacao e arquitetura (somente planejamento)
|
|
263
266
|
/eng.plan "feature" # Plano de execucao faseado (somente planejamento)
|
|
264
|
-
/eng.work "feature" # Implementacao e testes (sem
|
|
267
|
+
/eng.work "feature" # Implementacao e testes (commit por fase, sem push/PR)
|
|
265
268
|
/eng.pre-pr # Validacao pre-PR
|
|
266
269
|
/eng.pr # Cria branch, commit e PR
|
|
267
270
|
```
|
|
@@ -285,29 +288,30 @@ Quando um agente atua em tema com skill correspondente, o skill e a fonte de ver
|
|
|
285
288
|
|
|
286
289
|
| Comando/Workflow | Skill |
|
|
287
290
|
|------------------|-------|
|
|
288
|
-
| `/warm-up` | `docs-central` (sync) |
|
|
289
|
-
| `eng.start` | `docs-central` (buscar PRD/ARD) |
|
|
290
|
-
| `eng.docs` | `eng-docs-write`, `docs-index` |
|
|
291
|
-
| `eng.pre-pr` | `eng-qa-test-plan`, `eng-docs-write`, `docs-central` (detectar docs) |
|
|
292
|
-
| `eng.pr` | `eng-pr` (MR/PR via `VERSION_CONTROL`) |
|
|
293
|
-
| Comentário no card | `eng-task-comment` |
|
|
294
|
-
|
|
|
295
|
-
|
|
|
291
|
+
| `/warm-up` | `jarvis-docs-central` (sync) |
|
|
292
|
+
| `eng.start` | `jarvis-docs-central` (buscar PRD/ARD) |
|
|
293
|
+
| `eng.docs` | `eng-global-docs-write`, `jarvis-docs-index` |
|
|
294
|
+
| `eng.pre-pr` | `eng-qa-test-plan`, `eng-global-docs-write`, `jarvis-docs-central` (detectar docs) |
|
|
295
|
+
| `eng.pr` | `eng-global-pr` (MR/PR via `VERSION_CONTROL`) |
|
|
296
|
+
| Comentário no card | `eng-global-task-comment` |
|
|
297
|
+
| Listar especializações de stack (instaladas e registradas) | `jarvis-list-specializations` |
|
|
298
|
+
| Criar uma especialização de stack (backend ou frontend) a partir do código do projeto | `jarvis-create-specialization` |
|
|
299
|
+
| `jarvis docs sync` | `jarvis-docs-central` |
|
|
300
|
+
| `jarvis docs publish` | `jarvis-docs-central` |
|
|
296
301
|
| QA validation | `eng-qa-gate` |
|
|
297
|
-
| Arquitetura C4 | `eng-arch-c4` |
|
|
298
|
-
| Inicializacao | `init
|
|
302
|
+
| Arquitetura C4 | `eng-backend-arch-c4` |
|
|
303
|
+
| Inicializacao | `jarvis-init` |
|
|
299
304
|
| Testes unitarios | `eng-qa-unit-test` |
|
|
300
305
|
| Testes TestSprite | `eng-qa-testsprite` |
|
|
301
306
|
| Taxonomia | `taxonomy-manager` |
|
|
302
|
-
| Mensageria / RabbitMQ | `eng-rabbitmq` |
|
|
303
|
-
|
|
|
304
|
-
|
|
|
305
|
-
|
|
|
306
|
-
|
|
|
307
|
-
|
|
|
308
|
-
|
|
|
309
|
-
|
|
|
310
|
-
| Framework NestJS (módulos, DI, guards) | `eng-nestjs` |
|
|
307
|
+
| Mensageria / RabbitMQ | `eng-backend-rabbitmq` (especialização de backend) |
|
|
308
|
+
| APIs, auth, workers, caching | `eng-backend` (base) + `BACKEND_SPECIALIZATIONS` |
|
|
309
|
+
| Componentes, UI, frontend | `eng-frontend` (base) + `FRONTEND_SPECIALIZATIONS` |
|
|
310
|
+
| Micro frontend, Module Federation, shell/remote | `eng-frontend-microfrontend` (especialização de frontend) |
|
|
311
|
+
| Design system, tokens, CVA, Storybook, versionamento | `eng-frontend-design-system` (especialização de frontend) |
|
|
312
|
+
| Revisão de PR frontend (tipagem, a11y, tokens, itens da stack) | `eng.frontend-review` |
|
|
313
|
+
| Auditoria de performance frontend (Core Web Vitals, pacote entregue) | `eng.frontend-perf-audit` |
|
|
314
|
+
| Framework NestJS (módulos, DI, guards) | `eng-backend-nestjs` (especialização de backend) |
|
|
311
315
|
| Web scraping, Puppeteer, ETL | `eng-scraper` |
|
|
312
316
|
| Converter fluxo manual (produto/dev) em robô Playwright via Stagehand | `eng-scraper-robot-builder` |
|
|
313
317
|
| Criar ou manter robô RPA (ciclo completo) | `eng.rpa.robot` |
|
|
@@ -316,7 +320,6 @@ Quando um agente atua em tema com skill correspondente, o skill e a fonte de ver
|
|
|
316
320
|
| Sessão de teste exploratório (charter, roteiro de risco, achados, bug cards) | `eng-qa-exploratory` |
|
|
317
321
|
| Orientar dev sobre cobertura de testes Cypress sem escrever o teste | `eng-qa-dev-guide` |
|
|
318
322
|
| Consolidar sessões exploratórias, bugs e quality gates e gerar relatório de qualidade por sprint/release | `eng-qa-quality-report` |
|
|
319
|
-
| Análise de churn SaaS: coleta Slack, classificação por squad via taxonomy, relatório narrativo para liderança | `churn-audit` |
|
|
320
323
|
| Testes de acessibilidade WCAG 2.1 AA: integra jest-axe em testes unitários existentes | `eng-qa-a11y-audit` |
|
|
321
324
|
| Testes de contrato GraphQL: valida queries frontend contra schema do BFF | `eng-qa-graphql-contract` |
|
|
322
325
|
| Spec E2E para handoff: cenários, Page Objects, fixtures, intercepts, setup de ambiente | `eng-qa-e2e-spec-writer` |
|
|
@@ -329,14 +332,13 @@ Quando um agente atua em tema com skill correspondente, o skill e a fonte de ver
|
|
|
329
332
|
| Diagnóstico de falhas em pipelines por camada (fonte→bronze→silver→gold) | `eng-data-debug` |
|
|
330
333
|
| Onboarding de fonte nova: schema discovery, bronze, Expectation Suite, doc | `eng-data-onboard` |
|
|
331
334
|
| Criar/manter DAGs, retry strategies, alertas, troubleshooting de orquestração | `eng-data-orchestrator` |
|
|
332
|
-
| Documentação central (GitLab/GitHub/Bitbucket) | `docs-central` |
|
|
333
|
-
| Bug cross-service (HTTP + AMQP) | `eng-
|
|
334
|
-
|
|
|
335
|
-
| Auditoria de segurança OWASP, secrets, supply chain, headers, compliance | `eng-cybersecurity` |
|
|
335
|
+
| Documentação central (GitLab/GitHub/Bitbucket) | `jarvis-docs-central` |
|
|
336
|
+
| Bug cross-service (HTTP + AMQP) | `eng-backend-microservices-trace` |
|
|
337
|
+
| Auditoria de segurança OWASP, secrets, supply chain, headers, compliance | `eng-security-cybersecurity` |
|
|
336
338
|
| Resposta a incidentes de segurança, CVEs, vulnerabilidades | `eng.security-incident` |
|
|
337
339
|
| Review de segurança em PRs (gate pré-merge) | `eng.security-review` |
|
|
338
340
|
| Pipeline defensivo completo: threat-model → audit → triage → patch (fluxo guiado) | `eng.security-pipeline` |
|
|
339
|
-
| Produzir threat model estruturado do projeto (bootstrap/interview) | `eng-threat-model` |
|
|
341
|
+
| Produzir threat model estruturado do projeto (bootstrap/interview) | `eng-security-threat-model` |
|
|
340
342
|
| Deduplicar, verificar com multi-voto e rankear achados de segurança | `eng-security-triage` |
|
|
341
343
|
| Gerar diffs candidatos para achados confirmados de segurança (fechar o loop do triage) | `eng-security-patch` |
|
|
342
344
|
|
|
@@ -347,7 +349,7 @@ Quando um agente atua em tema com skill correspondente, o skill e a fonte de ver
|
|
|
347
349
|
| Fase | Comando | Restricao |
|
|
348
350
|
|------|---------|-----------|
|
|
349
351
|
| Planejamento | `eng.start`, `eng.plan` | Somente analise, sem codigo |
|
|
350
|
-
| Implementacao | `eng.work` | Codigo e testes, sem
|
|
352
|
+
| Implementacao | `eng.work` | Codigo e testes, commit por fase, sem push nem PR |
|
|
351
353
|
| Entrega | `eng.pr` | Branch, commit e PR |
|
|
352
354
|
|
|
353
355
|
---
|
|
@@ -359,9 +361,8 @@ Quando um agente atua em tema com skill correspondente, o skill e a fonte de ver
|
|
|
359
361
|
- `eng.bug-hunter.md` - Caça e análise de bugs
|
|
360
362
|
- `eng.dev-code-reviewer.md` - Revisao de codigo
|
|
361
363
|
- `eng.docs-writer.md` - Documentacao tecnica
|
|
362
|
-
- `eng.tech-analyst.agent.md` - Triagem e diagnóstico de chamados N2, escalonamento
|
|
363
364
|
- `eng.rpa.agent.md` - Automação e scraping RPA (ARACHNE) — robôs resilientes, análise de sistemas externos
|
|
364
|
-
- `eng.frontend.agent.md` - Especialista frontend:
|
|
365
|
+
- `eng.frontend.agent.md` - Especialista frontend (neutro de stack): UI, estado, performance, a11y
|
|
365
366
|
- `eng.ux-designer.agent.md` - Especialista UX/UI: auditoria heurística, fluxos, microcopy, arquitetura de informação
|
|
366
367
|
- `eng.cybersecurity.agent.md` - Especialista em cybersecurity e AppSec (SENTINEL) — OWASP Top 10, secrets, supply chain, incident response
|
|
367
368
|
|
|
@@ -378,6 +379,7 @@ Quando um agente atua em tema com skill correspondente, o skill e a fonte de ver
|
|
|
378
379
|
|
|
379
380
|
### Produto (Ativo)
|
|
380
381
|
- `prod.pm-checker.md` - Validacao de requisitos
|
|
382
|
+
- `prod.discovery-interviewer.md` - Entrevistador de discovery: investiga uma ideia sem chutar e gera um rascunho estruturado
|
|
381
383
|
|
|
382
384
|
### Arquivados
|
|
383
385
|
Disponiveis em `$IDE/agents/archive/` organizados por categoria.
|
package/README.md
CHANGED
|
@@ -49,10 +49,10 @@ IDEs: `windsurf` · `claude` · `cursor` · `codex` · `opencode` · `gemini` ·
|
|
|
49
49
|
### 3. No chat da IDE
|
|
50
50
|
|
|
51
51
|
```
|
|
52
|
-
/init
|
|
52
|
+
/jarvis-init
|
|
53
53
|
```
|
|
54
54
|
|
|
55
|
-
Siga o guia do seu papel. Sem `/init
|
|
55
|
+
Siga o guia do seu papel. Sem `/jarvis-init`, o `ENV.md` não existe e o resto dos comandos não tem contexto.
|
|
56
56
|
|
|
57
57
|
---
|
|
58
58
|
|
|
@@ -106,7 +106,7 @@ jarvis --version
|
|
|
106
106
|
|
|
107
107
|
### 3. Bootstrap da IDE e 4. No chat da IDE
|
|
108
108
|
|
|
109
|
-
Mesmos passos 2 e 3 do [Get Started](#get-started) acima — `jarvis init --ide {ide}` e `/init
|
|
109
|
+
Mesmos passos 2 e 3 do [Get Started](#get-started) acima — `jarvis init --ide {ide}` e `/jarvis-init` no chat.
|
|
110
110
|
|
|
111
111
|
---
|
|
112
112
|
|
|
@@ -169,10 +169,12 @@ Se o workspace usa `--save-dev` e já tem `jarvis-lock.json`, o `npm install` do
|
|
|
169
169
|
No chat da IDE:
|
|
170
170
|
|
|
171
171
|
```
|
|
172
|
-
/init
|
|
172
|
+
/jarvis-init
|
|
173
173
|
```
|
|
174
174
|
|
|
175
|
-
Escolha **Upgrade (C)** — adiciona chaves novas do template sem apagar os valores atuais
|
|
175
|
+
Escolha **Upgrade (C)** — adiciona chaves novas do template sem apagar os valores atuais e oferece o passo opcional **"adicionar as stacks"**.
|
|
176
|
+
|
|
177
|
+
> **Vindo de uma versão anterior à 2.0?** O Upgrade é **obrigatório**: sem as chaves `BACKEND_SPECIALIZATIONS` e `FRONTEND_SPECIALIZATIONS`, os comandos `eng.*` de backend e de frontend param. Skills criados por você precisam de `metadata.area` (veja [especializações de stack](docs/especializacoes-de-stack.md#atualizando-de-uma-versão-anterior)).
|
|
176
178
|
|
|
177
179
|
### O que cada passo atualiza
|
|
178
180
|
|
|
@@ -181,7 +183,7 @@ Escolha **Upgrade (C)** — adiciona chaves novas do template sem apagar os valo
|
|
|
181
183
|
| `git pull` | Código do framework no clone |
|
|
182
184
|
| `npm install -g` / `--save-dev` | Binário `jarvis` + pacote que o `init` lê |
|
|
183
185
|
| `jarvis init` (ou postinstall com lock) | Arquivos em `.$IDE/` (skills, agents, workflows…) |
|
|
184
|
-
| `/init
|
|
186
|
+
| `/jarvis-init` Upgrade | Só `$IDE/ENV.md` (variáveis faltantes) e, se você aceitar o passo opcional "adicionar as stacks", as listas de especializações |
|
|
185
187
|
|
|
186
188
|
`ENV.md`, `.jarvis/sessions/` e o `.gitignore` do workspace **não** são sobrescritos pelo sync de assets.
|
|
187
189
|
|
|
@@ -194,10 +196,22 @@ Escolha **Upgrade (C)** — adiciona chaves novas do template sem apagar os valo
|
|
|
194
196
|
|
|
195
197
|
| Recurso | Descricao | Link |
|
|
196
198
|
|---------|-----------|------|
|
|
197
|
-
| **Skills** | Playbooks executaveis (`eng-backend`, `eng-frontend`, `eng-pr`, …) | `skills/` |
|
|
199
|
+
| **Skills** | Playbooks executaveis (`eng-backend`, `eng-frontend`, `eng-global-pr`, …) | `skills/` |
|
|
198
200
|
| **Identidade** | `USER=` no ENV.md (fallback: git / SO). `jarvis whoami` | — |
|
|
199
201
|
| **Documentacao** | Geracao e organizacao de docs tecnica e de negocio | `templates/` |
|
|
200
|
-
| **Troubleshooting** | Configuracao e uso | `/init
|
|
202
|
+
| **Troubleshooting** | Configuracao e uso | `/jarvis-init` |
|
|
203
|
+
|
|
204
|
+
---
|
|
205
|
+
|
|
206
|
+
## Funciona com qualquer stack
|
|
207
|
+
|
|
208
|
+
O Jarvis não presume Go, PHP, NestJS ou React. Cada área (backend e frontend) tem uma **skill base neutra**, e cada projeto registra no `ENV.md` as **especializações** da sua stack (`BACKEND_SPECIALIZATIONS` e `FRONTEND_SPECIALIZATIONS`). Os comandos `eng.*` carregam a base mais o que o projeto registrou.
|
|
209
|
+
|
|
210
|
+
- **Na instalação:** o `/jarvis-init` oferece o passo opcional "adicionar as stacks", que lê o workspace e sugere registrar ou criar a especialização de cada stack
|
|
211
|
+
- **A qualquer momento:** `/jarvis-create-specialization backend golang` cria a especialização a partir do código do projeto, mostra para revisão e só então grava e registra
|
|
212
|
+
- **Consulta:** `/jarvis-list-specializations` mostra o que está instalado e registrado
|
|
213
|
+
|
|
214
|
+
Guia completo: [`docs/especializacoes-de-stack.md`](docs/especializacoes-de-stack.md).
|
|
201
215
|
|
|
202
216
|
---
|
|
203
217
|
|
|
@@ -210,7 +224,7 @@ O Jarvis e organizado em 5 camadas.
|
|
|
210
224
|
| **Agents** | Agentes especializados de IA para engenharia, QA e produto |
|
|
211
225
|
| **Skills** | Playbooks executaveis com logica autonoma |
|
|
212
226
|
| **Templates** | Modelos de documentos (ARD, RFC, Tech Spec, PRD, Epic) |
|
|
213
|
-
| **Rules** | Regras de dominio filtradas por perfil (HUB, POSITION, AREA, SQUAD) no `/init
|
|
227
|
+
| **Rules** | Regras de dominio filtradas por perfil (HUB, POSITION, AREA, SQUAD) no `/jarvis-init` |
|
|
214
228
|
| **Workflows** | Fluxos de execucao dos comandos slash |
|
|
215
229
|
|
|
216
230
|
---
|
|
@@ -226,6 +240,6 @@ Precisa de ajuda?
|
|
|
226
240
|
- **Engenharia (um guia por comando `eng.*`)** — [`docs/engenharia/`](docs/engenharia/README.md)
|
|
227
241
|
- **Indice de docs/** — [`docs/README.md`](docs/README.md)
|
|
228
242
|
- **Instrucoes para agentes / mapa de skills** — `AGENTS.md`
|
|
229
|
-
- **Issues/Feedback** — skill `report-issue`
|
|
243
|
+
- **Issues/Feedback** — skill `jarvis-report-issue`
|
|
230
244
|
- **Duvidas sobre comandos** — Pergunte diretamente ao agent:
|
|
231
245
|
`"Como funciona /eng.start?"` | `"Qual a diferenca entre /eng.work e /pr?"` | `"O que e CDD?"`
|
package/agents/AGENTS.md
CHANGED
|
@@ -14,12 +14,15 @@ A pasta `agents/` contem **definicoes de agentes especializados** que atuam no f
|
|
|
14
14
|
|
|
15
15
|
```
|
|
16
16
|
agents/
|
|
17
|
-
├── engineering/ # Agentes ativos de engenharia (
|
|
17
|
+
├── engineering/ # Agentes ativos de engenharia (15 agents)
|
|
18
18
|
│ ├── eng.agent.md
|
|
19
19
|
│ ├── eng.bug-hunter.md
|
|
20
|
+
│ ├── eng.cybersecurity.agent.md
|
|
20
21
|
│ ├── eng.dev-code-reviewer.md
|
|
21
22
|
│ ├── eng.docs-writer.md
|
|
22
|
-
│ ├── eng.
|
|
23
|
+
│ ├── eng.frontend.agent.md
|
|
24
|
+
│ ├── eng.rpa.agent.md
|
|
25
|
+
│ ├── eng.ux-designer.agent.md
|
|
23
26
|
│ ├── data/ # Agentes de Data (1 agent)
|
|
24
27
|
│ │ └── eng.data-engineer.agent.md
|
|
25
28
|
│ └── qa/ # Agentes de QA (6 agents)
|
|
@@ -29,8 +32,9 @@ agents/
|
|
|
29
32
|
│ ├── eng.qa.quality-champion-task-agent.md
|
|
30
33
|
│ ├── eng.qa.cypress-specialist.md
|
|
31
34
|
│ └── eng.qa.quality-strategist.md
|
|
32
|
-
├── product/ # Agentes ativos de produto (
|
|
33
|
-
│
|
|
35
|
+
├── product/ # Agentes ativos de produto (2 agents)
|
|
36
|
+
│ ├── prod.pm-checker.md
|
|
37
|
+
│ └── prod.discovery-interviewer.md
|
|
34
38
|
└── archive/ # Biblioteca de agentes arquivados (9 agents)
|
|
35
39
|
├── architecture-design/ # 2 agents
|
|
36
40
|
├── implementation/ # 2 agents
|
|
@@ -130,7 +134,7 @@ Os agentes do framework sao **conscientes de contexto** quando o CDD esta habili
|
|
|
130
134
|
|
|
131
135
|
### Como CDD Afeta os Agentes
|
|
132
136
|
|
|
133
|
-
Quando habilitado, agentes leem o `CONTEXT_PROFILE` gerado pelo skill `/context-detect`:
|
|
137
|
+
Quando habilitado, agentes leem o `CONTEXT_PROFILE` gerado pelo skill `/jarvis-context-detect`:
|
|
134
138
|
|
|
135
139
|
```yaml
|
|
136
140
|
CONTEXT_PROFILE:
|
|
@@ -166,15 +170,15 @@ Se `ENABLE_CDD=false` (padrao), agentes operam sem calibracao contextual:
|
|
|
166
170
|
ENABLE_CDD=true
|
|
167
171
|
```
|
|
168
172
|
|
|
169
|
-
> 📚 **Skill relacionado**: `.windsurf/skills/context-detect/SKILL.md`
|
|
173
|
+
> 📚 **Skill relacionado**: `.windsurf/skills/jarvis-context-detect/SKILL.md`
|
|
170
174
|
|
|
171
175
|
---
|
|
172
176
|
|
|
173
177
|
## Agentes Ativos vs Arquivados
|
|
174
178
|
|
|
175
179
|
### Ativos (em uso regular)
|
|
176
|
-
- `engineering/` - Agentes de engenharia (
|
|
177
|
-
- `product/` - Agentes de produto (
|
|
180
|
+
- `engineering/` - Agentes de engenharia (15 agents: 8 main + 6 QA + 1 Data)
|
|
181
|
+
- `product/` - Agentes de produto (2 agents)
|
|
178
182
|
|
|
179
183
|
### Arquivados (biblioteca de referência)
|
|
180
184
|
- `archive/` - Agentes genéricos organizados por área funcional (11 agents)
|
package/agents/README.md
CHANGED
|
@@ -16,24 +16,24 @@ agents/
|
|
|
16
16
|
│ ├── eng.bug-hunter.md # Caça e análise de bugs
|
|
17
17
|
│ ├── eng.dev-code-reviewer.md # Code reviewer
|
|
18
18
|
│ ├── eng.docs-writer.md # Escritor de documentação
|
|
19
|
-
│ ├── eng.tech-analyst.agent.md # Triagem e diagnóstico de chamados N2
|
|
20
19
|
│ ├── eng.rpa.agent.md # Automação RPA (ARACHNE)
|
|
21
|
-
│ ├── eng.frontend.agent.md # Especialista frontend:
|
|
20
|
+
│ ├── eng.frontend.agent.md # Especialista frontend (neutro de stack): UI, estado, a11y
|
|
22
21
|
│ ├── eng.ux-designer.agent.md # Especialista UX/UI: heurísticas, jornada, microcopy
|
|
23
22
|
│ ├── data/ # Data Engineering (1 agent)
|
|
24
23
|
│ │ └── eng.data-engineer.agent.md
|
|
25
24
|
│ └── qa/ # QA específico de engenharia (6 agents)
|
|
26
25
|
├── product/ # 🎯 Agentes do domínio de Produto (ATIVOS)
|
|
27
|
-
│
|
|
26
|
+
│ ├── prod.pm-checker.md # Product Manager checker
|
|
27
|
+
│ └── prod.discovery-interviewer.md # Entrevistador de discovery
|
|
28
28
|
└── archive/ # 📦 Biblioteca de agentes arquivados
|
|
29
29
|
└── product/ # Product WIP (5)
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
**📊 Total:**
|
|
33
|
-
- **
|
|
33
|
+
- **17 agents ativos** (prontos para uso)
|
|
34
34
|
- Engineering main: 8 (6 main + 1 data + subpasta qa)
|
|
35
35
|
- QA: 6
|
|
36
|
-
- Product:
|
|
36
|
+
- Product: 2
|
|
37
37
|
- **5 agents arquivados** (uso especializado quando necessário)
|
|
38
38
|
|
|
39
39
|
---
|
|
@@ -49,9 +49,8 @@ Agentes específicos para fluxos e regras do domínio de Engenharia.
|
|
|
49
49
|
- `eng.bug-hunter.md` - `@eng.bug-hunter` - Caça e análise de bugs
|
|
50
50
|
- `eng.dev-code-reviewer.md` - `@eng.dev-code-reviewer` - Code review
|
|
51
51
|
- `eng.docs-writer.md` - `@eng.docs-writer` - Documentação técnica
|
|
52
|
-
- `eng.tech-analyst.agent.md` - `@eng.tech-analyst` - Triagem e diagnóstico de chamados N2
|
|
53
52
|
- `eng.rpa.agent.md` - `@eng.rpa` - Automação e scraping RPA (ARACHNE)
|
|
54
|
-
- `eng.frontend.agent.md` - `@eng.frontend` - Especialista frontend:
|
|
53
|
+
- `eng.frontend.agent.md` - `@eng.frontend` - Especialista frontend (neutro de stack): UI, estado, performance, a11y
|
|
55
54
|
- `eng.ux-designer.agent.md` - `@eng.ux-designer` - Especialista UX/UI: heurísticas Nielsen, jornada, microcopy
|
|
56
55
|
- `eng.cybersecurity.agent.md` - `@eng.cybersecurity` - Especialista em cybersecurity e AppSec (SENTINEL): OWASP Top 10, secrets, supply chain, incident response
|
|
57
56
|
|
|
@@ -73,13 +72,14 @@ Agentes específicos para fluxos e regras do domínio de Engenharia.
|
|
|
73
72
|
|
|
74
73
|
---
|
|
75
74
|
|
|
76
|
-
## 🎯 2. Produto (
|
|
75
|
+
## 🎯 2. Produto (2 agentes)
|
|
77
76
|
|
|
78
77
|
**Pasta**: `product/`
|
|
79
78
|
|
|
80
79
|
Agentes específicos para fluxos e validações do domínio de Produto.
|
|
81
80
|
|
|
82
81
|
- `prod.pm-checker.md` - `@prod.pm-checker`
|
|
82
|
+
- `prod.discovery-interviewer.md` - `@prod.discovery-interviewer`: entrevista o usuário sobre uma ideia e gera o rascunho de discovery
|
|
83
83
|
|
|
84
84
|
---
|
|
85
85
|
|
|
@@ -116,7 +116,7 @@ Agentes específicos para fluxos e validações do domínio de Produto.
|
|
|
116
116
|
|
|
117
117
|
| Domínio | Agentes | Uso |
|
|
118
118
|
|---------|---------|-----|
|
|
119
|
-
| ⚙️ **Engineering** |
|
|
119
|
+
| ⚙️ **Engineering** | 4 | Agent principal, bug hunter, code review, docs |
|
|
120
120
|
| 🧪 **QA** (sub-eng) | 6 | Test planning, testing, quality gate, Cypress specialist, quality strategist |
|
|
121
121
|
| 📊 **Data** (sub-eng) | 1 | Pipelines, contratos de dados, qualidade |
|
|
122
122
|
| 🎯 **Product** | 1 | PM checker |
|
|
@@ -148,22 +148,20 @@ Quando um agente estiver atuando em um tema que possui skill correspondente, ele
|
|
|
148
148
|
|
|
149
149
|
### Mapeamento recomendado (Workflows/Comandos → Skills)
|
|
150
150
|
|
|
151
|
-
- **eng.docs** → `eng-docs-write` (principal) e `docs-index` (quando houver índice).
|
|
152
|
-
- **eng.pre-pr** → `eng-qa-test-plan` (cobertura) e `eng-docs-write` (docs).
|
|
153
|
-
- **eng.pr** → `eng-pr`.
|
|
151
|
+
- **eng.docs** → `eng-global-docs-write` (principal) e `jarvis-docs-index` (quando houver índice).
|
|
152
|
+
- **eng.pre-pr** → `eng-qa-test-plan` (cobertura) e `eng-global-docs-write` (docs).
|
|
153
|
+
- **eng.pr** → `eng-global-pr`.
|
|
154
154
|
- **qa-quality-gate-validation** → `eng-qa-gate`.
|
|
155
155
|
- **Sessão de teste exploratório (charter, risco, achados, bug cards)** → `eng-qa-exploratory`.
|
|
156
156
|
- **Gerar specs Cypress + TypeScript (Page Objects, data-testid, intercept)** → `eng-qa-cypress-e2e`.
|
|
157
157
|
- **Orientar dev sobre cobertura Cypress sem escrever o teste** → `eng-qa-dev-guide`.
|
|
158
158
|
- **Consolidar sessões, bugs e quality gates e gerar relatório de qualidade por período** → `eng-qa-quality-report`.
|
|
159
|
-
- **APIs, auth, workers,
|
|
160
|
-
- **Componentes, UI, estado,
|
|
161
|
-
- **Módulos NestJS, DI, guards, interceptors, Passport/JWT** → `eng-nestjs`.
|
|
159
|
+
- **APIs, auth, workers, filas, caching, banco de dados** → regra `eng.specializations-rules.md` (área backend: `eng-backend` + `BACKEND_SPECIALIZATIONS`).
|
|
160
|
+
- **Componentes, UI, estado, estilos, performance, acessibilidade** → regra `eng.specializations-rules.md` (área frontend: `eng-frontend` + `FRONTEND_SPECIALIZATIONS`).
|
|
162
161
|
- **Web scraping, Puppeteer, extração de dados, ETL** → `eng-scraper`.
|
|
163
162
|
- **Converter fluxo manual (produto/dev) em robô Playwright via Stagehand** → `eng-scraper-robot-builder`.
|
|
164
163
|
- **Criar ou manter robô RPA** → `eng.rpa.robot new|update {card}` (workflow).
|
|
165
164
|
- **Testes E2E em linguagem natural, fluxos de usuário, smoke tests pós-deploy** → `eng-qa-e2e`.
|
|
166
|
-
- **Atendimento técnico N2, triagem de chamados, diagnóstico, classificação de bugs, escalonamento** → `eng-tech-analyst`.
|
|
167
165
|
- **Pipelines de dados, ETL/ELT, Glue, Airflow, Athena, bronze/silver/gold, contratos de dados, Great Expectations** → `eng-data-engineer`.
|
|
168
166
|
|
|
169
167
|
### Ativação Automática (Agents Ativos)
|
|
@@ -96,11 +96,11 @@ Ativado quando há suspeita de dado incorreto, queda de volume ou falha de pipel
|
|
|
96
96
|
## Calibração Contextual (CDD)
|
|
97
97
|
|
|
98
98
|
> **Princípio**: O agente deve ser consciente do contexto, não apenas configurado por contexto.
|
|
99
|
-
> 📚 **Skill**: Use `/context-detect` para detecção automatizada do contexto
|
|
99
|
+
> 📚 **Skill**: Use `/jarvis-context-detect` para detecção automatizada do contexto
|
|
100
100
|
|
|
101
101
|
### Herdar Contexto da Sessão
|
|
102
102
|
|
|
103
|
-
Se existir arquivo `context.md` na sessão (gerado por `/context-detect`), use-o:
|
|
103
|
+
Se existir arquivo `context.md` na sessão (gerado por `/jarvis-context-detect`), use-o:
|
|
104
104
|
|
|
105
105
|
```bash
|
|
106
106
|
# Localização: $SESSIONS_DIR/eng/{TASK_MANAGER_KEY}/context.md
|
|
@@ -120,7 +120,7 @@ CONTEXT_PROFILE:
|
|
|
120
120
|
linter: [configurado|ausente]
|
|
121
121
|
```
|
|
122
122
|
|
|
123
|
-
> Se `context.md` não existir e for necessário, execute `/context-detect {TASK_MANAGER_KEY}` ou faça detecção manual.
|
|
123
|
+
> Se `context.md` não existir e for necessário, execute `/jarvis-context-detect {TASK_MANAGER_KEY}` ou faça detecção manual.
|
|
124
124
|
|
|
125
125
|
### Detecção de Urgência
|
|
126
126
|
|
|
@@ -222,10 +222,10 @@ Gerenciamento de DAGs e orquestração de pipelines:
|
|
|
222
222
|
- Uso: `/eng-data-orchestrator [criar|monitorar|retry|alerta|debug] [nome-do-dag]`
|
|
223
223
|
- Agnóstico ao orquestrador: adapta exemplos para `$DATA_ORCHESTRATOR` (Airflow, Prefect, Dagster, Glue Scheduler)
|
|
224
224
|
|
|
225
|
-
### context-detect (CDD)
|
|
225
|
+
### jarvis-context-detect (CDD)
|
|
226
226
|
Para detecção automática de contexto de tarefas:
|
|
227
|
-
- Arquivo: `$IDE/skills/context-detect/SKILL.md`
|
|
228
|
-
- Uso: `/context-detect [jira-key]`
|
|
227
|
+
- Arquivo: `$IDE/skills/jarvis-context-detect/SKILL.md`
|
|
228
|
+
- Uso: `/jarvis-context-detect [jira-key]`
|
|
229
229
|
|
|
230
230
|
---
|
|
231
231
|
|
|
@@ -49,11 +49,11 @@ Você é um **engenheiro de software sênior** atuando na squad $SQUAD do hub $H
|
|
|
49
49
|
## Calibração Contextual (CDD)
|
|
50
50
|
|
|
51
51
|
> **Princípio**: O agent deve ser consciente do contexto, não apenas configurado por contexto.
|
|
52
|
-
> 📚 **Skill**: Use `/context-detect` para detecção automatizada do contexto
|
|
52
|
+
> 📚 **Skill**: Use `/jarvis-context-detect` para detecção automatizada do contexto
|
|
53
53
|
|
|
54
54
|
### Herdar Contexto da Sessão
|
|
55
55
|
|
|
56
|
-
Se existir arquivo `context.md` na sessão (gerado por `/context-detect`), use-o:
|
|
56
|
+
Se existir arquivo `context.md` na sessão (gerado por `/jarvis-context-detect`), use-o:
|
|
57
57
|
|
|
58
58
|
```bash
|
|
59
59
|
# Localização: $SESSIONS_DIR/eng/{TASK_MANAGER_KEY}/context.md
|
|
@@ -73,7 +73,7 @@ CONTEXT_PROFILE:
|
|
|
73
73
|
linter: [configurado|ausente]
|
|
74
74
|
```
|
|
75
75
|
|
|
76
|
-
> Se `context.md` não existir e for necessário, execute `/context-detect {TASK_MANAGER_KEY}` ou faça detecção manual.
|
|
76
|
+
> Se `context.md` não existir e for necessário, execute `/jarvis-context-detect {TASK_MANAGER_KEY}` ou faça detecção manual.
|
|
77
77
|
|
|
78
78
|
### Detecção de Urgência (complementar)
|
|
79
79
|
|
|
@@ -169,52 +169,35 @@ Identifique palavras-chave na mensagem do usuário para ajuste imediato:
|
|
|
169
169
|
|
|
170
170
|
## Skills
|
|
171
171
|
|
|
172
|
-
### context-detect (CDD)
|
|
172
|
+
### jarvis-context-detect (CDD)
|
|
173
173
|
Para detecção automática de contexto de tarefas:
|
|
174
|
-
- Arquivo: `$IDE/skills/context-detect/SKILL.md`
|
|
175
|
-
- Uso: `/context-detect [jira-key]` ou `/context-detect --override tipo=hotfix`
|
|
174
|
+
- Arquivo: `$IDE/skills/jarvis-context-detect/SKILL.md`
|
|
175
|
+
- Uso: `/jarvis-context-detect [jira-key]` ou `/jarvis-context-detect --override tipo=hotfix`
|
|
176
176
|
- Chamado automaticamente pelo workflow `eng.start`
|
|
177
177
|
|
|
178
|
-
### eng-performance-engineer
|
|
178
|
+
### eng-devops-performance-engineer
|
|
179
179
|
Quando a tarefa envolver análise ou otimização de performance, observabilidade, gargalos, latência, load testing ou escalabilidade:
|
|
180
|
-
- Arquivo: `$IDE/skills/eng-performance-engineer/SKILL.md`
|
|
180
|
+
- Arquivo: `$IDE/skills/eng-devops-performance-engineer/SKILL.md`
|
|
181
181
|
|
|
182
182
|
### eng-ai-engineer
|
|
183
183
|
Quando a tarefa envolver features com LLM, sistemas RAG, agentes de IA, chatbots, embeddings, busca vetorial ou integrações com modelos de IA:
|
|
184
184
|
- Arquivo: `$IDE/skills/eng-ai-engineer/SKILL.md`
|
|
185
185
|
|
|
186
|
-
### eng-browser-extension-builder
|
|
186
|
+
### eng-global-browser-extension-builder
|
|
187
187
|
Quando a tarefa envolver criação ou manutenção de extensões de navegador (Chrome, Firefox, Manifest V3, content scripts, popup UI):
|
|
188
|
-
- Arquivo: `$IDE/skills/eng-browser-extension-builder/SKILL.md`
|
|
188
|
+
- Arquivo: `$IDE/skills/eng-global-browser-extension-builder/SKILL.md`
|
|
189
189
|
|
|
190
|
-
###
|
|
191
|
-
Quando
|
|
192
|
-
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
- Arquivo: `$IDE/skills/eng-rabbitmq/SKILL.md`
|
|
197
|
-
- Workflows relacionados: `eng.work` (implementação), `eng.debug` (troubleshooting), `eng.start` (arquitetura de mensageria)
|
|
198
|
-
|
|
199
|
-
### eng-nestjs
|
|
200
|
-
Quando a tarefa envolver problemas específicos do framework NestJS: erros de injeção de dependências, circular dependencies, configuração de guards, interceptors, pipes, middleware, ciclo de vida de requisição, ConfigModule, módulos dinâmicos, exception filters ou autenticação com Passport/JWT:
|
|
201
|
-
- Arquivo: `$IDE/skills/eng-nestjs/SKILL.md`
|
|
202
|
-
- Workflows relacionados: `eng.work` (implementação), `eng.debug` (debugging de DI e erros de framework)
|
|
203
|
-
|
|
204
|
-
### eng-frontend
|
|
205
|
-
Quando a tarefa envolver componentes React/Next.js/Vue/Svelte, estado (Zustand, React Query), performance de UI (bundle, SSR/SSG/ISR, Core Web Vitals, lazy loading), acessibilidade (WCAG, ARIA), design system ou testes de interface (Testing Library, Playwright):
|
|
206
|
-
- Arquivo: `$IDE/skills/eng-frontend/SKILL.md`
|
|
207
|
-
- Workflows relacionados: `eng.start` (arquitetura de UI), `eng.work` (implementação de componentes e features de interface)
|
|
208
|
-
|
|
209
|
-
### eng-backend
|
|
210
|
-
Quando a tarefa envolver APIs REST/GraphQL, autenticação (JWT, OAuth2, RBAC, sessions), workers e jobs assíncronos com RabbitMQ ou cron, integrações externas com retry/circuit breaker, webhooks, caching com Redis ou design de endpoints (paginação, versionamento, idempotência):
|
|
211
|
-
- Arquivo: `$IDE/skills/eng-backend/SKILL.md`
|
|
212
|
-
- Workflows relacionados: `eng.start` (arquitetura de API e serviços), `eng.work` (implementação), `eng.debug` (troubleshooting de APIs e workers)
|
|
190
|
+
### Backend e frontend (skill base + especializações)
|
|
191
|
+
Quando a tarefa envolver **backend** (APIs, autenticação, workers e jobs assíncronos, filas e mensageria, integrações externas, cache, banco de dados) ou **frontend** (componentes, estado, estilos, performance de UI, acessibilidade, testes de interface), não escolha o skill por nome: aplique a regra `$IDE/rules/engineering/eng.specializations-rules.md` para a área envolvida. Ela carrega o skill base e as especializações que o projeto registrou no `ENV.md`:
|
|
192
|
+
- Backend: `$IDE/skills/eng-backend/SKILL.md` + itens de `BACKEND_SPECIALIZATIONS`
|
|
193
|
+
- Frontend: `$IDE/skills/eng-frontend/SKILL.md` + itens de `FRONTEND_SPECIALIZATIONS`
|
|
194
|
+
- Workflows relacionados: `eng.start` (arquitetura), `eng.work` (implementação), `eng.debug` (troubleshooting)
|
|
195
|
+
- Para ver o que está instalado e registrado: `/jarvis-list-specializations`
|
|
213
196
|
|
|
214
197
|
### eng-scraper
|
|
215
198
|
Quando a tarefa envolver web scraping, extração de dados de páginas web, automação de browser com Puppeteer, parsing de HTML/XML/PDF, pipelines ETL leves ou monitoramento de mudanças em sites:
|
|
216
199
|
- Arquivo: `$IDE/skills/eng-scraper/SKILL.md`
|
|
217
|
-
- Workflows relacionados: `eng.work` (implementação de scrapers
|
|
200
|
+
- Workflows relacionados: `eng.work` (implementação de scrapers)
|
|
218
201
|
|
|
219
202
|
### eng-scraper-robot-builder
|
|
220
203
|
Quando o produto ou dev descrever um fluxo manual em linguagem natural que precisa virar automação (robô), ou quando for necessário criar um script Playwright sem conhecer seletores do site. Usa Stagehand para exploração e `observe()` para descoberta de seletores — o output final é Playwright TypeScript puro, sem dependência de LLM em runtime:
|
|
@@ -226,9 +209,9 @@ Quando o QA precisar criar testes E2E de sistema em linguagem natural, validar f
|
|
|
226
209
|
- Arquivo: `$IDE/skills/eng-qa-e2e/SKILL.md`
|
|
227
210
|
- Workflows relacionados: `eng.pr` (validação pré-PR), `eng.pre-pr` (cobertura de testes E2E)
|
|
228
211
|
|
|
229
|
-
### eng-cybersecurity
|
|
212
|
+
### eng-security-cybersecurity
|
|
230
213
|
Quando a tarefa envolver segurança de aplicação, auditoria OWASP, secrets management, sanitização de inputs, headers de segurança (CSP, HSTS, CORS), supply chain (npm audit, lockfile), compliance (LGPD/GDPR) ou resposta a CVEs/incidentes de segurança:
|
|
231
|
-
- Arquivo: `$IDE/skills/eng-cybersecurity/SKILL.md`
|
|
214
|
+
- Arquivo: `$IDE/skills/eng-security-cybersecurity/SKILL.md`
|
|
232
215
|
- Agente dedicado: `$IDE/agents/engineering/eng.cybersecurity.agent.md` (SENTINEL) — para auditorias completas e incident response
|
|
233
216
|
- Workflows relacionados: `eng.security-audit` (auditoria proativa), `eng.security-incident` (resposta a CVEs), `eng.security-review` (gate pré-merge)
|
|
234
217
|
|