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.
- package/ARCH.md +24 -77
- package/CHANGELOG.md +24 -0
- package/DECISIONS.md +1 -27
- package/README.md +7 -2
- package/ROSTER.md +3 -11
- package/adapters/README.md +7 -7
- package/adapters/antigravity/README.md +5 -5
- package/adapters/claude-code/README.md +1 -1
- package/adapters/codex/README.md +5 -5
- package/adapters/codex/adapter.yaml +1 -1
- package/adapters/codex/render.js +1 -1
- package/adapters/continue/README.md +5 -5
- package/adapters/cursor/README.md +2 -2
- package/adapters/generic/README.md +1 -1
- package/adapters/kimi-code/README.md +5 -5
- package/adapters/kimi-code/render.js +2 -2
- package/adapters/opencode/README.md +3 -3
- package/adapters/opencode/render.js +1 -27
- package/adapters/windsurf/README.md +3 -3
- package/package.json +1 -1
- package/schemas/agent.schema.json +2 -2
- package/schemas/workflow.schema.json +1 -1
- package/src/app-overlay/wize-app-release-channels/workflow.md +0 -2
- package/src/app-overlay/wize-app-scaffold/workflow.md +0 -2
- package/src/app-overlay/wize-app-store-listing/workflow.md +0 -2
- package/src/builder-skills/wize-create-agent/workflow.md +0 -2
- package/src/builder-skills/wize-create-skill/workflow.md +0 -2
- package/src/builder-skills/wize-create-workflow/workflow.md +0 -2
- package/src/core-skills/module.yaml +3 -0
- package/src/core-skills/wize-advanced-elicitation/skill.md +0 -2
- package/src/core-skills/wize-brainstorming/skill.md +0 -2
- package/src/core-skills/wize-eli5/skill.md +72 -0
- package/src/core-skills/wize-review-adversarial/skill.md +0 -3
- package/src/core-skills/wize-shard-doc/skill.md +0 -2
- package/src/method-skills/1-analysis/wize-agent-analyst/agent.yaml +0 -3
- package/src/method-skills/1-analysis/wize-document-project/workflow.md +20 -213
- package/src/method-skills/1-analysis/wize-prfaq/workflow.md +11 -152
- package/src/method-skills/1-analysis/wize-product-brief/workflow.md +19 -92
- package/src/method-skills/1-analysis/wize-research/workflow.md +12 -39
- package/src/method-skills/1-analysis/wize-trigger-map/workflow.md +16 -82
- package/src/method-skills/2-plan-workflows/wize-create-prd/workflow.md +23 -135
- package/src/method-skills/2-plan-workflows/wize-ux-design/workflow.md +28 -134
- package/src/method-skills/2-plan-workflows/wize-ux-scenarios/workflow.md +15 -93
- package/src/method-skills/2-plan-workflows/wize-validate-prd/workflow.md +12 -108
- package/src/method-skills/3-solutioning/wize-check-implementation-readiness/workflow.md +11 -103
- package/src/method-skills/3-solutioning/wize-create-architecture/workflow.md +48 -55
- package/src/method-skills/3-solutioning/wize-create-epics-and-stories/workflow.md +15 -154
- package/src/method-skills/3-solutioning/wize-design-system/workflow.md +22 -184
- package/src/method-skills/3-solutioning/wize-nfr-principles/workflow.md +17 -145
- package/src/method-skills/3-solutioning/wize-tech-vision/workflow.md +22 -130
- package/src/method-skills/4-implementation/wize-agent-dev/persona.md +0 -12
- package/src/method-skills/4-implementation/wize-code-review/workflow.md +12 -54
- package/src/method-skills/4-implementation/wize-create-story/workflow.md +10 -154
- package/src/method-skills/4-implementation/wize-dev-story/workflow.md +17 -185
- package/src/method-skills/4-implementation/wize-quick-dev/workflow.md +18 -136
- package/src/method-skills/4-implementation/wize-retrospective/workflow.md +10 -114
- package/src/method-skills/4-implementation/wize-sprint-planning/workflow.md +11 -78
- package/src/method-skills/4-implementation/wize-sprint-status/workflow.md +11 -45
- package/src/method-skills/module.yaml +0 -28
- package/src/orchestrator-skills/module.yaml +1 -7
- package/src/orchestrator-skills/wize-help/skill.md +67 -227
- package/src/orchestrator-skills/wize-onboarding/workflow.md +14 -78
- package/src/orchestrator-skills/wize-orchestrator/agent.yaml +0 -2
- package/src/orchestrator-skills/wize-orchestrator/persona.md +3 -44
- package/src/orchestrator-skills/wize-party-mode/workflow.md +0 -2
- package/src/tea-skills/wize-tea-design/workflow.md +13 -107
- package/src/tea-skills/wize-tea-gate/workflow.md +25 -118
- package/src/tea-skills/wize-tea-nfr/workflow.md +14 -107
- package/src/tea-skills/wize-tea-review/workflow.md +13 -123
- package/src/tea-skills/wize-tea-risk/workflow.md +10 -113
- package/src/tea-skills/wize-tea-trace/workflow.md +12 -86
- package/src/web-overlay/wize-web-deploy/workflow.md +0 -2
- package/src/web-overlay/wize-web-scaffold/workflow.md +0 -2
- package/src/web-overlay/wize-web-seo-audit/workflow.md +0 -2
- package/tools/check-eli5-all-adapters.js +50 -0
- package/tools/installer/onboarding.js +20 -14
- package/tools/installer/render-shared.js +14 -158
- package/tools/installer/validators/run-all.js +2 -3
- package/tools/installer/wize-cli.js +70 -499
- package/AGENTS.md +0 -37
- package/README.es.md +0 -294
- package/README.pt-BR.md +0 -292
- package/docs/harnesses/antigravity.md +0 -20
- package/docs/harnesses/antigravity.pt-BR.md +0 -20
- package/docs/harnesses/claude-code.md +0 -23
- package/docs/harnesses/claude-code.pt-BR.md +0 -23
- package/docs/harnesses/codex.md +0 -21
- package/docs/harnesses/codex.pt-BR.md +0 -21
- package/docs/harnesses/continue.md +0 -21
- package/docs/harnesses/continue.pt-BR.md +0 -21
- package/docs/harnesses/cursor.md +0 -22
- package/docs/harnesses/cursor.pt-BR.md +0 -22
- package/docs/harnesses/generic.md +0 -20
- package/docs/harnesses/generic.pt-BR.md +0 -20
- package/docs/harnesses/kimi-code.md +0 -19
- package/docs/harnesses/kimi-code.pt-BR.md +0 -19
- package/docs/harnesses/opencode.md +0 -31
- package/docs/harnesses/opencode.pt-BR.md +0 -31
- package/docs/harnesses/windsurf.md +0 -22
- package/docs/harnesses/windsurf.pt-BR.md +0 -22
- package/src/core-skills/wize-customize/skill.md +0 -116
- package/src/core-skills/wize-editorial-review-prose/skill.md +0 -94
- package/src/core-skills/wize-editorial-review-structure/skill.md +0 -99
- package/src/core-skills/wize-grill/skill.md +0 -77
- package/src/core-skills/wize-index-docs/skill.md +0 -119
- package/src/core-skills/wize-pre-pr-check/skill.md +0 -134
- package/src/core-skills/wize-review-edge-case-hunter/skill.md +0 -115
- package/src/core-skills/wize-spec/assets/headless-schemas.md +0 -39
- package/src/core-skills/wize-spec/assets/spec-template.md +0 -40
- package/src/core-skills/wize-spec/customize.toml +0 -20
- package/src/core-skills/wize-spec/skill.md +0 -112
- package/src/method-skills/1-analysis/wize-document-project/documentation-requirements.csv +0 -12
- package/src/method-skills/1-analysis/wize-document-project/templates/api-contracts-template.md +0 -38
- package/src/method-skills/1-analysis/wize-document-project/templates/architecture-template.md +0 -54
- package/src/method-skills/1-analysis/wize-document-project/templates/component-inventory-template.md +0 -40
- package/src/method-skills/1-analysis/wize-document-project/templates/contribution-guide-template.md +0 -34
- package/src/method-skills/1-analysis/wize-document-project/templates/data-models-template.md +0 -36
- package/src/method-skills/1-analysis/wize-document-project/templates/deep-dive-template.md +0 -312
- package/src/method-skills/1-analysis/wize-document-project/templates/deployment-guide-template.md +0 -42
- package/src/method-skills/1-analysis/wize-document-project/templates/development-guide-template.md +0 -61
- package/src/method-skills/1-analysis/wize-document-project/templates/index-template.md +0 -185
- package/src/method-skills/1-analysis/wize-document-project/templates/project-overview-template.md +0 -110
- package/src/method-skills/1-analysis/wize-document-project/templates/project-scan-report-schema.json +0 -159
- package/src/method-skills/1-analysis/wize-document-project/templates/source-tree-template.md +0 -142
- package/src/method-skills/1-analysis/wize-domain-research/customize.toml +0 -14
- package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-01-init.md +0 -49
- package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-02-domain-analysis.md +0 -39
- package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-03-competitive-landscape.md +0 -39
- package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-04-regulatory-focus.md +0 -39
- package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-05-technical-trends.md +0 -39
- package/src/method-skills/1-analysis/wize-domain-research/domain-steps/step-06-research-synthesis.md +0 -43
- package/src/method-skills/1-analysis/wize-domain-research/research.template.md +0 -31
- package/src/method-skills/1-analysis/wize-domain-research/workflow.md +0 -58
- package/src/method-skills/1-analysis/wize-market-research/customize.toml +0 -14
- package/src/method-skills/1-analysis/wize-market-research/research.template.md +0 -31
- package/src/method-skills/1-analysis/wize-market-research/steps/step-01-init.md +0 -57
- package/src/method-skills/1-analysis/wize-market-research/steps/step-02-customer-behavior.md +0 -39
- package/src/method-skills/1-analysis/wize-market-research/steps/step-03-customer-pain-points.md +0 -37
- package/src/method-skills/1-analysis/wize-market-research/steps/step-04-customer-decisions.md +0 -39
- package/src/method-skills/1-analysis/wize-market-research/steps/step-05-competitive-analysis.md +0 -37
- package/src/method-skills/1-analysis/wize-market-research/steps/step-06-research-completion.md +0 -47
- package/src/method-skills/1-analysis/wize-market-research/workflow.md +0 -66
- package/src/method-skills/1-analysis/wize-refresh-knowledge/workflow.md +0 -129
- package/src/method-skills/1-analysis/wize-technical-research/customize.toml +0 -14
- package/src/method-skills/1-analysis/wize-technical-research/research.template.md +0 -31
- package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-01-init.md +0 -49
- package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-02-technical-overview.md +0 -45
- package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-03-integration-patterns.md +0 -39
- package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-04-architectural-patterns.md +0 -39
- package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-05-implementation-research.md +0 -42
- package/src/method-skills/1-analysis/wize-technical-research/technical-steps/step-06-research-synthesis.md +0 -46
- package/src/method-skills/1-analysis/wize-technical-research/workflow.md +0 -60
- package/src/method-skills/2-plan-workflows/wize-edit-prd/workflow.md +0 -110
- package/src/method-skills/3-solutioning/wize-create-architecture/architecture-decision-template.md +0 -41
- package/src/method-skills/3-solutioning/wize-create-architecture/customize.toml +0 -20
- package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-01-init.md +0 -95
- package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-01b-continue.md +0 -32
- package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-02-context.md +0 -126
- package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-03-starter.md +0 -110
- package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-04-decisions.md +0 -129
- package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-05-patterns.md +0 -109
- package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-06-structure.md +0 -97
- package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-07-validation.md +0 -124
- package/src/method-skills/3-solutioning/wize-create-architecture/steps/step-08-complete.md +0 -59
- package/src/method-skills/3-solutioning/wize-project-context/workflow.md +0 -120
- package/src/method-skills/4-implementation/wize-changelog/workflow.md +0 -184
- package/src/method-skills/4-implementation/wize-checkpoint-preview/workflow.md +0 -117
- package/src/method-skills/4-implementation/wize-code-review/customize.toml +0 -21
- package/src/method-skills/4-implementation/wize-code-review/steps/step-01-gather-context.md +0 -64
- package/src/method-skills/4-implementation/wize-code-review/steps/step-02-review.md +0 -40
- package/src/method-skills/4-implementation/wize-code-review/steps/step-03-triage.md +0 -43
- package/src/method-skills/4-implementation/wize-code-review/steps/step-04-present.md +0 -100
- package/src/method-skills/4-implementation/wize-correct-course/workflow.md +0 -93
- package/src/method-skills/4-implementation/wize-investigate/workflow.md +0 -123
- package/src/method-skills/4-implementation/wize-release/workflow.md +0 -162
- package/src/orchestrator-skills/wize/skill.md +0 -164
- package/src/orchestrator-skills/wize-check/skill.md +0 -98
- package/src/security-overlay/_shared/allowlist.js +0 -154
- package/src/security-overlay/_shared/backlog.js +0 -169
- package/src/security-overlay/_shared/cli-runner.js +0 -87
- package/src/security-overlay/_shared/cvss.js +0 -108
- package/src/security-overlay/_shared/detect.js +0 -125
- package/src/security-overlay/_shared/install-script.js +0 -205
- package/src/security-overlay/_shared/invoke-phase.js +0 -86
- package/src/security-overlay/_shared/owasp.js +0 -56
- package/src/security-overlay/_shared/partial.js +0 -225
- package/src/security-overlay/_shared/preflight.js +0 -175
- package/src/security-overlay/_shared/scope-gate.js +0 -172
- package/src/security-overlay/_shared/scope-parser.js +0 -147
- package/src/security-overlay/agents/red-teamer/agent.yaml +0 -54
- package/src/security-overlay/agents/red-teamer/persona.md +0 -49
- package/src/security-overlay/data/common.txt +0 -115
- package/src/security-overlay/data/owasp-top10.json +0 -15
- package/src/security-overlay/data/tool-allowlist.json +0 -31
- package/src/security-overlay/skills/wize-sec-enumerate/scripts/run-enumerate.js +0 -180
- package/src/security-overlay/skills/wize-sec-enumerate/skill.md +0 -34
- package/src/security-overlay/skills/wize-sec-exploit/data/common.txt +0 -117
- package/src/security-overlay/skills/wize-sec-exploit/scripts/run-ffuf.js +0 -147
- package/src/security-overlay/skills/wize-sec-exploit/scripts/run-nikto.js +0 -145
- package/src/security-overlay/skills/wize-sec-exploit/scripts/run-nuclei.js +0 -176
- package/src/security-overlay/skills/wize-sec-exploit/scripts/run-sqlmap.js +0 -139
- package/src/security-overlay/skills/wize-sec-pentest/scripts/run-pipeline.js +0 -184
- package/src/security-overlay/skills/wize-sec-pentest/skill.md +0 -54
- package/src/security-overlay/skills/wize-sec-recon/scripts/run-gitleaks.js +0 -139
- package/src/security-overlay/skills/wize-sec-recon/scripts/run-osv.js +0 -227
- package/src/security-overlay/skills/wize-sec-recon/scripts/run-recon.js +0 -162
- package/src/security-overlay/skills/wize-sec-recon/skill.md +0 -37
- package/src/security-overlay/skills/wize-sec-report/scripts/render-report.js +0 -1033
- package/src/security-overlay/skills/wize-sec-scope/scripts/generate-scope.js +0 -106
- package/src/security-overlay/skills/wize-sec-scope/skill.md +0 -52
- package/src/tea-skills/wize-qa-generate-e2e-tests/workflow.md +0 -121
- package/tools/installer/baseline.js +0 -128
- package/tools/installer/commands/agent.js +0 -197
- package/tools/installer/commands/doctor.js +0 -319
- package/tools/installer/commands/document-project.js +0 -93
- package/tools/installer/commands/sync.js +0 -45
- package/tools/installer/commands/update.js +0 -172
- package/tools/installer/document-project/batch-scanner.js +0 -93
- package/tools/installer/document-project/classify.js +0 -170
- package/tools/installer/document-project/modes/deep-dive.js +0 -196
- package/tools/installer/document-project/modes/full-rescan.js +0 -15
- package/tools/installer/document-project/modes/initial-scan.js +0 -100
- package/tools/installer/document-project/modes/quick.js +0 -211
- package/tools/installer/document-project/render-index.js +0 -101
- package/tools/installer/document-project/state.js +0 -110
- package/tools/installer/version-check.js +0 -117
|
@@ -1,59 +1,25 @@
|
|
|
1
1
|
---
|
|
2
|
-
|
|
3
2
|
code: wize-sprint-status
|
|
4
|
-
description: "Use quando precisar verificar o status atual do sprint — stories concluídas, em progresso e bloqueios."
|
|
5
3
|
name: Sprint Status
|
|
6
4
|
phase: 4-implementation
|
|
7
5
|
owner: wize-agent-pm # Maria Hill
|
|
8
|
-
status:
|
|
6
|
+
status: stub
|
|
9
7
|
---
|
|
10
8
|
|
|
11
9
|
# Sprint Status
|
|
12
10
|
|
|
13
|
-
**Goal.**
|
|
14
|
-
|
|
15
|
-
## Inputs
|
|
16
|
-
|
|
17
|
-
- `.wize/implementation/sprint-status.yaml`
|
|
18
|
-
- `.wize/implementation/tea/{epic}/{story}/gate.md`
|
|
19
|
-
|
|
20
|
-
## Output
|
|
21
|
-
|
|
22
|
-
- Updated sprint-status.yaml (if statuses changed).
|
|
23
|
-
- One recommended next workflow.
|
|
24
|
-
|
|
25
|
-
## Steps
|
|
11
|
+
**Goal.** Daily snapshot of in-flight stories. Blockers up front.
|
|
26
12
|
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
3. **Count** statuses.
|
|
30
|
-
4. **Detect risks:**
|
|
31
|
-
- Story `in-progress` older than 2 days with no update.
|
|
32
|
-
- Blocked story without owner/deadline.
|
|
33
|
-
- Epic `in-progress` with no stories.
|
|
34
|
-
5. **Recommend next step** (in priority order):
|
|
35
|
-
1. Story `in-progress` → `/wize-dev-story`
|
|
36
|
-
2. Story `review` → `/wize-tea-review`
|
|
37
|
-
3. Story `ready-for-dev` → `/wize-dev-story`
|
|
38
|
-
4. Story `backlog` → `/wize-create-story`
|
|
39
|
-
5. Retrospective `optional` → `/wize-retrospective`
|
|
40
|
-
6. All done → congratulate team.
|
|
41
|
-
|
|
42
|
-
## Summary output
|
|
13
|
+
## Outputs
|
|
14
|
+
- Updates appended to `.wize/implementation/sprint-status.md`
|
|
43
15
|
|
|
16
|
+
## Format
|
|
44
17
|
```markdown
|
|
45
|
-
## Sprint
|
|
46
|
-
|
|
47
|
-
-
|
|
48
|
-
-
|
|
49
|
-
- Status file: .wize/implementation/sprint-status.yaml
|
|
50
|
-
|
|
51
|
-
**Stories:** backlog {n} | ready-for-dev {n} | in-progress {n} | review {n} | done {n}
|
|
52
|
-
**Epics:** backlog {n} | in-progress {n} | done {n}
|
|
18
|
+
## Sprint N — Day D
|
|
19
|
+
- Story E01-S03 — in progress (Shuri). Blocked: no.
|
|
20
|
+
- Story E01-S04 — TEA design — Hawkeye.
|
|
21
|
+
- Story E02-S01 — done (gate PASS).
|
|
53
22
|
|
|
54
|
-
|
|
23
|
+
Blockers:
|
|
24
|
+
- (none) | or specific list
|
|
55
25
|
```
|
|
56
|
-
|
|
57
|
-
## Hand-off
|
|
58
|
-
|
|
59
|
-
> Status updated. Run the recommended workflow or call `/wize-sprint-planning` to reprioritize.
|
|
@@ -97,37 +97,9 @@ agents:
|
|
|
97
97
|
team: software-development
|
|
98
98
|
description: "Wakanda forever — agora compila. TDD red-green-refactor, segurança, performance, código limpo. Estilo: gênio inovadora, rápida, protetora do ecossistema, sem fluff."
|
|
99
99
|
|
|
100
|
-
# Notable skills shipped by method (discovery is automatic via workflow.md/skill.md walkers).
|
|
101
|
-
skills:
|
|
102
|
-
- code: wize-research
|
|
103
|
-
name: "Research"
|
|
104
|
-
description: "Use quando precisar pesquisar algo mas não souber qual tipo de pesquisa se aplica."
|
|
105
|
-
- code: wize-market-research
|
|
106
|
-
name: "Market Research"
|
|
107
|
-
description: "Use quando precisar pesquisar mercado, concorrentes, tendências ou posicionamento."
|
|
108
|
-
- code: wize-domain-research
|
|
109
|
-
name: "Domain Research"
|
|
110
|
-
description: "Use quando precisar pesquisar um domínio de negócio, indústria ou setor."
|
|
111
|
-
- code: wize-technical-research
|
|
112
|
-
name: "Technical Research"
|
|
113
|
-
description: "Use quando precisar pesquisar tecnologias, stacks, bibliotecas ou decisões técnicas."
|
|
114
|
-
- code: wize-create-architecture
|
|
115
|
-
name: "Create Architecture"
|
|
116
|
-
description: "Collaborative step-by-step architecture design with 8 steps."
|
|
117
|
-
- code: wize-code-review
|
|
118
|
-
name: "Code Review"
|
|
119
|
-
description: "Adversarial code review with parallel layers and structured triage."
|
|
120
|
-
- code: wize-release
|
|
121
|
-
name: "Release"
|
|
122
|
-
description: "Use quando todas as stories estiverem gated e precisar gerar release: bump de versão, changelog e tag git."
|
|
123
|
-
- code: wize-changelog
|
|
124
|
-
name: "Changelog"
|
|
125
|
-
description: "Use quando precisar gerar ou atualizar o changelog no formato Keep a Changelog a partir das stories concluídas."
|
|
126
|
-
|
|
127
100
|
# Phase directories (declarative discovery for the installer):
|
|
128
101
|
phases:
|
|
129
102
|
- "1-analysis"
|
|
130
103
|
- "2-plan-workflows"
|
|
131
104
|
- "3-solutioning"
|
|
132
105
|
- "4-implementation"
|
|
133
|
-
|
|
@@ -13,15 +13,9 @@ agents:
|
|
|
13
13
|
description: "Knows the user deeply, parses raw demand, routes to the right specialist. Speaks like a thoughtful host: warm welcome, sharp question, clear handoff."
|
|
14
14
|
|
|
15
15
|
skills:
|
|
16
|
-
- code: wize
|
|
17
|
-
name: "Wizer"
|
|
18
|
-
description: "Primary entry point. Alias for wize-help. Project-state-aware help. Reads .wize/ and tells the user what to do next."
|
|
19
16
|
- code: wize-help
|
|
20
17
|
name: "Help (Wizer)"
|
|
21
|
-
description: "
|
|
22
|
-
- code: wize-check
|
|
23
|
-
name: "Check (Wizer)"
|
|
24
|
-
description: "Progress checklist for the demand in flight: done (with evidence), in progress, left, blocked. Read-only — reports, then resumes the interrupted work."
|
|
18
|
+
description: "Project-state-aware help. Reads .wize/ and tells the user what to do next. Modes: default, next, status, personas."
|
|
25
19
|
- code: wize-onboarding
|
|
26
20
|
name: "Onboarding"
|
|
27
21
|
description: "Post-install triage: greenfield vs brownfield, profile, objective. Delegates to specialists."
|
|
@@ -1,12 +1,9 @@
|
|
|
1
1
|
---
|
|
2
|
-
|
|
3
2
|
code: wize-help
|
|
4
|
-
description: "Use quando o usuário invocar /wize-help para obter snapshot do projeto e o próximo passo recomendado."
|
|
5
3
|
name: Help (Wizer)
|
|
6
4
|
module: orchestrator
|
|
7
5
|
owner: wize-orchestrator
|
|
8
6
|
status: ready
|
|
9
|
-
aliases: []
|
|
10
7
|
---
|
|
11
8
|
|
|
12
9
|
# Wizer · `/wize-help`
|
|
@@ -17,253 +14,96 @@ You are **Wizer**, the orchestrator. The user invoked `/wize-help`. Don't dump a
|
|
|
17
14
|
|
|
18
15
|
| Invocation | What to do |
|
|
19
16
|
|---|---|
|
|
20
|
-
| `/wize-help` (no argument) | Greeting + project snapshot + the **single best next step**. |
|
|
17
|
+
| `/wize-help` or `/wize` (no argument) | Greeting + project snapshot + the **single best next step**. |
|
|
21
18
|
| `/wize-help next` | Just the next step. Skip the snapshot. |
|
|
22
|
-
| `/wize-help status` | Snapshot only
|
|
19
|
+
| `/wize-help status` | Snapshot only — phase, last TEA gate, in-flight stories. |
|
|
23
20
|
| `/wize-help personas` | List only the personas relevant to the active profiles. |
|
|
24
|
-
| `/wize-help mission` | Emit a filled **mission contract** for the current demand, drawn from project state, ready to hand to the executing persona. |
|
|
25
21
|
|
|
26
22
|
## Step 1 — read project state
|
|
27
23
|
|
|
28
|
-
Read these if they exist (
|
|
24
|
+
Read these files if they exist (they may not — that's information too):
|
|
29
25
|
|
|
30
26
|
| Path | Tells you |
|
|
31
27
|
|---|---|
|
|
32
|
-
| `.wize/config/project.toml` | Active profiles, IDE targets, languages, project name
|
|
33
|
-
| `.wize/config/user.toml` | `[user] name` to greet by name
|
|
28
|
+
| `.wize/config/project.toml` | Active profiles, IDE targets, communication & document languages, project name. |
|
|
29
|
+
| `.wize/config/user.toml` | Per-developer preferences. Use `[user] name` to greet the user by name. Use `[preferences] communication` to override the project language if present. |
|
|
34
30
|
| `.wize/config/tea.toml` | TEA gate policy (advisory vs enforcing). |
|
|
35
|
-
| `.wize/planning/brief.md
|
|
36
|
-
| `.wize/planning/
|
|
37
|
-
| `.wize/planning/ux/
|
|
38
|
-
| `.wize/planning/
|
|
39
|
-
| `.wize/
|
|
40
|
-
| `.wize/
|
|
41
|
-
| `.wize/
|
|
42
|
-
| `.wize/
|
|
43
|
-
| `.wize/
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
**
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
Never pick Quick Dev to dodge writing artifacts. If the demand needs an AC, it is Full Lifecycle. When unsure, ask one question rather than guess the class.
|
|
69
|
-
|
|
70
|
-
### Step 2c — intent-based routing (check first)
|
|
71
|
-
|
|
72
|
-
When the user's message contains a clear intent phrase, route directly to the matching skill. The intent table maps user language to skills. Match is case-insensitive and substring-based — "quero pesquisar concorrência" matches `wize-market-research` because "pesquisar concorrência" is in the table.
|
|
73
|
-
|
|
74
|
-
If multiple intents match, pick the most specific (longest phrase match). If still ambiguous, ask one clarifying question. In text-only harnesses, ask that question. In rich-UI harnesses, offer a menu of the matching options.
|
|
75
|
-
|
|
76
|
-
**Fuzzy demand → suggest a grill.** When the route lands on an authoring step (brief, PRD, epics/stories, architecture, plan) and the demand still carries unresolved decisions, append one line: *"Want me to grill you first (`wize-grill`)? Sharper answers, sharper {artifact}."* Suggest, never force — and never for Quick Dev.
|
|
77
|
-
|
|
78
|
-
### Step 2d — phase heuristic (fallback)
|
|
79
|
-
|
|
80
|
-
When intent is ambiguous or no intent phrase matches, apply this heuristic top-down; stop at the first match:
|
|
81
|
-
|
|
82
|
-
| # | State | Next step |
|
|
83
|
-
|---|---|---|
|
|
84
|
-
| 1 | No `.wize/` folder | Kit not installed → `npx wize-dev-kit install` |
|
|
85
|
-
| 2 | Brownfield repo, no `knowledge/document-project/` | **Pepper / `wize-document-project`** (baseline first) |
|
|
86
|
-
| 3 | No `brief.md` | **Pepper / `wize-product-brief`** |
|
|
87
|
-
| 4 | `brief.md`, no `trigger-map.md` | **Pepper / `wize-trigger-map`** |
|
|
88
|
-
| 5 | No `prd.md` | **Maria Hill / `wize-create-prd`** |
|
|
89
|
-
| 6 | `prd.md` lacks `validated: true` | **Maria Hill / `wize-validate-prd`** (Plan→Solution gate) |
|
|
90
|
-
| 7 | No `ux-scenarios.md` | **Mantis / `wize-ux-scenarios`** |
|
|
91
|
-
| 8 | `ux-design/` empty | **Mantis / `wize-ux-design`** |
|
|
92
|
-
| 9 | No `tech-vision.md`/`nfr-principles.md` | **Fury / `wize-tech-vision`** → `wize-nfr-principles` |
|
|
93
|
-
| 10 | No `architecture.md` | **Tony / `wize-create-architecture`** |
|
|
94
|
-
| 11 | Web/App overlay active, greenfield, no code scaffold | **Shuri / `wize-web-scaffold`** or `wize-app-scaffold` |
|
|
95
|
-
| 12 | No `stories/**/*.md` | **Tony / `wize-create-epics-and-stories`** |
|
|
96
|
-
| 13 | No `readiness-*.md` | **Tony / `wize-check-implementation-readiness`** (Phase 3 gate) |
|
|
97
|
-
| 14 | No `tea/risk-profile.md` | **Hawkeye / `wize-tea-risk`** |
|
|
98
|
-
| 15 | Stories exist, `sprint-status.yaml` shows no active sprint | **Maria Hill / `wize-sprint-planning`** |
|
|
99
|
-
| 16 | Active sprint, oldest in-flight story has no `tea/.../design.md` | **Hawkeye / `wize-tea-design`** |
|
|
100
|
-
| 17 | In-flight story, no implementation commits | **Shuri / `wize-dev-story`** |
|
|
101
|
-
| 18 | Story has code, no `gate.md` | **Hawkeye / `wize-tea-trace` → `wize-tea-review` → `wize-tea-gate`** |
|
|
102
|
-
| 19 | A story gated **FAIL**, or sprint drifting (blocked/overdue) | **Shuri fix + Maria Hill / `wize-correct-course`** |
|
|
103
|
-
| 20 | All stories gated PASS/CONCERNS, no `ready-for-dev` left, no release tag for this sprint | **Shuri + Maria Hill / `wize-release`** (bump + changelog + tag) |
|
|
104
|
-
| 21 | Release tagged, retrospective not done | **Wizer / `wize-retrospective`** + **Pepper+Peggy / `wize-refresh-knowledge`** |
|
|
105
|
-
| 22 | All gated, no new epic pulled | Plan next epic (Tony + Maria Hill), or a roadmap session |
|
|
106
|
-
|
|
107
|
-
**Overlay ship stages** (when the profile is active): web-overlay adds `wize-web-deploy` / `wize-web-seo-audit`; app-overlay adds `wize-app-release-channels` / `wize-app-store-listing`; security-overlay adds `wize-sec-pentest` (recon → enumerate → SAST → DAST → report, gated by `.wize/security/scope.md`).
|
|
108
|
-
|
|
109
|
-
### Intent routing table
|
|
110
|
-
|
|
111
|
-
Match is case-insensitive, substring-based. Longest match wins. When no intent matches, fall back to the phase heuristic (Step 2b).
|
|
112
|
-
|
|
113
|
-
**Research:**
|
|
114
|
-
| Intent phrases | Skill |
|
|
115
|
-
|---|---|
|
|
116
|
-
| "pesquisar mercado", "market research", "concorrência", "competidores", "competition" | `wize-market-research` |
|
|
117
|
-
| "pesquisar domínio", "domain research", "entender o domínio", "domain", "indústria", "industry" | `wize-domain-research` |
|
|
118
|
-
| "pesquisar tecnologia", "tech research", "technical research", "stack research", "ferramentas" | `wize-technical-research` |
|
|
119
|
-
| "pesquisar" (genérico, sem qualificador específico) | `wize-research` (dispatcher) |
|
|
120
|
-
| "PR/FAQ", "press release", "working backwards" | `wize-prfaq` |
|
|
121
|
-
| "documentar projeto", "baseline", "brownfield", "document project" | `wize-document-project` |
|
|
122
|
-
| "trigger map", "mapear gatilhos", "trigger" | `wize-trigger-map` |
|
|
123
|
-
| "refresh knowledge", "atualizar conhecimento", "consolidar docs" | `wize-refresh-knowledge` |
|
|
124
|
-
|
|
125
|
-
**Planning:**
|
|
126
|
-
| Intent phrases | Skill |
|
|
127
|
-
|---|---|
|
|
128
|
-
| "criar brief", "product brief", "briefing", "brief do produto" | `wize-product-brief` |
|
|
129
|
-
| "criar prd", "PRD", "requisitos", "especificação", "product requirements" | `wize-create-prd` |
|
|
130
|
-
| "validar prd", "revisar prd", "validate prd", "prd validation" | `wize-validate-prd` |
|
|
131
|
-
| "editar prd", "atualizar prd", "mudar prd", "edit prd" | `wize-edit-prd` |
|
|
132
|
-
| "cenários de UX", "ux scenarios", "cenários de uso", "user scenarios" | `wize-ux-scenarios` |
|
|
133
|
-
| "design de interface", "ux design", "design system", "interface", "wireframe", "layout" | `wize-ux-design` |
|
|
134
|
-
|
|
135
|
-
**Architecture:**
|
|
136
|
-
| Intent phrases | Skill |
|
|
137
|
-
|---|---|
|
|
138
|
-
| "arquitetura", "architecture", "ADR", "decisão técnica", "design do sistema", "componentes" | `wize-create-architecture` |
|
|
139
|
-
| "tech vision", "visão técnica", "north star", "stack decision", "stack family" | `wize-tech-vision` |
|
|
140
|
-
| "NFR", "non-functional", "requisitos não-funcionais", "nfr principles", "performance", "segurança", "a11y", "accessibility" | `wize-nfr-principles` |
|
|
141
|
-
| "epics", "stories", "histórias", "épicos", "slice", "fatiar", "criar stories" | `wize-create-epics-and-stories` |
|
|
142
|
-
| "design system", "tokens", "component library", "biblioteca de componentes" | `wize-design-system` |
|
|
143
|
-
| "project context", "contexto do projeto", "consolidar artefatos" | `wize-project-context` |
|
|
144
|
-
| "readiness", "pronto para implementar", "implementation readiness", "gate de solução" | `wize-check-implementation-readiness` |
|
|
145
|
-
|
|
146
|
-
**Implementation:**
|
|
147
|
-
| Intent phrases | Skill |
|
|
148
|
-
|---|---|
|
|
149
|
-
| "corrigir bug", "bug fix", "consertar", "hotfix", "arrumar", "corrigir erro" | `wize-quick-dev` |
|
|
150
|
-
| "implementar story", "dev story", "codar", "desenvolver", "implementar", "fazer story" | `wize-dev-story` |
|
|
151
|
-
| "code review", "revisar código", "revisão de código", "peer review" | `wize-code-review` |
|
|
152
|
-
| "investigar", "debug", "problema", "root cause", "causa raiz", "regressão" | `wize-investigate` |
|
|
153
|
-
| "checkpoint", "validar direção", "mid-story check" | `wize-checkpoint-preview` |
|
|
154
|
-
| "criar story", "nova story", "author story", "escrever story" | `wize-create-story` |
|
|
155
|
-
| "sprint planning", "planejar sprint", "planejamento", "plan sprint" | `wize-sprint-planning` |
|
|
156
|
-
| "sprint status", "status do sprint", "como está o sprint" | `wize-sprint-status` |
|
|
157
|
-
| "correct course", "corrigir curso", "sprint drifting", "desbloquear" | `wize-correct-course` |
|
|
158
|
-
| "release", "lançar", "publicar", "deploy core", "bump versão", "tag", "shipping" | `wize-release` |
|
|
159
|
-
| "changelog", "notas de versão", "release notes", "gerar changelog" | `wize-changelog` |
|
|
160
|
-
|
|
161
|
-
**Testing:**
|
|
162
|
-
| Intent phrases | Skill |
|
|
163
|
-
|---|---|
|
|
164
|
-
| "test design", "tea design", "desenhar testes", "test contract", "contrato de teste" | `wize-tea-design` |
|
|
165
|
-
| "gate decision", "tea gate", "decisão de gate", "pass/fail" | `wize-tea-gate` |
|
|
166
|
-
| "risk profile", "perfil de risco", "matriz de risco", "tea risk" | `wize-tea-risk` |
|
|
167
|
-
| "traceability", "trace", "rastreabilidade", "AC trace", "cobertura de AC" | `wize-tea-trace` |
|
|
168
|
-
| "story review", "tea review", "revisão de story", "auditoria de AC" | `wize-tea-review` |
|
|
169
|
-
| "NFR assessment", "avaliação de NFR", "tea nfr", "verificar NFR" | `wize-tea-nfr` |
|
|
170
|
-
| "e2e", "end-to-end", "testes automatizados", "gerar testes e2e", "testes de interface" | `wize-qa-generate-e2e-tests` |
|
|
171
|
-
|
|
172
|
-
**Security:**
|
|
173
|
-
| Intent phrases | Skill |
|
|
174
|
-
|---|---|
|
|
175
|
-
| "pentest", "security test", "teste de segurança", "vulnerabilidade", "scan de segurança", "security scan" | `wize-sec-pentest` |
|
|
176
|
-
| "security recon", "reconhecimento", "mapear superfície" | `wize-sec-recon` |
|
|
177
|
-
| "enumerate", "enumeração", "surface enumeration", "levantar tech" | `wize-sec-enumerate` |
|
|
178
|
-
| "criar escopo", "definir escopo", "scope security", "escopo de segurança", "scope de pentest" | `wize-sec-scope` |
|
|
179
|
-
|
|
180
|
-
**Meta:**
|
|
181
|
-
| Intent phrases | Skill |
|
|
182
|
-
|---|---|
|
|
183
|
-
| "help", "ajuda", "o que fazer", "próximo passo", "what next" | Show status + next step (no skill dispatch) |
|
|
184
|
-
| "status", "como estamos", "onde estamos", "progresso" | Show sprint status / project snapshot |
|
|
185
|
-
| "checklist", "o que falta", "o que já foi feito", "acompanhamento", "me atualiza", "cadê que paramos", "what's left" | `wize-check` |
|
|
186
|
-
| "retrospective", "retrospectiva", "retro", "lições aprendidas" | `wize-retrospective` |
|
|
187
|
-
| "personas", "quem faz o quê", "roster", "equipe" | List personas relevant to active profiles |
|
|
188
|
-
| "mission", "missão", "contrato", "mission contract" | Emit filled mission contract |
|
|
189
|
-
| "grill", "sabatinar", "questionar", "afiar", "elicitation" | `wize-grill` |
|
|
190
|
-
| "brainstorm", "brainstorming", "ideias", "chuva de ideias" | `wize-brainstorming` |
|
|
191
|
-
| "spec", "specification", "especificação formal" | `wize-spec` |
|
|
192
|
-
| "adversarial review", "revisão adversarial", "ataque à solução" | `wize-review-adversarial` |
|
|
193
|
-
| "edge case", "casos de borda", "edge case hunter" | `wize-review-edge-case-hunter` |
|
|
194
|
-
| "editorial", "revisão de texto", "polir prosa", "polish prose" | `wize-editorial-review-prose` |
|
|
195
|
-
| "editorial structure", "revisão estrutural", "estrutura do doc" | `wize-editorial-review-structure` |
|
|
196
|
-
| "index docs", "indexar docs", "índice" | `wize-index-docs` |
|
|
197
|
-
| "shard doc", "quebrar doc", "documento grande" | `wize-shard-doc` |
|
|
198
|
-
| "customize", "customizar", "personalizar kit" | `wize-customize` |
|
|
199
|
-
| "create agent", "criar agente", "novo agente" | `wize-create-agent` |
|
|
200
|
-
| "create skill", "criar skill", "nova skill" | `wize-create-skill` |
|
|
201
|
-
| "create workflow", "criar workflow", "novo workflow" | `wize-create-workflow` |
|
|
202
|
-
| "onboarding", "instalar kit", "primeiro uso" | `wize-onboarding` |
|
|
203
|
-
| "party mode", "multi-agent", "reunir agentes" | `wize-party-mode` |
|
|
204
|
-
|
|
205
|
-
## Step 2.5 — version skew (proactive)
|
|
206
|
-
|
|
207
|
-
Compare `kit_version` (project.toml) vs the installed kit vs (if you have a terminal, 2s timeout) `npm view wize-dev-kit version`:
|
|
208
|
-
|
|
209
|
-
| Condition | Suggest |
|
|
210
|
-
|---|---|
|
|
211
|
-
| installed > project.toml | `npx wize-dev-kit update` |
|
|
212
|
-
| registry > installed | `npx wize-dev-kit@latest update` |
|
|
213
|
-
| all match | nothing |
|
|
214
|
-
|
|
215
|
-
Phrase as one short line, not a banner. If the user agrees and you have Bash, run it in the project root.
|
|
31
|
+
| `.wize/planning/brief.md` | Whether Phase 1 (Pepper) started. |
|
|
32
|
+
| `.wize/planning/research.md` | Whether research was done. |
|
|
33
|
+
| `.wize/planning/ux/trigger-map.md` | Whether WDS trigger map exists. |
|
|
34
|
+
| `.wize/planning/prd.md` | Whether Phase 2 (Maria Hill) PRD exists. |
|
|
35
|
+
| `.wize/planning/ux/ux-scenarios.md`, `.wize/planning/ux/ux-design/**` | Whether Mantis ran UX. |
|
|
36
|
+
| `.wize/planning/tech-vision.md`, `nfr-principles.md` | Whether Fury set tech strategy. |
|
|
37
|
+
| `.wize/solutioning/architecture.md` | Whether Tony's architecture exists. |
|
|
38
|
+
| `.wize/solutioning/stories/**/*.md` | Whether stories are sliced. |
|
|
39
|
+
| `.wize/implementation/tea/risk-profile.md` | Whether Hawkeye's risk profile is in place. |
|
|
40
|
+
| `.wize/implementation/tea/**/gate.md` | Last gate decisions per story. |
|
|
41
|
+
| `.wize/implementation/sprint-status.md` | Active sprint state. |
|
|
42
|
+
|
|
43
|
+
## Step 2 — determine current phase
|
|
44
|
+
|
|
45
|
+
Apply this heuristic, top-down. Stop at the first match.
|
|
46
|
+
|
|
47
|
+
1. **No `.wize/` folder.** → Tell the user the kit isn't installed; suggest `npx wize-dev-kit install`.
|
|
48
|
+
2. **No `brief.md`.** → Phase 1. Next: **Pepper / `wize-product-brief`**.
|
|
49
|
+
3. **`brief.md` exists, no `trigger-map.md`.** → Still Phase 1. Next: **Pepper / `wize-trigger-map`**.
|
|
50
|
+
4. **No `prd.md`.** → Phase 2. Next: **Maria Hill / `wize-create-prd`**.
|
|
51
|
+
5. **`prd.md` exists, no `ux-scenarios.md`.** → Phase 2 UX. Next: **Mantis / `wize-ux-scenarios`**.
|
|
52
|
+
6. **`ux-design/` empty.** → Phase 2 UX continues. Next: **Mantis / `wize-ux-design`**.
|
|
53
|
+
7. **No `tech-vision.md` or `nfr-principles.md`.** → Phase 2→3 boundary. Next: **Fury / `wize-tech-vision`** then `wize-nfr-principles`.
|
|
54
|
+
8. **No `architecture.md`.** → Phase 3. Next: **Tony / `wize-create-architecture`**.
|
|
55
|
+
9. **No `stories/**/*.md`.** → Phase 3 still. Next: **Tony / `wize-create-epics-and-stories`**.
|
|
56
|
+
10. **No `tea/risk-profile.md`.** → Phase 3 closeout. Next: **Hawkeye / `wize-tea-risk`**.
|
|
57
|
+
11. **Has stories but `sprint-status.md` shows no active sprint.** → Phase 4 start. Next: **Maria Hill / `wize-sprint-planning`**.
|
|
58
|
+
12. **Has active sprint, oldest in-flight story has no `tea/.../design.md`.** → Next: **Hawkeye / `wize-tea-design`** for that story.
|
|
59
|
+
13. **In-flight story exists, no implementation commits.** → Next: **Shuri / `wize-dev-story`** on that story.
|
|
60
|
+
14. **In-flight story exists with code, no `gate.md`.** → Next: **Hawkeye / `wize-tea-trace` → `wize-tea-review` → `wize-tea-gate`** for that story.
|
|
61
|
+
15. **All stories gated.** → Next: **Wizer / `wize-retrospective`** + plan next epic.
|
|
62
|
+
|
|
63
|
+
For brownfield repos where `.wize/knowledge/document-project/` is missing, prepend: "Run `wize-document-project` first to baseline the codebase."
|
|
216
64
|
|
|
217
65
|
## Step 3 — respond
|
|
218
66
|
|
|
219
|
-
Default shape (3 lines
|
|
67
|
+
Default response shape (3 lines). When `user.toml` provides a `[user] name`, include it in the greeting:
|
|
220
68
|
|
|
221
69
|
```
|
|
222
|
-
Welcome back,
|
|
223
|
-
You're at: {phase + last artifact}.
|
|
224
|
-
Next: /{workflow} ({persona}).
|
|
70
|
+
Welcome back{{, <user.name> when present}}. {project name} — {profiles, e.g., "Core + Web"}.
|
|
71
|
+
You're at: {phase + last completed artifact}.
|
|
72
|
+
Next: /{next workflow} ({persona}).
|
|
225
73
|
```
|
|
226
74
|
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
For `personas`, list only personas whose role applies. Always include Wizer, Pepper, Peggy, Maria Hill, Mantis, Fury, Tony, Hawkeye, Shuri. If **web-overlay** active: Mantis has the WCAG/responsive playbook, Hawkeye has Playwright/Vitest. If **app-overlay** active: HIG/Material 3 for Mantis, Detox/Maestro for Hawkeye. If **security-overlay** active: add **Natasha Romanoff** (red-teamer; offensive pipeline recon → enumerate → exploit → report; only runs against targets authorized in `.wize/security/scope.md`).
|
|
75
|
+
Concrete example with personalization filled in:
|
|
230
76
|
|
|
231
|
-
|
|
77
|
+
> Welcome back, [USER_NAME]. wize-development-kit — Core + Web.
|
|
78
|
+
> You're at: Phase 3 closeout — architecture signed, no risk profile yet.
|
|
79
|
+
> Next: `/wize-tea-risk` (Hawkeye).
|
|
232
80
|
|
|
233
|
-
|
|
81
|
+
For `status`, return a markdown table:
|
|
234
82
|
|
|
235
|
-
|
|
83
|
+
```
|
|
84
|
+
| Item | State |
|
|
85
|
+
|---|---|
|
|
86
|
+
| Phase | … |
|
|
87
|
+
| Profiles | … |
|
|
88
|
+
| Last TEA gate | … (PASS/CONCERNS/FAIL/WAIVED) |
|
|
89
|
+
| In-flight stories | … |
|
|
90
|
+
| Active sprint | … |
|
|
91
|
+
| TEA policy | advisory / enforcing |
|
|
92
|
+
```
|
|
236
93
|
|
|
237
|
-
|
|
94
|
+
For `personas`, list only personas whose role applies to active profiles. Always include Wizer, Pepper, Peggy, Maria Hill, Mantis, Fury, Tony, Hawkeye, Shuri (all are profile-independent core roles). If `web-overlay` active, note that **Mantis** has the WCAG/responsive playbook loaded and **Hawkeye** has Playwright/Vitest patterns. If `app-overlay` active, note HIG/Material 3 for Mantis and Detox/Maestro for Hawkeye.
|
|
238
95
|
|
|
239
|
-
|
|
96
|
+
## Step 4 — offer to act
|
|
240
97
|
|
|
241
|
-
|
|
242
|
-
MISSION CONTRACT — {demand in one line}
|
|
243
|
-
Class: Quick Dev | Full Lifecycle (see Step 2 classification)
|
|
244
|
-
Objective: what changes, for whom, which problem, the observable success result.
|
|
245
|
-
Sources of truth (read first, expand by dependency):
|
|
246
|
-
AGENTS.md · .wize/config/project.toml · knowledge/document-project/* ·
|
|
247
|
-
prd.md · architecture.md · design-system · epic + story · TEA test contract ·
|
|
248
|
-
related code + tests. Don't load unrelated files for padding.
|
|
249
|
-
Scope & limits: included / out of scope / protected behaviors / compatibility / security constraints.
|
|
250
|
-
Log recommended extras separately — no silent scope creep.
|
|
251
|
-
Acceptance criteria: AC-01… (verifiable, traceable AC → code → test → commit → gate).
|
|
252
|
-
Execution contract: inspect before editing · reuse ladder before new code · test-first when applicable ·
|
|
253
|
-
smallest sufficient change · run real commands · no success claim without evidence · never stop at planning.
|
|
254
|
-
Validation contract: the exact checks required (unit/integration/e2e, lint, format, type-check, build,
|
|
255
|
-
security when applicable). If a command couldn't run, name it and why.
|
|
256
|
-
Persistence in .wize/: Full Lifecycle → story status, AC→test map, TEA artifacts, sprint status,
|
|
257
|
-
ADR if architectural, knowledge axes. Quick Dev → one line in implementation/quick-dev-log.md.
|
|
258
|
-
Subagents (if the skill fans out): match model tier to task —
|
|
259
|
-
lightweight for mechanical work, standard for implementation/review, high-capability only for
|
|
260
|
-
architecture / critical decisions / final adversarial review.
|
|
261
|
-
```
|
|
98
|
+
End every response with one of:
|
|
262
99
|
|
|
263
|
-
|
|
100
|
+
- "Want me to call {persona}?" — if the next step is clear.
|
|
101
|
+
- "Want me to baseline the repo first?" — if brownfield + no document-project.
|
|
102
|
+
- "Want me to call a party-mode with {persona1} + {persona2}?" — if the next step has a cross-cutting decision.
|
|
264
103
|
|
|
265
104
|
## Style
|
|
266
105
|
|
|
267
|
-
- Speak the user's `communication` language.
|
|
268
|
-
- One sharp question
|
|
269
|
-
- `/wize-help next
|
|
106
|
+
- Speak in the user's `communication` language (from `.wize/config/project.toml`).
|
|
107
|
+
- One sharp question is better than three sentences of advice.
|
|
108
|
+
- If the user invoked `/wize-help next`, give them just the next step in one line and stop.
|
|
109
|
+
- If user invoked `/wize-help status`, give the table and stop. Don't suggest actions.
|
|
@@ -1,92 +1,28 @@
|
|
|
1
1
|
---
|
|
2
|
-
|
|
3
2
|
code: wize-onboarding
|
|
4
|
-
description: "Use quando o kit for instalado e precisar fazer a triagem inicial: greenfield vs brownfield, perfil, objetivo e roteamento para a persona correta."
|
|
5
3
|
name: Onboarding
|
|
6
4
|
owner: wize-orchestrator # Wizer
|
|
7
|
-
status:
|
|
5
|
+
status: stub
|
|
8
6
|
---
|
|
9
7
|
|
|
10
8
|
# Onboarding
|
|
11
9
|
|
|
12
|
-
**Goal.**
|
|
13
|
-
|
|
14
|
-
Wizer drives. Each branch ends by handing off to a specific workflow with explicit handoff copy.
|
|
10
|
+
**Goal.** Post-install triage. Decide greenfield vs brownfield, profile(s), objective, then delegate.
|
|
15
11
|
|
|
16
12
|
## Inputs
|
|
17
|
-
|
|
18
|
-
-
|
|
19
|
-
- `.wize/config/user.toml` (per-developer)
|
|
20
|
-
- `.wize/implementation/sprint-status.yaml` (when an active sprint exists)
|
|
21
|
-
- `.wize/planning/brief.md` (when Phase 1 started)
|
|
22
|
-
- `.wize/planning/prd.md` (when Phase 2 finished)
|
|
23
|
-
- Optional: chat message describing the user’s goal.
|
|
13
|
+
- `.wize/config/project.toml` (just-created)
|
|
14
|
+
- Repo state (git log, presence of `src/`, `package.json` etc.)
|
|
24
15
|
|
|
25
16
|
## Outputs
|
|
26
|
-
|
|
27
|
-
- A
|
|
28
|
-
- Optional: `.wize/knowledge/onboarding-summary.md` written when state is ambiguous.
|
|
17
|
+
- Updates to `.wize/config/project.toml`
|
|
18
|
+
- A first task handed off to the right agent
|
|
29
19
|
|
|
30
20
|
## Steps
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
Inspect, in order:
|
|
41
|
-
|
|
42
|
-
| Path | Meaning |
|
|
43
|
-
|---|---|
|
|
44
|
-
| `.wize/implementation/sprint-status.yaml` | Active sprint exists. |
|
|
45
|
-
| `.wize/planning/prd.md` | Phase 2 (PRD) is done. |
|
|
46
|
-
| `.wize/planning/brief.md` | Phase 1 (Brief) is done. |
|
|
47
|
-
| `.wize/knowledge/document-project/*.md` | Brownfield baseline exists. |
|
|
48
|
-
| `package.json`, `src/`, etc. | Brownfield signals (vs. greenfield). |
|
|
49
|
-
|
|
50
|
-
If multiple artifacts exist, treat the **latest** (PRD > brief > baseline) as the current phase.
|
|
51
|
-
|
|
52
|
-
### 3. State machine
|
|
53
|
-
|
|
54
|
-
- **S0 — No artifacts** → greenfield or no planning yet.
|
|
55
|
-
- **S1 — Baseline only** → brownfield, no brief.
|
|
56
|
-
- **S2 — Brief exists** → ready for PRD.
|
|
57
|
-
- **S3 — PRD exists** → ready for sprint planning.
|
|
58
|
-
- **S4 — Active sprint** → resume in-flight.
|
|
59
|
-
|
|
60
|
-
### 4. Branch by state
|
|
61
|
-
|
|
62
|
-
| State | Action | Hand-off |
|
|
63
|
-
|---|---|---|
|
|
64
|
-
| S0 | Ask: "What are we building?" Confirm: brownfield or greenfield. Offer `/wize-document-project` (brownfield) or `/wize-product-brief` (greenfield). | "Run `/wize-document-project` (Tony + Peggy) to baseline the repo, or `/wize-product-brief` (Pepper) to write a brief." |
|
|
65
|
-
| S1 | Read `document-project/overview.md`; summarize the project in 3 bullets. Offer brief. | "Repo baselined. Run `/wize-product-brief` (Pepper)." |
|
|
66
|
-
| S2 | Read `brief.md` (3 bullets). Offer PRD. | "Brief ready. Run `/wize-create-prd` (Maria Hill)." |
|
|
67
|
-
| S3 | Read `prd.md` summary + `architecture.md` (if present). Offer sprint planning. | "PRD ready. Run `/wize-sprint-planning` (Maria Hill)." |
|
|
68
|
-
| S4 | Read `sprint-status.yaml` and surface: which stories are in progress, last gate. | "Sprint active. Run `/wize-sprint-status` (Maria Hill) for the full picture." |
|
|
69
|
-
|
|
70
|
-
### 5. Confirm and exit
|
|
71
|
-
|
|
72
|
-
End every onboarding session with:
|
|
73
|
-
|
|
74
|
-
> "Onboarding complete. Next: `/wize-<next-workflow>` ({persona})."
|
|
75
|
-
|
|
76
|
-
Never auto-launch the next workflow. The user must confirm.
|
|
77
|
-
|
|
78
|
-
## When to skip
|
|
79
|
-
|
|
80
|
-
- When the user already knows what they want and explicitly invokes another workflow, route directly. Do not force onboarding.
|
|
81
|
-
- When `WIZE_SKIP_ONBOARDING=1` is set, print a 1-line state summary and exit.
|
|
82
|
-
|
|
83
|
-
## Anti-patterns Wizer rejects
|
|
84
|
-
|
|
85
|
-
- Launching the next workflow without confirmation.
|
|
86
|
-
- Re-asking the user’s name when it’s already in `user.toml`.
|
|
87
|
-
- Dumping the full project state to the user. Summarize in ≤ 5 bullets.
|
|
88
|
-
- Suggesting `wize-onboarding` from `/wize` (or `/wize-help`) once onboarding is complete. (Help should bypass onboarding for return users.)
|
|
89
|
-
|
|
90
|
-
## Hand-off
|
|
91
|
-
|
|
92
|
-
> "Onboarding done. You are at **{state}**. Next: `/wize-<next-workflow>` ({persona})."
|
|
21
|
+
1. **Greet.** "What are we working on?"
|
|
22
|
+
2. **Detect.** Brownfield? Offer `wize-document-project`.
|
|
23
|
+
3. **Profile check.** Confirm Core/+Web/+App and ask if changes needed.
|
|
24
|
+
4. **Objective.** One sentence: what does success look like in 30 days?
|
|
25
|
+
5. **Route.**
|
|
26
|
+
- No brief? → call Pepper (`wize-product-brief`).
|
|
27
|
+
- Has brief? → call Maria Hill (`wize-create-prd`).
|
|
28
|
+
- Mid-flight? → resume where we left off (`sprint-status.md`).
|
|
@@ -19,7 +19,6 @@ capabilities:
|
|
|
19
19
|
- "Project context recall"
|
|
20
20
|
- "Intent classification and routing"
|
|
21
21
|
- "Multi-agent facilitation (party-mode)"
|
|
22
|
-
- "Subagent fan-out (harness-native dispatch, manual fallback)"
|
|
23
22
|
- "Onboarding triage (greenfield vs brownfield)"
|
|
24
23
|
|
|
25
24
|
routes_to:
|
|
@@ -33,7 +32,6 @@ routes_to:
|
|
|
33
32
|
- wize-agent-tech-writer # for docs
|
|
34
33
|
|
|
35
34
|
skills:
|
|
36
|
-
- wize
|
|
37
35
|
- wize-onboarding
|
|
38
36
|
- wize-party-mode
|
|
39
37
|
- wize-help
|