jarvis-ai-framework 2.0.0 → 2.1.1

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 (192) hide show
  1. package/AGENTS.md +12 -9
  2. package/agents/AGENTS.md +9 -1
  3. package/agents/README.md +2 -2
  4. package/agents/engineering/data/eng.data-engineer.agent.md +2 -2
  5. package/agents/engineering/eng.agent.md +4 -6
  6. package/agents/engineering/eng.bug-hunter.md +10 -5
  7. package/agents/engineering/eng.cybersecurity.agent.md +2 -4
  8. package/agents/engineering/eng.dev-code-reviewer.md +4 -0
  9. package/agents/engineering/eng.docs-writer.md +3 -3
  10. package/agents/engineering/eng.frontend.agent.md +17 -8
  11. package/agents/engineering/eng.rpa.agent.md +3 -5
  12. package/agents/engineering/eng.ux-designer.agent.md +4 -0
  13. package/agents/engineering/qa/eng.qa.cypress-specialist.md +8 -5
  14. package/agents/engineering/qa/eng.qa.quality-champion-task-agent.md +4 -0
  15. package/agents/engineering/qa/eng.qa.quality-strategist.md +18 -8
  16. package/agents/engineering/qa/eng.qa.test-architect.md +17 -6
  17. package/agents/engineering/qa/eng.qa.test-planner.md +17 -8
  18. package/agents/engineering/qa/eng.qa.testing-engineer.md +26 -9
  19. package/agents/product/prod.discovery-interviewer.md +22 -3
  20. package/agents/product/prod.pm-checker.md +4 -0
  21. package/bin/commands/map.js +43 -0
  22. package/bin/commands/tokens.js +93 -0
  23. package/bin/jarvis.js +10 -0
  24. package/bin/lib/config/constants.js +11 -0
  25. package/bin/lib/core/profile-filter.js +113 -0
  26. package/bin/lib/core/scanner.js +2 -2
  27. package/bin/lib/core/token-report.js +90 -0
  28. package/bin/lib/flow-map/index.js +65 -0
  29. package/bin/lib/flow-map/parse.js +217 -0
  30. package/bin/lib/flow-map/render.js +86 -0
  31. package/bin/lib/flow-map/tree.js +199 -0
  32. package/members.md +1 -1
  33. package/package.json +4 -2
  34. package/rules/AGENTS.md +18 -7
  35. package/rules/engineering/eng-rules.md +2 -12
  36. package/rules/engineering/eng-security-rules.md +1 -2
  37. package/rules/engineering/eng.integrations-rules.md +0 -4
  38. package/rules/engineering/eng.skills-rules.md +0 -4
  39. package/rules/engineering/eng.specializations-rules.md +0 -4
  40. package/rules/product/README.md +1 -0
  41. package/rules/product/prod-rules.md +1 -4
  42. package/rules/product/prod.spec-rules.md +0 -4
  43. package/rules/rtk-rules.md +0 -1
  44. package/{rules → rules-on-demand}/engineering/eng.breakdown-subtasks-rules.md +0 -4
  45. package/{rules → rules-on-demand}/engineering/eng.plan-rules.md +0 -4
  46. package/{rules → rules-on-demand}/engineering/eng.pr-rules.md +0 -4
  47. package/{rules → rules-on-demand}/engineering/eng.pre-pr-rules.md +0 -4
  48. package/{rules → rules-on-demand}/engineering/eng.start-rules.md +0 -4
  49. package/{rules → rules-on-demand}/engineering/eng.tech-spec-rules.md +1 -2
  50. package/{rules → rules-on-demand}/engineering/eng.work-rules.md +0 -4
  51. package/skills/AGENTS.md +22 -21
  52. package/skills/SKILLS-ROADMAP.md +0 -4
  53. package/skills/eng-ai-engineer/SKILL.md +6 -0
  54. package/skills/eng-backend/SKILL.md +6 -0
  55. package/skills/eng-backend-arch-c4/SKILL.md +10 -4
  56. package/skills/eng-backend-microservices-trace/SKILL.md +6 -0
  57. package/skills/eng-backend-nestjs/SKILL.md +16 -461
  58. package/skills/eng-backend-nestjs/references/1-arquitetura-modulos.md +54 -0
  59. package/skills/eng-backend-nestjs/references/2-guards-autenticacao.md +118 -0
  60. package/skills/eng-backend-nestjs/references/3-interceptors-pipes-filters.md +113 -0
  61. package/skills/eng-backend-nestjs/references/4-config-logging.md +61 -0
  62. package/skills/eng-backend-nestjs/references/5-testes.md +83 -0
  63. package/skills/eng-backend-nestjs/references/6-problemas-comuns.md +53 -0
  64. package/skills/eng-backend-rabbitmq/SKILL.md +15 -298
  65. package/skills/eng-backend-rabbitmq/references/1-referencia-endpoints.md +28 -0
  66. package/skills/eng-backend-rabbitmq/references/2-codigo-consumer-producer.md +90 -0
  67. package/skills/eng-backend-rabbitmq/references/3-arquiteturas-comuns.md +101 -0
  68. package/skills/eng-backend-rabbitmq/references/4-troubleshooting.md +93 -0
  69. package/skills/eng-data-bi/SKILL.md +6 -0
  70. package/skills/eng-data-debug/SKILL.md +6 -0
  71. package/skills/eng-data-engineer/SKILL.md +16 -7
  72. package/skills/eng-data-onboard/SKILL.md +6 -0
  73. package/skills/eng-data-orchestrator/SKILL.md +6 -0
  74. package/skills/eng-devops-performance-engineer/SKILL.md +6 -0
  75. package/skills/eng-frontend/SKILL.md +6 -0
  76. package/skills/eng-frontend-design-system/SKILL.md +13 -479
  77. package/skills/eng-frontend-design-system/references/1-estrutura-pacote.md +57 -0
  78. package/skills/eng-frontend-design-system/references/2-tokens.md +116 -0
  79. package/skills/eng-frontend-design-system/references/3-componentes.md +165 -0
  80. package/skills/eng-frontend-design-system/references/4-storybook.md +85 -0
  81. package/skills/eng-frontend-design-system/references/5-auditoria-versionamento.md +76 -0
  82. package/skills/eng-frontend-microfrontend/SKILL.md +17 -457
  83. package/skills/eng-frontend-microfrontend/references/1-criando-remote.md +109 -0
  84. package/skills/eng-frontend-microfrontend/references/2-configurando-shell.md +70 -0
  85. package/skills/eng-frontend-microfrontend/references/3-contratos-interface.md +73 -0
  86. package/skills/eng-frontend-microfrontend/references/4-shared-dependencies.md +48 -0
  87. package/skills/eng-frontend-microfrontend/references/5-event-bus.md +59 -0
  88. package/skills/eng-frontend-microfrontend/references/6-monorepo-deploy.md +77 -0
  89. package/skills/eng-frontend-microfrontend/references/7-troubleshooting.md +45 -0
  90. package/skills/eng-global-browser-extension-builder/SKILL.md +6 -0
  91. package/skills/eng-global-docs-write/SKILL.md +10 -5
  92. package/skills/eng-global-jira-comment/SKILL.md +6 -0
  93. package/skills/eng-global-pr/SKILL.md +7 -1
  94. package/skills/eng-global-task-comment/SKILL.md +6 -0
  95. package/skills/eng-qa-a11y-audit/SKILL.md +10 -4
  96. package/skills/eng-qa-bug-report/SKILL.md +18 -230
  97. package/skills/eng-qa-bug-report/references/1-integracao-task-managers.md +148 -0
  98. package/skills/eng-qa-bug-report/references/2-exemplos-de-uso.md +46 -0
  99. package/skills/eng-qa-bug-report/references/3-bug-to-test.md +45 -0
  100. package/skills/eng-qa-cypress-e2e/SKILL.md +6 -0
  101. package/skills/eng-qa-dev-guide/SKILL.md +9 -1
  102. package/skills/eng-qa-e2e/SKILL.md +9 -3
  103. package/skills/eng-qa-e2e-spec-writer/SKILL.md +15 -9
  104. package/skills/eng-qa-exploratory/SKILL.md +16 -9
  105. package/skills/eng-qa-gate/SKILL.md +11 -5
  106. package/skills/eng-qa-gate/assets/checklist-validacao.md +1 -1
  107. package/skills/eng-qa-graphql-contract/SKILL.md +9 -3
  108. package/skills/eng-qa-quality-report/SKILL.md +9 -3
  109. package/skills/eng-qa-test-plan/SKILL.md +6 -0
  110. package/skills/eng-qa-testsprite/SKILL.md +10 -4
  111. package/skills/eng-qa-unit-test/SKILL.md +7 -1
  112. package/skills/eng-scraper/SKILL.md +12 -436
  113. package/skills/eng-scraper/references/1-puppeteer.md +140 -0
  114. package/skills/eng-scraper/references/2-playwright-cheerio-pdf.md +82 -0
  115. package/skills/eng-scraper/references/3-anti-bot.md +94 -0
  116. package/skills/eng-scraper/references/4-resiliencia-etl-monitoramento.md +137 -0
  117. package/skills/eng-scraper-robot-builder/SKILL.md +6 -0
  118. package/skills/eng-security-cybersecurity/SKILL.md +13 -409
  119. package/skills/eng-security-cybersecurity/references/1-owasp-top-10.md +331 -0
  120. package/skills/eng-security-cybersecurity/references/2-secrets-management.md +31 -0
  121. package/skills/eng-security-cybersecurity/references/3-input-validation.md +43 -0
  122. package/skills/eng-security-cybersecurity/references/4-compliance.md +20 -0
  123. package/skills/eng-security-patch/SKILL.md +6 -0
  124. package/skills/eng-security-threat-model/SKILL.md +6 -0
  125. package/skills/eng-security-triage/SKILL.md +6 -0
  126. package/skills/jarvis-context-detect/SKILL.md +6 -0
  127. package/skills/jarvis-create-specialization/SKILL.md +6 -0
  128. package/skills/jarvis-docs-central/SKILL.md +6 -0
  129. package/skills/jarvis-docs-index/SKILL.md +10 -2
  130. package/skills/jarvis-evolution-architect/SKILL.md +439 -0
  131. package/skills/jarvis-evolution-architect/references/exemplos.md +297 -0
  132. package/skills/jarvis-evolution-architect/references/guia-de-uso.md +355 -0
  133. package/skills/jarvis-evolution-architect/references/lentes-e-conceitos.md +292 -0
  134. package/skills/jarvis-evolution-architect/references/visao-geral.md +272 -0
  135. package/skills/jarvis-init/SKILL.md +14 -7
  136. package/skills/jarvis-list-specializations/SKILL.md +6 -0
  137. package/skills/jarvis-report-issue/SKILL.md +6 -0
  138. package/skills/product-roadmap-report/SKILL.md +8 -0
  139. package/skills/product-specs/SKILL.md +9 -0
  140. package/skills/product-specs-update/SKILL.md +6 -0
  141. package/taxonomy.md +12 -12
  142. package/templates/AGENTS.md +2 -0
  143. package/templates/engineering/tech-spec-delivery-template.md +179 -0
  144. package/workflows/AGENTS.md +12 -2
  145. package/workflows/README.md +18 -16
  146. package/workflows/all-tools.md +7 -1
  147. package/workflows/engineering/data/data.contract.md +8 -0
  148. package/workflows/engineering/data/data.new-pipeline.md +10 -0
  149. package/workflows/engineering/eng.breakdown-subtasks.md +9 -0
  150. package/workflows/engineering/eng.bug-audit.md +9 -2
  151. package/workflows/engineering/eng.build-tech-spec.md +17 -146
  152. package/workflows/engineering/eng.create-ard-from-code.md +8 -0
  153. package/workflows/engineering/eng.create-ard.md +8 -0
  154. package/workflows/engineering/eng.create-rfc.md +7 -0
  155. package/workflows/engineering/eng.debug.md +3 -3
  156. package/workflows/engineering/eng.docs.md +9 -0
  157. package/workflows/engineering/eng.light-arch.md +7 -0
  158. package/workflows/engineering/eng.plan.md +15 -2
  159. package/workflows/engineering/eng.pr.md +19 -7
  160. package/workflows/engineering/eng.pre-pr.md +27 -1
  161. package/workflows/engineering/eng.review.md +13 -0
  162. package/workflows/engineering/eng.rpa.robot.md +16 -0
  163. package/workflows/engineering/eng.security-audit.md +7 -0
  164. package/workflows/engineering/eng.security-incident.md +6 -0
  165. package/workflows/engineering/eng.security-pipeline.md +9 -0
  166. package/workflows/engineering/eng.security-review.md +6 -0
  167. package/workflows/engineering/eng.start.md +22 -6
  168. package/workflows/engineering/eng.work.md +18 -2
  169. package/workflows/engineering/frontend/eng.frontend-component.md +7 -0
  170. package/workflows/engineering/frontend/eng.frontend-perf-audit.md +8 -0
  171. package/workflows/engineering/frontend/eng.frontend-review.md +8 -0
  172. package/workflows/engineering/qa/eng.qa-dev-quality-guide.md +6 -0
  173. package/workflows/engineering/qa/eng.qa-e2e-test-generation.md +6 -0
  174. package/workflows/engineering/qa/eng.qa-exploratory-session.md +8 -0
  175. package/workflows/engineering/qa/eng.qa-quality-gate-validation.md +7 -0
  176. package/workflows/engineering/qa/eng.qa-quality-report.md +7 -0
  177. package/workflows/engineering/qa/eng.qa-refinement-entry.md +7 -0
  178. package/workflows/engineering/qa/eng.qa-release-signoff.md +6 -0
  179. package/workflows/engineering/qa/eng.qa-sprint-planning.md +6 -0
  180. package/workflows/product/prod.roadmap.preview.md +9 -0
  181. package/workflows/product/prod.spec.ard.md +97 -0
  182. package/workflows/product/prod.spec.breakdown.md +10 -0
  183. package/workflows/product/prod.spec.clarify.md +8 -2
  184. package/workflows/product/prod.spec.discovery.md +10 -0
  185. package/workflows/product/prod.spec.epic.md +8 -0
  186. package/workflows/product/prod.spec.frd.md +7 -0
  187. package/workflows/product/prod.spec.issue.md +6 -0
  188. package/workflows/product/prod.spec.md +15 -1
  189. package/workflows/product/prod.spec.prd.md +7 -0
  190. package/workflows/taxonomy.md +58 -6
  191. package/workflows/warm-up.md +24 -9
  192. package/rules/engineering/eng.downstream-flow-rules.md +0 -297
package/taxonomy.md CHANGED
@@ -58,63 +58,63 @@ Desenvolvedor Júnior (0-2 anos de experiência)
58
58
  - Aprendendo tecnologias e processos
59
59
  - Pede ajuda quando precisar — sem gate obrigatório de TL/PM
60
60
  - Foco em desenvolver habilidades técnicas
61
- - No fluxo downstream: dono ponta-a-ponta do card que assumiu (puxar, implementar, MR, validar, deploy)
61
+ - No card: dono ponta-a-ponta do card que assumiu (puxar, implementar, MR, validar, deploy)
62
62
 
63
63
  ### PLENO
64
64
  Desenvolvedor Pleno (2-4 anos de experiência)
65
65
  - Autonomia em tarefas individuais
66
66
  - Contribui para decisões técnicas
67
67
  - Mentoría desenvolvedores júnior
68
- - No fluxo downstream: dono ponta-a-ponta do card que assumiu
68
+ - No card: dono ponta-a-ponta do card que assumiu
69
69
 
70
70
  ### SENIOR
71
71
  Desenvolvedor Sênior (4+ anos de experiência)
72
72
  - Alta autonomia técnica
73
73
  - Toma decisões arquiteturais
74
74
  - Mentoria e liderança técnica
75
- - No fluxo downstream: dono ponta-a-ponta do card que assumiu
75
+ - No card: dono ponta-a-ponta do card que assumiu
76
76
 
77
77
  ### TECH LEAD
78
78
  Líder técnico de time ou squad
79
79
  - Responsável por direção técnica do time
80
80
  - Coordena desenvolvimento e arquitetura
81
81
  - Interface entre time e stakeholders
82
- - No fluxo downstream: apoia o time. Não é gate — o profissional que assumiu o card conduz ponta-a-ponta. TL desbloqueia e cobre quando pedido.
82
+ - No card: apoia o time. Não é gate — o profissional que assumiu o card conduz ponta-a-ponta. TL desbloqueia e cobre quando pedido.
83
83
 
84
84
  ### SPECIALIST
85
85
  Especialista em área técnica ou disciplina específica
86
86
  - Expert em domínio particular (segurança, performance, etc.)
87
87
  - Consultoria técnica para times
88
88
  - Define padrões e melhores práticas
89
- - No fluxo downstream: dono ponta-a-ponta do card que assumiu
89
+ - No card: dono ponta-a-ponta do card que assumiu
90
90
 
91
91
  ### QA-ENGINEER
92
92
  Engenheiro de Quality Assurance
93
93
  - Planejamento e execução de testes (manuais e automatizados)
94
94
  - Reporte e rastreamento de bugs
95
95
  - Validação técnica de entregas antes da aprovação de produto
96
- - No fluxo downstream: apoia o DEV na validação — não move cards, apenas executa e reporta
96
+ - No card: apoia o DEV na validação — não move cards, apenas executa e reporta
97
97
 
98
98
  ### PM
99
99
  Product Manager
100
100
  - Gestão de produto e roadmap
101
101
  - Define prioridades e features
102
102
  - Interface com stakeholders de negócio
103
- - No fluxo downstream: pode priorizar, aceitar e também assumir/conduzir um card ponta-a-ponta. Aceite apoia — não trava o owner.
103
+ - No card: pode priorizar, aceitar e também assumir/conduzir um card ponta-a-ponta. Aceite apoia — não trava o owner.
104
104
 
105
105
  ### TPM
106
106
  Technical Product Manager
107
107
  - Product Manager com foco técnico
108
108
  - Ponte entre produto e engenharia
109
109
  - Decisões de produto com viés técnico
110
- - No fluxo downstream: pode priorizar, aceitar e também assumir/conduzir um card ponta-a-ponta. Aceite apoia — não trava o owner.
110
+ - No card: pode priorizar, aceitar e também assumir/conduzir um card ponta-a-ponta. Aceite apoia — não trava o owner.
111
111
 
112
112
  ### GPM
113
113
  Group Product Manager
114
114
  - Gerencia múltiplos PMs
115
115
  - Visão estratégica de produto
116
116
  - Coordenação entre diferentes áreas
117
- - No fluxo downstream: pode priorizar, aceitar e também assumir/conduzir um card ponta-a-ponta. Aceite apoia — não trava o owner.
117
+ - No card: pode priorizar, aceitar e também assumir/conduzir um card ponta-a-ponta. Aceite apoia — não trava o owner.
118
118
 
119
119
  ### QUALITY_CHAMPION
120
120
  Designação secundária para devs com função parcial de qualidade dentro do squad.
@@ -124,7 +124,7 @@ Registrado no campo Posição do `members.md` junto com o cargo principal.
124
124
  - Executa quality gates e orienta outros devs via eng-qa-dev-guide
125
125
  - NÃO substitui QA em features críticas, decisões de bloqueio ou sign-off de release
126
126
  - Dedicação típica: ~30% do tempo em atividades de qualidade
127
- - No fluxo downstream: apoia o QA-ENGINEER na cobertura — não toma decisões de bloqueio
127
+ - No card: apoia o QA-ENGINEER na cobertura — não toma decisões de bloqueio
128
128
 
129
129
  ### CTO
130
130
  Chief Technology Officer
@@ -137,7 +137,7 @@ Profissional que acumula funções de outras posições (SPECIALIST, PM, dev, QA
137
137
  - Cargo principal (como SPECIALIST), não designação secundária (diferente de QUALITY_CHAMPION)
138
138
  - Transita entre ENGINEERING e PRODUCT — não fica restrito a uma única área
139
139
  - Em qualquer verificação de POSITION ou AREA, é tratado como coringa/superusuário: satisfaz qualquer valor exigido
140
- - No fluxo downstream: dono ponta-a-ponta do card que assumiu, com autonomia equivalente a TECH LEAD/staff (ver eng-rules.md)
140
+ - No card: dono ponta-a-ponta do card que assumiu, com autonomia equivalente a TECH LEAD/staff (ver eng-rules.md)
141
141
 
142
142
  ---
143
143
 
@@ -215,7 +215,7 @@ prefix: design
215
215
  Área de Design, UX e pesquisa com usuários
216
216
  ```
217
217
 
218
- > Use `/taxonomy-manager add` para adicionar opções com validação automática.
218
+ > Use `/taxonomy add` para adicionar opções com validação automática.
219
219
 
220
220
  ---
221
221
 
@@ -20,6 +20,7 @@ templates/
20
20
  │ ├── RFC-template.md # Request For Comments
21
21
  │ ├── RFC-Playbook@1.0.0.md # Playbook para RFCs
22
22
  │ ├── tech-spec-template.md # Especificacao tecnica
23
+ │ ├── tech-spec-delivery-template.md # Formatos de entrega da tech spec (Jira, mensagem final, fluxo)
23
24
  │ ├── plan-template.md # Plano de execucao
24
25
  │ ├── work-progress-template.md # Progresso de trabalho
25
26
  │ ├── PR-template.md # Pull Request
@@ -107,6 +108,7 @@ Use chaves `{...}` para indicar campos a serem preenchidos:
107
108
  | `ARD-template.md` | Revisao de arquitetura | `/eng.create-ard` |
108
109
  | `RFC-template.md` | Proposta de mudanca | `/eng.create-rfc` |
109
110
  | `tech-spec-template.md` | Especificacao tecnica | `/eng.build-tech-spec` |
111
+ | `tech-spec-delivery-template.md` | Formatos de entrega da tech spec | `/eng.build-tech-spec` |
110
112
  | `plan-template.md` | Plano de execucao | `/eng.plan` |
111
113
  | `PR-template.md` | Pull Request | `/eng.pr` |
112
114
 
@@ -0,0 +1,179 @@
1
+ # Tech Spec — Formatos de Entrega
2
+
3
+ > Template com os formatos usados no fim do `eng.build-tech-spec`: descrição da subtarefa no Jira, comentário na história original, mensagem de entrega e um exemplo preenchido, além do diagrama do fluxo. Substitua os placeholders `{...}`.
4
+
5
+ ## Descrição da subtarefa no Jira
6
+
7
+ Fase 7.2 do workflow. Use este formato na descrição de cada subtarefa criada no Jira (ou entregue ao usuário para copiar e colar).
8
+
9
+ ```markdown
10
+ ## Descrição
11
+
12
+ {Descrição técnica detalhada}
13
+
14
+ ## Arquivos a Modificar/Criar
15
+
16
+ - `path/to/file1.py` - [Modificação] - {Descrição}
17
+ - `path/to/file2.tsx` - [Criação] - {Descrição}
18
+
19
+ ## Critérios de Aceitação
20
+
21
+ - [ ] {Critério 1}
22
+ - [ ] {Critério 2}
23
+
24
+ ## Testes Requeridos
25
+
26
+ - [ ] Teste unitário: {descrição}
27
+ - [ ] Teste de integração: {descrição}
28
+
29
+ ## Dependências
30
+
31
+ {SUBTASK-XXX / Nenhuma}
32
+
33
+ ## Referência
34
+
35
+ Tech Spec: [Link para tech-spec.md]
36
+ ```
37
+
38
+ ## Comentário na história original
39
+
40
+ Fase 7.4 do workflow. Comentário a registrar na história (STORY-XXX) depois de criar as subtarefas.
41
+
42
+ ```
43
+ Tech Spec criada: [Link para tech-spec.md]
44
+
45
+ Subtarefas criadas:
46
+ - SUBTASK-001: {Nome}
47
+ - SUBTASK-002: {Nome}
48
+ - SUBTASK-003: {Nome}
49
+ ...
50
+
51
+ Total de subtarefas: {X}
52
+ Estimativa total: {Y horas}
53
+ ```
54
+
55
+ ## Mensagem de entrega
56
+
57
+ Fase 8.2 do workflow. O que entregar ao usuário ao final.
58
+
59
+ ```
60
+ ✅ Tech Spec criada com sucesso!
61
+
62
+ 📄 Documento Local: $SESSIONS_DIR/eng/{feature-name}/tech-spec.md
63
+ 📎 Anexada no Jira: {STORY-XXX}
64
+
65
+ 📋 Resumo:
66
+ - História: {STORY-XXX} - {Título}
67
+ - Fases: {X fases}
68
+ - Subtarefas: {Y subtarefas}
69
+ - Estimativa total: {Z horas}
70
+
71
+ 🔗 Subtarefas criadas no Jira:
72
+ - SUBTASK-001: {Nome} (P0, 6h)
73
+ - SUBTASK-002: {Nome} (P1, 4h)
74
+ - SUBTASK-003: {Nome} (P1, 8h)
75
+ ...
76
+
77
+ ⚠️ Riscos Principais:
78
+ - {Risco 1}
79
+ - {Risco 2}
80
+
81
+ 📌 Próximos Passos Sugeridos:
82
+ 1. Revisar e aprovar a Tech Spec
83
+ 2. Atribuir subtarefas ao time
84
+ 3. Iniciar desenvolvimento pela Fase 1
85
+ 4. Monitorar progresso e atualizar plan.md
86
+ ```
87
+
88
+ ## Exemplo de output final
89
+
90
+ Exemplo preenchido da mensagem de entrega (fictício).
91
+
92
+ ```markdown
93
+ ✅ Tech Spec para STORY-456 criada com sucesso!
94
+
95
+ 📄 **Documento Local**: $SESSIONS_DIR/eng/story-456/tech-spec.md
96
+ 📎 **Anexado no Jira**: STORY-456
97
+
98
+ 📊 **Resumo**:
99
+
100
+ - **História**: STORY-456 - Implementar autenticação de usuários
101
+ - **Fases**: 3 fases (Backend, Frontend, Testes)
102
+ - **Subtarefas**: 5 subtarefas
103
+ - **Estimativa total**: 26 horas
104
+
105
+ 🔗 **Subtarefas criadas no Jira**:
106
+
107
+ - SUBTASK-101: [BACKEND] Criar endpoint POST /api/auth/register (P0, 6h)
108
+ - SUBTASK-102: [BACKEND] Criar endpoint POST /api/auth/login (P0, 6h)
109
+ - SUBTASK-103: [BACKEND] Criar endpoint POST /api/auth/logout (P1, 4h)
110
+ - SUBTASK-104: [FRONTEND] Criar tela de login integrada à API (P1, 6h)
111
+ - SUBTASK-105: [QA] Testes E2E do fluxo de autenticação (P2, 4h)
112
+
113
+ ⚠️ **Riscos Principais**:
114
+
115
+ - JWT secret precisa estar em variável de ambiente
116
+ - Performance de bcrypt pode impactar tempo de login (mitigado com salt rounds = 10)
117
+
118
+ 📐 **Decisões Arquiteturais**:
119
+
120
+ - Escolhido JWT em vez de sessões (stateless, escalável)
121
+ - Bcrypt para hash de senhas (padrão da indústria)
122
+ - Rate limiting em login (proteção contra brute force)
123
+
124
+ 📌 **Próximos Passos**:
125
+
126
+ 1. ✅ Revisar tech spec (aguardando sua aprovação)
127
+ 2. Atribuir SUBTASK-101 a 103 para desenvolvedor backend
128
+ 3. Atribuir SUBTASK-104 para desenvolvedor frontend
129
+ 4. Iniciar pelo backend - SUBTASK-101 e 102
130
+ 5. Configurar variáveis de ambiente em staging/prod
131
+
132
+ 🎯 **Pronto para iniciar desenvolvimento!**
133
+ ```
134
+
135
+ ## Fluxo resumido
136
+
137
+ Visão geral do fluxo do workflow, do tipo de documento (épico ou história) até a entrega.
138
+
139
+ ```
140
+ ┌─────────────────────────────────────────────────────────┐
141
+ │ 0. DETECÇÃO DO TIPO │
142
+ │ └─ Épico ou História? (inferir ou perguntar) │
143
+ └─────────────────────────────────────────────────────────┘
144
+ ↓
145
+ ┌─────────────────────────────────────────────────────────┐
146
+ │ 1. ENTENDIMENTO │
147
+ │ └─ Ler card, fazer perguntas, validar contexto │
148
+ └─────────────────────────────────────────────────────────┘
149
+ ↓
150
+ ┌──────────────┴──────────────┐
151
+ ▼ ▼
152
+ ┌───────────────┐ ┌───────────────┐
153
+ │ ÉPICO │ │ HISTÓRIA │
154
+ ├───────────────┤ ├───────────────┤
155
+ │ 2A. Investig. │ │ 2B. Investig. │
156
+ │ arquit. │ │ codebase │
157
+ ├───────────────┤ ├───────────────┤
158
+ │ 3A. Proposta │ │ 2.5B. Compl. │
159
+ │ arquit. │ ├───────────────┤
160
+ ├───────────────┤ │ 3B. Proposta │
161
+ │ 4A. Doc │ ├───────────────┤
162
+ │ tech-spec- │ │ 4B. Subtaref. │
163
+ │ arch.md │ ├───────────────┤
164
+ └───────────────┘ │ 5B. Riscos │
165
+ ├───────────────┤
166
+ │ 6B. Doc │
167
+ │ tech-spec.md │
168
+ ├───────────────┤
169
+ │ 7B. $TASK_MGR │
170
+ ├───────────────┤
171
+ │ 8B. Entrega │
172
+ └───────────────┘
173
+ ```
174
+
175
+ ---
176
+
177
+ **Notas para o agente**:
178
+ - Este arquivo só traz formatos: o passo a passo continua em `workflows/engineering/eng.build-tech-spec.md`.
179
+ - Mantenha os placeholders `{...}` até ter os dados reais; não invente links, estimativas nem ids.
@@ -56,7 +56,7 @@ workflows/
56
56
  │ ├── eng.frontend-review.md # Revisão de PR frontend
57
57
  │ └── eng.frontend-perf-audit.md # Auditoria de performance (Core Web Vitals)
58
58
  └── qa/
59
- └── eng-qa-quality-gate-validation.md
59
+ └── eng.qa-quality-gate-validation.md
60
60
  ```
61
61
 
62
62
  ---
@@ -112,6 +112,12 @@ O que este workflow faz.
112
112
  - Validar ENV.md
113
113
  - Outros requisitos
114
114
 
115
+ ### Skills invocados durante o workflow
116
+
117
+ | Passo | Skill | Condição |
118
+ |-------|-------|----------|
119
+ | Fase 1 | `/nome-da-skill` | Condição real do texto do workflow |
120
+
115
121
  ## Entrada
116
122
  - `$ARGUMENTS` - Descricao
117
123
  - Outros inputs
@@ -133,6 +139,10 @@ Artefatos gerados.
133
139
  Feedback ao usuario.
134
140
  ```
135
141
 
142
+ A tabela `### Skills invocados durante o workflow` lista o que o workflow dispara no proprio fluxo: skills, outros workflows, agentes e MCP/CLI citados pelo nome (nao vale ferramenta interna como `Read`/`Grep`, nem "proximos passos" ou pre-requisito pedido ao usuario). Uma linha por referencia, com a condicao real. Fica logo depois da secao de recursos/dependencias (ou, sem ela, depois do titulo e da descricao). Sem chamadas: uma linha `Nenhuma — workflow autocontido`. Modelo: `engineering/eng.debug.md`.
143
+
144
+ O `jarvis map` e a verificação do `npm run test:comandos` leem **só** a tabela (e, nos agentes, as seções `## Skills Disponíveis` e `## Workflows e Agentes Relacionados`): uma chamada que existir apenas no texto corrido não aparece no mapa, e um nome citado na tabela que não existir faz o teste falhar. Mantenha a tabela em dia ao alterar o artefato.
145
+
136
146
  ---
137
147
 
138
148
  ## Fases de Desenvolvimento
@@ -221,7 +231,7 @@ Workflows de engenharia seguem fases restritas:
221
231
 
222
232
  1. Identificar necessidade (verificar existentes)
223
233
  2. Criar command em `commands/`
224
- 3. Criar workflow seguindo estrutura padrao
234
+ 3. Criar workflow seguindo estrutura padrao, incluindo a tabela `Skills invocados durante o workflow`
225
235
  4. Definir restricoes de fase (se engenharia)
226
236
  5. Vincular a templates (se aplicavel)
227
237
  6. Atualizar README.md
@@ -17,6 +17,7 @@ workflows/
17
17
  │ ├── prod.spec.discovery.md # Investigação inicial de uma ideia (rascunho)
18
18
  │ ├── prod.spec.prd.md # Documento de Requisitos de Produto
19
19
  │ ├── prod.spec.frd.md # Documento de Requisitos Funcionais
20
+ │ ├── prod.spec.ard.md # ARD a partir do produto
20
21
  │ ├── prod.spec.breakdown.md # Quebra em versões / épicos / histórias
21
22
  │ ├── prod.spec.epic.md # Épicos
22
23
  │ ├── prod.spec.issue.md # Issues (stories, tasks, bugs)
@@ -44,14 +45,14 @@ workflows/
44
45
  │ ├── eng.frontend-review.md # Revisão de PR frontend (TS, tokens, a11y, MFE)
45
46
  │ └── eng.frontend-perf-audit.md # Auditoria Core Web Vitals e bundle
46
47
  └── qa/
47
- ├── eng-qa-quality-gate-validation.md
48
- ├── eng-qa-e2e-test-generation.md
49
- ├── eng-qa-exploratory-session.md
50
- ├── eng-qa-dev-quality-guide.md
51
- ├── eng-qa-quality-report.md
52
- ├── eng-qa-refinement-entry.md
53
- ├── eng-qa-release-signoff.md
54
- └── eng-qa-sprint-planning.md
48
+ ├── eng.qa-quality-gate-validation.md
49
+ ├── eng.qa-e2e-test-generation.md
50
+ ├── eng.qa-exploratory-session.md
51
+ ├── eng.qa-dev-quality-guide.md
52
+ ├── eng.qa-quality-report.md
53
+ ├── eng.qa-refinement-entry.md
54
+ ├── eng.qa-release-signoff.md
55
+ └── eng.qa-sprint-planning.md
55
56
  ```
56
57
 
57
58
  ---
@@ -74,6 +75,7 @@ workflows/
74
75
  | `prod.spec.discovery.md` | Investigar uma ideia inicial (problema, requisitos e viabilidade) e gerar um rascunho |
75
76
  | `prod.spec.prd.md` | Criar/editar Documento de Requisitos de Produto |
76
77
  | `prod.spec.frd.md` | Criar/editar Documento de Requisitos Funcionais |
78
+ | `prod.spec.ard.md` | Levantar requisitos arquiteturais com o PM e conduzir o ARD |
77
79
  | `prod.spec.breakdown.md` | Quebrar spec grande em versões, épicos e histórias |
78
80
  | `prod.spec.epic.md` | Criar/editar épicos |
79
81
  | `prod.spec.issue.md` | Criar/editar issues (stories, tasks, bugs) |
@@ -104,14 +106,14 @@ workflows/
104
106
  | `eng.frontend-component.md` | Criar ou refatorar componente frontend com qualidade (design system vs remote, a11y, testes) |
105
107
  | `eng.frontend-review.md` | Revisão de código específica para PRs frontend (TypeScript, tokens, a11y, MFE) |
106
108
  | `eng.frontend-perf-audit.md` | Auditoria de performance frontend (Core Web Vitals, bundle, diagnóstico por métrica) |
107
- | `eng-qa-quality-gate-validation.md` | Validação de quality gate de um ticket |
108
- | `eng-qa-e2e-test-generation.md` | Geração de testes E2E Cypress para uma feature |
109
- | `eng-qa-exploratory-session.md` | Conduzir sessão de teste exploratório |
110
- | `eng-qa-dev-quality-guide.md` | Orientar dev a escrever seus próprios testes Cypress |
111
- | `eng-qa-quality-report.md` | Relatório de qualidade consolidado por sprint/release |
112
- | `eng-qa-refinement-entry.md` | Entrada do QA no refinement de tickets |
113
- | `eng-qa-release-signoff.md` | Sign-off QA pré-deploy (GO/NO-GO) |
114
- | `eng-qa-sprint-planning.md` | Planejamento de capacidade QA por sprint |
109
+ | `eng.qa-quality-gate-validation.md` | Validação de quality gate de um ticket |
110
+ | `eng.qa-e2e-test-generation.md` | Geração de testes E2E Cypress para uma feature |
111
+ | `eng.qa-exploratory-session.md` | Conduzir sessão de teste exploratório |
112
+ | `eng.qa-dev-quality-guide.md` | Orientar dev a escrever seus próprios testes Cypress |
113
+ | `eng.qa-quality-report.md` | Relatório de qualidade consolidado por sprint/release |
114
+ | `eng.qa-refinement-entry.md` | Entrada do QA no refinement de tickets |
115
+ | `eng.qa-release-signoff.md` | Sign-off QA pré-deploy (GO/NO-GO) |
116
+ | `eng.qa-sprint-planning.md` | Planejamento de capacidade QA por sprint |
115
117
 
116
118
  ---
117
119
 
@@ -8,4 +8,10 @@ model_justification: Listagem simples de ferramentas, não requer raciocínio co
8
8
 
9
9
  # all-tools
10
10
 
11
- Liste todas as ferramentas disponíveis detalhadas em seu prompt da plataforma. Exiba-as em marcadores. Mostre-as em formato de assinatura de função TypeScript e inclua o propósito da ferramenta como sufixo.
11
+ Liste todas as ferramentas disponíveis detalhadas em seu prompt da plataforma. Exiba-as em marcadores. Mostre-as em formato de assinatura de função TypeScript e inclua o propósito da ferramenta como sufixo.
12
+
13
+ ### Skills invocados durante o workflow
14
+
15
+ | Passo | Skill | Condição |
16
+ |-------|-------|----------|
17
+ | — | Nenhuma — workflow autocontido | — |
@@ -37,6 +37,14 @@ seguindo as convenções definidas em `$IDE/rules/engineering/data/data-rules.md
37
37
  - Arquivo: `$IDE/agents/engineering/eng.docs-writer.md`
38
38
  - Quando usar: contratos de domínios com muitos termos de negócio (financeiro, operacional, BI).
39
39
 
40
+ ### Skills invocados durante o workflow
41
+
42
+ | Passo | Skill | Condição |
43
+ |-------|-------|----------|
44
+ | Agentes recomendados | `eng.data-engineer.agent` (agente) | Sempre — agente primário que conduz todo o workflow |
45
+ | Agentes recomendados | `prod.pm-checker` (agente) | Se o caso de uso vier de uma solicitação de produto (analytics/BI) ou houver ambiguidade sobre o que a squad precisa |
46
+ | Agentes recomendados | `eng.docs-writer` (agente) | Se o contrato for de domínio com muitos termos de negócio (financeiro, operacional, BI) |
47
+
40
48
  ---
41
49
 
42
50
  ## Entrada
@@ -38,6 +38,16 @@ seguindo as convenções definidas em `$IDE/rules/engineering/data/data-rules.md
38
38
  - Arquivo: `$IDE/agents/engineering/eng.docs-writer.md`
39
39
  - Quando usar: pipelines de alta criticidade ou que precisam de documentação de suporte além do template padrão.
40
40
 
41
+ ### Skills invocados durante o workflow
42
+
43
+ | Passo | Skill | Condição |
44
+ |-------|-------|----------|
45
+ | Agentes recomendados | `eng.data-engineer.agent` (agente) | Sempre — agente primário que conduz todo o workflow |
46
+ | Pré-verificação — Fonte nova ou existente? | `/eng-data-onboard` | Se a fonte nunca foi ingerida antes (pipeline totalmente novo); depois volta a este workflow |
47
+ | Agentes recomendados | `eng.dev-code-reviewer` (agente) | Se o pipeline tiver lógica de transformação complexa ou antes de qualquer push ao repositório de pipelines |
48
+ | Agentes recomendados | `eng.qa.test-planner` (agente) | Se o pipeline for gold com múltiplos casos de uso, dados sensíveis ou SLA rigoroso (apoio à Expectation Suite) |
49
+ | Agentes recomendados | `eng.docs-writer` (agente) | Se o pipeline for de alta criticidade ou precisar de documentação além do template (diagramas, runbook, troubleshooting) |
50
+
41
51
  ---
42
52
 
43
53
  ## Entrada
@@ -4,6 +4,7 @@ auto_execution_mode: 0
4
4
  recommended_model: claude-sonnet-4-20250514
5
5
  model_tier: high
6
6
  model_justification: Decomposição de tarefas requer análise detalhada, geração de código de exemplo e estruturação de subtarefas executáveis
7
+ rules_file: "$IDE/rules-on-demand/engineering/eng.breakdown-subtasks-rules.md"
7
8
  ---
8
9
  # Breakdown Subtasks - Gerador de Subtarefas Mastigadas
9
10
 
@@ -11,10 +12,18 @@ Você receberá uma Tech Spec completa e deve quebrá-la em subtarefas **EXTREMA
11
12
 
12
13
  > ⚠️ **PRINCÍPIO FUNDAMENTAL**: Cada subtarefa deve ser tão detalhada que um desenvolvedor júnior possa executá-la SEM precisar perguntar nada. A subtarefa deve ser um "tutorial passo-a-passo" completo.
13
14
 
15
+ > 📋 **Rules**: `$IDE/rules-on-demand/engineering/eng.breakdown-subtasks-rules.md` — **antes de começar, leia esse arquivo e siga-o**: ele não é carregado automaticamente no início da sessão.
16
+
14
17
  <input>
15
18
  #$ARGUMENTS
16
19
  </input>
17
20
 
21
+ ### Skills invocados durante o workflow
22
+
23
+ | Passo | Skill | Condição |
24
+ |-------|-------|----------|
25
+ | — | Nenhuma — workflow autocontido | — |
26
+
18
27
  ---
19
28
 
20
29
  ## Fase 1: Análise Profunda da Tech Spec
@@ -57,6 +57,13 @@ Onde [escopo] pode ser:
57
57
  - Por tecnologia: --tech=react
58
58
  ```
59
59
 
60
+ ### Skills invocados durante o workflow
61
+
62
+ | Passo | Skill | Condição |
63
+ |-------|-------|----------|
64
+ | Fase 0 – Análise de Contexto (CDD) | `/jarvis-context-detect` | Se existir uma sessão ativa (e `ENABLE_CDD=true` no ENV.md) |
65
+ | Fase 5 – Ticketing › 5.1 | `/eng-qa-bug-report create` | Para cada problema P0 e P1 encontrado no audit |
66
+
60
67
  ---
61
68
 
62
69
  ## Fase 0 – Análise de Contexto (CDD)
@@ -456,12 +463,12 @@ echo "✅ Relatório gerado em: $SESSIONS_DIR/eng/bug-audit-$(date +%Y%m%d-%H%M%
456
463
 
457
464
  ## Fase 5 – Ticketing (Criação de Cards no Task Manager)
458
465
 
459
- ### 5.1 Usar Skill bug-report
466
+ ### 5.1 Usar Skill eng-qa-bug-report
460
467
 
461
468
  Para cada problema P0 e P1:
462
469
 
463
470
  ```bash
464
- /bug-report create \
471
+ /eng-qa-bug-report create \
465
472
  --title="{título do bug}" \
466
473
  --category="{categoria}" \
467
474
  --severity="{P0|P1|P2|P3}" \