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,8 +0,0 @@
1
- code: hermes
2
- description: "Hermes Agent skills (.hermes/skills/, Anthropic-compatible, project-local)."
3
- target_path: ".hermes/skills/"
4
- file_pattern: "wize-*/SKILL.md"
5
- file_format: markdown
6
- hooks:
7
- pre_render: []
8
- post_render: []
@@ -1,17 +0,0 @@
1
- // Hermes Agent adapter — emits .hermes/skills/wize-{code}/SKILL.md per asset.
2
- // Hermes consumes the Anthropic SKILL.md format verbatim (same as Claude Code,
3
- // Codex, Kimi Code). Project-local skills live at <repo-root>/.hermes/skills/
4
- // and are only loaded when the repo root is trusted (`hermes skills trust`),
5
- // mirroring the OpenCode/Codex `.agents/skills/` convention.
6
-
7
- 'use strict';
8
-
9
- const path = require('node:path');
10
- const { renderAnthropicSkills } = require('../../tools/installer/render-shared.js');
11
-
12
- function render(kitRoot, projectRoot, opts = {}) {
13
- const targetDir = path.join(projectRoot, '.hermes', 'skills');
14
- return renderAnthropicSkills(kitRoot, targetDir, opts);
15
- }
16
-
17
- module.exports = { render };
@@ -1,20 +0,0 @@
1
- # Google Antigravity — Wize Development Kit
2
-
3
- 🌐 **Languages:** **English** · [Português (pt-BR)](antigravity.pt-BR.md)
4
-
5
- ← [Back to README](../../README.md)
6
-
7
- Antigravity uses the same public Anthropic Skill format as Claude Code and Codex.
8
-
9
- ## Output
10
-
11
- - `.agent/skills/wize-{code}/SKILL.md` — note the **singular** `.agent`, not `.agents` (that's Codex's directory).
12
- - A root `AGENTS.md` (shared with Codex, Cursor, and Windsurf).
13
-
14
- ## Notable
15
-
16
- - `.antigravitycli/` is Antigravity's own CLI state directory and is never touched by the kit — only `.agent/skills/` and `AGENTS.md` are written.
17
-
18
- ## Setup
19
-
20
- Pick **Antigravity** as an IDE target during `npx wize-dev-kit install` (or add it and re-run `npx wize-dev-kit sync`). Restart Antigravity, then run `/wize-orchestrator` or ask it to read `AGENTS.md`.
@@ -1,20 +0,0 @@
1
- # Google Antigravity — Wize Development Kit
2
-
3
- 🌐 **Idiomas:** [English](antigravity.md) · **Português (pt-BR)**
4
-
5
- ← [Voltar ao README](../../README.pt-BR.md)
6
-
7
- O Antigravity usa o mesmo formato público de Skill da Anthropic que o Claude Code e o Codex.
8
-
9
- ## Saída
10
-
11
- - `.agent/skills/wize-{code}/SKILL.md` — repare no **singular** `.agent`, não `.agents` (esse é o diretório do Codex).
12
- - Um `AGENTS.md` na raiz (compartilhado com Codex, Cursor e Windsurf).
13
-
14
- ## Destaques
15
-
16
- - `.antigravitycli/` é o diretório de estado do próprio CLI do Antigravity e nunca é tocado pelo kit — só `.agent/skills/` e `AGENTS.md` são gravados.
17
-
18
- ## Como ativar
19
-
20
- Escolha **Antigravity** como alvo de IDE em `npx wize-dev-kit install` (ou adicione depois e rode `npx wize-dev-kit sync`). Reinicie o Antigravity e rode `/wize-orchestrator` ou peça pra ele ler o `AGENTS.md`.
@@ -1,23 +0,0 @@
1
- # Claude Code — Wize Development Kit
2
-
3
- 🌐 **Languages:** **English** · [Português (pt-BR)](claude-code.pt-BR.md)
4
-
5
- ← [Back to README](../../README.md)
6
-
7
- Claude Code was the kit's first target and uses the public Anthropic Skill format verbatim.
8
-
9
- ## Output
10
-
11
- `.claude/skills/wize-{code}/SKILL.md` — one directory per asset (persona, workflow, or skill). YAML frontmatter (`name`, `description`) plus the Markdown body. Companion files a workflow references by relative path (`steps/`, `templates/`, `data/`, `customize.toml`, ...) are copied alongside the `SKILL.md` so those paths resolve.
12
-
13
- There is no separate "agent" file shape here — personas (Wizer, Shuri, Hawkeye...) and workflows/skills all render to the same `SKILL.md` structure.
14
-
15
- ## Notable
16
-
17
- - **Discovery is description-based.** Claude Code surfaces installed skills by matching the task at hand against each `description`; you can also invoke one directly by name (`/wize-dev-story`) or ask to "activate Wizer."
18
- - **Subagent fan-out is ad hoc, not persona-bound.** `wize-code-review` uses Claude Code's own Task/Agent tool to spin up isolated, parallel workers (Blind Hunter, Edge Case Hunter, Acceptance Auditor) for a single review pass. Any skill can do this — it isn't wired to a specific `.claude/agents/*.md` subagent definition, since the kit doesn't emit one.
19
- - Claude Code does **not** read the root `AGENTS.md` the installer generates (that file is for Codex, Cursor, Windsurf, and Antigravity).
20
-
21
- ## Setup
22
-
23
- Pick **Claude Code** as an IDE target during `npx wize-dev-kit install` (default). Restart Claude Code, then say *"Activate Wizer and brief him on the project"* or run `/wize-orchestrator`.
@@ -1,23 +0,0 @@
1
- # Claude Code — Wize Development Kit
2
-
3
- 🌐 **Idiomas:** [English](claude-code.md) · **Português (pt-BR)**
4
-
5
- ← [Voltar ao README](../../README.pt-BR.md)
6
-
7
- Claude Code foi o primeiro alvo do kit e usa o formato público de Skill da Anthropic ao pé da letra.
8
-
9
- ## Saída
10
-
11
- `.claude/skills/wize-{code}/SKILL.md` — um diretório por asset (persona, workflow ou skill). Frontmatter YAML (`name`, `description`) mais o corpo em Markdown. Arquivos complementares que um workflow referencia por caminho relativo (`steps/`, `templates/`, `data/`, `customize.toml`, ...) são copiados junto do `SKILL.md` para que esses caminhos resolvam.
12
-
13
- Não existe um formato separado de "agente" aqui — personas (Wizer, Shuri, Hawkeye...) e workflows/skills viram todos a mesma estrutura de `SKILL.md`.
14
-
15
- ## Destaques
16
-
17
- - **Descoberta por descrição.** O Claude Code encontra as skills instaladas casando a tarefa em mãos contra cada `description`; também dá pra invocar direto pelo nome (`/wize-dev-story`) ou pedir pra "ativar o Wizer".
18
- - **Fan-out de subagentes é ad hoc, não amarrado a persona.** O `wize-code-review` usa a própria ferramenta Task/Agent do Claude Code pra levantar workers isolados e paralelos (Blind Hunter, Edge Case Hunter, Acceptance Auditor) numa única passada de review. Qualquer skill pode fazer isso — não está amarrado a uma definição de subagente `.claude/agents/*.md`, já que o kit não gera nenhuma.
19
- - O Claude Code **não** lê o `AGENTS.md` na raiz que o instalador gera (esse arquivo é pro Codex, Cursor, Windsurf e Antigravity).
20
-
21
- ## Como ativar
22
-
23
- Escolha **Claude Code** como alvo de IDE em `npx wize-dev-kit install` (padrão). Reinicie o Claude Code e diga *"Ative o Wizer e dê o briefing do projeto a ele"* ou rode `/wize-orchestrator`.
@@ -1,21 +0,0 @@
1
- # OpenAI Codex — Wize Development Kit
2
-
3
- 🌐 **Languages:** **English** · [Português (pt-BR)](codex.pt-BR.md)
4
-
5
- ← [Back to README](../../README.md)
6
-
7
- Codex shares the same Anthropic Skill format as Claude Code and Kimi Code.
8
-
9
- ## Output
10
-
11
- - `.agents/skills/wize-{code}/SKILL.md` — one directory per persona, workflow, or skill.
12
- - A root `AGENTS.md` (shared with Cursor, Windsurf, and Antigravity) listing the roster and pointing at `wize-orchestrator` as the entry point.
13
-
14
- ## Notable
15
-
16
- - `.agents/skills/` is Codex's documented path for repository-local skills — the kit writes there directly, not to a Codex-specific directory.
17
- - **History:** 0.7.2 briefly moved this output to `.codex/skills/`, which broke skill loading in real Codex sessions; 0.7.3 reverted it to `.agents/skills/`. If you're on an older install, run `npx wize-dev-kit update` to fix the path.
18
-
19
- ## Setup
20
-
21
- Pick **Codex** as an IDE target during `npx wize-dev-kit install` (or add it and re-run `npx wize-dev-kit sync`). Restart Codex, then run `/wize-orchestrator` or ask it to read `AGENTS.md`.
@@ -1,21 +0,0 @@
1
- # OpenAI Codex — Wize Development Kit
2
-
3
- 🌐 **Idiomas:** [English](codex.md) · **Português (pt-BR)**
4
-
5
- ← [Voltar ao README](../../README.pt-BR.md)
6
-
7
- O Codex usa o mesmo formato de Skill da Anthropic que o Claude Code e o Kimi Code.
8
-
9
- ## Saída
10
-
11
- - `.agents/skills/wize-{code}/SKILL.md` — um diretório por persona, workflow ou skill.
12
- - Um `AGENTS.md` na raiz (compartilhado com Cursor, Windsurf e Antigravity) listando o elenco e apontando pro `wize-orchestrator` como ponto de entrada.
13
-
14
- ## Destaques
15
-
16
- - `.agents/skills/` é o caminho documentado do Codex pra skills locais do repositório — o kit grava lá diretamente, não num diretório específico do Codex.
17
- - **Histórico:** a 0.7.2 moveu essa saída, por um breve período, para `.codex/skills/`, o que quebrou o carregamento das skills em sessões reais do Codex; a 0.7.3 reverteu para `.agents/skills/`. Se sua instalação é antiga, rode `npx wize-dev-kit update` pra corrigir o caminho.
18
-
19
- ## Como ativar
20
-
21
- Escolha **Codex** como alvo de IDE em `npx wize-dev-kit install` (ou adicione depois e rode `npx wize-dev-kit sync`). Reinicie o Codex e rode `/wize-orchestrator` ou peça pra ele ler o `AGENTS.md`.
@@ -1,21 +0,0 @@
1
- # Continue.dev — Wize Development Kit
2
-
3
- 🌐 **Languages:** **English** · [Português (pt-BR)](continue.pt-BR.md)
4
-
5
- ← [Back to README](../../README.md)
6
-
7
- ## Output
8
-
9
- `.continue/prompts/wize-{code}.prompt` — one file per persona, workflow, or skill.
10
-
11
- ## Notable
12
-
13
- - Frontmatter: `name`, `description`, `invokable: true`. The `invokable` flag is what registers the file as a slash command in Continue's palette instead of a passive context document.
14
-
15
- ## Setup
16
-
17
- Pick **Continue** as an IDE target during `npx wize-dev-kit install` (or add it and re-run `npx wize-dev-kit sync`). Reload the Continue extension, then run `/wize-orchestrator` from the prompt palette.
18
-
19
- ## Reference
20
-
21
- - [docs.continue.dev — Prompts](https://docs.continue.dev/customize/deep-dives/prompts)
@@ -1,21 +0,0 @@
1
- # Continue.dev — Wize Development Kit
2
-
3
- 🌐 **Idiomas:** [English](continue.md) · **Português (pt-BR)**
4
-
5
- ← [Voltar ao README](../../README.pt-BR.md)
6
-
7
- ## Saída
8
-
9
- `.continue/prompts/wize-{code}.prompt` — um arquivo por persona, workflow ou skill.
10
-
11
- ## Destaques
12
-
13
- - Frontmatter: `name`, `description`, `invokable: true`. É a flag `invokable` que registra o arquivo como slash command na paleta do Continue, em vez de um documento de contexto passivo.
14
-
15
- ## Como ativar
16
-
17
- Escolha **Continue** como alvo de IDE em `npx wize-dev-kit install` (ou adicione depois e rode `npx wize-dev-kit sync`). Recarregue a extensão do Continue e rode `/wize-orchestrator` na paleta de prompts.
18
-
19
- ## Referência
20
-
21
- - [docs.continue.dev — Prompts](https://docs.continue.dev/customize/deep-dives/prompts)
@@ -1,22 +0,0 @@
1
- # Cursor — Wize Development Kit
2
-
3
- 🌐 **Languages:** **English** · [Português (pt-BR)](cursor.pt-BR.md)
4
-
5
- ← [Back to README](../../README.md)
6
-
7
- ## Output
8
-
9
- `.cursor/rules/wize-{code}.mdc` — one rule per persona, workflow, or skill.
10
-
11
- ## Notable
12
-
13
- - Frontmatter: `description`, `globs` (empty — not file-pattern-triggered), `alwaysApply: false`. Every wize-dev-kit rule attaches **on demand**, matched by Cursor against its `description`, rather than being injected into every prompt.
14
- - No native agent/subagent split in this format — personas and workflows/skills share the same `.mdc` shape (unlike [OpenCode](opencode.md)).
15
-
16
- ## Setup
17
-
18
- Pick **Cursor** as an IDE target during `npx wize-dev-kit install` (or add it and re-run `npx wize-dev-kit sync`). Restart Cursor, then reference `@wize-orchestrator` or ask it to activate Wizer.
19
-
20
- ## Reference
21
-
22
- - [cursor.com/docs/context/rules](https://cursor.com/docs/context/rules)
@@ -1,22 +0,0 @@
1
- # Cursor — Wize Development Kit
2
-
3
- 🌐 **Idiomas:** [English](cursor.md) · **Português (pt-BR)**
4
-
5
- ← [Voltar ao README](../../README.pt-BR.md)
6
-
7
- ## Saída
8
-
9
- `.cursor/rules/wize-{code}.mdc` — uma rule por persona, workflow ou skill.
10
-
11
- ## Destaques
12
-
13
- - Frontmatter: `description`, `globs` (vazio — não é disparado por padrão de arquivo), `alwaysApply: false`. Toda rule do wize-dev-kit se anexa **sob demanda**, casada pelo Cursor contra sua `description`, em vez de ser injetada em todo prompt.
14
- - Sem divisão nativa agente/subagente nesse formato — personas e workflows/skills compartilham o mesmo formato `.mdc` (diferente do [OpenCode](opencode.pt-BR.md)).
15
-
16
- ## Como ativar
17
-
18
- Escolha **Cursor** como alvo de IDE em `npx wize-dev-kit install` (ou adicione depois e rode `npx wize-dev-kit sync`). Reinicie o Cursor e referencie `@wize-orchestrator` ou peça pra ativar o Wizer.
19
-
20
- ## Referência
21
-
22
- - [cursor.com/docs/context/rules](https://cursor.com/docs/context/rules)
@@ -1,20 +0,0 @@
1
- # Generic fallback — Wize Development Kit
2
-
3
- 🌐 **Languages:** **English** · [Português (pt-BR)](generic.pt-BR.md)
4
-
5
- ← [Back to README](../../README.md)
6
-
7
- For any AI IDE that isn't one of the [dedicated targets](../../README.md#supported-harnesses).
8
-
9
- ## Output
10
-
11
- - `.wize/agents/wize-{code}.md` — plain Markdown per persona, workflow, or skill: a heading, a one-line summary blockquote, and the body. No frontmatter, no slash-command wiring.
12
- - A root `AGENTS.md` — the same baseline pointer file also read natively by Codex, Cursor, Windsurf, and Antigravity. It is never overwritten if one already exists in the repo.
13
-
14
- ## Notable
15
-
16
- - This target has no activation mechanism of its own — you point your assistant at `.wize/agents/wize-orchestrator.md` (or `AGENTS.md`) and ask it to read and follow it.
17
-
18
- ## Setup
19
-
20
- Pick **Generic fallback** as an IDE target during `npx wize-dev-kit install` — it's on by default alongside your primary target, precisely so an unsupported second tool in the same repo still has something to read.
@@ -1,20 +0,0 @@
1
- # Fallback genérico — Wize Development Kit
2
-
3
- 🌐 **Idiomas:** [English](generic.md) · **Português (pt-BR)**
4
-
5
- ← [Voltar ao README](../../README.pt-BR.md)
6
-
7
- Para qualquer IDE com IA que não esteja entre os [alvos dedicados](../../README.pt-BR.md#harnesses-suportadas).
8
-
9
- ## Saída
10
-
11
- - `.wize/agents/wize-{code}.md` — Markdown puro por persona, workflow ou skill: um título, um resumo de uma linha em bloco de citação, e o corpo. Sem frontmatter, sem integração de slash command.
12
- - Um `AGENTS.md` na raiz — o mesmo arquivo-ponteiro de baseline lido nativamente por Codex, Cursor, Windsurf e Antigravity. Nunca é sobrescrito se já existir um no repositório.
13
-
14
- ## Destaques
15
-
16
- - Esse alvo não tem mecanismo de ativação próprio — você aponta seu assistente pra `.wize/agents/wize-orchestrator.md` (ou `AGENTS.md`) e pede pra ele ler e seguir.
17
-
18
- ## Como ativar
19
-
20
- Escolha **Fallback genérico** como alvo de IDE em `npx wize-dev-kit install` — ele já vem ligado por padrão junto do seu alvo principal, justamente pra que uma segunda ferramenta sem suporte dedicado no mesmo repositório ainda tenha algo pra ler.
@@ -1,26 +0,0 @@
1
- # Hermes Agent — Wize Development Kit
2
-
3
- 🌐 **Languages:** **English** · [Português (pt-BR)](hermes.pt-BR.md)
4
-
5
- ← [Back to README](../../README.md)
6
-
7
- Hermes Agent consumes the same public Anthropic Skill format as Claude Code, Codex, and Kimi Code, as project-local skills.
8
-
9
- ## Output
10
-
11
- `.hermes/skills/wize-{code}/SKILL.md` — one directory per persona, workflow, or skill, with companion files (`steps/`, `templates/`, `data/`) copied alongside.
12
-
13
- ## Notable
14
-
15
- - **Project-local skills.** Hermes discovers `<git-root>/.hermes/skills/` (Hermes-native) and `<git-root>/.agents/skills/` (cross-tool convention) for sessions started inside that project.
16
- - **Trust gate.** Skills are load-on-demand procedure documents, so Hermes only loads project skills when the repo root is trusted — run `hermes skills trust` (or add the root to `skills.trusted_project_dirs` in `~/.hermes/config.yaml`) once per checkout. Untrusted repos are still discoverable with a one-line notice.
17
- - **Precedence.** Trusted project skills override same-named profile/bundled skills — vendored repo skills win inside their repo.
18
- - Hermes also reads root-level `AGENTS.md` (plus `CLAUDE.md`, `.cursorrules`) as project context, so pairing with the **Generic fallback** target is a bonus.
19
-
20
- ## Setup
21
-
22
- Pick **Hermes Agent** as an IDE target during `npx wize-dev-kit install` (or add it and re-run `npx wize-dev-kit sync`). Run `hermes skills trust` in the repo, restart Hermes, then run `/wize-orchestrator`.
23
-
24
- ## Headless
25
-
26
- `hermes -z "<prompt>"` runs a one-shot headless session, which the installer's brownfield baseline uses when Hermes is the detected harness CLI.
@@ -1,26 +0,0 @@
1
- # Hermes Agent — Wize Development Kit
2
-
3
- 🌐 **Idiomas:** [English](hermes.md) · **Português (pt-BR)**
4
-
5
- ← [Voltar ao README](../../README.pt-BR.md)
6
-
7
- O Hermes Agent consome o mesmo formato público de Skill da Anthropic usado pelo Claude Code, Codex e Kimi Code, na forma de skills project-local.
8
-
9
- ## Saída
10
-
11
- `.hermes/skills/wize-{code}/SKILL.md` — um diretório por persona, workflow ou skill, com arquivos complementares (`steps/`, `templates/`, `data/`) copiados junto.
12
-
13
- ## Destaques
14
-
15
- - **Skills project-local.** O Hermes descobre `<git-root>/.hermes/skills/` (nativo do Hermes) e `<git-root>/.agents/skills/` (convenção compartilhada) para sessões iniciadas dentro do projeto.
16
- - **Trust gate.** Skills são documentos de procedimento carregados sob demanda, então o Hermes só carrega skills do projeto quando a raiz do repositório é confiável — rode `hermes skills trust` (ou adicione a raiz em `skills.trusted_project_dirs` no `~/.hermes/config.yaml`) uma vez por checkout. Repositórios não confiáveis seguem detectáveis com um aviso de uma linha.
17
- - **Precedência.** Skills project-local confiáveis sobrescrevem skills de mesmo nome do perfil/bundle — skills versionadas no repo vencem dentro do próprio repo.
18
- - O Hermes também lê `AGENTS.md` na raiz (além de `CLAUDE.md`, `.cursorrules`) como contexto de projeto, então combinar com o alvo **Fallback genérico** é um bônus.
19
-
20
- ## Como ativar
21
-
22
- Escolha **Hermes Agent** como alvo de IDE em `npx wize-dev-kit install` (ou adicione depois e rode `npx wize-dev-kit sync`). Rode `hermes skills trust` no repo, reinicie o Hermes e rode `/wize-orchestrator`.
23
-
24
- ## Headless
25
-
26
- `hermes -z "<prompt>"` roda uma sessão headless de uma execução, usada pelo baseline brownfield do instalador quando o Hermes é o CLI de harness detectado.
@@ -1,19 +0,0 @@
1
- # Kimi Code — Wize Development Kit
2
-
3
- 🌐 **Languages:** **English** · [Português (pt-BR)](kimi-code.pt-BR.md)
4
-
5
- ← [Back to README](../../README.md)
6
-
7
- Moonshot's Kimi Code consumes the same public Anthropic Skill format as Claude Code and Codex.
8
-
9
- ## Output
10
-
11
- `.kimi/skills/wize-{code}/SKILL.md` — one directory per persona, workflow, or skill, with companion files (`steps/`, `templates/`, `data/`) copied alongside.
12
-
13
- ## Notable
14
-
15
- - Kimi Code also auto-detects `.claude/skills/` and `.agents/skills/` (Codex) if present in the repo, so installing the **Kimi Code** target alongside **Claude Code** and/or **Codex** is harmless — Kimi just has more places to find the same skills.
16
-
17
- ## Setup
18
-
19
- Pick **Kimi Code** as an IDE target during `npx wize-dev-kit install` (or add it and re-run `npx wize-dev-kit sync`). Restart Kimi Code, then run `/wize-orchestrator`.
@@ -1,19 +0,0 @@
1
- # Kimi Code — Wize Development Kit
2
-
3
- 🌐 **Idiomas:** [English](kimi-code.md) · **Português (pt-BR)**
4
-
5
- ← [Voltar ao README](../../README.pt-BR.md)
6
-
7
- O Kimi Code, da Moonshot, consome o mesmo formato público de Skill da Anthropic usado pelo Claude Code e pelo Codex.
8
-
9
- ## Saída
10
-
11
- `.kimi/skills/wize-{code}/SKILL.md` — um diretório por persona, workflow ou skill, com arquivos complementares (`steps/`, `templates/`, `data/`) copiados junto.
12
-
13
- ## Destaques
14
-
15
- - O Kimi Code também autodetecta `.claude/skills/` e `.agents/skills/` (Codex) se existirem no repositório, então instalar o alvo **Kimi Code** junto com **Claude Code** e/ou **Codex** é inofensivo — o Kimi só passa a ter mais lugares onde achar as mesmas skills.
16
-
17
- ## Como ativar
18
-
19
- Escolha **Kimi Code** como alvo de IDE em `npx wize-dev-kit install` (ou adicione depois e rode `npx wize-dev-kit sync`). Reinicie o Kimi Code e rode `/wize-orchestrator`.
@@ -1,31 +0,0 @@
1
- # OpenCode — Wize Development Kit
2
-
3
- 🌐 **Languages:** **English** · [Português (pt-BR)](opencode.pt-BR.md)
4
-
5
- ← [Back to README](../../README.md)
6
-
7
- OpenCode is the harness where the kit's persona/workflow split maps onto a **native** primitive instead of being flattened to one file type. Everywhere else, "agent" and "workflow" both become the same kind of file; on OpenCode they become two different things OpenCode itself understands.
8
-
9
- ## Output
10
-
11
- `npx wize-dev-kit sync` (or `install`) writes two trees:
12
-
13
- - `.opencode/agents/wize-{code}.md` — the 10 personas (Wizer, Pepper, Shuri, Hawkeye...).
14
- - `.opencode/commands/wize-{code}.md` — the workflows and skills (`/wize-dev-story`, `/wize-code-review`, ...).
15
-
16
- ## Notable
17
-
18
- - **`mode: primary | subagent`.** Only `wize-orchestrator` (Wizer) is `primary`. Every other persona is `subagent` — addressable directly with `@wize-agent-dev`, or delegated to automatically based on its `description`.
19
- - **`agent:` on commands.** Each workflow/skill's `owner:` frontmatter (e.g. `owner: wize-agent-dev # Shuri`) is resolved against the installed personas, so `/wize-dev-story` runs under Shuri's system prompt instead of whatever agent happened to be active. Commands with no clear owner (the Agent Builder skills) are left unbound.
20
- - **`subtask: true` on fan-out workers.** `wize-review-adversarial` and `wize-review-edge-case-hunter` — the two named subagent workers `wize-code-review` dispatches in parallel — are marked `subtask: true`, so OpenCode isolates them from the caller's context regardless of who invokes them.
21
-
22
- This is also the harness the kit's own subagent fan-out pattern (documented in Wizer's persona) is written against: name each worker, scope its context, dispatch on `mode: subagent` / `subtask: true`, tolerate partial failure.
23
-
24
- ## Setup
25
-
26
- Pick **OpenCode** as an IDE target during `npx wize-dev-kit install` (or add it and re-run `npx wize-dev-kit sync`). Restart OpenCode, then say *"Activate Wizer and brief him on the project"* or run `/wize-orchestrator`.
27
-
28
- ## Reference
29
-
30
- - [opencode.ai/docs/agents](https://opencode.ai/docs/agents/)
31
- - [opencode.ai/docs/commands](https://opencode.ai/docs/commands/)
@@ -1,31 +0,0 @@
1
- # OpenCode — Wize Development Kit
2
-
3
- 🌐 **Idiomas:** [English](opencode.md) · **Português (pt-BR)**
4
-
5
- ← [Voltar ao README](../../README.pt-BR.md)
6
-
7
- OpenCode é a harness onde a divisão persona/workflow do kit mapeia para uma primitiva **nativa**, em vez de ser achatada num único tipo de arquivo. Em todo o resto, "agente" e "workflow" viram o mesmo tipo de arquivo; no OpenCode eles viram duas coisas diferentes que o próprio OpenCode entende.
8
-
9
- ## Saída
10
-
11
- `npx wize-dev-kit sync` (ou `install`) grava duas árvores:
12
-
13
- - `.opencode/agents/wize-{code}.md` — as 10 personas (Wizer, Pepper, Shuri, Hawkeye...).
14
- - `.opencode/commands/wize-{code}.md` — os workflows e skills (`/wize-dev-story`, `/wize-code-review`, ...).
15
-
16
- ## Destaques
17
-
18
- - **`mode: primary | subagent`.** Só o `wize-orchestrator` (Wizer) é `primary`. Toda outra persona é `subagent` — endereçável direto com `@wize-agent-dev`, ou delegada automaticamente com base na `description`.
19
- - **`agent:` nos commands.** O campo `owner:` de cada workflow/skill (ex.: `owner: wize-agent-dev # Shuri`) é resolvido contra as personas instaladas, então `/wize-dev-story` roda sob o system prompt da Shuri em vez do agente que estava ativo. Commands sem um dono claro (as skills do Agent Builder) ficam sem vínculo.
20
- - **`subtask: true` nos workers de fan-out.** `wize-review-adversarial` e `wize-review-edge-case-hunter` — os dois workers nomeados que o `wize-code-review` dispara em paralelo — vêm marcados como `subtask: true`, então o OpenCode os isola do contexto de quem invocou, não importa quem seja.
21
-
22
- Esta também é a harness contra a qual o padrão de fan-out de subagentes do kit (documentado na persona da Wizer) foi escrito: nomear cada worker, escopar seu contexto, despachar via `mode: subagent` / `subtask: true`, tolerar falha parcial.
23
-
24
- ## Como ativar
25
-
26
- Escolha **OpenCode** como alvo de IDE em `npx wize-dev-kit install` (ou adicione depois e rode `npx wize-dev-kit sync`). Reinicie o OpenCode e diga *"Ative o Wizer e dê o briefing do projeto a ele"* ou rode `/wize-orchestrator`.
27
-
28
- ## Referência
29
-
30
- - [opencode.ai/docs/agents](https://opencode.ai/docs/agents/)
31
- - [opencode.ai/docs/commands](https://opencode.ai/docs/commands/)
@@ -1,22 +0,0 @@
1
- # Windsurf (Codeium) — Wize Development Kit
2
-
3
- 🌐 **Languages:** **English** · [Português (pt-BR)](windsurf.pt-BR.md)
4
-
5
- ← [Back to README](../../README.md)
6
-
7
- ## Output
8
-
9
- `.windsurf/rules/wize-{code}.md` — plain Markdown, no frontmatter: a heading, a one-line summary blockquote, and the full body.
10
-
11
- ## Notable
12
-
13
- - Windsurf's Cascade reads everything under `.windsurf/rules/` at session start. Activation mode (always-on, manual, model-decided, glob) is configured **inside the IDE's Rules panel** per file — the kit doesn't encode it, since Windsurf's rule format has no frontmatter for it.
14
- - Same flattening as Cursor: no agent/workflow distinction in the file format.
15
-
16
- ## Setup
17
-
18
- Pick **Windsurf** as an IDE target during `npx wize-dev-kit install` (or add it and re-run `npx wize-dev-kit sync`). Restart Windsurf, review the new rules under **Cascade → Rules**, then ask it to activate Wizer.
19
-
20
- ## Reference
21
-
22
- - [docs.windsurf.com — Cascade rules](https://docs.windsurf.com/windsurf/cascade/memories#rules)
@@ -1,22 +0,0 @@
1
- # Windsurf (Codeium) — Wize Development Kit
2
-
3
- 🌐 **Idiomas:** [English](windsurf.md) · **Português (pt-BR)**
4
-
5
- ← [Voltar ao README](../../README.pt-BR.md)
6
-
7
- ## Saída
8
-
9
- `.windsurf/rules/wize-{code}.md` — Markdown puro, sem frontmatter: um título, um resumo de uma linha em bloco de citação, e o corpo completo.
10
-
11
- ## Destaques
12
-
13
- - O Cascade do Windsurf lê tudo dentro de `.windsurf/rules/` no início da sessão. O modo de ativação (sempre ativo, manual, decidido pelo modelo, por glob) é configurado **dentro do painel de Rules da IDE**, por arquivo — o kit não codifica isso, já que o formato de rule do Windsurf não tem frontmatter pra isso.
14
- - Mesmo achatamento do Cursor: sem distinção agente/workflow no formato do arquivo.
15
-
16
- ## Como ativar
17
-
18
- Escolha **Windsurf** como alvo de IDE em `npx wize-dev-kit install` (ou adicione depois e rode `npx wize-dev-kit sync`). Reinicie o Windsurf, confira as novas rules em **Cascade → Rules**, e peça pra ativar o Wizer.
19
-
20
- ## Referência
21
-
22
- - [docs.windsurf.com — Cascade rules](https://docs.windsurf.com/windsurf/cascade/memories#rules)
@@ -1,116 +0,0 @@
1
- ---
2
-
3
- code: wize-customize
4
- description: "Use quando precisar personalizar um agente, skill ou workflow built-in sem alterar os arquivos originais do kit."
5
- name: Customize
6
- module: core
7
- status: ready
8
- ---
9
-
10
- # Customize
11
-
12
- **Goal.** Guide the user through creating an override (customize.toml) for a built-in agent, skill, or workflow. The override lives at `.wize/custom/{type}/{code}/customize.toml` and is loaded by the adapter at sync time.
13
-
14
- Wizer drives. Tony on call for agent structure.
15
-
16
- ## When to use
17
-
18
- - "Override the persona of `wize-agent-pm`."
19
- - "Customize the wording in `wize-product-brief`."
20
- - "Add a tool to `wize-orchestrator`."
21
-
22
- ## When NOT to use
23
-
24
- - Creating a brand-new agent/skill/workflow → use `wize-create-agent` (or `wize-create-skill` / `wize-create-workflow`).
25
- - Updating built-ins directly (the kit does not support forking built-ins; the next update would clobber your changes).
26
-
27
- ## Inputs
28
-
29
- - A target: agent code, skill code, or workflow code.
30
- - A scope: what to override (name, title, persona, tools, body).
31
-
32
- ## Output
33
-
34
- - A new file at `.wize/custom/{type}/{code}/customize.toml` (or update of an existing one).
35
- - A re-run of `wize-dev-kit sync` to apply the override.
36
-
37
- ## Steps
38
-
39
- ### 1. Identify the target
40
-
41
- The user names the code (e.g., `wize-agent-pm`). The skill validates:
42
-
43
- - Code shape: `wize-{kind}-{slug}`.
44
- - Exists in the kit's built-in roster.
45
-
46
- If the target does not exist, suggest `wize-create-agent` instead.
47
-
48
- ### 2. Inspect the existing override
49
-
50
- If `.wize/custom/{type}/{code}/customize.toml` exists, read it. The user is updating; otherwise creating.
51
-
52
- ### 3. Ask what to change
53
-
54
- The skill asks the user to pick from the overrideable fields:
55
-
56
- - `name` (display name)
57
- - `title` (job title)
58
- - `persona` (markdown body)
59
- - `tools` (list of tool names the agent can call)
60
- - `icon` (emoji)
61
-
62
- One field per run. Re-run for additional fields.
63
-
64
- ### 4. Generate the customize.toml
65
-
66
- Write the new (or merged) customize.toml. Keep the structure as comments so the user can see the template.
67
-
68
- ```toml
69
- # Override for {code} — generated by /wize-customize
70
- # Re-running the skill merges; lines you delete are restored on next install.
71
-
72
- [persona]
73
- # name = "Your name here"
74
- # title = "Your title here"
75
-
76
- [tools]
77
- # Add tool names the agent can call. Empty = default set.
78
- # tools = []
79
- ```
80
-
81
- ### 5. Re-sync
82
-
83
- Run `wize-dev-kit sync` (or instruct the user to). The override is loaded by the adapter and emitted to the IDE targets.
84
-
85
- ### 6. Hand off
86
-
87
- Notify the user of:
88
-
89
- - File written: `.wize/custom/{type}/{code}/customize.toml`.
90
- - Sync completed (or instructions to run it).
91
- - Where to verify the override (e.g., `.claude/skills/{code}/SKILL.md`).
92
-
93
- ## Output template
94
-
95
- The skill does not write a markdown output; it writes the customize.toml and re-syncs.
96
-
97
- ```toml
98
- # Override for wize-agent-pm — generated by /wize-customize
99
-
100
- [persona]
101
- name = "Hill" # shortened from "Maria Hill"
102
-
103
- [tools]
104
- # tools = [] # default set
105
- ```
106
-
107
- ## Anti-patterns Wizer rejects
108
-
109
- - Suggesting direct edits to built-in files in `node_modules/wize-dev-kit/`. (Next update clobbers.)
110
- - Creating a customize.toml with no overrideable fields filled. (Empty = no-op.)
111
- - Auto-running `wize-dev-kit sync` silently. (Confirm with the user first.)
112
- - Customizing the same field twice in one run. (One field per run.)
113
-
114
- ## Hand-off
115
-
116
- > "Override written at `.wize/custom/{type}/{code}/customize.toml`. Sync applied. Verify in `.claude/skills/{code}/SKILL.md` (or your IDE target)."