wize-dev-kit 0.14.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 (226) hide show
  1. package/ARCH.md +24 -77
  2. package/CHANGELOG.md +24 -0
  3. package/DECISIONS.md +1 -27
  4. package/README.md +7 -2
  5. package/ROSTER.md +3 -11
  6. package/adapters/README.md +7 -7
  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 +14 -158
  78. package/tools/installer/validators/run-all.js +2 -3
  79. package/tools/installer/wize-cli.js +70 -499
  80. package/AGENTS.md +0 -37
  81. package/README.es.md +0 -294
  82. package/README.pt-BR.md +0 -292
  83. package/docs/harnesses/antigravity.md +0 -20
  84. package/docs/harnesses/antigravity.pt-BR.md +0 -20
  85. package/docs/harnesses/claude-code.md +0 -23
  86. package/docs/harnesses/claude-code.pt-BR.md +0 -23
  87. package/docs/harnesses/codex.md +0 -21
  88. package/docs/harnesses/codex.pt-BR.md +0 -21
  89. package/docs/harnesses/continue.md +0 -21
  90. package/docs/harnesses/continue.pt-BR.md +0 -21
  91. package/docs/harnesses/cursor.md +0 -22
  92. package/docs/harnesses/cursor.pt-BR.md +0 -22
  93. package/docs/harnesses/generic.md +0 -20
  94. package/docs/harnesses/generic.pt-BR.md +0 -20
  95. package/docs/harnesses/kimi-code.md +0 -19
  96. package/docs/harnesses/kimi-code.pt-BR.md +0 -19
  97. package/docs/harnesses/opencode.md +0 -31
  98. package/docs/harnesses/opencode.pt-BR.md +0 -31
  99. package/docs/harnesses/windsurf.md +0 -22
  100. package/docs/harnesses/windsurf.pt-BR.md +0 -22
  101. package/src/core-skills/wize-customize/skill.md +0 -116
  102. package/src/core-skills/wize-editorial-review-prose/skill.md +0 -94
  103. package/src/core-skills/wize-editorial-review-structure/skill.md +0 -99
  104. package/src/core-skills/wize-grill/skill.md +0 -77
  105. package/src/core-skills/wize-index-docs/skill.md +0 -119
  106. package/src/core-skills/wize-pre-pr-check/skill.md +0 -134
  107. package/src/core-skills/wize-review-edge-case-hunter/skill.md +0 -115
  108. package/src/core-skills/wize-spec/assets/headless-schemas.md +0 -39
  109. package/src/core-skills/wize-spec/assets/spec-template.md +0 -40
  110. package/src/core-skills/wize-spec/customize.toml +0 -20
  111. package/src/core-skills/wize-spec/skill.md +0 -112
  112. package/src/method-skills/1-analysis/wize-document-project/documentation-requirements.csv +0 -12
  113. package/src/method-skills/1-analysis/wize-document-project/templates/api-contracts-template.md +0 -38
  114. package/src/method-skills/1-analysis/wize-document-project/templates/architecture-template.md +0 -54
  115. package/src/method-skills/1-analysis/wize-document-project/templates/component-inventory-template.md +0 -40
  116. package/src/method-skills/1-analysis/wize-document-project/templates/contribution-guide-template.md +0 -34
  117. package/src/method-skills/1-analysis/wize-document-project/templates/data-models-template.md +0 -36
  118. package/src/method-skills/1-analysis/wize-document-project/templates/deep-dive-template.md +0 -312
  119. package/src/method-skills/1-analysis/wize-document-project/templates/deployment-guide-template.md +0 -42
  120. package/src/method-skills/1-analysis/wize-document-project/templates/development-guide-template.md +0 -61
  121. package/src/method-skills/1-analysis/wize-document-project/templates/index-template.md +0 -185
  122. package/src/method-skills/1-analysis/wize-document-project/templates/project-overview-template.md +0 -110
  123. package/src/method-skills/1-analysis/wize-document-project/templates/project-scan-report-schema.json +0 -159
  124. package/src/method-skills/1-analysis/wize-document-project/templates/source-tree-template.md +0 -142
  125. package/src/method-skills/1-analysis/wize-domain-research/customize.toml +0 -14
  126. package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-01-init.md +0 -49
  127. package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-02-domain-analysis.md +0 -39
  128. package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-03-competitive-landscape.md +0 -39
  129. package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-04-regulatory-focus.md +0 -39
  130. package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-05-technical-trends.md +0 -39
  131. package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-06-research-synthesis.md +0 -43
  132. package/src/method-skills/1-analysis/wize-domain-research/research.template.md +0 -31
  133. package/src/method-skills/1-analysis/wize-domain-research/workflow.md +0 -58
  134. package/src/method-skills/1-analysis/wize-market-research/customize.toml +0 -14
  135. package/src/method-skills/1-analysis/wize-market-research/research.template.md +0 -31
  136. package/src/method-skills/1-analysis/wize-market-research/steps/step-01-init.md +0 -57
  137. package/src/method-skills/1-analysis/wize-market-research/steps/step-02-customer-behavior.md +0 -39
  138. package/src/method-skills/1-analysis/wize-market-research/steps/step-03-customer-pain-points.md +0 -37
  139. package/src/method-skills/1-analysis/wize-market-research/steps/step-04-customer-decisions.md +0 -39
  140. package/src/method-skills/1-analysis/wize-market-research/steps/step-05-competitive-analysis.md +0 -37
  141. package/src/method-skills/1-analysis/wize-market-research/steps/step-06-research-completion.md +0 -47
  142. package/src/method-skills/1-analysis/wize-market-research/workflow.md +0 -66
  143. package/src/method-skills/1-analysis/wize-refresh-knowledge/workflow.md +0 -129
  144. package/src/method-skills/1-analysis/wize-technical-research/customize.toml +0 -14
  145. package/src/method-skills/1-analysis/wize-technical-research/research.template.md +0 -31
  146. package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-01-init.md +0 -49
  147. package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-02-technical-overview.md +0 -45
  148. package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-03-integration-patterns.md +0 -39
  149. package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-04-architectural-patterns.md +0 -39
  150. package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-05-implementation-research.md +0 -42
  151. package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-06-research-synthesis.md +0 -46
  152. package/src/method-skills/1-analysis/wize-technical-research/workflow.md +0 -60
  153. package/src/method-skills/2-plan-workflows/wize-edit-prd/workflow.md +0 -110
  154. package/src/method-skills/3-solutioning/wize-create-architecture/architecture-decision-template.md +0 -41
  155. package/src/method-skills/3-solutioning/wize-create-architecture/customize.toml +0 -20
  156. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-01-init.md +0 -95
  157. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-01b-continue.md +0 -32
  158. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-02-context.md +0 -126
  159. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-03-starter.md +0 -110
  160. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-04-decisions.md +0 -129
  161. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-05-patterns.md +0 -109
  162. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-06-structure.md +0 -97
  163. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-07-validation.md +0 -124
  164. package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-08-complete.md +0 -59
  165. package/src/method-skills/3-solutioning/wize-project-context/workflow.md +0 -120
  166. package/src/method-skills/4-implementation/wize-changelog/workflow.md +0 -184
  167. package/src/method-skills/4-implementation/wize-checkpoint-preview/workflow.md +0 -117
  168. package/src/method-skills/4-implementation/wize-code-review/customize.toml +0 -21
  169. package/src/method-skills/4-implementation/wize-code-review/steps/step-01-gather-context.md +0 -64
  170. package/src/method-skills/4-implementation/wize-code-review/steps/step-02-review.md +0 -40
  171. package/src/method-skills/4-implementation/wize-code-review/steps/step-03-triage.md +0 -43
  172. package/src/method-skills/4-implementation/wize-code-review/steps/step-04-present.md +0 -100
  173. package/src/method-skills/4-implementation/wize-correct-course/workflow.md +0 -93
  174. package/src/method-skills/4-implementation/wize-investigate/workflow.md +0 -123
  175. package/src/method-skills/4-implementation/wize-release/workflow.md +0 -162
  176. package/src/orchestrator-skills/wize/skill.md +0 -164
  177. package/src/orchestrator-skills/wize-check/skill.md +0 -98
  178. package/src/security-overlay/_shared/allowlist.js +0 -154
  179. package/src/security-overlay/_shared/backlog.js +0 -169
  180. package/src/security-overlay/_shared/cli-runner.js +0 -87
  181. package/src/security-overlay/_shared/cvss.js +0 -108
  182. package/src/security-overlay/_shared/detect.js +0 -125
  183. package/src/security-overlay/_shared/install-script.js +0 -205
  184. package/src/security-overlay/_shared/invoke-phase.js +0 -86
  185. package/src/security-overlay/_shared/owasp.js +0 -56
  186. package/src/security-overlay/_shared/partial.js +0 -225
  187. package/src/security-overlay/_shared/preflight.js +0 -175
  188. package/src/security-overlay/_shared/scope-gate.js +0 -172
  189. package/src/security-overlay/_shared/scope-parser.js +0 -147
  190. package/src/security-overlay/agents/red-teamer/agent.yaml +0 -54
  191. package/src/security-overlay/agents/red-teamer/persona.md +0 -49
  192. package/src/security-overlay/data/common.txt +0 -115
  193. package/src/security-overlay/data/owasp-top10.json +0 -15
  194. package/src/security-overlay/data/tool-allowlist.json +0 -31
  195. package/src/security-overlay/skills/wize-sec-enumerate/scripts/run-enumerate.js +0 -180
  196. package/src/security-overlay/skills/wize-sec-enumerate/skill.md +0 -34
  197. package/src/security-overlay/skills/wize-sec-exploit/data/common.txt +0 -117
  198. package/src/security-overlay/skills/wize-sec-exploit/scripts/run-ffuf.js +0 -147
  199. package/src/security-overlay/skills/wize-sec-exploit/scripts/run-nikto.js +0 -145
  200. package/src/security-overlay/skills/wize-sec-exploit/scripts/run-nuclei.js +0 -176
  201. package/src/security-overlay/skills/wize-sec-exploit/scripts/run-sqlmap.js +0 -139
  202. package/src/security-overlay/skills/wize-sec-pentest/scripts/run-pipeline.js +0 -184
  203. package/src/security-overlay/skills/wize-sec-pentest/skill.md +0 -54
  204. package/src/security-overlay/skills/wize-sec-recon/scripts/run-gitleaks.js +0 -139
  205. package/src/security-overlay/skills/wize-sec-recon/scripts/run-osv.js +0 -227
  206. package/src/security-overlay/skills/wize-sec-recon/scripts/run-recon.js +0 -162
  207. package/src/security-overlay/skills/wize-sec-recon/skill.md +0 -37
  208. package/src/security-overlay/skills/wize-sec-report/scripts/render-report.js +0 -1033
  209. package/src/security-overlay/skills/wize-sec-scope/scripts/generate-scope.js +0 -106
  210. package/src/security-overlay/skills/wize-sec-scope/skill.md +0 -52
  211. package/src/tea-skills/wize-qa-generate-e2e-tests/workflow.md +0 -121
  212. package/tools/installer/baseline.js +0 -128
  213. package/tools/installer/commands/agent.js +0 -197
  214. package/tools/installer/commands/doctor.js +0 -319
  215. package/tools/installer/commands/document-project.js +0 -93
  216. package/tools/installer/commands/sync.js +0 -45
  217. package/tools/installer/commands/update.js +0 -172
  218. package/tools/installer/document-project/batch-scanner.js +0 -93
  219. package/tools/installer/document-project/classify.js +0 -170
  220. package/tools/installer/document-project/modes/deep-dive.js +0 -196
  221. package/tools/installer/document-project/modes/full-rescan.js +0 -15
  222. package/tools/installer/document-project/modes/initial-scan.js +0 -100
  223. package/tools/installer/document-project/modes/quick.js +0 -211
  224. package/tools/installer/document-project/render-index.js +0 -101
  225. package/tools/installer/document-project/state.js +0 -110
  226. package/tools/installer/version-check.js +0 -117
@@ -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,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)."
@@ -1,94 +0,0 @@
1
- ---
2
-
3
- code: wize-editorial-review-prose
4
- description: "Use quando um artefato Wize (brief, PRD, ADR, gate) precisar de revisão de prosa — clareza, tom, jargão e precisão."
5
- name: Editorial Review — Prose
6
- module: core
7
- status: ready
8
- ---
9
-
10
- # Editorial Review — Prose
11
-
12
- **Goal.** Catch prose drift in Wize artifacts (brief, PRD, ADR, gate, story, retrospective). Peggy Carter runs the review; the user applies the fixes.
13
-
14
- Peggy drives. Wizer is on call for the call to action ("rewrite the whole section" or "leave it").
15
-
16
- ## When to use
17
-
18
- - "Review the prose in this PRD."
19
- - "Find jargon and hedging in the brief."
20
- - "Is this gate file clear?"
21
-
22
- ## When NOT to use
23
-
24
- - Spelling/grammar (use a linter; out of scope here).
25
- - Structure (missing sections, wrong ordering) → use `wize-editorial-review-structure`.
26
- - Tone change (tone is intentional; leave it).
27
-
28
- ## Inputs
29
-
30
- - A markdown file under `.wize/`.
31
- - A line range (optional; default = whole file).
32
-
33
- ## Output
34
-
35
- - A markdown review with line-level findings, each tagged with severity (nit / suggest / recommend).
36
-
37
- ## Steps
38
-
39
- ### 1. Read
40
-
41
- Read the file (or line range). Skip code blocks. Skip frontmatter.
42
-
43
- ### 2. Hunt (4 areas)
44
-
45
- - **Voice.** Active voice preferred. Flag passive constructions ("was decided by", "is being implemented").
46
- - **Jargon.** Acronyms not defined on first use. Discipline-specific terms (e.g., "JTBD", "NFR") that are not in the project glossary.
47
- - **Hedging.** Softeners that hide commitment: "might", "could possibly", "we should consider", "it would be nice". Suggest a stronger verb.
48
- - **Pronouns.** Ambiguous "this", "it", "they" without a clear referent. Suggest a specific noun.
49
-
50
- ### 3. Rank
51
-
52
- Per finding:
53
-
54
- - **Nit** — minor; user can ignore.
55
- - **Suggest** — worth a 5-second fix.
56
- - **Recommend** — blocks the artifact's clarity; should be fixed.
57
-
58
- ### 4. Hand off
59
-
60
- Output is a markdown list. The user applies or rejects each finding. Peggy does not auto-edit.
61
-
62
- ## Output template
63
-
64
- ```markdown
65
- ---
66
- date: 2026-06-17
67
- file: planning/prd.md
68
- author: Peggy
69
- ---
70
-
71
- # Prose review — prd.md
72
-
73
- ## Recommendations
74
- - L42: "we should consider using a token bucket" → "we use a token bucket". Hedging hides the decision. **[recommend]**
75
- - L78: "this might affect the user" → "this affects new signups". Pronoun + hedging. **[recommend]**
76
-
77
- ## Suggests
78
- - L15: "rate-limit" appears 4 times. First use: spell out "rate-limit (per-IP cap on request rate)". **[suggest]**
79
- - L23: passive "is implemented by" → active "we implement". **[suggest]**
80
-
81
- ## Nits
82
- - L88: comma splice. **[nit]**
83
- ```
84
-
85
- ## Anti-patterns Peggy rejects
86
-
87
- - Auto-editing the source file. (Suggest; never write.)
88
- - Commenting on tone or style preference. (Tone is intentional; structure is a separate review.)
89
- - Marking everything as recommend. (Cap at 5 recommends per review.)
90
- - Reviewing code blocks. (Out of scope.)
91
-
92
- ## Hand-off
93
-
94
- > "Prose review complete for `{file}`. {N} findings. {M} recommends, {K} suggests, {L} nits. Apply or reject per finding."