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.
- package/AGENTS.md +12 -9
- package/agents/AGENTS.md +9 -1
- package/agents/README.md +2 -2
- package/agents/engineering/data/eng.data-engineer.agent.md +2 -2
- package/agents/engineering/eng.agent.md +4 -6
- package/agents/engineering/eng.bug-hunter.md +10 -5
- package/agents/engineering/eng.cybersecurity.agent.md +2 -4
- package/agents/engineering/eng.dev-code-reviewer.md +4 -0
- package/agents/engineering/eng.docs-writer.md +3 -3
- package/agents/engineering/eng.frontend.agent.md +17 -8
- package/agents/engineering/eng.rpa.agent.md +3 -5
- package/agents/engineering/eng.ux-designer.agent.md +4 -0
- package/agents/engineering/qa/eng.qa.cypress-specialist.md +8 -5
- package/agents/engineering/qa/eng.qa.quality-champion-task-agent.md +4 -0
- package/agents/engineering/qa/eng.qa.quality-strategist.md +18 -8
- package/agents/engineering/qa/eng.qa.test-architect.md +17 -6
- package/agents/engineering/qa/eng.qa.test-planner.md +17 -8
- package/agents/engineering/qa/eng.qa.testing-engineer.md +26 -9
- package/agents/product/prod.discovery-interviewer.md +22 -3
- package/agents/product/prod.pm-checker.md +4 -0
- package/bin/commands/map.js +43 -0
- package/bin/commands/tokens.js +93 -0
- package/bin/jarvis.js +10 -0
- package/bin/lib/config/constants.js +11 -0
- package/bin/lib/core/profile-filter.js +113 -0
- package/bin/lib/core/scanner.js +2 -2
- package/bin/lib/core/token-report.js +90 -0
- package/bin/lib/flow-map/index.js +65 -0
- package/bin/lib/flow-map/parse.js +217 -0
- package/bin/lib/flow-map/render.js +86 -0
- package/bin/lib/flow-map/tree.js +199 -0
- package/members.md +1 -1
- package/package.json +4 -2
- package/rules/AGENTS.md +18 -7
- package/rules/engineering/eng-rules.md +2 -12
- package/rules/engineering/eng-security-rules.md +1 -2
- package/rules/engineering/eng.integrations-rules.md +0 -4
- package/rules/engineering/eng.skills-rules.md +0 -4
- package/rules/engineering/eng.specializations-rules.md +0 -4
- package/rules/product/README.md +1 -0
- package/rules/product/prod-rules.md +1 -4
- package/rules/product/prod.spec-rules.md +0 -4
- package/rules/rtk-rules.md +0 -1
- package/{rules → rules-on-demand}/engineering/eng.breakdown-subtasks-rules.md +0 -4
- package/{rules → rules-on-demand}/engineering/eng.plan-rules.md +0 -4
- package/{rules → rules-on-demand}/engineering/eng.pr-rules.md +0 -4
- package/{rules → rules-on-demand}/engineering/eng.pre-pr-rules.md +0 -4
- package/{rules → rules-on-demand}/engineering/eng.start-rules.md +0 -4
- package/{rules → rules-on-demand}/engineering/eng.tech-spec-rules.md +1 -2
- package/{rules → rules-on-demand}/engineering/eng.work-rules.md +0 -4
- package/skills/AGENTS.md +22 -21
- package/skills/SKILLS-ROADMAP.md +0 -4
- package/skills/eng-ai-engineer/SKILL.md +6 -0
- package/skills/eng-backend/SKILL.md +6 -0
- package/skills/eng-backend-arch-c4/SKILL.md +10 -4
- package/skills/eng-backend-microservices-trace/SKILL.md +6 -0
- package/skills/eng-backend-nestjs/SKILL.md +16 -461
- package/skills/eng-backend-nestjs/references/1-arquitetura-modulos.md +54 -0
- package/skills/eng-backend-nestjs/references/2-guards-autenticacao.md +118 -0
- package/skills/eng-backend-nestjs/references/3-interceptors-pipes-filters.md +113 -0
- package/skills/eng-backend-nestjs/references/4-config-logging.md +61 -0
- package/skills/eng-backend-nestjs/references/5-testes.md +83 -0
- package/skills/eng-backend-nestjs/references/6-problemas-comuns.md +53 -0
- package/skills/eng-backend-rabbitmq/SKILL.md +15 -298
- package/skills/eng-backend-rabbitmq/references/1-referencia-endpoints.md +28 -0
- package/skills/eng-backend-rabbitmq/references/2-codigo-consumer-producer.md +90 -0
- package/skills/eng-backend-rabbitmq/references/3-arquiteturas-comuns.md +101 -0
- package/skills/eng-backend-rabbitmq/references/4-troubleshooting.md +93 -0
- package/skills/eng-data-bi/SKILL.md +6 -0
- package/skills/eng-data-debug/SKILL.md +6 -0
- package/skills/eng-data-engineer/SKILL.md +16 -7
- package/skills/eng-data-onboard/SKILL.md +6 -0
- package/skills/eng-data-orchestrator/SKILL.md +6 -0
- package/skills/eng-devops-performance-engineer/SKILL.md +6 -0
- package/skills/eng-frontend/SKILL.md +6 -0
- package/skills/eng-frontend-design-system/SKILL.md +13 -479
- package/skills/eng-frontend-design-system/references/1-estrutura-pacote.md +57 -0
- package/skills/eng-frontend-design-system/references/2-tokens.md +116 -0
- package/skills/eng-frontend-design-system/references/3-componentes.md +165 -0
- package/skills/eng-frontend-design-system/references/4-storybook.md +85 -0
- package/skills/eng-frontend-design-system/references/5-auditoria-versionamento.md +76 -0
- package/skills/eng-frontend-microfrontend/SKILL.md +17 -457
- package/skills/eng-frontend-microfrontend/references/1-criando-remote.md +109 -0
- package/skills/eng-frontend-microfrontend/references/2-configurando-shell.md +70 -0
- package/skills/eng-frontend-microfrontend/references/3-contratos-interface.md +73 -0
- package/skills/eng-frontend-microfrontend/references/4-shared-dependencies.md +48 -0
- package/skills/eng-frontend-microfrontend/references/5-event-bus.md +59 -0
- package/skills/eng-frontend-microfrontend/references/6-monorepo-deploy.md +77 -0
- package/skills/eng-frontend-microfrontend/references/7-troubleshooting.md +45 -0
- package/skills/eng-global-browser-extension-builder/SKILL.md +6 -0
- package/skills/eng-global-docs-write/SKILL.md +10 -5
- package/skills/eng-global-jira-comment/SKILL.md +6 -0
- package/skills/eng-global-pr/SKILL.md +7 -1
- package/skills/eng-global-task-comment/SKILL.md +6 -0
- package/skills/eng-qa-a11y-audit/SKILL.md +10 -4
- package/skills/eng-qa-bug-report/SKILL.md +18 -230
- package/skills/eng-qa-bug-report/references/1-integracao-task-managers.md +148 -0
- package/skills/eng-qa-bug-report/references/2-exemplos-de-uso.md +46 -0
- package/skills/eng-qa-bug-report/references/3-bug-to-test.md +45 -0
- package/skills/eng-qa-cypress-e2e/SKILL.md +6 -0
- package/skills/eng-qa-dev-guide/SKILL.md +9 -1
- package/skills/eng-qa-e2e/SKILL.md +9 -3
- package/skills/eng-qa-e2e-spec-writer/SKILL.md +15 -9
- package/skills/eng-qa-exploratory/SKILL.md +16 -9
- package/skills/eng-qa-gate/SKILL.md +11 -5
- package/skills/eng-qa-gate/assets/checklist-validacao.md +1 -1
- package/skills/eng-qa-graphql-contract/SKILL.md +9 -3
- package/skills/eng-qa-quality-report/SKILL.md +9 -3
- package/skills/eng-qa-test-plan/SKILL.md +6 -0
- package/skills/eng-qa-testsprite/SKILL.md +10 -4
- package/skills/eng-qa-unit-test/SKILL.md +7 -1
- package/skills/eng-scraper/SKILL.md +12 -436
- package/skills/eng-scraper/references/1-puppeteer.md +140 -0
- package/skills/eng-scraper/references/2-playwright-cheerio-pdf.md +82 -0
- package/skills/eng-scraper/references/3-anti-bot.md +94 -0
- package/skills/eng-scraper/references/4-resiliencia-etl-monitoramento.md +137 -0
- package/skills/eng-scraper-robot-builder/SKILL.md +6 -0
- package/skills/eng-security-cybersecurity/SKILL.md +13 -409
- package/skills/eng-security-cybersecurity/references/1-owasp-top-10.md +331 -0
- package/skills/eng-security-cybersecurity/references/2-secrets-management.md +31 -0
- package/skills/eng-security-cybersecurity/references/3-input-validation.md +43 -0
- package/skills/eng-security-cybersecurity/references/4-compliance.md +20 -0
- package/skills/eng-security-patch/SKILL.md +6 -0
- package/skills/eng-security-threat-model/SKILL.md +6 -0
- package/skills/eng-security-triage/SKILL.md +6 -0
- package/skills/jarvis-context-detect/SKILL.md +6 -0
- package/skills/jarvis-create-specialization/SKILL.md +6 -0
- package/skills/jarvis-docs-central/SKILL.md +6 -0
- package/skills/jarvis-docs-index/SKILL.md +10 -2
- package/skills/jarvis-evolution-architect/SKILL.md +439 -0
- package/skills/jarvis-evolution-architect/references/exemplos.md +297 -0
- package/skills/jarvis-evolution-architect/references/guia-de-uso.md +355 -0
- package/skills/jarvis-evolution-architect/references/lentes-e-conceitos.md +292 -0
- package/skills/jarvis-evolution-architect/references/visao-geral.md +272 -0
- package/skills/jarvis-init/SKILL.md +14 -7
- package/skills/jarvis-list-specializations/SKILL.md +6 -0
- package/skills/jarvis-report-issue/SKILL.md +6 -0
- package/skills/product-roadmap-report/SKILL.md +8 -0
- package/skills/product-specs/SKILL.md +9 -0
- package/skills/product-specs-update/SKILL.md +6 -0
- package/taxonomy.md +12 -12
- package/templates/AGENTS.md +2 -0
- package/templates/engineering/tech-spec-delivery-template.md +179 -0
- package/workflows/AGENTS.md +12 -2
- package/workflows/README.md +18 -16
- package/workflows/all-tools.md +7 -1
- package/workflows/engineering/data/data.contract.md +8 -0
- package/workflows/engineering/data/data.new-pipeline.md +10 -0
- package/workflows/engineering/eng.breakdown-subtasks.md +9 -0
- package/workflows/engineering/eng.bug-audit.md +9 -2
- package/workflows/engineering/eng.build-tech-spec.md +17 -146
- package/workflows/engineering/eng.create-ard-from-code.md +8 -0
- package/workflows/engineering/eng.create-ard.md +8 -0
- package/workflows/engineering/eng.create-rfc.md +7 -0
- package/workflows/engineering/eng.debug.md +3 -3
- package/workflows/engineering/eng.docs.md +9 -0
- package/workflows/engineering/eng.light-arch.md +7 -0
- package/workflows/engineering/eng.plan.md +15 -2
- package/workflows/engineering/eng.pr.md +19 -7
- package/workflows/engineering/eng.pre-pr.md +27 -1
- package/workflows/engineering/eng.review.md +13 -0
- package/workflows/engineering/eng.rpa.robot.md +16 -0
- package/workflows/engineering/eng.security-audit.md +7 -0
- package/workflows/engineering/eng.security-incident.md +6 -0
- package/workflows/engineering/eng.security-pipeline.md +9 -0
- package/workflows/engineering/eng.security-review.md +6 -0
- package/workflows/engineering/eng.start.md +22 -6
- package/workflows/engineering/eng.work.md +18 -2
- package/workflows/engineering/frontend/eng.frontend-component.md +7 -0
- package/workflows/engineering/frontend/eng.frontend-perf-audit.md +8 -0
- package/workflows/engineering/frontend/eng.frontend-review.md +8 -0
- package/workflows/engineering/qa/eng.qa-dev-quality-guide.md +6 -0
- package/workflows/engineering/qa/eng.qa-e2e-test-generation.md +6 -0
- package/workflows/engineering/qa/eng.qa-exploratory-session.md +8 -0
- package/workflows/engineering/qa/eng.qa-quality-gate-validation.md +7 -0
- package/workflows/engineering/qa/eng.qa-quality-report.md +7 -0
- package/workflows/engineering/qa/eng.qa-refinement-entry.md +7 -0
- package/workflows/engineering/qa/eng.qa-release-signoff.md +6 -0
- package/workflows/engineering/qa/eng.qa-sprint-planning.md +6 -0
- package/workflows/product/prod.roadmap.preview.md +9 -0
- package/workflows/product/prod.spec.ard.md +97 -0
- package/workflows/product/prod.spec.breakdown.md +10 -0
- package/workflows/product/prod.spec.clarify.md +8 -2
- package/workflows/product/prod.spec.discovery.md +10 -0
- package/workflows/product/prod.spec.epic.md +8 -0
- package/workflows/product/prod.spec.frd.md +7 -0
- package/workflows/product/prod.spec.issue.md +6 -0
- package/workflows/product/prod.spec.md +15 -1
- package/workflows/product/prod.spec.prd.md +7 -0
- package/workflows/taxonomy.md +58 -6
- package/workflows/warm-up.md +24 -9
- 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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
218
|
+
> Use `/taxonomy add` para adicionar opções com validação automática.
|
|
219
219
|
|
|
220
220
|
---
|
|
221
221
|
|
package/templates/AGENTS.md
CHANGED
|
@@ -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.
|
package/workflows/AGENTS.md
CHANGED
|
@@ -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
|
|
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
|
package/workflows/README.md
CHANGED
|
@@ -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
|
|
48
|
-
├── eng
|
|
49
|
-
├── eng
|
|
50
|
-
├── eng
|
|
51
|
-
├── eng
|
|
52
|
-
├── eng
|
|
53
|
-
├── eng
|
|
54
|
-
└── eng
|
|
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
|
|
108
|
-
| `eng
|
|
109
|
-
| `eng
|
|
110
|
-
| `eng
|
|
111
|
-
| `eng
|
|
112
|
-
| `eng
|
|
113
|
-
| `eng
|
|
114
|
-
| `eng
|
|
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
|
|
package/workflows/all-tools.md
CHANGED
|
@@ -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}" \
|