@polymorphism-tech/morph-spec 4.9.0 → 4.10.1

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 (164) hide show
  1. package/README.md +2 -2
  2. package/bin/morph-spec.js +30 -0
  3. package/bin/task-manager.js +34 -22
  4. package/claude-plugin.json +1 -1
  5. package/docs/CHEATSHEET.md +1 -1
  6. package/docs/QUICKSTART.md +1 -1
  7. package/framework/CLAUDE.md +35 -98
  8. package/framework/agents/backend/api-designer.md +3 -0
  9. package/framework/agents/backend/dotnet-senior.md +3 -0
  10. package/framework/agents/backend/ef-modeler.md +2 -0
  11. package/framework/agents/backend/hangfire-orchestrator.md +2 -0
  12. package/framework/agents/backend/ms-agent-expert.md +2 -0
  13. package/framework/agents/frontend/blazor-builder.md +2 -0
  14. package/framework/agents/frontend/nextjs-expert.md +2 -0
  15. package/framework/agents/infrastructure/azure-architect.md +2 -0
  16. package/framework/agents/infrastructure/azure-deploy-specialist.md +2 -0
  17. package/framework/agents/infrastructure/bicep-architect.md +2 -0
  18. package/framework/agents/infrastructure/container-specialist.md +2 -0
  19. package/framework/agents/infrastructure/devops-engineer.md +3 -0
  20. package/framework/agents/infrastructure/infra-architect.md +3 -0
  21. package/framework/agents/integrations/asaas-financial.md +2 -0
  22. package/framework/agents/integrations/azure-identity.md +2 -0
  23. package/framework/agents/integrations/clerk-auth.md +3 -0
  24. package/framework/agents/integrations/hangfire-integration.md +2 -0
  25. package/framework/agents/integrations/resend-email.md +2 -0
  26. package/framework/agents.json +37 -7
  27. package/framework/commands/commit.md +166 -0
  28. package/framework/commands/morph-apply.md +156 -155
  29. package/framework/commands/morph-archive.md +33 -27
  30. package/framework/commands/morph-infra.md +83 -77
  31. package/framework/commands/morph-preflight.md +97 -55
  32. package/framework/commands/morph-proposal.md +131 -58
  33. package/framework/commands/morph-status.md +36 -30
  34. package/framework/commands/morph-troubleshoot.md +68 -59
  35. package/framework/hooks/claude-code/notification/approval-reminder.js +3 -2
  36. package/framework/hooks/claude-code/post-tool-use/dispatch.js +154 -31
  37. package/framework/hooks/claude-code/post-tool-use/skill-reminder.js +7 -84
  38. package/framework/hooks/claude-code/post-tool-use/validator-feedback.js +8 -17
  39. package/framework/hooks/claude-code/pre-compact/save-morph-context.js +16 -3
  40. package/framework/hooks/claude-code/pre-tool-use/enforce-phase-writes.js +4 -3
  41. package/framework/hooks/claude-code/pre-tool-use/protect-spec-files.js +3 -2
  42. package/framework/hooks/claude-code/pre-tool-use/task-tracking-guard.js +60 -0
  43. package/framework/hooks/claude-code/session-start/inject-morph-context.js +55 -2
  44. package/framework/hooks/claude-code/session-start/post-compact-restore.js +41 -0
  45. package/framework/hooks/claude-code/stop/validate-completion.js +2 -15
  46. package/framework/hooks/claude-code/user-prompt/enrich-prompt.js +23 -5
  47. package/framework/hooks/shared/compact-restore.js +100 -0
  48. package/framework/hooks/shared/dispatch-helpers.js +116 -0
  49. package/framework/hooks/shared/phase-utils.js +9 -5
  50. package/framework/hooks/shared/state-reader.js +27 -3
  51. package/framework/phases.json +30 -7
  52. package/framework/rules/csharp-standards.md +3 -0
  53. package/framework/rules/frontend-standards.md +2 -0
  54. package/framework/rules/infrastructure-standards.md +3 -0
  55. package/framework/rules/morph-workflow.md +143 -86
  56. package/framework/rules/nextjs-standards.md +2 -0
  57. package/framework/rules/testing-standards.md +3 -0
  58. package/framework/skills/level-0-meta/mcp-registry.json +86 -51
  59. package/framework/skills/level-0-meta/morph-brainstorming/SKILL.md +139 -0
  60. package/framework/skills/level-0-meta/morph-checklist/SKILL.md +42 -19
  61. package/framework/skills/level-0-meta/{code-review → morph-code-review}/SKILL.md +8 -5
  62. package/framework/skills/level-0-meta/{code-review-nextjs → morph-code-review-nextjs}/SKILL.md +8 -6
  63. package/framework/skills/level-0-meta/morph-frontend-review/SKILL.md +362 -0
  64. package/framework/skills/level-0-meta/morph-init/SKILL.md +114 -20
  65. package/framework/skills/level-0-meta/morph-post-implementation/SKILL.md +362 -0
  66. package/framework/skills/level-0-meta/morph-replicate/SKILL.md +95 -87
  67. package/framework/skills/level-0-meta/{simulation-checklist → morph-simulation-checklist}/SKILL.md +24 -0
  68. package/framework/skills/level-0-meta/{tool-usage-guide → morph-tool-usage-guide}/SKILL.md +43 -43
  69. package/framework/skills/level-0-meta/{tool-usage-guide → morph-tool-usage-guide}/references/tools-per-phase.md +1 -2
  70. package/framework/skills/level-0-meta/{verification-before-completion → morph-verification-before-completion}/SKILL.md +23 -12
  71. package/framework/skills/level-0-meta/{verification-before-completion → morph-verification-before-completion}/scripts/check-phase-outputs.mjs +2 -2
  72. package/framework/skills/level-1-workflows/morph-phase-clarify/SKILL.md +247 -0
  73. package/framework/skills/level-1-workflows/morph-phase-codebase-analysis/SKILL.md +270 -0
  74. package/framework/skills/level-1-workflows/morph-phase-design/SKILL.md +499 -0
  75. package/framework/skills/level-1-workflows/morph-phase-implement/.morph/logs/activity.json +38 -0
  76. package/framework/skills/level-1-workflows/morph-phase-implement/SKILL.md +472 -0
  77. package/framework/skills/level-1-workflows/morph-phase-implement/prompts/code-quality-reviewer-prompt.md +50 -0
  78. package/framework/skills/level-1-workflows/morph-phase-implement/prompts/implementer-prompt.md +45 -0
  79. package/framework/skills/level-1-workflows/morph-phase-implement/prompts/spec-reviewer-prompt.md +47 -0
  80. package/framework/skills/level-1-workflows/morph-phase-plan/SKILL.md +246 -0
  81. package/framework/skills/level-1-workflows/morph-phase-setup/SKILL.md +238 -0
  82. package/framework/skills/level-1-workflows/morph-phase-tasks/.morph/logs/activity.json +14 -0
  83. package/framework/skills/level-1-workflows/morph-phase-tasks/SKILL.md +312 -0
  84. package/framework/skills/level-1-workflows/{phase-tasks → morph-phase-tasks}/scripts/validate-tasks.mjs +3 -3
  85. package/framework/skills/level-1-workflows/morph-phase-uiux/SKILL.md +324 -0
  86. package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md +146 -0
  87. package/framework/standards/integration/mcp/mcp-tools.md +25 -7
  88. package/framework/templates/docs/onboarding.md +2 -2
  89. package/package.json +3 -4
  90. package/src/commands/agents/dispatch-agents.js +50 -3
  91. package/src/commands/mcp/mcp-setup.js +39 -2
  92. package/src/commands/phase/phase-reset.js +74 -0
  93. package/src/commands/project/doctor.js +26 -7
  94. package/src/commands/project/update.js +4 -4
  95. package/src/commands/scope/escalate.js +215 -0
  96. package/src/commands/state/advance-phase.js +27 -53
  97. package/src/commands/state/state.js +1 -1
  98. package/src/commands/task/expand.js +100 -0
  99. package/src/core/paths/output-schema.js +4 -3
  100. package/src/core/state/phase-state-machine.js +7 -4
  101. package/src/core/state/state-manager.js +4 -3
  102. package/src/lib/detectors/claude-config-detector.js +93 -347
  103. package/src/lib/detectors/design-system-detector.js +189 -189
  104. package/src/lib/detectors/index.js +155 -57
  105. package/src/lib/generators/context-generator.js +2 -2
  106. package/src/lib/installers/mcp-installer.js +37 -5
  107. package/src/lib/phase-chain/phase-validator.js +22 -16
  108. package/src/lib/scope/impact-analyzer.js +106 -0
  109. package/src/lib/stack-filter.js +58 -0
  110. package/src/lib/tasks/task-parser.js +1 -1
  111. package/src/lib/validators/shared/emit-validator-dispatch.js +64 -0
  112. package/src/scripts/setup-infra.js +68 -18
  113. package/src/utils/agents-installer.js +51 -17
  114. package/src/utils/claude-md-injector.js +90 -0
  115. package/src/utils/file-copier.js +0 -1
  116. package/src/utils/hooks-installer.js +16 -5
  117. package/src/utils/skills-installer.js +67 -7
  118. package/CLAUDE.md +0 -98
  119. package/framework/memory/patterns-learned.md +0 -766
  120. package/framework/skills/level-0-meta/brainstorming/SKILL.md +0 -137
  121. package/framework/skills/level-0-meta/frontend-review/SKILL.md +0 -359
  122. package/framework/skills/level-0-meta/post-implementation/SKILL.md +0 -362
  123. package/framework/skills/level-0-meta/terminal-title/SKILL.md +0 -61
  124. package/framework/skills/level-0-meta/terminal-title/scripts/set_title.sh +0 -65
  125. package/framework/skills/level-1-workflows/phase-clarify/SKILL.md +0 -216
  126. package/framework/skills/level-1-workflows/phase-codebase-analysis/SKILL.md +0 -252
  127. package/framework/skills/level-1-workflows/phase-design/SKILL.md +0 -383
  128. package/framework/skills/level-1-workflows/phase-implement/SKILL.md +0 -492
  129. package/framework/skills/level-1-workflows/phase-setup/SKILL.md +0 -195
  130. package/framework/skills/level-1-workflows/phase-tasks/SKILL.md +0 -271
  131. package/framework/skills/level-1-workflows/phase-uiux/SKILL.md +0 -286
  132. package/src/commands/project/index.js +0 -8
  133. package/src/core/index.js +0 -10
  134. package/src/core/state/index.js +0 -8
  135. package/src/core/templates/index.js +0 -9
  136. package/src/core/templates/template-data-sources.js +0 -325
  137. package/src/core/workflows/index.js +0 -7
  138. package/src/lib/detectors/config-detector.js +0 -223
  139. package/src/lib/detectors/standards-generator.js +0 -335
  140. package/src/lib/detectors/structure-detector.js +0 -275
  141. package/src/lib/monitor/agent-resolver.js +0 -144
  142. package/src/lib/monitor/renderer.js +0 -230
  143. package/src/lib/orchestration/index.js +0 -7
  144. package/src/lib/orchestration/team-orchestrator.js +0 -404
  145. package/src/sanitizer/context-sanitizer.js +0 -221
  146. package/src/sanitizer/patterns.js +0 -163
  147. package/src/writer/file-writer.js +0 -86
  148. /package/framework/skills/level-0-meta/{brainstorming → morph-brainstorming}/references/proposal-example.md +0 -0
  149. /package/framework/skills/level-0-meta/{code-review → morph-code-review}/references/review-example.md +0 -0
  150. /package/framework/skills/level-0-meta/{code-review → morph-code-review}/references/review-guidelines.md +0 -0
  151. /package/framework/skills/level-0-meta/{code-review → morph-code-review}/scripts/scan-csharp.mjs +0 -0
  152. /package/framework/skills/level-0-meta/{code-review-nextjs → morph-code-review-nextjs}/references/review-example-nextjs.md +0 -0
  153. /package/framework/skills/level-0-meta/{code-review-nextjs → morph-code-review-nextjs}/scripts/scan-nextjs.mjs +0 -0
  154. /package/framework/skills/level-0-meta/{frontend-review → morph-frontend-review}/scripts/scan-accessibility.mjs +0 -0
  155. /package/framework/skills/level-0-meta/{post-implementation → morph-post-implementation}/scripts/detect-dev-server.mjs +0 -0
  156. /package/framework/skills/level-0-meta/{post-implementation → morph-post-implementation}/scripts/detect-stack.mjs +0 -0
  157. /package/framework/skills/level-1-workflows/{phase-clarify → morph-phase-clarify}/references/clarifications-example.md +0 -0
  158. /package/framework/skills/level-1-workflows/{phase-design → morph-phase-design}/references/architecture-analysis-guide.md +0 -0
  159. /package/framework/skills/level-1-workflows/{phase-design → morph-phase-design}/references/spec-authoring-guide.md +0 -0
  160. /package/framework/skills/level-1-workflows/{phase-design → morph-phase-design}/references/spec-example.md +0 -0
  161. /package/framework/skills/level-1-workflows/{phase-implement → morph-phase-implement}/references/recap-example.md +0 -0
  162. /package/framework/skills/level-1-workflows/{phase-implement → morph-phase-implement}/references/vsa-implementation-guide.md +0 -0
  163. /package/framework/skills/level-1-workflows/{phase-tasks → morph-phase-tasks}/references/task-planning-patterns.md +0 -0
  164. /package/framework/skills/level-1-workflows/{phase-tasks → morph-phase-tasks}/references/tasks-example.md +0 -0
@@ -1,271 +0,0 @@
1
- ---
2
- name: morph:phase-tasks
3
- description: MORPH-SPEC Phase 4 (Tasks). Breaks approved spec into bottom-up ordered implementation tasks (T001...TXXX) with dependencies, checkpoints every 3 tasks, and effort estimates, producing tasks.md. Use after design and clarification phases to create a structured implementation plan before coding starts.
4
- argument-hint: "[feature-name]"
5
- disable-model-invocation: true
6
- user-invocable: false
7
- allowed-tools: Read, Write, Edit, Bash, Glob, Grep
8
- cliVersion: "4.9.0"
9
- ---
10
-
11
- # MORPH Tasks - FASE 4
12
-
13
- > INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
14
-
15
- Quebre a especificação em tasks executáveis, defina ordem de execução e estabeleça checkpoints.
16
-
17
- ## Pré-requisitos
18
-
19
- - [ ] FASE 3 (Clarify) concluída
20
- - [ ] `spec.md` atualizado com clarificações
21
- - [ ] Todos os edge cases documentados
22
-
23
- ## Ferramentas Recomendadas
24
-
25
- > **Ref:** `framework/skills/level-0-meta/tool-usage-guide/SKILL.md` para guia completo.
26
- > **Ref:** `framework/standards/integration/mcp/mcp-tools.md` para referência MCP.
27
- > **Example:** `references/tasks-example.md` — filled-in tasks.md showing expected granularity and format.
28
- > **Script:** `scripts/validate-tasks.mjs` — validates tasks.md structure, T### IDs, and required fields.
29
-
30
- | Ação | Ferramenta | Alternativa |
31
- |------|------------|-------------|
32
- | Ler spec + contracts + decisions | **Read** todos os outputs | — |
33
- | Analisar complexidade de implementação | **Grep** padrões no código existente | — |
34
- | Contar padrões similares existentes | **Glob** `**/Services/**/*.cs` | — |
35
- | Consultar padrões de implementação | **Context7 MCP** `query_docs()` | **WebSearch** |
36
- | Criar issues no GitHub a partir das tasks | **GitHub MCP** `create_issue()` | **Bash** `gh issue create ...` |
37
- | Renderizar template de tasks | **Bash** `npx morph-spec template render docs/tasks ...` | — |
38
- | Atualizar state com total de tasks | **Bash** `npx morph-spec state set ... tasks.total N` | — |
39
-
40
- **MCPs desta fase:** Context7 (estimar complexidade), GitHub (criar issues).
41
-
42
- **Anti-padrões:**
43
- - ❌ Task agent para quebrar spec simples de 1 domínio (faça diretamente)
44
- - ✅ Task agent para specs multi-domínio (backend + frontend + infra = 3 planners em paralelo)
45
- - ✅ Task agent quando spec tem 20+ requisitos em múltiplos bounded contexts
46
- - ❌ Criar tasks.json sem ler todos os outputs primeiro
47
- - ❌ **(VSA)** Criar tasks separadas para Handler, Validator e Endpoint — um slice = uma task
48
- - ❌ **(VSA)** Usar categorias DDD (`domain`, `application`, `infrastructure`) em projetos VSA
49
- - ❌ **(VSA)** Criar task de "Implementar Service layer" — não existe em VSA
50
-
51
- ---
52
-
53
- ## ✅ PRÉ-VOO OBRIGATÓRIO (antes de iniciar breakdown de tasks)
54
-
55
- ### 1. Ler todos os prerequisitos em PARALELO
56
-
57
- ```
58
- # Uma única chamada, não sequencial:
59
- Read: .morph/features/{feature}/1-design/spec.md
60
- + Read: .morph/features/{feature}/1-design/contracts.cs
61
- + Read: .morph/features/{feature}/1-design/decisions.md
62
- + Read: .morph/features/{feature}/1-design/schema-analysis.md (se existir)
63
- + Read: .morph/config/config.json (→ architecture.style)
64
- ```
65
-
66
- ### 2. Criar tasks de sessão para visibilidade
67
-
68
- ```
69
- TaskCreate: "Analisar spec e definir tasks" → activeForm: "Analisando spec"
70
- TaskCreate: "Gerar tasks.md" → activeForm: "Gerando tasks.md"
71
- TaskCreate: "Avanço de fase" → activeForm: "Avançando fase"
72
- ```
73
-
74
- > **Nota:** As tasks individuais T001-T00N serão criadas como native tasks durante a fase de implementação (`phase-implement`). Aqui mantemos apenas as 3 tasks de alto nível desta sessão de planejamento.
75
-
76
- ---
77
-
78
- ## Workflow
79
-
80
- ### CHECKPOINT DE ENTRADA: Verificar Pré-requisitos
81
-
82
- **⏸️ PAUSE - Antes de iniciar o breakdown de tasks:**
83
-
84
- - [ ] `spec.md` existe e foi aprovado pelo usuário?
85
- - [ ] `contracts.cs` existe e corresponde ao schema real?
86
- - [ ] `schema-analysis.md` foi validado (se aplicável)?
87
- - [ ] `decisions.md` contém ADRs para todas as escolhas críticas?
88
- - [ ] Design gate (`morph-spec approve $ARGUMENTS design`) foi aprovado?
89
- - [ ] Clarificações (FASE 3) foram resolvidas e spec atualizado?
90
-
91
- **❌ Se alguma checkbox NÃO estiver marcada:**
92
- → Voltar para a fase correspondente e resolver
93
-
94
- **✅ Se TODAS as checkboxes estiverem marcadas:**
95
- → Prosseguir para análise e breakdown
96
-
97
- ```bash
98
- # Verificar estado atual:
99
- npx morph-spec state get $ARGUMENTS
100
- # Verificar se design foi aprovado:
101
- npx morph-spec approval-status $ARGUMENTS
102
- ```
103
-
104
- ---
105
-
106
- ### Passo 0: Detectar Estilo de Arquitetura
107
-
108
- Antes de tudo, determine se o projeto é VSA ou DDD:
109
-
110
- ```bash
111
- cat .morph/config/config.json | grep -A3 '"architecture"'
112
- ```
113
-
114
- **Se `config.architecture.style === "vertical-slice"`** → siga o **Passo 0.5 (VSA)** e pule o Passo 0 DDD.
115
- **Caso contrário** → siga o **Passo 0.6 (DDD)** abaixo.
116
-
117
- ---
118
-
119
- ### Passo 0.5: Plano de Tasks — VSA
120
-
121
- > Para padrões de tarefas VSA e mapeamento DDD por nível, veja `references/task-planning-patterns.md`
122
-
123
- Leia a seção `## Architecture Style: Vertical Slice` do spec.md para o **VSA Blueprint**:
124
-
125
- ```bash
126
- grep -A30 "## Architecture Style" ".morph/features/$ARGUMENTS/1-design/spec.md"
127
- ```
128
-
129
- Crie uma task por slice (entity → errors → tags → migration → slices CRUD → slices custom → tests). Cada slice = Handler + Validator + Endpoint numa única task. `GetAll` não tem Validator.
130
-
131
- **Após definir tasks VSA, pule direto para o Passo 3 (Dependências).**
132
-
133
- ---
134
-
135
- ### Passo 0.6: Ler Nível de Domínio — DDD
136
-
137
- Leia a seção `## Domain Complexity` do spec.md:
138
-
139
- ```bash
140
- grep -A15 "## Domain Complexity" ".morph/features/$ARGUMENTS/1-design/spec.md"
141
- ```
142
-
143
- > Se a seção não existir, assuma **Nível 1 (CRUD)**.
144
-
145
- Use o nível para restringir categorias (Nível 1: domain→infra→application→presentation→tests; Nível 2: adiciona AggregateRoot, ValueObjects, DomainEvents, CQRS handlers; Nível 3: adiciona BC setup, Integration Events). Ver `references/task-planning-patterns.md` para tabela completa.
146
-
147
- ---
148
-
149
- ### Passo 1: Analisar Spec
150
-
151
- > **VSA:** Se veio do Passo 0.5, o breakdown de tasks já foi definido — use os exemplos gerados como base e pule para o Passo 3 (Dependências).
152
-
153
- Leia `.morph/features/$ARGUMENTS/1-design/spec.md` e identifique:
154
-
155
- 1. **Requisitos funcionais** (FR001, FR002, ...)
156
- 2. **Componentes técnicos** (Entities, Services/Slices, Controllers/Endpoints, Pages)
157
- 3. **Infraestrutura** (Bicep, migrations, configs)
158
- 4. **Testes** (Unit tests, integration tests)
159
-
160
- ### Passo 2: Quebrar em Tasks
161
-
162
- > Para estrutura JSON, categorias e ordem de implementação, veja `references/task-planning-patterns.md`
163
-
164
- Crie tasks no formato **T{NNN}** seguindo bottom-up: domain → infrastructure → application → presentation → tests → infra → docs.
165
-
166
- ### Passo 3: Definir Dependências
167
-
168
- Para cada task, especifique dependências:
169
-
170
- ```json
171
- {
172
- "id": "T005",
173
- "title": "Criar {Nome}Service",
174
- "dependencies": ["T001", "T002"],
175
- "status": "pending"
176
- }
177
- ```
178
-
179
- **Regra:** Task só pode ser executada quando todas as dependências estão `completed`.
180
-
181
- ### Passo 4: Estabelecer Checkpoints
182
-
183
- Defina checkpoints a cada **3 tasks** ou **marcos significativos**:
184
-
185
- ```json
186
- {
187
- "id": "CHECKPOINT_001",
188
- "title": "Domain Layer Completo",
189
- "afterTasks": ["T001", "T002", "T003"],
190
- "validations": [
191
- "Todas as entities criadas",
192
- "Migrations aplicadas",
193
- "Testes de domain passando"
194
- ]
195
- }
196
- ```
197
-
198
- ### Passo 5: Estimar Esforço
199
-
200
- Para cada task, estime tempo em minutos:
201
-
202
- | Complexidade | Tempo Estimado |
203
- |--------------|----------------|
204
- | Trivial (CRUD básico) | 15-30 min |
205
- | Simples (Service, Controller) | 30-60 min |
206
- | Média (Business logic, validações) | 60-120 min |
207
- | Complexa (Integrações, AI) | 120-240 min |
208
-
209
- ### Passo 6: Gerar `tasks.md`
210
-
211
- Crie `.morph/features/$ARGUMENTS/3-tasks/tasks.md` com a estrutura completa de tasks, checkpoints e estimativas.
212
-
213
- ### Passo 7: Incluir Tasks de IaC (se necessário)
214
-
215
- Se houver recursos Azure, adicionar tasks de Bicep e migrations.
216
-
217
- ### Passo 8: Atualizar State
218
-
219
- ```bash
220
- npx morph-spec state set $ARGUMENTS tasks.total {N}
221
- npx morph-spec state mark-output $ARGUMENTS tasks
222
- ```
223
-
224
- ## Outputs Gerados
225
-
226
- - `.morph/features/$ARGUMENTS/3-tasks/tasks.md` - Breakdown completo de tasks
227
-
228
- ## PAUSA OBRIGATÓRIA
229
-
230
- Apresente ao usuário 3 ações sugeridas:
231
-
232
- 1. **Aprovar breakdown e iniciar implementação**
233
- 2. **Repriorizar tasks** - Mudar ordem de execução
234
- 3. **Adicionar/remover tasks** - Ajustar escopo
235
-
236
- ## Critérios de Avanço
237
-
238
- - [x] `tasks.json` criado com todas as tasks
239
- - [x] Tasks categorizadas corretamente
240
- - [x] Dependências mapeadas
241
- - [x] Checkpoints definidos (a cada 3 tasks)
242
- - [x] Esforço estimado por task
243
- - [x] Ordem de execução clara
244
- - [x] Tasks de IaC incluídas (se aplicável)
245
- - [x] State atualizado com total de tasks
246
- - [x] Usuário aprovou breakdown
247
-
248
- ---
249
-
250
- ## Integração com Superpowers
251
-
252
- > Disponível quando o plugin `superpowers` está instalado.
253
-
254
- | Skill | Quando Usar | Invocação |
255
- |-------|-------------|-----------|
256
- | `writing-plans` | Após breakdown de tasks, para planejar sequência de implementação | `Skill(superpowers:writing-plans)` |
257
- | `executing-plans` | Para executar o plano de tasks em sessão separada | `Skill(superpowers:executing-plans)` |
258
-
259
- ---
260
-
261
- ## Outputs desta Fase
262
-
263
- <!-- morph:outputs:tasks -->
264
- | Output | Caminho |
265
- |--------|---------|
266
- | `tasks` | `.morph/features/{feature}/3-tasks/tasks.md` |
267
- <!-- /morph:outputs -->
268
-
269
- ---
270
-
271
- Após aprovação: "Planejamento completo! Execute `/morph-apply $ARGUMENTS` para iniciar implementação."
@@ -1,286 +0,0 @@
1
- ---
2
- name: morph:phase-uiux
3
- description: MORPH-SPEC Phase 1.5 (UI/UX). Creates design-system.md, mockups.md, components.md, and flows.md using Figma/Playwright/Context7 MCPs. Use after setup for features with frontend UI components, pages, dashboards, forms, wizards, or visual interactions requiring design documentation.
4
- argument-hint: "[feature-name]"
5
- user-invocable: false
6
- allowed-tools: Read, Write, Edit, Bash, Glob, Grep
7
- cliVersion: "4.9.0"
8
- ---
9
-
10
- # MORPH UI/UX Design - FASE 1.5
11
-
12
- > INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
13
-
14
- Fase condicional para features com front-end. Coleta requisitos de UI/UX, gera wireframes, specs de componentes e fluxos de usuário.
15
-
16
- ## Pré-requisitos
17
-
18
- - [ ] FASE 1 (Setup) concluída
19
- - [ ] Feature tem keywords de UI detectadas (blazor, ui, component, page, dashboard, wizard, form, chart)
20
- - [ ] `uiux-designer` agent ativado
21
-
22
- ## Ferramentas Recomendadas
23
-
24
- > **Ref:** `framework/skills/level-0-meta/tool-usage-guide/SKILL.md` para guia completo.
25
- > **Ref:** `framework/standards/integration/mcp/mcp-tools.md` para referência MCP.
26
-
27
- | Ação | Ferramenta | Alternativa |
28
- |------|------------|-------------|
29
- | Verificar design system existente | **Read** `.morph/context/design-system.md` | — |
30
- | Ler screenshots do usuário | **Read** (arquivo de imagem) | — |
31
- | Buscar variáveis CSS existentes | **Grep** `--root:` em `*.css,*.scss` | — |
32
- | Encontrar componentes existentes | **Glob** `**/Components/**/*.razor` ou `**/components/**/*.tsx` | — |
33
- | Extrair design tokens do Figma | **Figma MCP** `get_file({ fileKey })` | Read CSS/SCSS variables |
34
- | Documentação de componentes UI | **Context7 MCP** `query_docs({ libraryId, query })` | **WebSearch** + **WebFetch** |
35
- | Preview de página existente | **Playwright MCP** `browser_navigate()` + `browser_take_screenshot()` | **WebFetch** URL |
36
- | Inspecionar estrutura da página | **Playwright MCP** `browser_snapshot()` | **WebFetch** + parse manual |
37
- | Testar layout responsivo | **Playwright MCP** `browser_resize()` + `browser_take_screenshot()` | Manual testing |
38
- | Referências de design externas | **WebSearch** + **WebFetch** | — |
39
- | Renderizar templates UI | **Bash** `npx morph-spec template render docs/ui-mockups ...` | — |
40
- | Gerar design system de CSS existente | **Bash** `npx morph-spec generate design-system --scan` | — |
41
- | Atualizar state | **Bash** `npx morph-spec state mark-output ...` | — |
42
-
43
- **MCPs desta fase:** Figma (design tokens), Playwright (preview, inspeção, responsividade), Context7 (docs de componentes).
44
-
45
- **Anti-padrões:**
46
- - ❌ WebSearch para docs MudBlazor (use Context7 MCP — mais preciso)
47
- - ❌ Task agent para ler um screenshot (use Read direto na imagem)
48
- - ❌ Adivinhar props de componentes (use Context7 para API real)
49
-
50
- ---
51
-
52
- ## Workflow
53
-
54
- ### Passo 0: Verificar Design System Existe
55
-
56
- **CRITICAL:** Antes de iniciar a FASE UI/UX, verifique se um design system existe:
57
-
58
- ```
59
- Read: .morph/context/design-system.md
60
- ```
61
-
62
- Se o arquivo não existir (design system não encontrado):
63
-
64
- 1. **Opção A - Scaffold automático:**
65
- - O sistema criará automaticamente um design system ao avançar para implementação
66
- - Você pode gerar manualmente agora: `npx morph-spec generate design-system`
67
-
68
- 2. **Opção B - Criar manualmente:**
69
- - Crie `.morph/context/design-system.md` (project-level, compartilhado)
70
- - Ou `.morph/features/$ARGUMENTS/2-ui/design-system.md` (feature-specific)
71
-
72
- 3. **Opção C - Scan existing CSS:**
73
- - Se o projeto já tem CSS com variáveis: `npx morph-spec generate design-system --scan`
74
-
75
- **⚠️ IMPORTANTE:**
76
- - Design system é **obrigatório** para features UI
77
- - Gate automático bloqueará implementação (FASE 5) se design system não existir
78
- - Melhor criar agora para garantir consistência visual
79
-
80
- ### Passo 1: Detectar Se Fase É Necessária
81
-
82
- Verifique se agentes ativos incluem `uiux-designer`:
83
-
84
- ```bash
85
- npx morph-spec state get $ARGUMENTS
86
- ```
87
-
88
- Se `uiux-designer` NÃO estiver nos `activeAgents`, pule esta fase e continue para FASE 2 (Design).
89
-
90
- ### Passo 1.5: Design Thinking — Direção Estética
91
-
92
- > **Ref:** `framework/standards/frontend/design-system/aesthetic-direction.md`
93
-
94
- **ANTES de coletar requisitos técnicos**, definir a direção visual com 4 perguntas:
95
-
96
- 1. **Purpose**: Que problema resolve? Quem usa? Qual o contexto profissional?
97
- 2. **Tone**: Qual direção? (Minimal Refined / Editorial / Soft Professional / Industrial / Modern Luxury)
98
- 3. **Differentiation**: Qual o 1 elemento memorável desta interface?
99
- 4. **Constraints**: Framework, performance budget, brand guidelines existentes
100
-
101
- **CRITICAL:** Commitar à direção ANTES das specs técnicas. Documentar em `ui-design-system.md`
102
- na seção `## Aesthetic Direction` (template disponível no standard acima).
103
-
104
- **Anti-padrões a evitar:**
105
- - ❌ Gradiente roxo em fundo branco (AI cliché)
106
- - ❌ Inter/Roboto como fonte de display
107
- - ❌ Grid 3-colunas de cards sem diferencial visual
108
- - ❌ Paleta de 5 cores de peso igual (sem dominant + accent)
109
-
110
- ### Passo 2: Coletar Input do Usuário
111
-
112
- **SEMPRE perguntar ao usuário PRIMEIRO:**
113
-
114
- 1. **Layout e estilo**:
115
- - Você tem alguma ideia de layout em mente?
116
- - Tem alguma referência visual? (sites, apps, screenshots)
117
- - Como imagina o fluxo do usuário?
118
-
119
- 2. **Componentes e interações**:
120
- - Quais os principais componentes desta tela/página?
121
- - Quais estados precisam ser considerados? (loading, error, empty, success)
122
-
123
- 3. **Imagens de referência**:
124
- - Tem imagens de exemplo que eu possa analisar?
125
- - Se SIM: use Read tool para ler screenshots e extrair padrões
126
-
127
- ### Passo 3: Decidir Biblioteca UI
128
-
129
- Escolha entre **Fluent UI Blazor** (recomendado para AI-first) ou **MudBlazor** (componentes complexos):
130
-
131
- **Critérios:**
132
- - Fluent UI: Para dashboards, forms simples, AI components, Microsoft design language
133
- - MudBlazor: Para data grids avançadas, charts complexos, material design
134
-
135
- **Documente a decisão em `decisions.md`.**
136
-
137
- ### Passo 4: Gerar Deliverables
138
-
139
- Crie os seguintes arquivos em `.morph/features/$ARGUMENTS/`:
140
-
141
- > **Use templates:** Utilize `npx morph-spec template render` para gerar os arquivos a partir dos templates em `.morph/framework/templates/docs/`. Templates disponíveis: `ui-design-system`, `ui-mockups`, `ui-components`, `ui-flows`.
142
-
143
- #### 4.1. `ui-design-system.md`
144
-
145
- **Se design system project-level existe (`.morph/context/design-system.md`):**
146
- - Referencie-o nos specs: "Uses project design system at .morph/context/design-system.md"
147
- - Crie `ui-design-system.md` apenas se houver cores/componentes **específicos** da feature
148
-
149
- **Se não existe:**
150
- - Crie design system feature-level completo com:
151
- - **Seção `## Aesthetic Direction`** (usar template de `aesthetic-direction.md`):
152
- direção, font pair, color philosophy, motion intent, composition approach
153
- - Paleta de cores (primary, secondary, accent, semantic)
154
- - Tipografia (heading scales, body text, code)
155
- - Spacing e layout (grid, margins, paddings)
156
- - Componentes base (buttons, inputs, cards)
157
-
158
- #### 4.2. `ui-mockups.md`
159
-
160
- Wireframes ASCII + descrições:
161
- - Layout geral de cada tela/página
162
- - Posicionamento de componentes
163
- - Responsividade (desktop, tablet, mobile)
164
- - Estados (loading, error, empty, success)
165
-
166
- #### 4.3. `ui-components.md`
167
-
168
- Specs técnicas de componentes Fluent UI/MudBlazor:
169
- - Componente a usar (FluentButton, MudDataGrid, etc.)
170
- - Props e configurações
171
- - Eventos e bindings
172
- - Validações e estados
173
-
174
- #### 4.4. `ui-flows.md`
175
-
176
- Fluxos de usuário completos:
177
- - User stories
178
- - Diagramas de fluxo (texto/ASCII)
179
- - Edge cases (o que acontece se...?)
180
- - Validações e feedback
181
-
182
- ### CHECKPOINT: Validar Deliverables UI
183
-
184
- **⏸️ PAUSE - Antes de prosseguir para acessibilidade:**
185
-
186
- - [ ] Direção estética definida e documentada em `ui-design-system.md`?
187
- - [ ] Font pair especificado (não apenas Inter/Roboto para display)?
188
- - [ ] Color philosophy: dominant + accent + rationale documentados?
189
- - [ ] Design system definido (project-level ou feature-level)?
190
- - [ ] Wireframes cobrem todos os estados (loading, error, empty, success)?
191
- - [ ] Componentes especificados com props reais da biblioteca UI escolhida?
192
- - [ ] Fluxos de usuário completos com edge cases?
193
- - [ ] Biblioteca UI escolhida documentada como ADR em `decisions.md`?
194
-
195
- **❌ Se alguma checkbox NÃO estiver marcada:**
196
- → Voltar e completar o deliverable faltante
197
-
198
- **✅ Se TODAS as checkboxes estiverem marcadas:**
199
- → Prosseguir para validação de acessibilidade
200
-
201
- ---
202
-
203
- ### Passo 5: Validar Acessibilidade e Responsividade
204
-
205
- Documente nos arquivos UI:
206
- - **WCAG 2.1 Level AA** compliance
207
- - Contraste de cores adequado
208
- - Labels acessíveis para screen readers
209
- - Navegação por teclado
210
- - **Responsive breakpoints**
211
- - Desktop (>1200px)
212
- - Tablet (768px - 1199px)
213
- - Mobile (<768px)
214
-
215
- ### Passo 6: Atualizar State
216
-
217
- ```bash
218
- npx morph-spec state mark-output $ARGUMENTS ui-design-system
219
- npx morph-spec state mark-output $ARGUMENTS ui-mockups
220
- npx morph-spec state mark-output $ARGUMENTS ui-components
221
- npx morph-spec state mark-output $ARGUMENTS ui-flows
222
- ```
223
-
224
- > **Nota sobre formatos:** Os comandos `mark-output` aceitam TANTO kebab-case (`ui-design-system`)
225
- > QUANTO camelCase (`uiDesignSystem`). Ambos os formatos funcionam igualmente! Use o que for mais
226
- > confortável para você. Exemplos:
227
- > - `npx morph-spec state mark-output my-feature uiDesignSystem` ✅
228
- > - `npx morph-spec state mark-output my-feature ui-design-system` ✅
229
-
230
- ## Outputs Gerados
231
-
232
- - `.morph/features/$ARGUMENTS/2-ui/design-system.md`
233
- - `.morph/features/$ARGUMENTS/2-ui/mockups.md`
234
- - `.morph/features/$ARGUMENTS/2-ui/components.md`
235
- - `.morph/features/$ARGUMENTS/2-ui/flows.md`
236
- - `.morph/features/$ARGUMENTS/1-design/decisions.md` (atualizado com ADR UI library)
237
-
238
- ### Passo 7: Validar Design com Frontend Review
239
-
240
- Após gerar todos os 4 outputs de UI e atualizar o state (Passo 6):
241
-
242
- ```bash
243
- /frontend-review $ARGUMENTS
244
- ```
245
-
246
- O skill valida: contraste WCAG dos tokens, existência de todos os outputs, acessibilidade
247
- estática no design, e gera screenshots dos mockups se dev server disponível.
248
-
249
- **🚫 Se o frontend-review bloquear**, corrija os issues antes de apresentar ao usuário.
250
-
251
- ---
252
-
253
- ## PAUSA OBRIGATÓRIA
254
-
255
- Apresente ao usuário 3 ações sugeridas:
256
-
257
- 1. **Aprovar UI/UX e prosseguir para design técnico**
258
- 2. **Ajustar wireframes/componentes de telas específicas**
259
- 3. **Revisar biblioteca UI escolhida (Fluent UI / MudBlazor)**
260
-
261
- ## Critérios de Avanço
262
-
263
- - [x] Input do usuário coletado (layout, referências)
264
- - [x] Biblioteca UI escolhida e justificada (ADR)
265
- - [x] 4 deliverables criados (design-system, mockups, components, flows)
266
- - [x] Acessibilidade WCAG 2.1 documentada
267
- - [x] Responsividade especificada
268
- - [x] State atualizado
269
- - [x] Usuário aprovou UI/UX
270
-
271
- ---
272
-
273
- ## Outputs desta Fase
274
-
275
- <!-- morph:outputs:uiux -->
276
- | Output | Caminho |
277
- |--------|---------|
278
- | `uiDesignSystem` | `.morph/features/{feature}/2-ui/design-system.md` |
279
- | `uiMockups` | `.morph/features/{feature}/2-ui/mockups.md` |
280
- | `uiComponents` | `.morph/features/{feature}/2-ui/components.md` |
281
- | `uiFlows` | `.morph/features/{feature}/2-ui/flows.md` |
282
- <!-- /morph:outputs -->
283
-
284
- ---
285
-
286
- Continuar automaticamente para FASE 2 (Design) após aprovação.
@@ -1,8 +0,0 @@
1
- /**
2
- * Project-Level Commands
3
- */
4
- export { initCommand } from './init.js';
5
- export { doctorCommand } from './doctor.js';
6
- export { updateCommand } from './update.js';
7
- export { tutorialCommand } from './tutorial.js';
8
- export { monitorCommand } from './monitor.js';
package/src/core/index.js DELETED
@@ -1,10 +0,0 @@
1
- /**
2
- * Core Framework Logic
3
- *
4
- * Central hub for state management, templates, and workflows.
5
- * Separated from shared libraries (lib/) for clear architectural boundaries.
6
- */
7
-
8
- export * from './state/index.js';
9
- export * from './templates/index.js';
10
- export * from './workflows/index.js';
@@ -1,8 +0,0 @@
1
- /**
2
- * Core State Management
3
- *
4
- * State management and phase state machine for MORPH-SPEC workflow.
5
- */
6
-
7
- export { StateManager } from './state-manager.js';
8
- export { PhaseStateMachine, PHASES, validatePhase } from './phase-state-machine.js';
@@ -1,9 +0,0 @@
1
- /**
2
- * Core Template System
3
- *
4
- * Template registry, rendering, and data sources for code generation.
5
- */
6
-
7
- export { TemplateRegistry } from './template-registry.js';
8
- export { TemplateRenderer } from './template-renderer.js';
9
- export { TemplateDataSources } from './template-data-sources.js';