jarvis-ai-framework 1.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 (240) hide show
  1. package/AGENTS.md +416 -0
  2. package/LICENSE +21 -0
  3. package/README.md +190 -0
  4. package/agents/AGENTS.md +234 -0
  5. package/agents/README.md +309 -0
  6. package/agents/engineering/data/eng.data-engineer.agent.md +309 -0
  7. package/agents/engineering/eng.agent.md +303 -0
  8. package/agents/engineering/eng.bug-hunter.md +386 -0
  9. package/agents/engineering/eng.cybersecurity.agent.md +503 -0
  10. package/agents/engineering/eng.dev-code-reviewer.md +148 -0
  11. package/agents/engineering/eng.docs-writer.md +152 -0
  12. package/agents/engineering/eng.frontend.agent.md +117 -0
  13. package/agents/engineering/eng.rpa.agent.md +215 -0
  14. package/agents/engineering/eng.tech-analyst.agent.md +102 -0
  15. package/agents/engineering/eng.ux-designer.agent.md +193 -0
  16. package/agents/engineering/qa/eng.qa.cypress-specialist.md +109 -0
  17. package/agents/engineering/qa/eng.qa.quality-champion-task-agent.md +85 -0
  18. package/agents/engineering/qa/eng.qa.quality-strategist.md +111 -0
  19. package/agents/engineering/qa/eng.qa.test-architect.md +400 -0
  20. package/agents/engineering/qa/eng.qa.test-planner.md +477 -0
  21. package/agents/engineering/qa/eng.qa.testing-engineer.md +339 -0
  22. package/agents/product/prod.pm-checker.md +52 -0
  23. package/bin/commands/docs-publish.js +184 -0
  24. package/bin/commands/docs-sync.js +139 -0
  25. package/bin/commands/info.js +87 -0
  26. package/bin/commands/init.js +237 -0
  27. package/bin/commands/install-rtk.js +90 -0
  28. package/bin/commands/list.js +48 -0
  29. package/bin/commands/qa-signoff.js +112 -0
  30. package/bin/commands/whoami.js +43 -0
  31. package/bin/jarvis.js +159 -0
  32. package/bin/lib/auth/session.js +56 -0
  33. package/bin/lib/config/constants.js +123 -0
  34. package/bin/lib/config/ide-config.js +233 -0
  35. package/bin/lib/core/scanner.js +124 -0
  36. package/bin/lib/core/sync-engine.js +551 -0
  37. package/bin/lib/docs/fetch-file.sh +41 -0
  38. package/bin/lib/docs/publish-file.sh +284 -0
  39. package/bin/lib/docs/validate-frontmatter.js +157 -0
  40. package/bin/lib/env-loader.js +198 -0
  41. package/bin/lib/tasks/comment.js +131 -0
  42. package/bin/lib/utils/git-parser.js +145 -0
  43. package/bin/lib/utils/logger.js +104 -0
  44. package/bin/lib/utils/npmrc-parser.js +106 -0
  45. package/bin/lib/utils/paths.js +55 -0
  46. package/bin/lib/utils/ui.js +59 -0
  47. package/bin/lib/vcs/api.js +312 -0
  48. package/bin/lib/vcs/create-issue.js +43 -0
  49. package/bin/lib/vcs/create-merge.js +43 -0
  50. package/bin/lib/vcs/fetch-raw.js +30 -0
  51. package/bin/postinstall.js +41 -0
  52. package/members.md +25 -0
  53. package/package.json +55 -0
  54. package/rules/AGENTS.md +205 -0
  55. package/rules/engineering/data/data-rules.md +200 -0
  56. package/rules/engineering/eng-rules.md +243 -0
  57. package/rules/engineering/eng-security-rules.md +186 -0
  58. package/rules/engineering/eng.breakdown-subtasks-rules.md +585 -0
  59. package/rules/engineering/eng.bump-rules.md +27 -0
  60. package/rules/engineering/eng.docs-scraping-rules.md +64 -0
  61. package/rules/engineering/eng.downstream-flow-rules.md +297 -0
  62. package/rules/engineering/eng.integrations-rules.md +73 -0
  63. package/rules/engineering/eng.plan-rules.md +333 -0
  64. package/rules/engineering/eng.pr-rules.md +359 -0
  65. package/rules/engineering/eng.pre-pr-rules.md +103 -0
  66. package/rules/engineering/eng.start-rules.md +246 -0
  67. package/rules/engineering/eng.tech-spec-rules.md +968 -0
  68. package/rules/engineering/eng.work-rules.md +312 -0
  69. package/rules/engineering/frontend/eng.frontend-rules.md +147 -0
  70. package/rules/engineering/qa/eng.qa.cypress-standards-rules.md +259 -0
  71. package/rules/engineering/qa/eng.qa.exploratory-session-rules.md +137 -0
  72. package/rules/engineering/qa/eng.qa.quality-gate-scoring-rules.md +181 -0
  73. package/rules/engineering/qa/eng.qa.tech-spec-validation-criteria-rules.md +120 -0
  74. package/rules/engineering/rpa/eng.rpa-rules.md +230 -0
  75. package/rules/product/README.md +24 -0
  76. package/rules/product/prod-rules.md +151 -0
  77. package/rules/rtk-rules.md +68 -0
  78. package/skills/AGENTS.md +290 -0
  79. package/skills/SKILLS-ROADMAP.md +333 -0
  80. package/skills/churn-audit/SKILL.md +385 -0
  81. package/skills/context-detect/SKILL.md +399 -0
  82. package/skills/context-detect/assets/context-profile-template.md +127 -0
  83. package/skills/docs-central/README.md +310 -0
  84. package/skills/docs-central/SKILL.md +423 -0
  85. package/skills/docs-index/SKILL.md +377 -0
  86. package/skills/eng-ai-engineer/SKILL.md +296 -0
  87. package/skills/eng-arch-c4/SKILL.md +358 -0
  88. package/skills/eng-arch-c4/assets/example-code.md +189 -0
  89. package/skills/eng-arch-c4/assets/example-component.md +105 -0
  90. package/skills/eng-arch-c4/assets/example-container.md +104 -0
  91. package/skills/eng-arch-c4/assets/example-context.md +81 -0
  92. package/skills/eng-backend/SKILL.md +776 -0
  93. package/skills/eng-browser-extension-builder/SKILL.md +385 -0
  94. package/skills/eng-cybersecurity/SKILL.md +645 -0
  95. package/skills/eng-data-bi/SKILL.md +199 -0
  96. package/skills/eng-data-debug/SKILL.md +307 -0
  97. package/skills/eng-data-engineer/SKILL.md +256 -0
  98. package/skills/eng-data-onboard/SKILL.md +310 -0
  99. package/skills/eng-data-orchestrator/SKILL.md +426 -0
  100. package/skills/eng-design-system/SKILL.md +619 -0
  101. package/skills/eng-docs-write/SKILL.md +312 -0
  102. package/skills/eng-frontend/SKILL.md +913 -0
  103. package/skills/eng-jira-comment/SKILL.md +17 -0
  104. package/skills/eng-microfrontend/SKILL.md +602 -0
  105. package/skills/eng-ms-trace/SKILL.md +469 -0
  106. package/skills/eng-nestjs/SKILL.md +791 -0
  107. package/skills/eng-performance-engineer/SKILL.md +312 -0
  108. package/skills/eng-pr/SKILL.md +339 -0
  109. package/skills/eng-qa-a11y-audit/SKILL.md +269 -0
  110. package/skills/eng-qa-bug-report/SKILL.md +1088 -0
  111. package/skills/eng-qa-bug-report/TASK_MANAGERS.md +138 -0
  112. package/skills/eng-qa-cypress-e2e/SKILL.md +177 -0
  113. package/skills/eng-qa-dev-guide/SKILL.md +164 -0
  114. package/skills/eng-qa-e2e/SKILL.md +400 -0
  115. package/skills/eng-qa-e2e-spec-writer/SKILL.md +322 -0
  116. package/skills/eng-qa-exploratory/SKILL.md +188 -0
  117. package/skills/eng-qa-gate/SKILL.md +370 -0
  118. package/skills/eng-qa-gate/assets/checklist-validacao.md +291 -0
  119. package/skills/eng-qa-graphql-contract/SKILL.md +256 -0
  120. package/skills/eng-qa-quality-report/SKILL.md +412 -0
  121. package/skills/eng-qa-test-plan/SKILL.md +466 -0
  122. package/skills/eng-qa-test-plan/assets/test-coverage-template.md +92 -0
  123. package/skills/eng-qa-test-plan/assets/test-patterns.md +178 -0
  124. package/skills/eng-qa-testsprite/SKILL.md +325 -0
  125. package/skills/eng-qa-testsprite/references/testsprite-mcp.md +224 -0
  126. package/skills/eng-qa-unit-test/SKILL.md +471 -0
  127. package/skills/eng-rabbitmq/SKILL.md +661 -0
  128. package/skills/eng-scraper/SKILL.md +683 -0
  129. package/skills/eng-scraper-robot-builder/SKILL.md +370 -0
  130. package/skills/eng-security-patch/SKILL.md +378 -0
  131. package/skills/eng-security-triage/SKILL.md +266 -0
  132. package/skills/eng-task-comment/SKILL.md +60 -0
  133. package/skills/eng-tech-analyst/SKILL.md +529 -0
  134. package/skills/eng-threat-model/SKILL.md +161 -0
  135. package/skills/init-jarvis/SKILL.md +1304 -0
  136. package/skills/init-jarvis/assets/mcp-configs.md +389 -0
  137. package/skills/init-jarvis/assets/onboarding-checklist.md +104 -0
  138. package/skills/init-jarvis/assets/setup-guide.md +360 -0
  139. package/skills/lovable-prompt-generator/SKILL.md +304 -0
  140. package/skills/prod-roadmap-report/README.md +303 -0
  141. package/skills/prod-roadmap-report/SKILL.md +198 -0
  142. package/skills/prod-roadmap-report/commands/status.compiled.single.team.md +23 -0
  143. package/skills/prod-roadmap-report/commands/status.list.projects.md +17 -0
  144. package/skills/prod-roadmap-report/commands/status.memory.md +192 -0
  145. package/skills/prod-roadmap-report/commands/status.roadmap.preview.md +94 -0
  146. package/skills/prod-roadmap-report/references/detailed-guide.md +236 -0
  147. package/skills/prod-roadmap-report/rules/detailed-guide.md +237 -0
  148. package/skills/prod-roadmap-report/rules/status-report-rules.md +44 -0
  149. package/skills/prod-roadmap-report/templates/template-multiple-teams-compiled-status.md +53 -0
  150. package/skills/prod-roadmap-report/templates/template-projects-list.md +23 -0
  151. package/skills/prod-roadmap-report/templates/template-single-team-compiled-status.md +60 -0
  152. package/skills/prod-roadmap-report/templates/template-single-team-status.md +49 -0
  153. package/skills/prod-specs/SKILL.md +108 -0
  154. package/skills/prod-specs/references/prod.spec.clarify.md +176 -0
  155. package/skills/prod-specs/references/prod.spec.epic.md +107 -0
  156. package/skills/prod-specs/references/prod.spec.frd.md +135 -0
  157. package/skills/prod-specs/references/prod.spec.issue.md +145 -0
  158. package/skills/prod-specs/references/prod.spec.prd.md +118 -0
  159. package/skills/prod-specs/rules/prod-spec-rules.md +186 -0
  160. package/skills/prod-specs/templates/prod-breakdown-template.md +136 -0
  161. package/skills/prod-specs/templates/prod-epic-template.md +76 -0
  162. package/skills/prod-specs/templates/prod-frd-template.md +172 -0
  163. package/skills/prod-specs/templates/prod-issue-template.md +68 -0
  164. package/skills/prod-specs/templates/prod-prd-full-template.md +159 -0
  165. package/skills/prod-specs/templates/prod-prd-template.md +173 -0
  166. package/skills/prod-specs-update/SKILL.md +272 -0
  167. package/skills/report-issue/SKILL.md +156 -0
  168. package/taxonomy.md +270 -0
  169. package/templates/AGENTS.md +189 -0
  170. package/templates/CDD aplicado a Prompts.md +182 -0
  171. package/templates/ENV-template.md +187 -0
  172. package/templates/engineering/AGENTS-template.md +71 -0
  173. package/templates/engineering/ARD-template.md +193 -0
  174. package/templates/engineering/CONTACTS-template.md +135 -0
  175. package/templates/engineering/PR-template.md +40 -0
  176. package/templates/engineering/RFC-Playbook.md +325 -0
  177. package/templates/engineering/RFC-template.md +199 -0
  178. package/templates/engineering/architecture-template.md +277 -0
  179. package/templates/engineering/breakdown-subtasks-template.md +582 -0
  180. package/templates/engineering/c4-model-template.md +516 -0
  181. package/templates/engineering/data-contract-template.md +135 -0
  182. package/templates/engineering/data-pipeline-template.md +163 -0
  183. package/templates/engineering/plan-template.md +255 -0
  184. package/templates/engineering/qa/eng.qa.quality-gate-examples-template.md +311 -0
  185. package/templates/engineering/qa/eng.qa.quality-gate-report-template.md +249 -0
  186. package/templates/engineering/qa/qa.cypress-test-template.md +172 -0
  187. package/templates/engineering/qa/qa.exploratory-session-template.md +148 -0
  188. package/templates/engineering/qa/qa.quality-report-template.md +130 -0
  189. package/templates/engineering/qa/qa.release-signoff-template.md +54 -0
  190. package/templates/engineering/qa/qa.sprint-plan-template.md +49 -0
  191. package/templates/engineering/swagger-template.md +145 -0
  192. package/templates/engineering/tech-spec-template.md +497 -0
  193. package/templates/engineering/work-progress-template.md +155 -0
  194. package/workflows/AGENTS.md +240 -0
  195. package/workflows/README.md +160 -0
  196. package/workflows/all-tools.md +11 -0
  197. package/workflows/engineering/data/data.contract.md +202 -0
  198. package/workflows/engineering/data/data.new-pipeline.md +234 -0
  199. package/workflows/engineering/eng.breakdown-subtasks.md +420 -0
  200. package/workflows/engineering/eng.bug-audit.md +591 -0
  201. package/workflows/engineering/eng.build-tech-spec.md +1116 -0
  202. package/workflows/engineering/eng.create-ard-from-code.md +259 -0
  203. package/workflows/engineering/eng.create-ard.md +382 -0
  204. package/workflows/engineering/eng.create-rfc.md +245 -0
  205. package/workflows/engineering/eng.debug.md +479 -0
  206. package/workflows/engineering/eng.docs.md +40 -0
  207. package/workflows/engineering/eng.light-arch.md +84 -0
  208. package/workflows/engineering/eng.plan.md +213 -0
  209. package/workflows/engineering/eng.pr.md +466 -0
  210. package/workflows/engineering/eng.pre-pr.md +167 -0
  211. package/workflows/engineering/eng.review.md +185 -0
  212. package/workflows/engineering/eng.rpa.robot.md +342 -0
  213. package/workflows/engineering/eng.security-audit.md +312 -0
  214. package/workflows/engineering/eng.security-incident.md +275 -0
  215. package/workflows/engineering/eng.security-pipeline.md +210 -0
  216. package/workflows/engineering/eng.security-review.md +235 -0
  217. package/workflows/engineering/eng.start.md +494 -0
  218. package/workflows/engineering/eng.work.md +558 -0
  219. package/workflows/engineering/frontend/eng.frontend-component.md +190 -0
  220. package/workflows/engineering/frontend/eng.frontend-perf-audit.md +375 -0
  221. package/workflows/engineering/frontend/eng.frontend-review.md +185 -0
  222. package/workflows/engineering/qa/eng.qa-dev-quality-guide.md +51 -0
  223. package/workflows/engineering/qa/eng.qa-e2e-test-generation.md +51 -0
  224. package/workflows/engineering/qa/eng.qa-exploratory-session.md +60 -0
  225. package/workflows/engineering/qa/eng.qa-quality-gate-validation.md +202 -0
  226. package/workflows/engineering/qa/eng.qa-quality-report.md +83 -0
  227. package/workflows/engineering/qa/eng.qa-refinement-entry.md +83 -0
  228. package/workflows/engineering/qa/eng.qa-release-signoff.md +170 -0
  229. package/workflows/engineering/qa/eng.qa-sprint-planning.md +100 -0
  230. package/workflows/engineering/ta/eng.ta.atendimento.md +93 -0
  231. package/workflows/product/prod.roadmap.preview.md +110 -0
  232. package/workflows/product/prod.spec.breakdown.md +163 -0
  233. package/workflows/product/prod.spec.clarify.md +178 -0
  234. package/workflows/product/prod.spec.epic.md +154 -0
  235. package/workflows/product/prod.spec.frd.md +96 -0
  236. package/workflows/product/prod.spec.issue.md +145 -0
  237. package/workflows/product/prod.spec.md +60 -0
  238. package/workflows/product/prod.spec.prd.md +100 -0
  239. package/workflows/taxonomy.md +92 -0
  240. package/workflows/warm-up.md +574 -0
@@ -0,0 +1,290 @@
1
+ # AGENTS.md - Pasta skills/
2
+
3
+ Instrucoes especificas para agentes de IA que manipulam a pasta de skills.
4
+
5
+ ---
6
+
7
+ ## Proposito desta Pasta
8
+
9
+ A pasta `skills/` contem **playbooks executaveis** que sao a fonte de verdade operacional do framework. Skills definem o "como fazer" de forma detalhada e passo a passo.
10
+
11
+ ---
12
+
13
+ ## Estrutura
14
+
15
+ ```
16
+ skills/
17
+ ├── eng-arch-c4/ # Diagramas C4
18
+ │ ├── SKILL.md
19
+ │ └── assets/
20
+ ├── eng-docs-write/ # Escrita de documentacao
21
+ │ └── SKILL.md
22
+ ├── eng-pr/ # Criacao de Pull/Merge Requests (GitLab/GitHub/Bitbucket)
23
+ │ └── SKILL.md
24
+ ├── eng-task-comment/ # Comentário no card (Jira/Linear/GitHub Issues/Asana)
25
+ │ └── SKILL.md
26
+ ├── eng-jira-comment/ # Alias → eng-task-comment
27
+ │ └── SKILL.md
28
+ ├── eng-backend/ # APIs REST/GraphQL, auth JWT/OAuth2/RBAC, RabbitMQ workers, caching
29
+ │ └── SKILL.md
30
+ ├── eng-frontend/ # React/Next.js/Vue, estado, performance UI, acessibilidade
31
+ │ └── SKILL.md
32
+ ├── eng-microfrontend/ # Module Federation, shell/remote, contratos de interface, event bus
33
+ │ └── SKILL.md
34
+ ├── eng-design-system/ # Tokens semânticos, CVA, Storybook, versionamento, auditoria visual
35
+ │ └── SKILL.md
36
+ ├── eng-nestjs/ # Framework NestJS: módulos, DI, guards, interceptors, pipes, Passport/JWT
37
+ │ └── SKILL.md
38
+ ├── eng-rabbitmq/ # Mensageria RabbitMQ (HTTP API, codigo, arquitetura, troubleshooting)
39
+ │ └── SKILL.md
40
+ ├── eng-cybersecurity/ # Segurança de aplicações: OWASP Top 10, secrets, supply chain, headers, SAST, compliance
41
+ │ └── SKILL.md
42
+ ├── churn-audit/ # Análise de churn SaaS por squad com relatório narrativo via $MESSAGE_COMUNICATOR
43
+ │ └── SKILL.md
44
+ ├── eng-scraper/ # Web scraping com Puppeteer, Cheerio, anti-bot, pipelines ETL
45
+ │ └── SKILL.md
46
+ ├── eng-scraper-robot-builder/ # Converte fluxo manual (linguagem natural) em robô Playwright via Stagehand
47
+ │ └── 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
49
+ │ └── SKILL.md
50
+ ├── lovable-prompt-generator/ # Geracao de prompts para frontend React via Lovable
51
+ │ └── SKILL.md
52
+ ├── docs-index/ # Indexacao de documentos
53
+ │ └── SKILL.md
54
+ ├── init-jarvis/ # Inicializacao do framework (/init-jarvis)
55
+ │ ├── SKILL.md
56
+ │ └── assets/
57
+ ├── eng-qa-gate/ # Quality gate validation
58
+ │ ├── SKILL.md
59
+ │ └── assets/
60
+ ├── eng-qa-test-plan/ # Planejamento de testes
61
+ │ ├── SKILL.md
62
+ │ └── assets/
63
+ ├── eng-qa-testsprite/ # Testes automatizados
64
+ │ ├── SKILL.md
65
+ │ └── assets/
66
+ ├── eng-qa-e2e/ # Testes E2E em linguagem natural com Stagehand, exportação Cypress
67
+ │ └── SKILL.md
68
+ ├── eng-qa-cypress-e2e/ # Testes E2E Cypress + TypeScript (Page Objects, data-testid, intercept)
69
+ │ └── SKILL.md
70
+ ├── eng-qa-exploratory/ # Sessões de teste exploratório estruturadas (charter, risco, achados)
71
+ │ └── SKILL.md
72
+ ├── eng-qa-dev-guide/ # Orienta devs a escreverem seus próprios testes Cypress
73
+ │ └── SKILL.md
74
+ ├── eng-qa-a11y-audit/ # Testes de acessibilidade WCAG 2.1 AA via jest-axe em testes unitários existentes
75
+ │ └── SKILL.md
76
+ ├── eng-qa-graphql-contract/ # Testes de contrato GraphQL: queries frontend vs schema do BFF
77
+ │ └── SKILL.md
78
+ ├── eng-qa-e2e-spec-writer/ # Gera spec E2E de handoff (doc, não código): cenários, Page Objects, fixtures
79
+ │ └── SKILL.md
80
+ ├── eng-qa-quality-report/ # Consolida sessões, bugs e quality gates e gera relatório de qualidade por período
81
+ │ └── SKILL.md
82
+ ├── eng-qa-unit-test/ # Testes unitarios
83
+ │ └── SKILL.md
84
+ ├── report-issue/ # Reportar bug no próprio Jarvis (JARVIS_PROJECT)
85
+ │ └── SKILL.md
86
+ ├── context-detect/ # Detecta contexto do projeto/tarefa
87
+ │ └── SKILL.md
88
+ └── docs-central/ # Sync/publish docs no central-docs (GitLab/GitHub/Bitbucket)
89
+ └── SKILL.md
90
+ ```
91
+
92
+ > Pastas listadas acima refletem skills com `SKILL.md` neste repo. Não invente `skill-creator` / `taxonomy-manager` / `members-manager` se a pasta não existir.
93
+
94
+ ---
95
+
96
+ ## Estrutura de um Skill
97
+
98
+ Cada skill vive em sua propria pasta:
99
+
100
+ ```
101
+ skills/{nome-do-skill}/
102
+ ├── SKILL.md # Obrigatorio - arquivo principal
103
+ ├── assets/ # Opcional - schemas, templates
104
+ │ ├── schema.json
105
+ │ └── template.md
106
+ └── references/ # Opcional - docs locais
107
+ │ └── docs.md
108
+ └── commands/ # Opcional - Comandos ou workflows usados pela skills
109
+ └── command-name.md
110
+ ```
111
+
112
+ ---
113
+
114
+ ## Frontmatter Obrigatorio
115
+
116
+ Todo SKILL.md deve comecar com frontmatter YAML:
117
+
118
+ ```yaml
119
+ ---
120
+ name: nome-do-skill
121
+ description: >
122
+ O que faz + Trigger de quando usar.
123
+ argument-hint: "[argumentos]"
124
+ disable-model-invocation: false
125
+ allowed-tools: Read Edit Write Glob Grep Bash
126
+ license: AGPL-3.0
127
+ metadata:
128
+ author: jarvis-team
129
+ version: "1.0"
130
+ ---
131
+ ```
132
+
133
+ ---
134
+
135
+ ## Convencoes de Nomenclatura
136
+
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` |
143
+
144
+ ---
145
+
146
+ ## Secoes Obrigatorias de um SKILL.md
147
+
148
+ 1. **Frontmatter** - Metadados YAML
149
+ 2. **Objetivo** - O que o skill faz
150
+ 3. **Entrada** - Argumentos e inputs
151
+ 4. **Recursos** - Templates, schemas, referencias
152
+ 5. **Pre-requisito** - Validacoes antes de executar
153
+ 6. **Quando Usar** - Cenarios de uso
154
+ 7. **Padroes Criticos** - Regras mais importantes
155
+ 8. **Fluxo de Trabalho** - Passo a passo
156
+ 9. **Regras** - Nunca/Sempre
157
+ 10. **Checklist de Conclusao** - Validacao final
158
+ 11. **Output** - Artefatos gerados
159
+ 12. **Mensagem de Conclusao** - Feedback ao usuario
160
+
161
+ ---
162
+
163
+ ## Diferenca entre Skills e Agents
164
+
165
+ | Aspecto | Skills | Agents |
166
+ |---------|--------|--------|
167
+ | Define | Playbook executavel | Persona e postura |
168
+ | Foco | Como executar | Quem executa |
169
+ | Detalhe | Passo a passo | Alto nivel |
170
+ | Fonte de verdade | Operacional | Comportamento |
171
+
172
+ **Regra**: Skills tem precedencia para detalhes operacionais.
173
+
174
+ ---
175
+
176
+ ## Invocação por IDE
177
+
178
+ Skills são invocados de formas diferentes dependendo da IDE:
179
+
180
+ | IDE | Invocação |
181
+ |-----|-----------|
182
+ | Claude Code, Cursor, OpenCode | `/nome-do-skill` (slash command) |
183
+ | Windsurf | `/nome-do-skill` (slash command) |
184
+ | **Codex (OpenAI)** | Linguagem natural ou painel TUI de skills — **sem slash commands** |
185
+ | Gemini CLI | `@nome-do-skill` ou linguagem natural |
186
+
187
+ > **Codex**: Skills ficam em `.codex/skills/` com `SKILL.md` + `openai.yaml` gerado
188
+ > automaticamente pelo `jarvis init`. O Codex descobre os skills pelo `openai.yaml`
189
+ > e os exibe no painel TUI. Para invocar, diga o que quer fazer — o Codex seleciona
190
+ > o skill adequado ou você indica pelo nome: _"use o skill eng-backend"_.
191
+
192
+ ---
193
+
194
+ ## Mapeamento Comando → Skill
195
+
196
+ | Comando / Trigger | Skill |
197
+ |-------------------|-------|
198
+ | `/init-jarvis` | `init` |
199
+ | `/eng.docs` | `eng-docs-write`, `docs-index` |
200
+ | `/eng.pre-pr` | `eng-qa-test-plan` |
201
+ | `/eng.pr` | `eng-pr` |
202
+ | QA validation | `eng-qa-gate` |
203
+ | Criar skill | `skill-creator` |
204
+ | `/taxonomy-manager` | `taxonomy-manager` |
205
+ | `/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` |
213
+ | Web scraping, Puppeteer, extração de dados, parsing, ETL | `eng-scraper` |
214
+ | 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
+ | Gerar specs Cypress + TypeScript para fluxos de usuário | `eng-qa-cypress-e2e` |
217
+ | Sessão de teste exploratório estruturada (charter, risco, achados, bug cards) | `eng-qa-exploratory` |
218
+ | Orientar dev sobre cobertura Cypress sem escrever o teste | `eng-qa-dev-guide` |
219
+ | 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
+ | Testes de acessibilidade WCAG 2.1 AA: integra jest-axe em testes unitários existentes | `eng-qa-a11y-audit` |
222
+ | Testes de contrato GraphQL: valida queries frontend contra schema do BFF | `eng-qa-graphql-contract` |
223
+ | 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` |
225
+
226
+ ---
227
+
228
+ ## Criando um Novo Skill
229
+
230
+ Use o skill-creator:
231
+
232
+ ```bash
233
+ /skill-creator meu-novo-skill
234
+ ```
235
+
236
+ Ou manualmente:
237
+
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
242
+
243
+ ---
244
+
245
+ ## Regras
246
+
247
+ ### Nunca
248
+
249
+ - Criar skill sem frontmatter completo
250
+ - Duplicar skill existente
251
+ - Colocar detalhes de persona (isso vai no agent)
252
+ - Usar URLs web em references (use caminhos locais)
253
+ - Omitir secao "Quando Usar" ou "Padroes Criticos"
254
+ - Remover acentos do portugues
255
+
256
+ ### Sempre
257
+
258
+ - Verificar se skill ja existe antes de criar
259
+ - Seguir convencoes de nomenclatura
260
+ - Incluir todas as secoes obrigatorias
261
+ - Documentar padroes criticos primeiro
262
+ - Manter exemplos de codigo minimos e focados
263
+ - Usar portugues correto com acentos
264
+
265
+ ---
266
+
267
+ ## assets/ vs references/
268
+
269
+ ```
270
+ Precisa de templates de codigo? → templates/{skill}-template.md
271
+ Precisa de schemas JSON? → assets/
272
+ Precisa de configs de exemplo? → assets/
273
+ Link para docs existentes? → references/
274
+ ```
275
+
276
+ **Regra**: `references/` deve apontar para arquivos LOCAIS, nao URLs web.
277
+
278
+ ---
279
+
280
+ ## Referencias
281
+
282
+ - `skill-creator/SKILL.md` - Skill para criar skills
283
+ - `skill-creator/assets/SKILL-template.md` - Template padrao
284
+ - `../agents/` - Agentes que usam skills
285
+ - `../workflows/` - Workflows relacionados
286
+ - `../rules/` - Regras que skills implementam
287
+
288
+ ---
289
+
290
+ **Ultima atualizacao**: 2026-03-10
@@ -0,0 +1,333 @@
1
+ # Skills Roadmap
2
+
3
+ Skills existentes e planejadas do framework Jarvis.
4
+
5
+ ---
6
+
7
+ ## Skills Criadas — Engenharia
8
+
9
+ ### `eng-frontend` ✅
10
+ - **Trigger**: componentes, estado, bundle, performance de UI, acessibilidade, SSR/SSG
11
+ - **Escopo**: React 19, Next.js 15 App Router, Tailwind, Zustand, Core Web Vitals, Blade/Laravel
12
+ - **Status**: `criado`
13
+
14
+ ### `eng-backend` ✅
15
+ - **Trigger**: APIs REST/GraphQL, autenticação, workers, jobs, integrações externas, caching
16
+ - **Escopo**: NestJS, JWT/OAuth2/RBAC, RabbitMQ, Redis, webhooks, circuit breaker
17
+ - **Status**: `criado`
18
+
19
+ ### `eng-nestjs` ✅
20
+ - **Trigger**: framework NestJS — DI, guards, interceptors, pipes, Passport/JWT, circular deps
21
+ - **Escopo**: módulos, providers, middleware, ConfigModule, testes com `Test.createTestingModule`
22
+ - **Status**: `criado`
23
+
24
+ ### `eng-scraper` ✅
25
+ - **Trigger**: web scraping, extração de dados, automação de browser, parsing HTML/XML
26
+ - **Escopo**: Puppeteer, Cheerio, anti-bot, rate limiting, pipelines ETL light
27
+ - **Status**: `criado`
28
+
29
+ ### `eng-scraper-robot-builder` ✅
30
+ - **Trigger**: converter fluxo manual em robô Playwright via Stagehand
31
+ - **Escopo**: exploração com `act()`/`observe()`, geração de script Playwright TypeScript
32
+ - **Status**: `criado`
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` ✅
40
+ - **Trigger**: tokens, CVA, Storybook, versionamento de componentes, auditoria visual
41
+ - **Escopo**: design tokens, variantes com `cva`, componentes reutilizáveis, changelog de UI
42
+ - **Status**: `criado`
43
+
44
+ ### `eng-microfrontend` ✅
45
+ - **Trigger**: Module Federation, shell/remote, contratos de interface, event bus
46
+ - **Escopo**: Webpack MF, standalone/integrado, shared dependencies, versionamento
47
+ - **Status**: `criado`
48
+
49
+ ### `eng-rabbitmq` ✅
50
+ - **Trigger**: mensageria, filas, events, consumers, producers, DLX
51
+ - **Escopo**: RabbitMQ, `@golevelup/nestjs-rabbitmq`, retry, DLQ, idempotência
52
+ - **Status**: `criado`
53
+
54
+ ### `eng-ms-trace` ✅
55
+ - **Trigger**: bug cross-service, rastreamento HTTP + AMQP
56
+ - **Escopo**: correlation ID, tracing distribuído, diagnóstico de falhas entre microsserviços
57
+ - **Status**: `criado`
58
+
59
+ ### `eng-performance-engineer` ✅
60
+ - **Trigger**: performance, latência, throughput, profiling, otimização
61
+ - **Escopo**: Core Web Vitals, bundle analysis, lazy loading, caching, memory leaks
62
+ - **Status**: `criado`
63
+
64
+ ### `eng-arch-c4` ✅
65
+ - **Trigger**: arquitetura C4, diagramas de contexto/container/componente
66
+ - **Escopo**: modelagem C4, documentação arquitetural, decisões de design
67
+ - **Status**: `criado`
68
+
69
+ ### `eng-ai-engineer` ✅
70
+ - **Trigger**: IA aplicada, chatbots, agents, n8n, LLMs
71
+ - **Escopo**: integração de LLMs, prompts, RAG, automação com IA
72
+ - **Status**: `criado`
73
+
74
+ ### `eng-browser-extension-builder` ✅
75
+ - **Trigger**: extensões de navegador, Chrome extensions, content scripts
76
+ - **Escopo**: manifest v3, background workers, content scripts, popup UI
77
+ - **Status**: `criado`
78
+
79
+ ### `eng-pr` ✅
80
+ - **Trigger**: criação de branch, commit, Merge Request
81
+ - **Escopo**: git flow, MR description, `eng-task-comment`, code review automation
82
+ - **Status**: `criado`
83
+
84
+ ### `eng-docs-write` ✅
85
+ - **Trigger**: documentação técnica, ADRs, RFCs, tech specs
86
+ - **Escopo**: geração e atualização de docs de engenharia
87
+ - **Status**: `criado`
88
+
89
+ ### `eng-task-comment` ✅
90
+ - **Trigger**: comentários técnicos em cards do task manager
91
+ - **Escopo**: Jira/Linear/GitHub/Asana via adapter; alias `eng-jira-comment`
92
+ - **Status**: `criado`
93
+
94
+ ---
95
+
96
+ ## Skills Criadas — Engenharia de Dados
97
+
98
+ ### `eng-data-engineer` ✅
99
+ - **Trigger**: pipelines ETL/ELT, contratos de dados, qualidade
100
+ - **Escopo**: Glue, Airflow, PySpark, Athena, Metabase, bronze/silver/gold, Great Expectations
101
+ - **Status**: `criado`
102
+
103
+ ### `eng-data-bi` ✅
104
+ - **Trigger**: dashboards BI, queries SQL analíticas
105
+ - **Escopo**: Metabase, queries analíticas, compartilhamento com squads
106
+ - **Status**: `criado`
107
+
108
+ ### `eng-data-debug` ✅
109
+ - **Trigger**: diagnóstico de falhas em pipelines por camada
110
+ - **Escopo**: fonte → bronze → silver → gold, troubleshooting
111
+ - **Status**: `criado`
112
+
113
+ ### `eng-data-onboard` ✅
114
+ - **Trigger**: onboarding de fonte nova
115
+ - **Escopo**: schema discovery, bronze, Expectation Suite, documentação
116
+ - **Status**: `criado`
117
+
118
+ ### `eng-data-orchestrator` ✅
119
+ - **Trigger**: DAGs, retry strategies, alertas, troubleshooting de orquestração
120
+ - **Escopo**: Airflow, Glue scheduler, monitoramento
121
+ - **Status**: `criado`
122
+
123
+ ---
124
+
125
+ ## Skills Criadas — QA
126
+
127
+ ### `eng-qa-gate` ✅
128
+ - **Trigger**: quality gate validation
129
+ - **Escopo**: critérios de aceite, bloqueio/aprovação de entrega
130
+ - **Status**: `criado`
131
+
132
+ ### `eng-qa-test-plan` ✅
133
+ - **Trigger**: planejamento de testes
134
+ - **Escopo**: estratégia de testes, cobertura, priorização
135
+ - **Status**: `criado`
136
+
137
+ ### `eng-qa-unit-test` ✅
138
+ - **Trigger**: testes unitários
139
+ - **Escopo**: Jest, Vitest, Testing Library, mocks, assertions
140
+ - **Status**: `criado`
141
+
142
+ ### `eng-qa-e2e` ✅
143
+ - **Trigger**: testes E2E em linguagem natural, regressão de UI
144
+ - **Escopo**: Stagehand `act()`/`extract()`/`observe()`, exportação Cypress
145
+ - **Status**: `criado`
146
+
147
+ ### `eng-qa-cypress-e2e` ✅
148
+ - **Trigger**: specs Cypress + TypeScript
149
+ - **Escopo**: Page Objects, `data-testid`, `cy.intercept`, fixtures, CI
150
+ - **Status**: `criado`
151
+
152
+ ### `eng-qa-exploratory` ✅
153
+ - **Trigger**: sessões de teste exploratório
154
+ - **Escopo**: charter, roteiro de risco, achados, bug cards
155
+ - **Status**: `criado`
156
+
157
+ ### `eng-qa-dev-guide` ✅
158
+ - **Trigger**: orientar dev sobre cobertura de testes
159
+ - **Escopo**: guia Cypress sem escrever código, Quality Champion
160
+ - **Status**: `criado`
161
+
162
+ ### `eng-qa-bug-report` ✅
163
+ - **Trigger**: reporte de bugs
164
+ - **Escopo**: descrição, reprodução, impacto, classificação
165
+ - **Status**: `criado`
166
+
167
+ ### `eng-qa-quality-report` ✅
168
+ - **Trigger**: relatório de qualidade por sprint/release
169
+ - **Escopo**: consolida sessões, bugs, quality gates
170
+ - **Status**: `criado`
171
+
172
+ ### `eng-qa-testsprite` ✅
173
+ - **Trigger**: testes automatizados via TestSprite
174
+ - **Escopo**: geração automática de testes, integração MCP
175
+ - **Status**: `criado`
176
+
177
+ ### `eng-qa-a11y-audit` ✅
178
+ - **Trigger**: testes de acessibilidade WCAG 2.1 AA
179
+ - **Escopo**: jest-axe em testes unitários existentes, report com fix sugerido
180
+ - **Status**: `criado` (v1.5.0)
181
+
182
+ ### `eng-qa-graphql-contract` ✅
183
+ - **Trigger**: testes de contrato GraphQL frontend vs BFF
184
+ - **Escopo**: validar queries/mutations contra schema, cobertura reversa
185
+ - **Status**: `criado` (v1.5.0)
186
+
187
+ ### `eng-qa-e2e-spec-writer` ✅
188
+ - **Trigger**: spec E2E para handoff (documentação, não código)
189
+ - **Escopo**: cenários priorizados, Page Objects, fixtures, intercepts, setup
190
+ - **Status**: `criado` (v1.5.0)
191
+
192
+ ---
193
+
194
+ ## Skills Criadas — Produto
195
+
196
+ ### `prod-specs` ✅
197
+ - **Trigger**: criação de PRD/FRD
198
+ - **Escopo**: especificação de produto, requisitos
199
+ - **Status**: `criado`
200
+
201
+ ### `prod-specs-update` ✅
202
+ - **Trigger**: atualização de specs existentes
203
+ - **Escopo**: revisão e evolução de requisitos
204
+ - **Status**: `criado`
205
+
206
+ ### `product-specs` ✅
207
+ - **Trigger**: especificação de produto (alias)
208
+ - **Status**: `criado`
209
+
210
+ ### `prod-roadmap-report` ✅
211
+ - **Trigger**: relatório de roadmap de produto
212
+ - **Status**: `criado`
213
+
214
+ ---
215
+
216
+ ## Skills — Daily Ritual
217
+
218
+ Removidas: `checkin`, `checkout`, `daily`, `task-log`, `send-priority`, `sent-priorities`, `my-priorities`.
219
+
220
+ ---
221
+
222
+ ## Skills Criadas — Utilitários / Framework
223
+
224
+ ### `init-jarvis` ✅
225
+ - **Trigger**: inicialização do framework
226
+ - **Escopo**: criação de ENV.md, validação de MCPs, onboarding
227
+ - **Status**: `criado`
228
+
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` ✅
235
+ - **Trigger**: auto-report de bugs no framework Jarvis via GitLab API
236
+ - **Status**: `criado`
237
+
238
+ ### `skill-creator` ✅
239
+ - **Trigger**: criação de novos skills
240
+ - **Status**: `criado`
241
+
242
+ ### `docs-index` / `docs-central` / `context-detect` ✅
243
+ - **Trigger**: indexação de docs, sync com repo central, detecção de contexto
244
+ - **Status**: `criado`
245
+
246
+ ### `lovable-prompt-generator` ✅
247
+ - **Trigger**: gerar prompts para frontend React via Lovable
248
+ - **Status**: `criado`
249
+
250
+ ---
251
+
252
+ ## Skills Planejadas
253
+
254
+ ### `eng-database`
255
+ - **Trigger**: queries, migrations, schema design, performance de banco, indexação
256
+ - **Escopo**: PostgreSQL, MySQL, Prisma, TypeORM, EXPLAIN ANALYZE, transações, NoSQL
257
+ - **Status**: `planejado`
258
+
259
+ ### `eng-infrastructure`
260
+ - **Trigger**: CI/CD, containers, cloud, IaC, observabilidade, deploy
261
+ - **Escopo**: Docker, Kubernetes, GitHub Actions, Terraform, AWS/GCP, logs/métricas/tracing
262
+ - **Status**: `planejado`
263
+
264
+ ### `eng-cybersecurity` ✅
265
+ - **Trigger**: segurança de aplicação, OWASP, hardening, secrets, supply chain, compliance
266
+ - **Escopo**: OWASP Top 10, secrets management, sanitização, headers de segurança, SAST, supply chain, LGPD/GDPR
267
+ - **Status**: `criado`
268
+
269
+ ### `eng-ui`
270
+ - **Trigger**: padrões de UI, layouts, responsividade, grids, animações
271
+ - **Status**: `planejado`
272
+
273
+ ### `eng-ux`
274
+ - **Trigger**: UX research, heurísticas, fluxos de usuário, microcopy
275
+ - **Status**: `planejado`
276
+
277
+ ### `eng-react`
278
+ - **Trigger**: React avançado isolado — hooks custom, concurrent features, suspense
279
+ - **Status**: `planejado`
280
+
281
+ ### `eng-support`
282
+ - **Trigger**: suporte técnico, runbooks, escalonamento, SLA
283
+ - **Status**: `planejado`
284
+
285
+ ### `eng-back-for-frontend`
286
+ - **Trigger**: BFF, agregação de APIs, GraphQL gateway, data loaders
287
+ - **Status**: `planejado`
288
+
289
+ ### `eng-laravel`
290
+ - **Trigger**: Laravel, Blade, Eloquent, migrations PHP, artisan
291
+ - **Escopo**: coberto parcialmente por `eng-frontend` (contexto Blade)
292
+ - **Status**: `planejado`
293
+
294
+ ---
295
+
296
+ ## Prioridade Sugerida
297
+
298
+ | # | Skill | Status | Justificativa |
299
+ |---|-------|--------|--------------|
300
+ | 1 | `eng-frontend` | ✅ criado | Alta demanda, dois contextos (React + PHP/Blade) |
301
+ | 2 | `eng-backend` | ✅ criado | APIs, auth, workers RabbitMQ — core do produto |
302
+ | 3 | `eng-nestjs` | ✅ criado | Framework principal — DI, guards, Passport/JWT |
303
+ | 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 |
307
+ | 8 | `eng-database` | planejado | Área densa com muitos anti-patterns críticos |
308
+ | 9 | `eng-cybersecurity` | ✅ criado | Transversal — impacta todas as outras áreas |
309
+ | 10 | `eng-infrastructure` | planejado | Necessário para squads com CI/CD próprio |
310
+ | 11 | `eng-back-for-frontend` | planejado | BFF, GraphQL gateway — demanda crescente |
311
+ | 12 | `eng-ui` | planejado | Nicho — criar sob demanda |
312
+ | 13 | `eng-ux` | planejado | Nicho — criar sob demanda |
313
+ | 14 | `eng-react` | planejado | Nicho — criar sob demanda |
314
+ | 15 | `eng-support` | planejado | Nicho — criar sob demanda |
315
+ | 16 | `eng-laravel` | planejado | Nicho — coberto parcialmente por eng-frontend |
316
+
317
+ ---
318
+
319
+ ## Resumo
320
+
321
+ | Categoria | Criados | Planejados |
322
+ |-----------|---------|------------|
323
+ | Engenharia | 18 | 8 |
324
+ | Engenharia de Dados | 5 | 0 |
325
+ | QA | 13 | 0 |
326
+ | Produto | 4 | 0 |
327
+ | Daily Ritual | 6 | 0 |
328
+ | Utilitários | 8 | 0 |
329
+ | **Total** | **54** | **8** |
330
+
331
+ ---
332
+
333
+ **Última atualização**: 2026-05-30