wize-dev-kit 0.15.0 → 0.16.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 (232) hide show
  1. package/ARCH.md +24 -77
  2. package/CHANGELOG.md +9 -0
  3. package/DECISIONS.md +1 -27
  4. package/README.md +4 -0
  5. package/ROSTER.md +3 -11
  6. package/adapters/README.md +7 -8
  7. package/adapters/antigravity/README.md +5 -5
  8. package/adapters/claude-code/README.md +1 -1
  9. package/adapters/codex/README.md +5 -5
  10. package/adapters/codex/adapter.yaml +1 -1
  11. package/adapters/codex/render.js +1 -1
  12. package/adapters/continue/README.md +5 -5
  13. package/adapters/cursor/README.md +2 -2
  14. package/adapters/generic/README.md +1 -1
  15. package/adapters/kimi-code/README.md +5 -5
  16. package/adapters/kimi-code/render.js +2 -2
  17. package/adapters/opencode/README.md +3 -3
  18. package/adapters/opencode/render.js +1 -27
  19. package/adapters/windsurf/README.md +3 -3
  20. package/package.json +1 -1
  21. package/schemas/agent.schema.json +2 -2
  22. package/schemas/workflow.schema.json +1 -1
  23. package/src/app-overlay/wize-app-release-channels/workflow.md +0 -2
  24. package/src/app-overlay/wize-app-scaffold/workflow.md +0 -2
  25. package/src/app-overlay/wize-app-store-listing/workflow.md +0 -2
  26. package/src/builder-skills/wize-create-agent/workflow.md +0 -2
  27. package/src/builder-skills/wize-create-skill/workflow.md +0 -2
  28. package/src/builder-skills/wize-create-workflow/workflow.md +0 -2
  29. package/src/core-skills/module.yaml +3 -0
  30. package/src/core-skills/wize-advanced-elicitation/skill.md +0 -2
  31. package/src/core-skills/wize-brainstorming/skill.md +0 -2
  32. package/src/core-skills/wize-eli5/skill.md +72 -0
  33. package/src/core-skills/wize-review-adversarial/skill.md +0 -3
  34. package/src/core-skills/wize-shard-doc/skill.md +0 -2
  35. package/src/method-skills/1-analysis/wize-agent-analyst/agent.yaml +0 -3
  36. package/src/method-skills/1-analysis/wize-document-project/workflow.md +20 -213
  37. package/src/method-skills/1-analysis/wize-prfaq/workflow.md +11 -152
  38. package/src/method-skills/1-analysis/wize-product-brief/workflow.md +19 -92
  39. package/src/method-skills/1-analysis/wize-research/workflow.md +12 -39
  40. package/src/method-skills/1-analysis/wize-trigger-map/workflow.md +16 -82
  41. package/src/method-skills/2-plan-workflows/wize-create-prd/workflow.md +23 -135
  42. package/src/method-skills/2-plan-workflows/wize-ux-design/workflow.md +28 -134
  43. package/src/method-skills/2-plan-workflows/wize-ux-scenarios/workflow.md +15 -93
  44. package/src/method-skills/2-plan-workflows/wize-validate-prd/workflow.md +12 -108
  45. package/src/method-skills/3-solutioning/wize-check-implementation-readiness/workflow.md +11 -103
  46. package/src/method-skills/3-solutioning/wize-create-architecture/workflow.md +48 -55
  47. package/src/method-skills/3-solutioning/wize-create-epics-and-stories/workflow.md +15 -154
  48. package/src/method-skills/3-solutioning/wize-design-system/workflow.md +22 -184
  49. package/src/method-skills/3-solutioning/wize-nfr-principles/workflow.md +17 -145
  50. package/src/method-skills/3-solutioning/wize-tech-vision/workflow.md +22 -130
  51. package/src/method-skills/4-implementation/wize-agent-dev/persona.md +0 -12
  52. package/src/method-skills/4-implementation/wize-code-review/workflow.md +12 -54
  53. package/src/method-skills/4-implementation/wize-create-story/workflow.md +10 -154
  54. package/src/method-skills/4-implementation/wize-dev-story/workflow.md +17 -185
  55. package/src/method-skills/4-implementation/wize-quick-dev/workflow.md +18 -136
  56. package/src/method-skills/4-implementation/wize-retrospective/workflow.md +10 -114
  57. package/src/method-skills/4-implementation/wize-sprint-planning/workflow.md +11 -78
  58. package/src/method-skills/4-implementation/wize-sprint-status/workflow.md +11 -45
  59. package/src/method-skills/module.yaml +0 -28
  60. package/src/orchestrator-skills/module.yaml +1 -7
  61. package/src/orchestrator-skills/wize-help/skill.md +67 -227
  62. package/src/orchestrator-skills/wize-onboarding/workflow.md +14 -78
  63. package/src/orchestrator-skills/wize-orchestrator/agent.yaml +0 -2
  64. package/src/orchestrator-skills/wize-orchestrator/persona.md +3 -44
  65. package/src/orchestrator-skills/wize-party-mode/workflow.md +0 -2
  66. package/src/tea-skills/wize-tea-design/workflow.md +13 -107
  67. package/src/tea-skills/wize-tea-gate/workflow.md +25 -118
  68. package/src/tea-skills/wize-tea-nfr/workflow.md +14 -107
  69. package/src/tea-skills/wize-tea-review/workflow.md +13 -123
  70. package/src/tea-skills/wize-tea-risk/workflow.md +10 -113
  71. package/src/tea-skills/wize-tea-trace/workflow.md +12 -86
  72. package/src/web-overlay/wize-web-deploy/workflow.md +0 -2
  73. package/src/web-overlay/wize-web-scaffold/workflow.md +0 -2
  74. package/src/web-overlay/wize-web-seo-audit/workflow.md +0 -2
  75. package/tools/check-eli5-all-adapters.js +50 -0
  76. package/tools/installer/onboarding.js +20 -14
  77. package/tools/installer/render-shared.js +15 -159
  78. package/tools/installer/setup-helpers.js +0 -1
  79. package/tools/installer/validators/run-all.js +2 -3
  80. package/tools/installer/wize-cli.js +70 -500
  81. package/AGENTS.md +0 -37
  82. package/README.es.md +0 -295
  83. package/README.pt-BR.md +0 -293
  84. package/adapters/hermes/README.md +0 -23
  85. package/adapters/hermes/adapter.yaml +0 -8
  86. package/adapters/hermes/render.js +0 -17
  87. package/docs/harnesses/antigravity.md +0 -20
  88. package/docs/harnesses/antigravity.pt-BR.md +0 -20
  89. package/docs/harnesses/claude-code.md +0 -23
  90. package/docs/harnesses/claude-code.pt-BR.md +0 -23
  91. package/docs/harnesses/codex.md +0 -21
  92. package/docs/harnesses/codex.pt-BR.md +0 -21
  93. package/docs/harnesses/continue.md +0 -21
  94. package/docs/harnesses/continue.pt-BR.md +0 -21
  95. package/docs/harnesses/cursor.md +0 -22
  96. package/docs/harnesses/cursor.pt-BR.md +0 -22
  97. package/docs/harnesses/generic.md +0 -20
  98. package/docs/harnesses/generic.pt-BR.md +0 -20
  99. package/docs/harnesses/hermes.md +0 -26
  100. package/docs/harnesses/hermes.pt-BR.md +0 -26
  101. package/docs/harnesses/kimi-code.md +0 -19
  102. package/docs/harnesses/kimi-code.pt-BR.md +0 -19
  103. package/docs/harnesses/opencode.md +0 -31
  104. package/docs/harnesses/opencode.pt-BR.md +0 -31
  105. package/docs/harnesses/windsurf.md +0 -22
  106. package/docs/harnesses/windsurf.pt-BR.md +0 -22
  107. package/src/core-skills/wize-customize/skill.md +0 -116
  108. package/src/core-skills/wize-editorial-review-prose/skill.md +0 -94
  109. package/src/core-skills/wize-editorial-review-structure/skill.md +0 -99
  110. package/src/core-skills/wize-grill/skill.md +0 -77
  111. package/src/core-skills/wize-index-docs/skill.md +0 -119
  112. package/src/core-skills/wize-pre-pr-check/skill.md +0 -134
  113. package/src/core-skills/wize-review-edge-case-hunter/skill.md +0 -115
  114. package/src/core-skills/wize-spec/assets/headless-schemas.md +0 -39
  115. package/src/core-skills/wize-spec/assets/spec-template.md +0 -40
  116. package/src/core-skills/wize-spec/customize.toml +0 -20
  117. package/src/core-skills/wize-spec/skill.md +0 -112
  118. package/src/method-skills/1-analysis/wize-document-project/documentation-requirements.csv +0 -12
  119. package/src/method-skills/1-analysis/wize-document-project/templates/api-contracts-template.md +0 -38
  120. package/src/method-skills/1-analysis/wize-document-project/templates/architecture-template.md +0 -54
  121. package/src/method-skills/1-analysis/wize-document-project/templates/component-inventory-template.md +0 -40
  122. package/src/method-skills/1-analysis/wize-document-project/templates/contribution-guide-template.md +0 -34
  123. package/src/method-skills/1-analysis/wize-document-project/templates/data-models-template.md +0 -36
  124. package/src/method-skills/1-analysis/wize-document-project/templates/deep-dive-template.md +0 -312
  125. package/src/method-skills/1-analysis/wize-document-project/templates/deployment-guide-template.md +0 -42
  126. package/src/method-skills/1-analysis/wize-document-project/templates/development-guide-template.md +0 -61
  127. package/src/method-skills/1-analysis/wize-document-project/templates/index-template.md +0 -185
  128. package/src/method-skills/1-analysis/wize-document-project/templates/project-overview-template.md +0 -110
  129. package/src/method-skills/1-analysis/wize-document-project/templates/project-scan-report-schema.json +0 -159
  130. package/src/method-skills/1-analysis/wize-document-project/templates/source-tree-template.md +0 -142
  131. package/src/method-skills/1-analysis/wize-domain-research/customize.toml +0 -14
  132. package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-01-init.md +0 -49
  133. package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-02-domain-analysis.md +0 -39
  134. package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-03-competitive-landscape.md +0 -39
  135. package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-04-regulatory-focus.md +0 -39
  136. package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-05-technical-trends.md +0 -39
  137. package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-06-research-synthesis.md +0 -43
  138. package/src/method-skills/1-analysis/wize-domain-research/research.template.md +0 -31
  139. package/src/method-skills/1-analysis/wize-domain-research/workflow.md +0 -58
  140. package/src/method-skills/1-analysis/wize-market-research/customize.toml +0 -14
  141. package/src/method-skills/1-analysis/wize-market-research/research.template.md +0 -31
  142. package/src/method-skills/1-analysis/wize-market-research/steps/step-01-init.md +0 -57
  143. package/src/method-skills/1-analysis/wize-market-research/steps/step-02-customer-behavior.md +0 -39
  144. package/src/method-skills/1-analysis/wize-market-research/steps/step-03-customer-pain-points.md +0 -37
  145. package/src/method-skills/1-analysis/wize-market-research/steps/step-04-customer-decisions.md +0 -39
  146. package/src/method-skills/1-analysis/wize-market-research/steps/step-05-competitive-analysis.md +0 -37
  147. package/src/method-skills/1-analysis/wize-market-research/steps/step-06-research-completion.md +0 -47
  148. package/src/method-skills/1-analysis/wize-market-research/workflow.md +0 -66
  149. package/src/method-skills/1-analysis/wize-refresh-knowledge/workflow.md +0 -129
  150. package/src/method-skills/1-analysis/wize-technical-research/customize.toml +0 -14
  151. package/src/method-skills/1-analysis/wize-technical-research/research.template.md +0 -31
  152. package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-01-init.md +0 -49
  153. package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-02-technical-overview.md +0 -45
  154. package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-03-integration-patterns.md +0 -39
  155. package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-04-architectural-patterns.md +0 -39
  156. package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-05-implementation-research.md +0 -42
  157. package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-06-research-synthesis.md +0 -46
  158. package/src/method-skills/1-analysis/wize-technical-research/workflow.md +0 -60
  159. package/src/method-skills/2-plan-workflows/wize-edit-prd/workflow.md +0 -110
  160. package/src/method-skills/3-solutioning/wize-create-architecture/architecture-decision-template.md +0 -41
  161. package/src/method-skills/3-solutioning/wize-create-architecture/customize.toml +0 -20
  162. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-01-init.md +0 -95
  163. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-01b-continue.md +0 -32
  164. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-02-context.md +0 -126
  165. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-03-starter.md +0 -110
  166. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-04-decisions.md +0 -129
  167. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-05-patterns.md +0 -109
  168. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-06-structure.md +0 -97
  169. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-07-validation.md +0 -124
  170. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-08-complete.md +0 -59
  171. package/src/method-skills/3-solutioning/wize-project-context/workflow.md +0 -120
  172. package/src/method-skills/4-implementation/wize-changelog/workflow.md +0 -184
  173. package/src/method-skills/4-implementation/wize-checkpoint-preview/workflow.md +0 -117
  174. package/src/method-skills/4-implementation/wize-code-review/customize.toml +0 -21
  175. package/src/method-skills/4-implementation/wize-code-review/steps/step-01-gather-context.md +0 -64
  176. package/src/method-skills/4-implementation/wize-code-review/steps/step-02-review.md +0 -40
  177. package/src/method-skills/4-implementation/wize-code-review/steps/step-03-triage.md +0 -43
  178. package/src/method-skills/4-implementation/wize-code-review/steps/step-04-present.md +0 -100
  179. package/src/method-skills/4-implementation/wize-correct-course/workflow.md +0 -93
  180. package/src/method-skills/4-implementation/wize-investigate/workflow.md +0 -123
  181. package/src/method-skills/4-implementation/wize-release/workflow.md +0 -162
  182. package/src/orchestrator-skills/wize/skill.md +0 -164
  183. package/src/orchestrator-skills/wize-check/skill.md +0 -98
  184. package/src/security-overlay/_shared/allowlist.js +0 -154
  185. package/src/security-overlay/_shared/backlog.js +0 -169
  186. package/src/security-overlay/_shared/cli-runner.js +0 -87
  187. package/src/security-overlay/_shared/cvss.js +0 -108
  188. package/src/security-overlay/_shared/detect.js +0 -125
  189. package/src/security-overlay/_shared/install-script.js +0 -205
  190. package/src/security-overlay/_shared/invoke-phase.js +0 -86
  191. package/src/security-overlay/_shared/owasp.js +0 -56
  192. package/src/security-overlay/_shared/partial.js +0 -225
  193. package/src/security-overlay/_shared/preflight.js +0 -175
  194. package/src/security-overlay/_shared/scope-gate.js +0 -172
  195. package/src/security-overlay/_shared/scope-parser.js +0 -147
  196. package/src/security-overlay/agents/red-teamer/agent.yaml +0 -54
  197. package/src/security-overlay/agents/red-teamer/persona.md +0 -49
  198. package/src/security-overlay/data/common.txt +0 -115
  199. package/src/security-overlay/data/owasp-top10.json +0 -15
  200. package/src/security-overlay/data/tool-allowlist.json +0 -31
  201. package/src/security-overlay/skills/wize-sec-enumerate/scripts/run-enumerate.js +0 -180
  202. package/src/security-overlay/skills/wize-sec-enumerate/skill.md +0 -34
  203. package/src/security-overlay/skills/wize-sec-exploit/data/common.txt +0 -117
  204. package/src/security-overlay/skills/wize-sec-exploit/scripts/run-ffuf.js +0 -147
  205. package/src/security-overlay/skills/wize-sec-exploit/scripts/run-nikto.js +0 -145
  206. package/src/security-overlay/skills/wize-sec-exploit/scripts/run-nuclei.js +0 -176
  207. package/src/security-overlay/skills/wize-sec-exploit/scripts/run-sqlmap.js +0 -139
  208. package/src/security-overlay/skills/wize-sec-pentest/scripts/run-pipeline.js +0 -184
  209. package/src/security-overlay/skills/wize-sec-pentest/skill.md +0 -54
  210. package/src/security-overlay/skills/wize-sec-recon/scripts/run-gitleaks.js +0 -139
  211. package/src/security-overlay/skills/wize-sec-recon/scripts/run-osv.js +0 -227
  212. package/src/security-overlay/skills/wize-sec-recon/scripts/run-recon.js +0 -162
  213. package/src/security-overlay/skills/wize-sec-recon/skill.md +0 -37
  214. package/src/security-overlay/skills/wize-sec-report/scripts/render-report.js +0 -1033
  215. package/src/security-overlay/skills/wize-sec-scope/scripts/generate-scope.js +0 -106
  216. package/src/security-overlay/skills/wize-sec-scope/skill.md +0 -52
  217. package/src/tea-skills/wize-qa-generate-e2e-tests/workflow.md +0 -121
  218. package/tools/installer/baseline.js +0 -133
  219. package/tools/installer/commands/agent.js +0 -197
  220. package/tools/installer/commands/doctor.js +0 -320
  221. package/tools/installer/commands/document-project.js +0 -93
  222. package/tools/installer/commands/sync.js +0 -45
  223. package/tools/installer/commands/update.js +0 -172
  224. package/tools/installer/document-project/batch-scanner.js +0 -93
  225. package/tools/installer/document-project/classify.js +0 -170
  226. package/tools/installer/document-project/modes/deep-dive.js +0 -196
  227. package/tools/installer/document-project/modes/full-rescan.js +0 -15
  228. package/tools/installer/document-project/modes/initial-scan.js +0 -100
  229. package/tools/installer/document-project/modes/quick.js +0 -211
  230. package/tools/installer/document-project/render-index.js +0 -101
  231. package/tools/installer/document-project/state.js +0 -110
  232. package/tools/installer/version-check.js +0 -117
@@ -1,184 +0,0 @@
1
- ---
2
- code: wize-changelog
3
- description: "Use quando precisar gerar ou atualizar o changelog no formato Keep a Changelog a partir das stories concluídas."
4
- name: Changelog
5
- phase: 4-implementation
6
- owner: wize-agent-dev # Shuri
7
- status: ready
8
- ---
9
-
10
- # Changelog
11
-
12
- **Goal.** Gerar `CHANGELOG.md` no formato [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) a partir das stories concluídas no sprint, agrupadas por epic e categoria.
13
-
14
- Shuri executa. O changelog é gerado em pt-BR (texto voltado ao usuário) e segue a convenção do projeto.
15
-
16
- ## Inputs
17
-
18
- - `.wize/implementation/sprint-status.yaml` — stories concluídas
19
- - `.wize/solutioning/stories/{epic}/*.md` — detalhes das stories
20
- - `.wize/solutioning/epics/*.md` — nomes legíveis dos epics
21
- - `CHANGELOG.md` — changelog existente (se houver)
22
- - `git tag --list 'v*' --sort=-v:refname | head -1` — última tag
23
-
24
- ## Output
25
-
26
- - `CHANGELOG.md` criado ou atualizado com a nova entrada pré-pendida
27
-
28
- ## Formato Keep a Changelog
29
-
30
- Seguir estritamente o formato [Keep a Changelog 1.1.0](https://keepachangelog.com/en/1.1.0/):
31
-
32
- ```markdown
33
- # Changelog
34
-
35
- All notable changes to this project are documented here.
36
- Format inspired by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
37
-
38
- ## [Unreleased]
39
-
40
- ## [0.12.0] — 2026-08-08
41
-
42
- ### Added
43
- - **Epic 09 — UX / intent:** Release e changelog skills (`wize-release`, `wize-changelog`). #E09-S07
44
-
45
- ### Changed
46
- - **Epic 09 — UX / intent:** Roteamento por intenção expandido com release/changelog. #E09-S03
47
-
48
- ### Fixed
49
- - **Epic 09 — UX / intent:** Descrições de skill corrigidas (block scalars). #E09-S01
50
-
51
- ### Security
52
- - (vazio se não houver stories de segurança)
53
- ```
54
-
55
- ### Regras de categoria
56
-
57
- | Categoria | Quando usar |
58
- |---|---|
59
- | **Added** | Nova feature, nova skill, nova funcionalidade |
60
- | **Changed** | Mudança em funcionalidade existente, alteração de comportamento |
61
- | **Deprecated** | Funcionalidade que será removida em breve |
62
- | **Removed** | Funcionalidade removida |
63
- | **Fixed** | Correção de bug |
64
- | **Security** | Correção de vulnerabilidade, melhoria de segurança |
65
-
66
- ### Regras de agrupamento
67
-
68
- - Agrupar por **epic** dentro de cada categoria.
69
- - Cada linha começa com `- **Epic NN — Nome:**` seguido da descrição e `#story_id`.
70
- - Stories sem epic definido vão sob `- **Geral:**`.
71
- - Se uma categoria não tiver stories, escrever `- (vazio)` ou omitir (consistente com o changelog existente).
72
-
73
- ## Steps
74
-
75
- ### 1. Coletar stories concluídas
76
-
77
- Ler `sprint-status.yaml`. Para cada story com status `done`:
78
-
79
- 1. Localizar o arquivo em `.wize/solutioning/stories/{epic}/{story}.md`
80
- 2. Extrair do frontmatter: `story_id`, `epic`
81
- 3. Extrair do corpo: título (linha `# Story:`) e primeira frase da seção `## Context` como sumário
82
-
83
- Se o arquivo da story não existir, usar apenas o `story_id` como referência.
84
-
85
- ### 2. Classificar por categoria
86
-
87
- Para cada story, determinar a categoria com base no conteúdo:
88
-
89
- | Padrão no título/contexto | Categoria |
90
- |---|---|
91
- | "Adicionar", "Criar", "Novo", "Added", "Add" | Added |
92
- | "Corrigir", "Consertar", "Bug", "Fix", "Hotfix", "Correção" | Fixed |
93
- | "Alterar", "Mudar", "Refatorar", "Change", "Update" | Changed |
94
- | "Remover", "Deprecar" | Removed / Deprecated |
95
- | "Segurança", "Vulnerabilidade", "Security", "CVE" | Security |
96
-
97
- Se ambíguo, default `Added` para stories novas, `Changed` para alterações.
98
-
99
- ### 3. Agrupar por epic
100
-
101
- Para cada story, resolver o nome do epic:
102
-
103
- 1. Se o frontmatter tem `epic: NN-nome`, usar `Epic NN — Nome`
104
- 2. Buscar em `.wize/solutioning/epics/{epic}.md` o título (`# Epic NN: Nome`)
105
- 3. Fallback: `Epic {epic_id}`
106
-
107
- Agrupar stories por epic, depois por categoria.
108
-
109
- ### 4. Gerar entrada do changelog
110
-
111
- Montar a entrada no formato:
112
-
113
- ```markdown
114
- ## [{version}] — {YYYY-MM-DD}
115
-
116
- {descrição curta do release — 1-2 frases sobre o que esta versão entrega}
117
-
118
- ### Added
119
- - **{epic_nome}:** {descrição}. #{story_id}
120
-
121
- ### Changed
122
- - **{epic_nome}:** {descrição}. #{story_id}
123
-
124
- ### Fixed
125
- - **{epic_nome}:** {descrição}. #{story_id}
126
-
127
- ### Security
128
- - **{epic_nome}:** {descrição}. #{story_id}
129
- ```
130
-
131
- ### 5. Atualizar CHANGELOG.md
132
-
133
- Se `CHANGELOG.md` não existir, criar com o cabeçalho padrão:
134
-
135
- ```markdown
136
- # Changelog
137
-
138
- All notable changes to this project are documented here.
139
- Format inspired by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
140
-
141
- > **Language:** entries are written in **Portuguese (pt-BR)**.
142
-
143
- ## [Unreleased]
144
- ```
145
-
146
- Se existir:
147
- 1. Localizar a linha `## [Unreleased]`
148
- 2. Inserir a nova entrada entre `## [Unreleased]` e a primeira `## [versão]` existente
149
- 3. Se não houver `## [Unreleased]`, inserir após o cabeçalho
150
-
151
- ### 6. Verificar formatação
152
-
153
- - A data está no formato `YYYY-MM-DD`
154
- - A versão segue semver (`X.Y.Z`)
155
- - Cada story tem referência ao `#story_id`
156
- - Categorias vazias foram omitidas
157
- - O link do Keep a Changelog está presente
158
-
159
- ## Exemplo de saída
160
-
161
- ```markdown
162
- ## [0.12.0] — 2026-08-08
163
-
164
- Release do cluster de ship: skills de release e changelog para o perfil core, roteamento por intenção expandido.
165
-
166
- ### Added
167
- - **Epic 09 — UX / intent:** Skill `wize-release` para bump de versão, changelog e tag git a partir das stories gated. #E09-S07
168
- - **Epic 09 — UX / intent:** Skill `wize-changelog` para geração de changelog no formato Keep a Changelog. #E09-S07
169
-
170
- ### Changed
171
- - **Epic 09 — UX / intent:** Tabela de roteamento por intenção expandida com release, changelog, lançar, publicar, notas de versão. #E09-S03
172
- ```
173
-
174
- ## Anti-patterns
175
-
176
- - Changelog escrito à mão sem referência às stories — perde rastreabilidade.
177
- - Categoria "Added" para correção de bug — usar "Fixed".
178
- - Data fora do formato ISO — usar `YYYY-MM-DD`.
179
- - Pular stories concluídas — toda story `done` no sprint entra no changelog.
180
- - Escrever changelog em inglês quando o projeto usa pt-BR — seguir o idioma do changelog existente.
181
-
182
- ## Hand-off
183
-
184
- > Changelog atualizado em `CHANGELOG.md`. {count} stories de {epic_count} epics registradas. Próximo: `/wize-release` para bump de versão e tag, ou revisão manual do changelog.
@@ -1,117 +0,0 @@
1
- ---
2
-
3
- code: wize-checkpoint-preview
4
- description: "Use quando uma story estiver parcialmente implementada e precisar de preview de checkpoint para validar direção antes de continuar."
5
- name: Checkpoint Preview
6
- phase: 4-implementation
7
- owner: wize-agent-dev # Shuri (+ wize-agent-architect Tony on call)
8
- status: ready
9
- ---
10
-
11
- # Checkpoint Preview
12
-
13
- **Goal.** Pause mid-story to validate direction before continuing. For larger stories where the cost of going off-rail is high, a quick checkpoint catches drift before it becomes rework.
14
-
15
- Shuri drives. Tony on call for architectural drift. Hawkeye on call for test design drift.
16
-
17
- ## When to run
18
-
19
- - Manually, when a story is running long or feels off-track.
20
- - After the first 2-3 commits of a larger story.
21
- - When a new constraint is mentioned (security review, perf budget, vendor change).
22
-
23
- ## When NOT to run
24
-
25
- - Quick-dev / small stories (overhead exceeds the value).
26
- - When the story is < 50% done and no surprise has come up yet.
27
-
28
- ## Inputs
29
-
30
- - The current story file: `.wize/solutioning/stories/{epic}/{story}.md`
31
- - The git diff: uncommitted + committed since story start
32
- - The `tea-design.md` for the story
33
- - The `design-system/` tokens used so far
34
-
35
- ## Output
36
-
37
- - `.wize/implementation/checkpoints/{story_id}.md` (one file per checkpoint, append over time)
38
- - A decision: continue / pivot / stop
39
-
40
- ## Steps
41
-
42
- ### 1. Pause
43
-
44
- Stop writing code. Do not commit any pending work until the checkpoint is recorded.
45
-
46
- ### 2. Snapshot
47
-
48
- Write 5 lines:
49
-
50
- - Files touched: (list, max 10)
51
- - ACs done vs. remaining: (X / Y)
52
- - Tests added: (count, by split)
53
- - New dependencies: (list)
54
- - Commits so far: (count)
55
-
56
- ### 3. Sanity check (3 questions)
57
-
58
- - **Are we solving the right problem?** Compare the implementation with the story's Context and ACs. If the story's intent was misunderstood, pivot.
59
- - **Is the design holding?** Compare the code with the architecture. If a new pattern emerged without an ADR, flag it.
60
- - **Any new constraints?** Did anything new appear (security finding, perf regression, vendor change, new stakeholder)?
61
-
62
- ### 4. Decide
63
-
64
- One of three:
65
-
66
- - **Continue** — the path is right. Record the snapshot; resume.
67
- - **Pivot** — change scope or approach. Open a follow-up story with `wize-create-story`; do not edit the current story's ACs.
68
- - **Stop** — the story is no longer worth it. Move it to `backlog` via `wize-correct-course`.
69
-
70
- One decision per checkpoint. Re-run for additional decisions.
71
-
72
- ### 5. Hand off
73
-
74
- Notify the next workflow:
75
-
76
- - Continue → `/wize-dev-story` (resume).
77
- - Pivot → `/wize-create-story` (new story for the pivot).
78
- - Stop → `/wize-correct-course` (defer the original).
79
-
80
- ## Output template
81
-
82
- ```markdown
83
- ---
84
- story_id: E04-S02
85
- checkpoint: 1
86
- date: 2026-06-16
87
- author: Shuri
88
- ---
89
-
90
- # Checkpoint — E04-S02
91
-
92
- ## Snapshot
93
- - Files touched: src/...
94
- - ACs done vs. remaining: 1 / 4
95
- - Tests added: 2 unit, 1 integration
96
- - New dependencies: none
97
- - Commits so far: 3
98
-
99
- ## Sanity check
100
- - Right problem? Yes.
101
- - Design holding? Yes.
102
- - New constraints? Vendor X deprecated their API; need a different client lib.
103
-
104
- ## Decision
105
- **Pivot** — see follow-up E04-S04 (client lib migration).
106
- ```
107
-
108
- ## Anti-patterns Shuri rejects
109
-
110
- - Skipping the snapshot to "save time" — the snapshot is the artifact.
111
- - Auto-pivoting (changing scope without an explicit checkpoint).
112
- - Recording "continue" without the sanity check answers.
113
- - Bundling multiple pivots in one checkpoint (one decision per run).
114
-
115
- ## Hand-off
116
-
117
- > "Checkpoint recorded for **{story_id}** (decision: {continue|pivot|stop}). Next: `/wize-dev-story` / `/wize-create-story` / `/wize-correct-course`."
@@ -1,21 +0,0 @@
1
- # Wize Dev Kit — overrides for the built-in workflow "wize-code-review".
2
- # DO NOT EDIT in the installed kit; copy to .wize/custom/workflows/wize-code-review/
3
- # for project-level overrides.
4
-
5
- [workflow]
6
-
7
- # Steps to run before standard activation (config load, greet).
8
- activation_steps_prepend = []
9
-
10
- # Steps to run after greet but before the workflow begins.
11
- activation_steps_append = []
12
-
13
- # Persistent facts the workflow keeps in mind for the whole run.
14
- persistent_facts = [
15
- "file:{project-root}/.wize/knowledge/document-project/conventions.md",
16
- ]
17
-
18
- # Scalar executed when the workflow reaches its final step,
19
- # after review findings are presented and sprint status is synced.
20
- # Override wins. Leave empty for no custom post-completion behavior.
21
- on_complete = ""
@@ -1,64 +0,0 @@
1
- ---
2
- diff_output: ''
3
- spec_file: ''
4
- review_mode: ''
5
- story_key: ''
6
- ---
7
-
8
- # Step 1: Gather Context
9
-
10
- ## Rules
11
-
12
- - Speak in `{communication_language}`.
13
- - The prompt that triggered this workflow IS the intent.
14
- - Do not modify any files in this step. Read-only.
15
-
16
- ## Instructions
17
-
18
- 1. **Find the review target.** Check in this order and stop as soon as the target is identified:
19
-
20
- **Tier 1 — Explicit argument.**
21
- Did the user pass a PR, commit SHA, branch, spec file, or diff source?
22
- - PR reference → resolve to branch/commit via `gh pr view`.
23
- - Commit or branch → use directly.
24
- - Spec file → set `{spec_file}` to the path. Check its frontmatter for `baseline_commit`.
25
- - Diff-mode keywords: `staged`, `uncommitted`, `branch diff`, `commit range`, `this diff`.
26
-
27
- **Tier 2 — Recent conversation.**
28
- Look for refs in the last few messages.
29
-
30
- **Tier 3 — Sprint tracking.**
31
- Look for `*sprint-status*` files and find stories with status `review`.
32
-
33
- **Tier 4 — Current git state.**
34
- If not on the default branch, confirm whether to review the current branch.
35
-
36
- **Tier 5 — Ask.**
37
- Present options: uncommitted changes, staged changes, branch diff, commit range, provided diff.
38
-
39
- 2. **Construct `{diff_output}`.**
40
- - Staged only: `git diff --cached`
41
- - Uncommitted: `git diff HEAD`
42
- - Branch diff: `git diff <base>..<branch>`
43
- - Commit range: `git diff <from>..<to>`
44
- - Provided diff: validate and use verbatim
45
- - File list: `git diff HEAD -- <files...>`, with untracked files included via `git diff --no-index /dev/null <path>`
46
-
47
- If `{diff_output}` is empty, halt and say so.
48
-
49
- 3. **Set the spec context.**
50
- - If `{spec_file}` is set and readable, set `{review_mode}` = `"full"`.
51
- - Otherwise ask: "Is there a spec or story file that provides context for these changes?"
52
- - Yes → set `{spec_file}`, verify it, set `{review_mode}` = `"full"`.
53
- - No → set `{review_mode}` = `"no-spec"`.
54
-
55
- 4. **Sanity check.**
56
- If the diff exceeds ~3000 lines, warn and offer to chunk.
57
-
58
- ### Checkpoint
59
-
60
- Present a summary: diff stats, `{review_mode}`, loaded spec/context docs. Halt and wait for confirmation to proceed.
61
-
62
- ## Next
63
-
64
- Read fully and follow `./step-02-review.md`.
@@ -1,40 +0,0 @@
1
- ---
2
- failed_layers: ''
3
- ---
4
-
5
- # Step 2: Review
6
-
7
- ## Rules
8
-
9
- - Speak in `{communication_language}`.
10
- - The Blind Hunter subagent receives **only** the diff — no project context.
11
- - The Edge Case Hunter subagent receives the diff and project read access.
12
- - The Acceptance Auditor subagent receives the diff, spec, and context docs.
13
- - All review subagents run at the same model capability as the current session.
14
-
15
- ## Instructions
16
-
17
- This step is an instance of Wizer's subagent fan-out pattern (see `wize-orchestrator` persona): name, scope, dispatch on whatever the current harness natively supports, tolerate partial failure.
18
-
19
- 1. If `{review_mode}` = `"no-spec"`, note: "Acceptance Auditor skipped — no spec file provided."
20
-
21
- 2. Launch parallel subagents without conversation context:
22
-
23
- - **Blind Hunter** — receives `{diff_output}` only. Invoke via `wize-review-adversarial`.
24
- Prompt: "Review this diff cynically. Assume problems exist. Find at least ten issues. Output as a Markdown list with one-line titles."
25
-
26
- - **Edge Case Hunter** — receives `{diff_output}` and read access to the project. Invoke via `wize-review-edge-case-hunter`.
27
- Prompt: "Walk every branching path and boundary condition in this diff. Report only unhandled edge cases as a JSON array."
28
-
29
- - **Acceptance Auditor** (only if `{review_mode}` = `"full"`) — receives `{diff_output}`, `{spec_file}` content, and context docs.
30
- Prompt: "Review this diff against the spec. Check for violations of acceptance criteria, deviations from spec intent, and missing behavior. Output findings as a Markdown list with AC/constraint reference and evidence."
31
-
32
- 3. If subagents are unavailable, generate prompt files in `{implementation_artifacts}` and halt, asking the user to run each in a separate session.
33
-
34
- 4. If any subagent fails, times out, or returns empty, append the layer name to `{failed_layers}` and proceed with findings from the remaining layers.
35
-
36
- 5. Collect all findings from completed layers.
37
-
38
- ## Next
39
-
40
- Read fully and follow `./step-03-triage.md`.
@@ -1,43 +0,0 @@
1
- # Step 3: Triage
2
-
3
- ## Rules
4
-
5
- - Speak in `{communication_language}`.
6
- - Be precise. When uncertain between categories, prefer the more conservative classification.
7
-
8
- ## Instructions
9
-
10
- 1. **Normalize** findings into a common format. Expected input formats:
11
- - Blind Hunter: Markdown list of descriptions.
12
- - Edge Case Hunter: JSON array with `location`, `trigger_condition`, `guard_snippet`, `potential_consequence`.
13
- - Acceptance Auditor: Markdown list with title, AC/constraint reference, and evidence.
14
-
15
- Convert all to a unified list with:
16
- - `id` — sequential integer
17
- - `source` — `blind`, `edge`, `auditor`, or merged (`blind+edge`, etc.)
18
- - `title` — one-line summary
19
- - `detail` — full description
20
- - `location` — file and line reference if available
21
-
22
- 2. **Deduplicate.** Merge findings that describe the same issue:
23
- - Use the most specific finding as the base (prefer Edge Case Hunter JSON with location).
24
- - Append unique detail, reasoning, or locations from other findings.
25
- - Set `source` to merged sources.
26
-
27
- 3. **Classify** each finding into exactly one bucket:
28
- - **decision_needed** — ambiguous choice requiring human input. Only possible if `{review_mode}` = `"full"`.
29
- - **patch** — code issue fixable without human input.
30
- - **defer** — pre-existing issue not caused by this change.
31
- - **dismiss** — noise, false positive, or handled elsewhere.
32
-
33
- If `{review_mode}` = `"no-spec"` and a finding would be `decision_needed`, reclassify as `patch` or `defer`.
34
-
35
- 4. **Drop** all `dismiss` findings. Record the dismiss count.
36
-
37
- 5. If `{failed_layers}` is non-empty, report which layers failed. If zero findings remain and layers failed, warn the user that the review may be incomplete.
38
-
39
- 6. If zero findings remain after triage, state: "✅ Clean review — all layers passed."
40
-
41
- ## Next
42
-
43
- Read fully and follow `./step-04-present.md`.
@@ -1,100 +0,0 @@
1
- ---
2
- deferred_work_file: '{implementation_artifacts}/deferred-work.md'
3
- ---
4
-
5
- # Step 4: Present and Act
6
-
7
- ## Rules
8
-
9
- - Speak in `{communication_language}`.
10
- - When `{spec_file}` is set, always write findings to the story file before offering action choices.
11
- - `decision_needed` findings must be resolved before handling `patch` findings.
12
-
13
- ## Instructions
14
-
15
- ### 1. Clean review shortcut
16
-
17
- If zero findings remain after triage, state that and proceed to section 6 (Sprint Status Update).
18
-
19
- ### 2. Write findings to the story file
20
-
21
- If `{spec_file}` exists and contains a Tasks/Subtasks section, append a `### Review Findings` subsection in this order:
22
-
23
- 1. `decision_needed` (unchecked):
24
- ```
25
- - [ ] [Review][Decision] <Title> — <Detail>
26
- ```
27
- 2. `patch` (unchecked):
28
- ```
29
- - [ ] [Review][Patch] <Title> [<file>:<line>]
30
- ```
31
- 3. `defer` (checked):
32
- ```
33
- - [x] [Review][Defer] <Title> [<file>:<line>] — deferred, pre-existing
34
- ```
35
-
36
- Also append each `defer` finding to `{deferred_work_file}` under `## Deferred from: code review ({date})`.
37
-
38
- ### 3. Present summary
39
-
40
- ```
41
- Code review complete.
42
- - decision_needed: {D}
43
- - patch: {P}
44
- - defer: {W}
45
- - dismissed: {R}
46
- ```
47
-
48
- If `{spec_file}` is set, add: "Findings written to `{spec_file}`."
49
-
50
- ### 4. Resolve decision_needed findings
51
-
52
- Present each `decision_needed` finding and ask the user to decide. Once resolved, each becomes a `patch`, `defer`, or is dismissed.
53
-
54
- If deferred, ask for a one-line reason and append it to both the story file bullet and the deferred-work file.
55
-
56
- ### 5. Handle patch findings
57
-
58
- If `patch` findings exist, ask:
59
-
60
- ```
61
- How would you like to handle the {P} patch findings?
62
- 1. Apply every patch — fix all now, no per-finding confirmation.
63
- 2. Leave as action items — they are already in the story file (only if spec_file set).
64
- 3. Walk through each patch — show details before deciding.
65
- ```
66
-
67
- Wait for the numbered choice. Do not proceed until selected.
68
-
69
- - **Apply every patch**: apply all patch findings. Afterward, present a summary of changes and check off patch items in the story file if applicable.
70
- - **Leave as action items**: done.
71
- - **Walk through each patch**: present each finding with detail and suggested fix, then re-offer the menu.
72
-
73
- ### 6. Update story status and sync sprint tracking
74
-
75
- Skip if `{spec_file}` is not set.
76
-
77
- Determine `{new_status}`:
78
- - If all `decision_needed` and `patch` findings are resolved and no unresolved issues remain → `done`
79
- - If patch findings were left as action items or unresolved issues remain → `in-progress`
80
-
81
- Update the story file status and save it.
82
-
83
- If `{story_key}` is set and a sprint-status file exists, update the matching `development_status` entry.
84
-
85
- ### 7. Next steps
86
-
87
- Present options:
88
-
89
- ```
90
- What would you like to do next?
91
- 1. Start the next story — run wize-dev-story to pick up the next ready-for-dev story.
92
- 2. Re-run code review — address findings and review again.
93
- 3. Done — end the workflow.
94
- ```
95
-
96
- Wait for the numbered choice.
97
-
98
- ## On complete
99
-
100
- Run `{workflow.on_complete}` if non-empty.
@@ -1,93 +0,0 @@
1
- ---
2
-
3
- code: wize-correct-course
4
- description: "Use quando o projeto desviar do plano e precisar de correção de curso com decisão documentada."
5
- name: Correct Course
6
- phase: 4-implementation
7
- owner: wize-agent-pm # Maria Hill, with wize-orchestrator
8
- status: ready
9
- ---
10
-
11
- # Correct Course
12
-
13
- **Goal.** React when a sprint drifts. Detect the deviation, classify the cause, propose one of three corrective moves (cut scope, re-route, escalate), and update `sprint-status.yaml` after the user confirms.
14
-
15
- Maria Hill chairs. Wizer is on call for cross-cutting decisions. The human always confirms the action.
16
-
17
- ## When to run
18
-
19
- - `wize-sprint-status` flagged a risk: "slipping" or "at risk".
20
- - The team says "we won't make it" during a stand-up.
21
- - A story's TEA gate came back as `FAIL` mid-sprint.
22
- - An external event (incident, vendor outage) consumed capacity.
23
- - **Automatic trigger:** any skill that completes step 7.5 (loop verification) and hits the max-cycles guard escalates to Wizer, who runs this skill.
24
- - **Staleness monitor:** if `wize-sprint-status` has not been updated in 2+ days, Wizer auto-runs this skill on session start (detected in step 1).
25
-
26
- ## Inputs
27
-
28
- - `.wize/implementation/sprint-status.yaml`
29
- - `.wize/implementation/tea/{epic}/{story}/gate.md` (when a gate failed)
30
- - `.wize/knowledge/document-project/risk-spots.md` (for context on known risks)
31
- - A free-form reason from the user: chat message, stand-up note, or incident link.
32
-
33
- ## Output
34
-
35
- - Updated `.wize/implementation/sprint-status.yaml` (statuses changed, items deferred).
36
- - One-line entry in `.wize/implementation/course-corrections.md` with date, cause, action, owner.
37
-
38
- ## Steps
39
-
40
- ### 1. Detect
41
-
42
- Wizer pulls the latest status file. If `last_updated` is older than 2 days, the sprint is stale. Mark this as risk #0: stale signal.
43
-
44
- ### 2. Classify
45
-
46
- Pick exactly one cause:
47
-
48
- - **Cut scope.** Story turned out larger than one PR, or a non-essential AC can be deferred.
49
- - **Re-route.** Story needs a different agent (e.g., Mantis for UX) or skill (e.g., `wize-investigate` for a regression).
50
- - **Escalate.** Story needs more hands, or a decision outside the team.
51
-
52
- A sprint can have multiple causes; the workflow handles one per run. Re-run for additional causes.
53
-
54
- ### 3. Propose
55
-
56
- For each cause, propose 1–3 specific actions. Each action is bounded: a story ID to move, a date to defer to, or a person to page. No vague "communicate more" — that’s not an action.
57
-
58
- ### 4. Confirm with the human
59
-
60
- List the actions; the human picks which to apply. Apply only what the human approved.
61
-
62
- ### 5. Update the sprint
63
-
64
- For each approved action:
65
-
66
- - Change `sprint-status.yaml` statuses (e.g., story from `in-progress` → `backlog` if deferred).
67
- - Append a row to `course-corrections.md` with `date`, `cause`, `action`, `owner`.
68
-
69
- ### 6. Hand off
70
-
71
- Notify the next workflow that should run (usually `wize-sprint-status` to confirm the new state, or `wize-dev-story` to continue the remaining work).
72
-
73
- ## Output template — `course-corrections.md`
74
-
75
- ```markdown
76
- # Course corrections
77
-
78
- | Date | Sprint | Cause | Action | Owner |
79
- |---|---|---|---|---|
80
- | 2026-06-15 | 4 | cut scope | E04-S02 split into S02a + S02b; S02b deferred to S5 | Hill |
81
- | 2026-06-15 | 4 | escalate | Paged Tony to unblock E04-S01 (waiting on ADR-010) | Wizer |
82
- ```
83
-
84
- ## Anti-patterns Hill rejects
85
-
86
- - Cutting scope without confirming the trade-off with the user.
87
- - Moving a story to `done` to "stop tracking it" when it isn’t actually done.
88
- - Re-routing to an agent who doesn’t have the context (always include a 3-sentence brief).
89
- - Escalating without naming a specific decision blocker.
90
-
91
- ## Hand-off
92
-
93
- > "Course correction applied at `.wize/implementation/course-corrections.md`. Sprint {N} updated. Run `/wize-sprint-status` to confirm the new state."