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.
Files changed (193) hide show
  1. package/AGENTS.md +66 -64
  2. package/README.md +24 -10
  3. package/agents/AGENTS.md +12 -8
  4. package/agents/README.md +14 -16
  5. package/agents/engineering/data/eng.data-engineer.agent.md +6 -6
  6. package/agents/engineering/eng.agent.md +19 -36
  7. package/agents/engineering/eng.bug-hunter.md +13 -12
  8. package/agents/engineering/eng.cybersecurity.agent.md +20 -35
  9. package/agents/engineering/eng.docs-writer.md +2 -2
  10. package/agents/engineering/eng.frontend.agent.md +17 -22
  11. package/agents/engineering/eng.rpa.agent.md +5 -15
  12. package/agents/engineering/qa/eng.qa.test-architect.md +4 -4
  13. package/agents/engineering/qa/eng.qa.test-planner.md +3 -3
  14. package/agents/engineering/qa/eng.qa.testing-engineer.md +3 -3
  15. package/agents/product/prod.discovery-interviewer.md +86 -0
  16. package/bin/commands/init.js +6 -6
  17. package/bin/jarvis.js +1 -1
  18. package/bin/lib/config/constants.js +47 -0
  19. package/bin/lib/core/sync-engine.js +12 -0
  20. package/package.json +2 -5
  21. package/rules/AGENTS.md +6 -4
  22. package/rules/engineering/eng-rules.md +5 -3
  23. package/rules/engineering/eng-security-rules.md +4 -4
  24. package/rules/engineering/eng.breakdown-subtasks-rules.md +208 -37
  25. package/rules/engineering/eng.docs-scraping-rules.md +1 -1
  26. package/rules/engineering/eng.downstream-flow-rules.md +1 -1
  27. package/rules/engineering/eng.integrations-rules.md +2 -2
  28. package/rules/engineering/eng.pre-pr-rules.md +1 -1
  29. package/rules/engineering/eng.skills-rules.md +60 -0
  30. package/rules/engineering/eng.specializations-rules.md +69 -0
  31. package/rules/engineering/eng.start-rules.md +11 -11
  32. package/rules/engineering/eng.work-rules.md +19 -14
  33. package/rules/engineering/frontend/eng.frontend-rules.md +70 -69
  34. package/rules/product/README.md +2 -0
  35. package/rules/product/prod-rules.md +7 -5
  36. package/{skills/prod-specs/rules/prod-spec-rules.md → rules/product/prod.spec-rules.md} +55 -50
  37. package/skills/AGENTS.md +111 -47
  38. package/skills/SKILLS-ROADMAP.md +26 -45
  39. package/skills/eng-ai-engineer/SKILL.md +1 -0
  40. package/skills/eng-backend/SKILL.md +142 -644
  41. package/skills/eng-backend/references/1-fundamentos-programacao.md +41 -0
  42. package/skills/eng-backend/references/10-seguranca.md +61 -0
  43. package/skills/eng-backend/references/11-performance.md +49 -0
  44. package/skills/eng-backend/references/12-erros-logging.md +42 -0
  45. package/skills/eng-backend/references/13-qualidade-codigo.md +51 -0
  46. package/skills/eng-backend/references/2-design-arquitetura.md +48 -0
  47. package/skills/eng-backend/references/3-design-patterns.md +50 -0
  48. package/skills/eng-backend/references/4-algoritmos-estruturas.md +43 -0
  49. package/skills/eng-backend/references/5-banco-dados.md +53 -0
  50. package/skills/eng-backend/references/6-api-comunicacao.md +42 -0
  51. package/skills/eng-backend/references/7-concorrencia-async.md +49 -0
  52. package/skills/eng-backend/references/8-arquitetura-servidor.md +49 -0
  53. package/skills/eng-backend/references/9-testes.md +43 -0
  54. package/skills/{eng-arch-c4 → eng-backend-arch-c4}/SKILL.md +12 -7
  55. package/skills/{eng-ms-trace → eng-backend-microservices-trace}/SKILL.md +6 -4
  56. package/skills/{eng-nestjs → eng-backend-nestjs}/SKILL.md +3 -1
  57. package/skills/{eng-rabbitmq → eng-backend-rabbitmq}/SKILL.md +3 -1
  58. package/skills/eng-data-bi/SKILL.md +1 -0
  59. package/skills/eng-data-debug/SKILL.md +2 -1
  60. package/skills/eng-data-engineer/SKILL.md +1 -0
  61. package/skills/eng-data-onboard/SKILL.md +1 -0
  62. package/skills/eng-data-orchestrator/SKILL.md +1 -0
  63. package/skills/{eng-performance-engineer → eng-devops-performance-engineer}/SKILL.md +2 -1
  64. package/skills/eng-frontend/SKILL.md +145 -782
  65. package/skills/eng-frontend/references/1-fundamentos-programacao.md +37 -0
  66. package/skills/eng-frontend/references/10-testes.md +47 -0
  67. package/skills/eng-frontend/references/11-seguranca.md +56 -0
  68. package/skills/eng-frontend/references/12-qualidade-codigo.md +51 -0
  69. package/skills/eng-frontend/references/2-html-fundamentals.md +51 -0
  70. package/skills/eng-frontend/references/3-css-responsive.md +61 -0
  71. package/skills/eng-frontend/references/4-javascript-dom.md +60 -0
  72. package/skills/eng-frontend/references/5-state-management.md +55 -0
  73. package/skills/eng-frontend/references/6-uiux-design.md +59 -0
  74. package/skills/eng-frontend/references/7-acessibilidade.md +46 -0
  75. package/skills/eng-frontend/references/8-performance.md +58 -0
  76. package/skills/eng-frontend/references/9-browser-apis.md +54 -0
  77. package/skills/{eng-design-system → eng-frontend-design-system}/SKILL.md +4 -2
  78. package/skills/{eng-microfrontend → eng-frontend-microfrontend}/SKILL.md +4 -2
  79. package/skills/{eng-browser-extension-builder → eng-global-browser-extension-builder}/SKILL.md +2 -1
  80. package/skills/{eng-docs-write → eng-global-docs-write}/SKILL.md +8 -4
  81. package/skills/eng-global-jira-comment/SKILL.md +21 -0
  82. package/skills/{eng-pr → eng-global-pr}/SKILL.md +7 -3
  83. package/skills/{eng-task-comment → eng-global-task-comment}/SKILL.md +6 -2
  84. package/skills/eng-qa-a11y-audit/SKILL.md +1 -0
  85. package/skills/eng-qa-bug-report/SKILL.md +2 -1
  86. package/skills/eng-qa-bug-report/TASK_MANAGERS.md +1 -1
  87. package/skills/eng-qa-cypress-e2e/SKILL.md +1 -0
  88. package/skills/eng-qa-dev-guide/SKILL.md +1 -0
  89. package/skills/eng-qa-e2e/SKILL.md +1 -0
  90. package/skills/eng-qa-e2e-spec-writer/SKILL.md +1 -0
  91. package/skills/eng-qa-exploratory/SKILL.md +1 -0
  92. package/skills/eng-qa-gate/SKILL.md +3 -2
  93. package/skills/eng-qa-graphql-contract/SKILL.md +1 -0
  94. package/skills/eng-qa-quality-report/SKILL.md +3 -2
  95. package/skills/eng-qa-test-plan/SKILL.md +1 -0
  96. package/skills/eng-qa-testsprite/SKILL.md +2 -1
  97. package/skills/eng-qa-unit-test/SKILL.md +1 -0
  98. package/skills/eng-scraper/SKILL.md +1 -0
  99. package/skills/eng-scraper-robot-builder/SKILL.md +1 -0
  100. package/skills/{eng-cybersecurity → eng-security-cybersecurity}/SKILL.md +3 -2
  101. package/skills/eng-security-patch/SKILL.md +6 -2
  102. package/skills/{eng-threat-model → eng-security-threat-model}/SKILL.md +6 -2
  103. package/skills/eng-security-triage/SKILL.md +4 -0
  104. package/skills/{context-detect → jarvis-context-detect}/SKILL.md +6 -5
  105. package/skills/{context-detect → jarvis-context-detect}/assets/context-profile-template.md +3 -3
  106. package/skills/jarvis-create-specialization/SKILL.md +230 -0
  107. package/skills/jarvis-create-specialization/assets/referencia-template.md +39 -0
  108. package/skills/jarvis-create-specialization/assets/skill-especializacao-template.md +78 -0
  109. package/skills/{docs-central → jarvis-docs-central}/README.md +1 -1
  110. package/skills/{docs-central → jarvis-docs-central}/SKILL.md +3 -40
  111. package/skills/{docs-index → jarvis-docs-index}/SKILL.md +8 -4
  112. package/skills/{init-jarvis → jarvis-init}/SKILL.md +42 -19
  113. package/skills/{init-jarvis → jarvis-init}/assets/mcp-configs.md +3 -3
  114. package/skills/{init-jarvis → jarvis-init}/assets/onboarding-checklist.md +1 -1
  115. package/skills/jarvis-init/assets/passo-adicionar-stacks.md +163 -0
  116. package/skills/{init-jarvis → jarvis-init}/assets/setup-guide.md +1 -1
  117. package/skills/jarvis-init/assets/sinais-de-stack.md +54 -0
  118. package/skills/jarvis-list-specializations/SKILL.md +148 -0
  119. package/skills/{report-issue → jarvis-report-issue}/SKILL.md +3 -2
  120. package/skills/{prod-roadmap-report → product-roadmap-report}/SKILL.md +2 -1
  121. package/skills/product-specs/SKILL.md +45 -0
  122. package/skills/{prod-specs-update → product-specs-update}/SKILL.md +3 -2
  123. package/taxonomy.md +3 -21
  124. package/templates/AGENTS.md +7 -6
  125. package/templates/CDD aplicado a Prompts.md +5 -5
  126. package/templates/ENV-template.md +12 -9
  127. package/templates/engineering/AGENTS-template.md +1 -1
  128. package/templates/engineering/CONTACTS-template.md +1 -1
  129. package/templates/product/prod-discovery-template.md +98 -0
  130. package/{skills/prod-specs/templates → templates/product}/prod-epic-template.md +1 -0
  131. package/{skills/prod-specs/templates → templates/product}/prod-frd-template.md +1 -0
  132. package/{skills/prod-specs/templates → templates/product}/prod-issue-template.md +1 -0
  133. package/{skills/prod-specs/templates → templates/product}/prod-prd-template.md +1 -0
  134. package/workflows/AGENTS.md +3 -1
  135. package/workflows/README.md +2 -0
  136. package/workflows/engineering/eng.bug-audit.md +2 -2
  137. package/workflows/engineering/eng.build-tech-spec.md +38 -49
  138. package/workflows/engineering/eng.debug.md +10 -10
  139. package/workflows/engineering/eng.docs.md +2 -2
  140. package/workflows/engineering/eng.plan.md +5 -5
  141. package/workflows/engineering/eng.pr.md +8 -8
  142. package/workflows/engineering/eng.pre-pr.md +16 -20
  143. package/workflows/engineering/eng.review.md +5 -10
  144. package/workflows/engineering/eng.rpa.robot.md +3 -3
  145. package/workflows/engineering/eng.security-audit.md +5 -5
  146. package/workflows/engineering/eng.security-incident.md +2 -2
  147. package/workflows/engineering/eng.security-pipeline.md +2 -2
  148. package/workflows/engineering/eng.start.md +16 -50
  149. package/workflows/engineering/eng.work.md +9 -12
  150. package/workflows/engineering/frontend/eng.frontend-component.md +68 -96
  151. package/workflows/engineering/frontend/eng.frontend-perf-audit.md +90 -220
  152. package/workflows/engineering/frontend/eng.frontend-review.md +57 -63
  153. package/workflows/engineering/qa/eng.qa-quality-report.md +0 -5
  154. package/workflows/product/prod.roadmap.preview.md +2 -2
  155. package/workflows/product/prod.spec.breakdown.md +3 -8
  156. package/workflows/product/prod.spec.discovery.md +152 -0
  157. package/workflows/product/prod.spec.epic.md +3 -0
  158. package/workflows/product/prod.spec.frd.md +123 -8
  159. package/workflows/product/prod.spec.issue.md +3 -2
  160. package/workflows/product/prod.spec.md +2 -0
  161. package/workflows/product/prod.spec.prd.md +105 -6
  162. package/workflows/taxonomy.md +1 -1
  163. package/workflows/warm-up.md +5 -26
  164. package/agents/engineering/eng.tech-analyst.agent.md +0 -102
  165. package/skills/churn-audit/SKILL.md +0 -385
  166. package/skills/eng-jira-comment/SKILL.md +0 -17
  167. package/skills/eng-tech-analyst/SKILL.md +0 -529
  168. package/skills/lovable-prompt-generator/SKILL.md +0 -304
  169. package/skills/prod-specs/SKILL.md +0 -108
  170. package/skills/prod-specs/references/prod.spec.clarify.md +0 -176
  171. package/skills/prod-specs/references/prod.spec.epic.md +0 -107
  172. package/skills/prod-specs/references/prod.spec.frd.md +0 -135
  173. package/skills/prod-specs/references/prod.spec.issue.md +0 -145
  174. package/skills/prod-specs/references/prod.spec.prd.md +0 -118
  175. package/skills/prod-specs/templates/prod-prd-full-template.md +0 -159
  176. package/workflows/engineering/ta/eng.ta.atendimento.md +0 -93
  177. /package/skills/{eng-arch-c4 → eng-backend-arch-c4}/assets/example-code.md +0 -0
  178. /package/skills/{eng-arch-c4 → eng-backend-arch-c4}/assets/example-component.md +0 -0
  179. /package/skills/{eng-arch-c4 → eng-backend-arch-c4}/assets/example-container.md +0 -0
  180. /package/skills/{eng-arch-c4 → eng-backend-arch-c4}/assets/example-context.md +0 -0
  181. /package/skills/{prod-roadmap-report → product-roadmap-report}/README.md +0 -0
  182. /package/skills/{prod-roadmap-report → product-roadmap-report}/commands/status.compiled.single.team.md +0 -0
  183. /package/skills/{prod-roadmap-report → product-roadmap-report}/commands/status.list.projects.md +0 -0
  184. /package/skills/{prod-roadmap-report → product-roadmap-report}/commands/status.memory.md +0 -0
  185. /package/skills/{prod-roadmap-report → product-roadmap-report}/commands/status.roadmap.preview.md +0 -0
  186. /package/skills/{prod-roadmap-report → product-roadmap-report}/references/detailed-guide.md +0 -0
  187. /package/skills/{prod-roadmap-report → product-roadmap-report}/rules/detailed-guide.md +0 -0
  188. /package/skills/{prod-roadmap-report → product-roadmap-report}/rules/status-report-rules.md +0 -0
  189. /package/skills/{prod-roadmap-report → product-roadmap-report}/templates/template-multiple-teams-compiled-status.md +0 -0
  190. /package/skills/{prod-roadmap-report → product-roadmap-report}/templates/template-projects-list.md +0 -0
  191. /package/skills/{prod-roadmap-report → product-roadmap-report}/templates/template-single-team-compiled-status.md +0 -0
  192. /package/skills/{prod-roadmap-report → product-roadmap-report}/templates/template-single-team-status.md +0 -0
  193. /package/{skills/prod-specs/templates → templates/product}/prod-breakdown-template.md +0 -0
package/skills/AGENTS.md CHANGED
@@ -14,44 +14,75 @@ A pasta `skills/` contem **playbooks executaveis** que sao a fonte de verdade op
14
14
 
15
15
  ```
16
16
  skills/
17
- ├── eng-arch-c4/ # Diagramas C4
17
+ ├── eng-backend-arch-c4/ # Diagramas C4
18
18
  │ ├── SKILL.md
19
19
  │ └── assets/
20
- ├── eng-docs-write/ # Escrita de documentacao
20
+ ├── eng-global-docs-write/ # Escrita de documentacao
21
21
  │ └── SKILL.md
22
- ├── eng-pr/ # Criacao de Pull/Merge Requests (GitLab/GitHub/Bitbucket)
22
+ ├── eng-global-pr/ # Criacao de Pull/Merge Requests (GitLab/GitHub/Bitbucket)
23
23
  │ └── SKILL.md
24
- ├── eng-task-comment/ # Comentário no card (Jira/Linear/GitHub Issues/Asana)
24
+ ├── eng-global-task-comment/ # Comentário no card (Jira/Linear/GitHub Issues/Asana)
25
25
  │ └── SKILL.md
26
- ├── eng-jira-comment/ # Alias → eng-task-comment
26
+ ├── eng-global-jira-comment/ # Alias → eng-global-task-comment
27
27
  │ └── SKILL.md
28
- ├── eng-backend/ # APIs REST/GraphQL, auth JWT/OAuth2/RBAC, RabbitMQ workers, caching
28
+ ├── jarvis-list-specializations/ # Lista especializações de stack instaladas e registradas
29
29
  │ └── SKILL.md
30
- ├── eng-frontend/ # React/Next.js/Vue, estado, performance UI, acessibilidade
30
+ ├── jarvis-create-specialization/ # Cria uma especialização de stack (backend/frontend) a partir do código do projeto e a registra na lista
31
+ │ ├── SKILL.md
32
+ │ └── assets/
33
+ ├── eng-backend/ # Base neutra de backend (APIs, auth, workers, dados); especializações por stack se somam a ele
31
34
  │ └── SKILL.md
32
- ├── eng-microfrontend/ # Module Federation, shell/remote, contratos de interface, event bus
35
+ ├── eng-frontend/ # Base neutra de frontend (componentes, estado, performance UI, acessibilidade); especializações se somam a ele
33
36
  │ └── SKILL.md
34
- ├── eng-design-system/ # Tokens semânticos, CVA, Storybook, versionamento, auditoria visual
37
+ ├── eng-frontend-microfrontend/ # Module Federation, shell/remote, contratos de interface, event bus
35
38
  │ └── SKILL.md
36
- ├── eng-nestjs/ # Framework NestJS: módulos, DI, guards, interceptors, pipes, Passport/JWT
39
+ ├── eng-frontend-design-system/ # Tokens semânticos, CVA, Storybook, versionamento, auditoria visual
37
40
  │ └── SKILL.md
38
- ├── eng-rabbitmq/ # Mensageria RabbitMQ (HTTP API, codigo, arquitetura, troubleshooting)
41
+ ├── eng-backend-nestjs/ # Framework NestJS: módulos, DI, guards, interceptors, pipes, Passport/JWT
39
42
  │ └── SKILL.md
40
- ├── eng-cybersecurity/ # Segurança de aplicações: OWASP Top 10, secrets, supply chain, headers, SAST, compliance
43
+ ├── eng-backend-rabbitmq/ # Mensageria RabbitMQ (HTTP API, codigo, arquitetura, troubleshooting)
41
44
  │ └── SKILL.md
42
- ├── churn-audit/ # Análise de churn SaaS por squad com relatório narrativo via $MESSAGE_COMUNICATOR
45
+ ├── eng-security-cybersecurity/ # Segurança de aplicações: OWASP Top 10, secrets, supply chain, headers, SAST, compliance
43
46
  │ └── SKILL.md
44
- ├── eng-scraper/ # Web scraping com Puppeteer, Cheerio, anti-bot, pipelines ETL
47
+ ├── eng-backend-microservices-trace/ # Rastreamento de bugs entre serviços (HTTP + AMQP); especialização de backend
45
48
  │ └── SKILL.md
46
- ├── eng-scraper-robot-builder/ # Converte fluxo manual (linguagem natural) em robô Playwright via Stagehand
49
+ ├── eng-security-threat-model/ # Threat model estruturado do projeto (bootstrap/entrevista)
50
+ │ └── SKILL.md
51
+ ├── eng-security-triage/ # Deduplicar, verificar e rankear achados de segurança
52
+ │ └── SKILL.md
53
+ ├── eng-security-patch/ # Diffs candidatos para achados de segurança confirmados
54
+ │ └── SKILL.md
55
+ ├── eng-devops-performance-engineer/ # Performance: baseline, SLIs/SLOs, load tests
56
+ │ └── SKILL.md
57
+ ├── eng-ai-engineer/ # Features com LLM, RAG, agentes, embeddings
58
+ │ └── SKILL.md
59
+ ├── eng-global-browser-extension-builder/ # Extensões de navegador (Manifest V3)
60
+ │ └── SKILL.md
61
+ ├── eng-data-engineer/ # Pipelines ETL/ELT, camadas bronze/silver/gold, contratos de dados
62
+ │ └── SKILL.md
63
+ ├── eng-data-bi/ # Dashboards BI e queries analíticas
64
+ │ └── SKILL.md
65
+ ├── eng-data-debug/ # Diagnóstico de falhas em pipelines por camada
66
+ │ └── SKILL.md
67
+ ├── eng-data-onboard/ # Onboarding de fonte nova de dados
68
+ │ └── SKILL.md
69
+ ├── eng-data-orchestrator/ # DAGs, retries e alertas de orquestração
47
70
  │ └── SKILL.md
48
- ├── eng-tech-analyst/ # Triagem de chamados do HUBS board: keywords, sub-bug linking, frequência via comentários no card, encaminhamento para squad
71
+ ├── eng-qa-bug-report/ # Bug reports de QA
49
72
  │ └── SKILL.md
50
- ├── lovable-prompt-generator/ # Geracao de prompts para frontend React via Lovable
73
+ ├── product-specs/ # Porta de entrada de especificação de produto
51
74
  │ └── SKILL.md
52
- ├── docs-index/ # Indexacao de documentos
75
+ ├── product-specs-update/ # Sincroniza especificações de produto
53
76
  │ └── SKILL.md
54
- ├── init-jarvis/ # Inicializacao do framework (/init-jarvis)
77
+ ├── product-roadmap-report/ # Relatório de status do roadmap
78
+ │ └── SKILL.md
79
+ ├── eng-scraper/ # Web scraping com Puppeteer, Cheerio, anti-bot, pipelines ETL
80
+ │ └── SKILL.md
81
+ ├── eng-scraper-robot-builder/ # Converte fluxo manual (linguagem natural) em robô Playwright via Stagehand
82
+ │ └── SKILL.md
83
+ ├── jarvis-docs-index/ # Indexacao de documentos
84
+ │ └── SKILL.md
85
+ ├── jarvis-init/ # Inicializacao do framework (/jarvis-init), com o passo opcional de adicionar as stacks
55
86
  │ ├── SKILL.md
56
87
  │ └── assets/
57
88
  ├── eng-qa-gate/ # Quality gate validation
@@ -81,11 +112,11 @@ skills/
81
112
  │ └── SKILL.md
82
113
  ├── eng-qa-unit-test/ # Testes unitarios
83
114
  │ └── SKILL.md
84
- ├── report-issue/ # Reportar bug no próprio Jarvis (JARVIS_PROJECT)
115
+ ├── jarvis-report-issue/ # Reportar bug no próprio Jarvis (JARVIS_PROJECT)
85
116
  │ └── SKILL.md
86
- ├── context-detect/ # Detecta contexto do projeto/tarefa
117
+ ├── jarvis-context-detect/ # Detecta contexto do projeto/tarefa
87
118
  │ └── SKILL.md
88
- └── docs-central/ # Sync/publish docs no central-docs (GitLab/GitHub/Bitbucket)
119
+ └── jarvis-docs-central/ # Sync/publish docs no central-docs (GitLab/GitHub/Bitbucket)
89
120
  └── SKILL.md
90
121
  ```
91
122
 
@@ -127,19 +158,52 @@ license: AGPL-3.0
127
158
  metadata:
128
159
  author: jarvis-team
129
160
  version: "1.0"
161
+ area: backend # obrigatório: área do skill (ver "Áreas e nomes")
162
+ stack: golang # só em especializações de backend/frontend
130
163
  ---
131
164
  ```
132
165
 
166
+ > **`metadata.area` é obrigatório.** Um skill instalado sem área reconhecida faz os comandos `eng.*` serem bloqueados (ver `rules/engineering/eng.skills-rules.md`).
167
+
133
168
  ---
134
169
 
135
- ## Convencoes de Nomenclatura
170
+ ## Áreas e nomes
171
+
172
+ ### Áreas reconhecidas (`metadata.area`)
173
+
174
+ | Área | O que cobre |
175
+ |------|-------------|
176
+ | `backend` | APIs, autenticação, workers, mensageria, banco de dados |
177
+ | `frontend` | Componentes, estado, estilos, performance de UI, acessibilidade |
178
+ | `qa` | Testes, quality gates, relatórios de qualidade |
179
+ | `data` | Pipelines, qualidade e contratos de dados |
180
+ | `ai` | Features com modelos de IA |
181
+ | `security` | Segurança de aplicações |
182
+ | `scraper` | Scraping e automação de robôs |
183
+ | `devops` | Performance, infraestrutura, entrega |
184
+ | `global` | Skills transversais de engenharia e do próprio framework |
185
+ | `product` | Especificação de produto |
186
+
187
+ Skill sem `metadata.area`, ou com área fora desta lista, é tratado como **sem área** (`unknown`) e bloqueia os comandos `eng.*`.
188
+
189
+ ### Nome do skill
190
+
191
+ O nome tem a forma `<prefixo>-<área>-<nome>`; **só os dois primeiros segmentos importam** para a regra, o resto é livre.
192
+
193
+ | Tipo | Padrão | Exemplos |
194
+ |------|--------|----------|
195
+ | Engenharia por área | `eng-<área>-<nome>` | `eng-qa-gate`, `eng-data-engineer`, `eng-security-cybersecurity` |
196
+ | Skill base de backend/frontend | `eng-backend`, `eng-frontend` | — |
197
+ | Especialização de stack | `eng-<backend\|frontend>-<stack>` | `eng-backend-nestjs`, `eng-frontend-design-system` |
198
+ | Engenharia global | `eng-global-<nome>` | `eng-global-pr`, `eng-global-docs-write` |
199
+ | Produto | `product-<nome>` | `product-specs`, `product-specs-update` |
200
+ | Transversal do framework | `jarvis-<nome>` (`area: global`) | `jarvis-init`, `jarvis-docs-central` |
201
+
202
+ ### Skill base, especialização e `stack`
136
203
 
137
- | Domínio | Prefixo | Exemplos |
138
- |---------|---------|----------|
139
- | Engenharia | `eng-` | `eng-docs-write`, `eng-pr`, `eng-arch-c4` |
140
- | Produto | `prod-` | `prod-prd`, `prod-frd`, `prod-epic` |
141
- | QA | `qa-` | `eng-qa-gate`, `eng-qa-test-plan`, `eng-qa-unit-test` |
142
- | Geral / utilitário | _(sem prefixo)_ | `skill-creator`, `docs-index`, `init-jarvis` |
204
+ - **Base:** `area: backend` ou `frontend`, **sem** `stack`. É sempre carregado pela regra `eng.specializations-rules.md`.
205
+ - **Especialização:** `area: backend` ou `frontend`, **com** `metadata.stack` (o sufixo do nome). Só é carregada quando o projeto a registra em `BACKEND_SPECIALIZATIONS` ou `FRONTEND_SPECIALIZATIONS` no `ENV.md`.
206
+ - Demais áreas não têm lista e não usam `stack`.
143
207
 
144
208
  ---
145
209
 
@@ -195,33 +259,32 @@ Skills são invocados de formas diferentes dependendo da IDE:
195
259
 
196
260
  | Comando / Trigger | Skill |
197
261
  |-------------------|-------|
198
- | `/init-jarvis` | `init` |
199
- | `/eng.docs` | `eng-docs-write`, `docs-index` |
262
+ | `/jarvis-init` | `jarvis-init` |
263
+ | `/eng.docs` | `eng-global-docs-write`, `jarvis-docs-index` |
200
264
  | `/eng.pre-pr` | `eng-qa-test-plan` |
201
- | `/eng.pr` | `eng-pr` |
265
+ | `/eng.pr` | `eng-global-pr` |
202
266
  | QA validation | `eng-qa-gate` |
203
267
  | Criar skill | `skill-creator` |
204
268
  | `/taxonomy-manager` | `taxonomy-manager` |
269
+ | Listar especializações de stack (instaladas e registradas) | `jarvis-list-specializations` |
270
+ | Criar uma especialização de stack (backend ou frontend) a partir do código do projeto | `jarvis-create-specialization` |
205
271
  | `/members-manager` | `members-manager` |
206
- | Mensageria, filas, RabbitMQ, events, consumers, producers | `eng-rabbitmq` |
207
- | Gerar prompt para Lovable, criar frontend React com Lovable | `lovable-prompt-generator` |
208
- | APIs REST/GraphQL, auth, workers, RabbitMQ, caching | `eng-backend` |
209
- | Componentes, UI, estado, SSR/SSG, performance, acessibilidade | `eng-frontend` |
210
- | Micro frontend, Module Federation, shell/remote, contratos de interface | `eng-microfrontend` |
211
- | Design system, tokens, CVA, Storybook, versionamento de componentes | `eng-design-system` |
212
- | Módulos NestJS, DI, guards, interceptors, pipes, Passport/JWT | `eng-nestjs` |
272
+ | Mensageria, filas, RabbitMQ, events, consumers, producers | `eng-backend-rabbitmq` (especialização de backend: registrar em `BACKEND_SPECIALIZATIONS`) |
273
+ | APIs, auth, workers, filas, caching, banco de dados | `eng-backend` (base) + `BACKEND_SPECIALIZATIONS` |
274
+ | Componentes, UI, estado, estilos, performance, acessibilidade | `eng-frontend` (base) + `FRONTEND_SPECIALIZATIONS` |
275
+ | Micro frontend, Module Federation, shell/remote, contratos de interface | `eng-frontend-microfrontend` (especialização de frontend) |
276
+ | Design system, tokens, CVA, Storybook, versionamento de componentes | `eng-frontend-design-system` (especialização de frontend) |
277
+ | Módulos NestJS, DI, guards, interceptors, pipes, Passport/JWT | `eng-backend-nestjs` (especialização de backend) |
213
278
  | Web scraping, Puppeteer, extração de dados, parsing, ETL | `eng-scraper` |
214
279
  | Criar robô RPA novo ou manter existente (new|update + card) | `eng.rpa.robot` (workflow) |
215
- | Atendimento técnico, triagem de chamados, diagnóstico, classificação de bugs, escalonamento | `eng-tech-analyst` |
216
280
  | Gerar specs Cypress + TypeScript para fluxos de usuário | `eng-qa-cypress-e2e` |
217
281
  | Sessão de teste exploratório estruturada (charter, risco, achados, bug cards) | `eng-qa-exploratory` |
218
282
  | Orientar dev sobre cobertura Cypress sem escrever o teste | `eng-qa-dev-guide` |
219
283
  | Consolidar sessões exploratórias, bugs e quality gates e gerar relatório de qualidade por sprint/release | `eng-qa-quality-report` |
220
- | Análise de churn SaaS: coleta Slack, classificação por squad via taxonomy, relatório narrativo | `churn-audit` |
221
284
  | Testes de acessibilidade WCAG 2.1 AA: integra jest-axe em testes unitários existentes | `eng-qa-a11y-audit` |
222
285
  | Testes de contrato GraphQL: valida queries frontend contra schema do BFF | `eng-qa-graphql-contract` |
223
286
  | Spec E2E para handoff: cenários priorizados, Page Objects, fixtures, intercepts, setup | `eng-qa-e2e-spec-writer` |
224
- | Segurança de aplicações: OWASP Top 10, secrets, sanitização, headers, supply chain, compliance | `eng-cybersecurity` |
287
+ | Segurança de aplicações: OWASP Top 10, secrets, sanitização, headers, supply chain, compliance | `eng-security-cybersecurity` |
225
288
 
226
289
  ---
227
290
 
@@ -235,10 +298,11 @@ Use o skill-creator:
235
298
 
236
299
  Ou manualmente:
237
300
 
238
- 1. Criar pasta: `skills/{nome}/`
239
- 2. Copiar template: `skills/skill-creator/assets/SKILL-template.md`
240
- 3. Preencher todos os placeholders
241
- 4. Validar estrutura
301
+ 1. Escolher a **área** e o nome no padrão `<prefixo>-<área>-<nome>` (ver "Áreas e nomes")
302
+ 2. Criar pasta: `skills/{nome}/`
303
+ 3. Copiar template: `skills/skill-creator/assets/SKILL-template.md`
304
+ 4. Preencher todos os placeholders, **inclusive `metadata.area`** (e `metadata.stack` se for especialização)
305
+ 5. Validar estrutura: `name` igual ao nome da pasta e área reconhecida
242
306
 
243
307
  ---
244
308
 
@@ -246,7 +310,7 @@ Ou manualmente:
246
310
 
247
311
  ### Nunca
248
312
 
249
- - Criar skill sem frontmatter completo
313
+ - Criar skill sem frontmatter completo ou sem `metadata.area`
250
314
  - Duplicar skill existente
251
315
  - Colocar detalhes de persona (isso vai no agent)
252
316
  - Usar URLs web em references (use caminhos locais)
@@ -16,7 +16,7 @@ Skills existentes e planejadas do framework Jarvis.
16
16
  - **Escopo**: NestJS, JWT/OAuth2/RBAC, RabbitMQ, Redis, webhooks, circuit breaker
17
17
  - **Status**: `criado`
18
18
 
19
- ### `eng-nestjs` ✅
19
+ ### `eng-backend-nestjs` ✅
20
20
  - **Trigger**: framework NestJS — DI, guards, interceptors, pipes, Passport/JWT, circular deps
21
21
  - **Escopo**: módulos, providers, middleware, ConfigModule, testes com `Test.createTestingModule`
22
22
  - **Status**: `criado`
@@ -31,37 +31,32 @@ Skills existentes e planejadas do framework Jarvis.
31
31
  - **Escopo**: exploração com `act()`/`observe()`, geração de script Playwright TypeScript
32
32
  - **Status**: `criado`
33
33
 
34
- ### `eng-tech-analyst` ✅
35
- - **Trigger**: triagem de chamados, diagnóstico de bugs, classificação por área, escalonamento
36
- - **Escopo**: fluxo de triagem, avaliação de impacto, frequência de bugs, comunicação adaptada
37
- - **Status**: `criado`
38
-
39
- ### `eng-design-system` ✅
34
+ ### `eng-frontend-design-system` ✅
40
35
  - **Trigger**: tokens, CVA, Storybook, versionamento de componentes, auditoria visual
41
36
  - **Escopo**: design tokens, variantes com `cva`, componentes reutilizáveis, changelog de UI
42
37
  - **Status**: `criado`
43
38
 
44
- ### `eng-microfrontend` ✅
39
+ ### `eng-frontend-microfrontend` ✅
45
40
  - **Trigger**: Module Federation, shell/remote, contratos de interface, event bus
46
41
  - **Escopo**: Webpack MF, standalone/integrado, shared dependencies, versionamento
47
42
  - **Status**: `criado`
48
43
 
49
- ### `eng-rabbitmq` ✅
44
+ ### `eng-backend-rabbitmq` ✅
50
45
  - **Trigger**: mensageria, filas, events, consumers, producers, DLX
51
46
  - **Escopo**: RabbitMQ, `@golevelup/nestjs-rabbitmq`, retry, DLQ, idempotência
52
47
  - **Status**: `criado`
53
48
 
54
- ### `eng-ms-trace` ✅
49
+ ### `eng-backend-microservices-trace` ✅
55
50
  - **Trigger**: bug cross-service, rastreamento HTTP + AMQP
56
51
  - **Escopo**: correlation ID, tracing distribuído, diagnóstico de falhas entre microsserviços
57
52
  - **Status**: `criado`
58
53
 
59
- ### `eng-performance-engineer` ✅
54
+ ### `eng-devops-performance-engineer` ✅
60
55
  - **Trigger**: performance, latência, throughput, profiling, otimização
61
56
  - **Escopo**: Core Web Vitals, bundle analysis, lazy loading, caching, memory leaks
62
57
  - **Status**: `criado`
63
58
 
64
- ### `eng-arch-c4` ✅
59
+ ### `eng-backend-arch-c4` ✅
65
60
  - **Trigger**: arquitetura C4, diagramas de contexto/container/componente
66
61
  - **Escopo**: modelagem C4, documentação arquitetural, decisões de design
67
62
  - **Status**: `criado`
@@ -71,24 +66,24 @@ Skills existentes e planejadas do framework Jarvis.
71
66
  - **Escopo**: integração de LLMs, prompts, RAG, automação com IA
72
67
  - **Status**: `criado`
73
68
 
74
- ### `eng-browser-extension-builder` ✅
69
+ ### `eng-global-browser-extension-builder` ✅
75
70
  - **Trigger**: extensões de navegador, Chrome extensions, content scripts
76
71
  - **Escopo**: manifest v3, background workers, content scripts, popup UI
77
72
  - **Status**: `criado`
78
73
 
79
- ### `eng-pr` ✅
74
+ ### `eng-global-pr` ✅
80
75
  - **Trigger**: criação de branch, commit, Merge Request
81
- - **Escopo**: git flow, MR description, `eng-task-comment`, code review automation
76
+ - **Escopo**: git flow, MR description, `eng-global-task-comment`, code review automation
82
77
  - **Status**: `criado`
83
78
 
84
- ### `eng-docs-write` ✅
79
+ ### `eng-global-docs-write` ✅
85
80
  - **Trigger**: documentação técnica, ADRs, RFCs, tech specs
86
81
  - **Escopo**: geração e atualização de docs de engenharia
87
82
  - **Status**: `criado`
88
83
 
89
- ### `eng-task-comment` ✅
84
+ ### `eng-global-task-comment` ✅
90
85
  - **Trigger**: comentários técnicos em cards do task manager
91
- - **Escopo**: Jira/Linear/GitHub/Asana via adapter; alias `eng-jira-comment`
86
+ - **Escopo**: Jira/Linear/GitHub/Asana via adapter; alias `eng-global-jira-comment`
92
87
  - **Status**: `criado`
93
88
 
94
89
  ---
@@ -193,21 +188,17 @@ Skills existentes e planejadas do framework Jarvis.
193
188
 
194
189
  ## Skills Criadas — Produto
195
190
 
196
- ### `prod-specs` ✅
197
- - **Trigger**: criação de PRD/FRD
198
- - **Escopo**: especificação de produto, requisitos
191
+ ### `product-specs` ✅
192
+ - **Trigger**: pedido de especificação de produto (PRD, FRD, épico, história, discovery), inclusive em linguagem natural
193
+ - **Escopo**: skill fina, só porta de entrada: aponta para os workflows `prod.spec.*`, que são a fonte única de cada comando
199
194
  - **Status**: `criado`
200
195
 
201
- ### `prod-specs-update` ✅
196
+ ### `product-specs-update` ✅
202
197
  - **Trigger**: atualização de specs existentes
203
198
  - **Escopo**: revisão e evolução de requisitos
204
199
  - **Status**: `criado`
205
200
 
206
- ### `product-specs` ✅
207
- - **Trigger**: especificação de produto (alias)
208
- - **Status**: `criado`
209
-
210
- ### `prod-roadmap-report` ✅
201
+ ### `product-roadmap-report` ✅
211
202
  - **Trigger**: relatório de roadmap de produto
212
203
  - **Status**: `criado`
213
204
 
@@ -221,17 +212,12 @@ Removidas: `checkin`, `checkout`, `daily`, `task-log`, `send-priority`, `sent-pr
221
212
 
222
213
  ## Skills Criadas — Utilitários / Framework
223
214
 
224
- ### `init-jarvis` ✅
215
+ ### `jarvis-init` ✅
225
216
  - **Trigger**: inicialização do framework
226
217
  - **Escopo**: criação de ENV.md, validação de MCPs, onboarding
227
218
  - **Status**: `criado`
228
219
 
229
- ### `churn-audit` ✅
230
- - **Trigger**: análise de churn SaaS por squad
231
- - **Escopo**: coleta via `$MESSAGE_COMUNICATOR`, classificação por taxonomy.md, relatório narrativo
232
- - **Status**: `criado` (v1.5.0)
233
-
234
- ### `report-issue` ✅
220
+ ### `jarvis-report-issue` ✅
235
221
  - **Trigger**: auto-report de bugs no framework Jarvis via GitLab API
236
222
  - **Status**: `criado`
237
223
 
@@ -239,14 +225,10 @@ Removidas: `checkin`, `checkout`, `daily`, `task-log`, `send-priority`, `sent-pr
239
225
  - **Trigger**: criação de novos skills
240
226
  - **Status**: `criado`
241
227
 
242
- ### `docs-index` / `docs-central` / `context-detect` ✅
228
+ ### `jarvis-docs-index` / `jarvis-docs-central` / `jarvis-context-detect` ✅
243
229
  - **Trigger**: indexação de docs, sync com repo central, detecção de contexto
244
230
  - **Status**: `criado`
245
231
 
246
- ### `lovable-prompt-generator` ✅
247
- - **Trigger**: gerar prompts para frontend React via Lovable
248
- - **Status**: `criado`
249
-
250
232
  ---
251
233
 
252
234
  ## Skills Planejadas
@@ -261,7 +243,7 @@ Removidas: `checkin`, `checkout`, `daily`, `task-log`, `send-priority`, `sent-pr
261
243
  - **Escopo**: Docker, Kubernetes, GitHub Actions, Terraform, AWS/GCP, logs/métricas/tracing
262
244
  - **Status**: `planejado`
263
245
 
264
- ### `eng-cybersecurity` ✅
246
+ ### `eng-security-cybersecurity` ✅
265
247
  - **Trigger**: segurança de aplicação, OWASP, hardening, secrets, supply chain, compliance
266
248
  - **Escopo**: OWASP Top 10, secrets management, sanitização, headers de segurança, SAST, supply chain, LGPD/GDPR
267
249
  - **Status**: `criado`
@@ -299,13 +281,12 @@ Removidas: `checkin`, `checkout`, `daily`, `task-log`, `send-priority`, `sent-pr
299
281
  |---|-------|--------|--------------|
300
282
  | 1 | `eng-frontend` | ✅ criado | Alta demanda, dois contextos (React + PHP/Blade) |
301
283
  | 2 | `eng-backend` | ✅ criado | APIs, auth, workers RabbitMQ — core do produto |
302
- | 3 | `eng-nestjs` | ✅ criado | Framework principal — DI, guards, Passport/JWT |
284
+ | 3 | `eng-backend-nestjs` | ✅ criado | Framework principal — DI, guards, Passport/JWT |
303
285
  | 4 | `eng-scraper` | ✅ criado | Puppeteer como primário, ETL pipelines NestJS |
304
- | 5 | `eng-tech-analyst` | ✅ criado | Triagem, diagnóstico e escalonamento |
305
- | 6 | `eng-design-system` | ✅ criado | Tokens, CVA, Storybook, versionamento |
306
- | 7 | `eng-microfrontend` | ✅ criado | Module Federation, shell/remote |
286
+ | 6 | `eng-frontend-design-system` | ✅ criado | Tokens, CVA, Storybook, versionamento |
287
+ | 7 | `eng-frontend-microfrontend` | ✅ criado | Module Federation, shell/remote |
307
288
  | 8 | `eng-database` | planejado | Área densa com muitos anti-patterns críticos |
308
- | 9 | `eng-cybersecurity` | ✅ criado | Transversal — impacta todas as outras áreas |
289
+ | 9 | `eng-security-cybersecurity` | ✅ criado | Transversal — impacta todas as outras áreas |
309
290
  | 10 | `eng-infrastructure` | planejado | Necessário para squads com CI/CD próprio |
310
291
  | 11 | `eng-back-for-frontend` | planejado | BFF, GraphQL gateway — demanda crescente |
311
292
  | 12 | `eng-ui` | planejado | Nicho — criar sob demanda |
@@ -11,6 +11,7 @@ license: AGPL-3.0
11
11
  metadata:
12
12
  author: jarvis-team
13
13
  version: "1.0"
14
+ area: ai
14
15
  ---
15
16
 
16
17
  # AI Engineer - Engenheiro de IA