@polymorphism-tech/morph-spec 2.3.0 → 3.0.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 (166) hide show
  1. package/CLAUDE.md +446 -1730
  2. package/README.md +515 -516
  3. package/bin/morph-spec.js +366 -294
  4. package/bin/task-manager.js +429 -368
  5. package/bin/validate.js +369 -268
  6. package/content/.claude/commands/morph-apply.md +221 -158
  7. package/content/.claude/commands/morph-deploy.md +529 -0
  8. package/content/.claude/commands/morph-preflight.md +227 -0
  9. package/content/.claude/commands/morph-proposal.md +122 -101
  10. package/content/.claude/commands/morph-status.md +86 -86
  11. package/content/.claude/commands/morph-troubleshoot.md +122 -0
  12. package/content/.claude/skills/infra/azure-deploy-specialist.md +699 -0
  13. package/content/.claude/skills/level-0-meta/README.md +7 -0
  14. package/content/.claude/skills/level-0-meta/code-review.md +226 -0
  15. package/content/.claude/skills/level-0-meta/morph-checklist.md +117 -0
  16. package/content/.claude/skills/level-0-meta/simulation-checklist.md +77 -0
  17. package/content/.claude/skills/level-1-workflows/README.md +7 -0
  18. package/content/.claude/skills/level-1-workflows/morph-replicate.md +213 -0
  19. package/content/.claude/{commands/morph-clarify.md → skills/level-1-workflows/phase-clarify.md} +131 -184
  20. package/content/.claude/{commands/morph-design.md → skills/level-1-workflows/phase-design.md} +213 -275
  21. package/content/.claude/skills/level-1-workflows/phase-setup.md +106 -0
  22. package/content/.claude/skills/level-1-workflows/phase-tasks.md +164 -0
  23. package/content/.claude/{commands/morph-uiux.md → skills/level-1-workflows/phase-uiux.md} +169 -211
  24. package/content/.claude/skills/level-2-domains/README.md +14 -0
  25. package/content/.claude/skills/level-2-domains/ai-agents/ai-system-architect.md +192 -0
  26. package/content/.claude/skills/{specialists → level-2-domains/architecture}/po-pm-advisor.md +197 -197
  27. package/content/.claude/skills/level-2-domains/architecture/standards-architect.md +156 -0
  28. package/content/.claude/skills/level-2-domains/backend/dotnet-senior.md +287 -0
  29. package/content/.claude/skills/level-2-domains/backend/ef-modeler.md +113 -0
  30. package/content/.claude/skills/level-2-domains/backend/hangfire-orchestrator.md +126 -0
  31. package/content/.claude/skills/level-2-domains/backend/ms-agent-expert.md +109 -0
  32. package/content/.claude/skills/level-2-domains/frontend/blazor-builder.md +210 -0
  33. package/content/.claude/skills/level-2-domains/frontend/nextjs-expert.md +154 -0
  34. package/content/.claude/skills/level-2-domains/frontend/ui-ux-designer.md +191 -0
  35. package/content/.claude/skills/{specialists → level-2-domains/infrastructure}/azure-architect.md +142 -142
  36. package/content/.claude/skills/level-2-domains/infrastructure/bicep-architect.md +126 -0
  37. package/content/.claude/skills/level-2-domains/infrastructure/container-specialist.md +131 -0
  38. package/content/.claude/skills/level-2-domains/infrastructure/devops-engineer.md +119 -0
  39. package/content/.claude/skills/level-2-domains/integrations/asaas-financial.md +130 -0
  40. package/content/.claude/skills/level-2-domains/integrations/azure-identity.md +142 -0
  41. package/content/.claude/skills/level-2-domains/integrations/clerk-auth.md +108 -0
  42. package/content/.claude/skills/level-2-domains/integrations/resend-email.md +119 -0
  43. package/content/.claude/skills/level-2-domains/quality/code-analyzer.md +235 -0
  44. package/content/.claude/skills/level-2-domains/quality/testing-specialist.md +126 -0
  45. package/content/.claude/skills/level-3-technologies/README.md +7 -0
  46. package/content/.claude/skills/level-4-patterns/README.md +7 -0
  47. package/content/.claude/skills/specialists/prompt-engineer.md +189 -0
  48. package/content/.claude/skills/specialists/seo-growth-hacker.md +320 -0
  49. package/content/.morph/config/agents.json +762 -242
  50. package/content/.morph/config/config.template.json +122 -108
  51. package/content/.morph/docs/workflows/design-impl.md +37 -0
  52. package/content/.morph/docs/workflows/enforcement-pipeline.md +668 -0
  53. package/content/.morph/docs/workflows/fast-track.md +29 -0
  54. package/content/.morph/docs/workflows/full-morph.md +76 -0
  55. package/content/.morph/docs/workflows/standard.md +44 -0
  56. package/content/.morph/docs/workflows/ui-refresh.md +39 -0
  57. package/content/.morph/examples/scheduled-reports/decisions.md +158 -0
  58. package/content/.morph/examples/scheduled-reports/proposal.md +95 -0
  59. package/content/.morph/examples/scheduled-reports/spec.md +267 -0
  60. package/content/.morph/hooks/README.md +348 -239
  61. package/content/.morph/hooks/pre-commit-agents.sh +24 -24
  62. package/content/.morph/hooks/task-completed.js +73 -0
  63. package/content/.morph/hooks/teammate-idle.js +68 -0
  64. package/content/.morph/schemas/tasks.schema.json +220 -0
  65. package/content/.morph/standards/agent-framework-blazor-ui.md +359 -0
  66. package/content/.morph/standards/agent-framework-production.md +410 -0
  67. package/content/.morph/standards/agent-framework-setup.md +413 -453
  68. package/content/.morph/standards/agent-framework-workflows.md +349 -0
  69. package/content/.morph/standards/agent-teams-workflow.md +474 -0
  70. package/content/.morph/standards/architecture.md +325 -325
  71. package/content/.morph/standards/azure.md +605 -379
  72. package/content/.morph/standards/dotnet10-migration.md +520 -494
  73. package/content/.morph/templates/CONTEXT-FEATURE.md +276 -0
  74. package/content/.morph/templates/CONTEXT.md +170 -0
  75. package/content/.morph/templates/agent.cs +163 -172
  76. package/content/.morph/templates/clarify-questions.md +159 -0
  77. package/content/.morph/templates/contracts/Commands.cs +74 -0
  78. package/content/.morph/templates/contracts/Entities.cs +25 -0
  79. package/content/.morph/templates/contracts/Queries.cs +74 -0
  80. package/content/.morph/templates/contracts/README.md +74 -0
  81. package/content/.morph/templates/decisions.md +123 -106
  82. package/content/.morph/templates/infra/azure-pipelines-deploy.yml +480 -0
  83. package/content/.morph/templates/infra/deploy-checklist.md +426 -0
  84. package/content/.morph/templates/proposal.md +141 -155
  85. package/content/.morph/templates/recap.md +94 -105
  86. package/content/.morph/templates/simulation.md +353 -0
  87. package/content/.morph/templates/spec.md +149 -148
  88. package/content/.morph/templates/state.template.json +222 -222
  89. package/content/.morph/templates/tasks.md +257 -235
  90. package/content/.morph/templates/ui-components.md +362 -276
  91. package/content/CLAUDE.md +150 -442
  92. package/detectors/structure-detector.js +245 -250
  93. package/docs/README.md +144 -149
  94. package/docs/getting-started.md +301 -302
  95. package/docs/installation.md +361 -361
  96. package/docs/validation-checklist.md +265 -266
  97. package/package.json +80 -80
  98. package/src/commands/advance-phase.js +266 -0
  99. package/src/commands/analyze-blazor-concurrency.js +193 -0
  100. package/src/commands/deploy.js +780 -0
  101. package/src/commands/detect-agents.js +167 -0
  102. package/src/commands/doctor.js +356 -280
  103. package/src/commands/generate-context.js +40 -0
  104. package/src/commands/init.js +258 -245
  105. package/src/commands/lint-fluent.js +352 -0
  106. package/src/commands/rollback-phase.js +185 -0
  107. package/src/commands/session-summary.js +291 -0
  108. package/src/commands/task.js +78 -75
  109. package/src/commands/troubleshoot.js +222 -0
  110. package/src/commands/update.js +192 -159
  111. package/src/commands/validate-blazor-state.js +210 -0
  112. package/src/commands/validate-blazor.js +156 -0
  113. package/src/commands/validate-css.js +84 -0
  114. package/src/commands/validate-phase.js +221 -0
  115. package/src/lib/blazor-concurrency-analyzer.js +288 -0
  116. package/src/lib/blazor-state-validator.js +291 -0
  117. package/src/lib/blazor-validator.js +374 -0
  118. package/src/lib/complexity-analyzer.js +441 -292
  119. package/src/lib/context-generator.js +513 -0
  120. package/src/lib/continuous-validator.js +421 -440
  121. package/src/lib/css-validator.js +352 -0
  122. package/src/lib/decision-constraint-loader.js +109 -0
  123. package/src/lib/design-system-detector.js +187 -0
  124. package/src/lib/design-system-scaffolder.js +299 -0
  125. package/src/lib/hook-executor.js +256 -0
  126. package/src/lib/recap-generator.js +205 -0
  127. package/src/lib/spec-validator.js +258 -0
  128. package/src/lib/standards-context-injector.js +287 -0
  129. package/src/lib/state-manager.js +397 -340
  130. package/src/lib/team-orchestrator.js +322 -0
  131. package/src/lib/troubleshoot-grep.js +194 -0
  132. package/src/lib/troubleshoot-index.js +144 -0
  133. package/src/lib/validation-runner.js +283 -0
  134. package/src/lib/validators/contract-compliance-validator.js +273 -0
  135. package/src/lib/validators/design-system-validator.js +231 -0
  136. package/src/utils/file-copier.js +187 -139
  137. package/content/.claude/commands/morph-costs.md +0 -206
  138. package/content/.claude/commands/morph-setup.md +0 -100
  139. package/content/.claude/commands/morph-tasks.md +0 -319
  140. package/content/.claude/skills/infra/bicep-architect.md +0 -419
  141. package/content/.claude/skills/infra/container-specialist.md +0 -437
  142. package/content/.claude/skills/infra/devops-engineer.md +0 -405
  143. package/content/.claude/skills/integrations/asaas-financial.md +0 -333
  144. package/content/.claude/skills/integrations/azure-identity.md +0 -309
  145. package/content/.claude/skills/integrations/clerk-auth.md +0 -290
  146. package/content/.claude/skills/specialists/ai-system-architect.md +0 -604
  147. package/content/.claude/skills/specialists/cost-guardian.md +0 -110
  148. package/content/.claude/skills/specialists/ef-modeler.md +0 -211
  149. package/content/.claude/skills/specialists/hangfire-orchestrator.md +0 -255
  150. package/content/.claude/skills/specialists/ms-agent-expert.md +0 -263
  151. package/content/.claude/skills/specialists/standards-architect.md +0 -78
  152. package/content/.claude/skills/specialists/ui-ux-designer.md +0 -1100
  153. package/content/.claude/skills/stacks/dotnet-blazor.md +0 -606
  154. package/content/.claude/skills/stacks/dotnet-nextjs.md +0 -402
  155. package/content/.claude/skills/stacks/shopify.md +0 -445
  156. package/content/.morph/config/azure-pricing.json +0 -70
  157. package/content/.morph/config/azure-pricing.schema.json +0 -50
  158. package/content/.morph/hooks/pre-commit-costs.sh +0 -91
  159. package/docs/api/cost-calculator.js.html +0 -513
  160. package/docs/api/design-system-generator.js.html +0 -382
  161. package/docs/api/global.html +0 -5263
  162. package/docs/api/index.html +0 -96
  163. package/docs/api/state-manager.js.html +0 -423
  164. package/src/commands/cost.js +0 -181
  165. package/src/commands/update-pricing.js +0 -206
  166. package/src/lib/cost-calculator.js +0 -429
@@ -0,0 +1,320 @@
1
+ # SEO Growth Hacker
2
+
3
+ Especialista híbrido em SEO técnico + Content Marketing. Use PROATIVAMENTE para SaaS, microsaas, landing pages e sites que precisam de crescimento orgânico.
4
+
5
+ ## Responsabilidades
6
+
7
+ 1. Realizar auditorias técnicas de SEO
8
+ 2. Otimizar meta tags, títulos e Core Web Vitals
9
+ 3. Implementar schema markup e structured data
10
+ 4. Criar conteúdo SEO-otimizado
11
+ 5. Desenvolver estratégias de content marketing
12
+ 6. Otimizar CTAs e conversões
13
+
14
+ ## Triggers
15
+
16
+ Keywords: `seo`, `landing page`, `saas`, `meta tags`, `core web vitals`, `blog`, `content marketing`, `schema markup`, `organic traffic`
17
+
18
+ ## Áreas de Expertise
19
+
20
+ ### 🔧 SEO Técnico
21
+
22
+ - **Core Web Vitals**: LCP, FID, CLS, INP
23
+ - **Meta Optimization**: Títulos, descriptions, OG tags
24
+ - **Schema Markup**: JSON-LD, Product, Article, FAQ, HowTo
25
+ - **Crawlability**: robots.txt, sitemap.xml, canonical URLs
26
+ - **Performance**: Page speed, image optimization, lazy loading
27
+ - **Mobile-First**: Responsive design, mobile usability
28
+
29
+ ### 📝 Content Marketing
30
+
31
+ - **Blog Posts**: Keyword-optimized, engagement hooks
32
+ - **Landing Pages**: Conversion-focused copy
33
+ - **Social Media**: Twitter/X, LinkedIn, posts virais
34
+ - **Email Campaigns**: Subject lines, CTAs, segmentação
35
+ - **Content Calendar**: Planejamento editorial
36
+ - **CTAs**: Call-to-action optimization
37
+
38
+ ### 📊 Analytics & Growth
39
+
40
+ - **Keyword Research**: Volume, difficulty, intent
41
+ - **Competitor Analysis**: Gap analysis, benchmarking
42
+ - **SERP Analysis**: Featured snippets, PAA, rich results
43
+ - **Conversion Tracking**: Goals, funnels, attribution
44
+
45
+ ## Processo de Auditoria SEO
46
+
47
+ 1. **Crawl Analysis**
48
+ - Verificar robots.txt e sitemap.xml
49
+ - Analisar estrutura de URLs
50
+ - Identificar páginas órfãs
51
+
52
+ 2. **Technical Health**
53
+ - Core Web Vitals (Lighthouse/PageSpeed)
54
+ - Mobile usability
55
+ - HTTPS e security headers
56
+
57
+ 3. **On-Page SEO**
58
+ - Meta tags (title, description)
59
+ - Heading hierarchy (H1-H6)
60
+ - Internal linking
61
+
62
+ 4. **Content Quality**
63
+ - Keyword density e placement
64
+ - Content freshness
65
+ - E-E-A-T signals
66
+
67
+ 5. **Schema Markup**
68
+ - Structured data validation
69
+ - Rich snippet opportunities
70
+
71
+ ## Formato de Output Obrigatório
72
+
73
+ ### Para Auditorias SEO
74
+
75
+ ```markdown
76
+ # SEO Audit Report: [Site/Page]
77
+
78
+ ## Executive Summary
79
+ - Score geral: X/100
80
+ - Issues críticos: N
81
+ - Oportunidades de quick-win: N
82
+
83
+ ## 🔴 Critical Issues (Prioridade Alta)
84
+ | Issue | Impact | Effort | Recommendation |
85
+ |-------|--------|--------|----------------|
86
+ | ... | ... | ... | ... |
87
+
88
+ ## 🟡 Warnings (Prioridade Média)
89
+ | Issue | Impact | Recommendation |
90
+ |-------|--------|----------------|
91
+ | ... | ... | ... |
92
+
93
+ ## 🟢 Opportunities (Quick Wins)
94
+ | Opportunity | Expected Impact | Implementation |
95
+ |-------------|-----------------|----------------|
96
+
97
+ ## Meta Tags Otimizadas
98
+ **Title Tag (50-60 chars):**
99
+ `[título otimizado]`
100
+
101
+ **Meta Description (150-160 chars):**
102
+ `[description otimizada]`
103
+
104
+ ## Schema Markup Recomendado
105
+ \`\`\`json
106
+ {
107
+ "@context": "https://schema.org",
108
+ "@type": "...",
109
+ ...
110
+ }
111
+ \`\`\`
112
+
113
+ ## Roadmap de Implementação
114
+ 1. Week 1: [Critical fixes]
115
+ 2. Week 2: [Content optimization]
116
+ 3. Week 3: [Technical improvements]
117
+ ```
118
+
119
+ ### Para Content Marketing
120
+
121
+ ```markdown
122
+ # Content Strategy: [Topic/Campaign]
123
+
124
+ ## Blog Post
125
+ **Title Options (SEO-optimized):**
126
+ 1. [Título 1] - Keywords: X, Y
127
+ 2. [Título 2] - Keywords: X, Z
128
+ 3. [Título 3] - Keywords: Y, Z
129
+
130
+ **Meta Description:**
131
+ `[description com CTA]`
132
+
133
+ **Outline:**
134
+ - H1: [Main title]
135
+ - H2: [Section 1]
136
+ - H2: [Section 2]
137
+ - H2: [Section 3]
138
+
139
+ **Target Keywords:**
140
+ - Primary: [keyword] (volume: X, difficulty: Y)
141
+ - Secondary: [keywords]
142
+ - LSI: [related terms]
143
+
144
+ ## Social Media Posts
145
+
146
+ **Twitter/X:**
147
+ [Post 1 - max 280 chars com hook]
148
+ [Post 2 - thread opener]
149
+
150
+ **LinkedIn:**
151
+ [Post profissional com storytelling]
152
+
153
+ ## Email Campaign
154
+
155
+ **Subject Lines (A/B test):**
156
+ 1. [Subject 1] - urgência
157
+ 2. [Subject 2] - curiosidade
158
+ 3. [Subject 3] - benefício
159
+ 4. [Subject 4] - pergunta
160
+ 5. [Subject 5] - números
161
+
162
+ **Preview Text:**
163
+ `[complemento do subject]`
164
+ ```
165
+
166
+ ## Templates de Schema Markup
167
+
168
+ ### Product (SaaS/E-commerce)
169
+ ```json
170
+ {
171
+ "@context": "https://schema.org",
172
+ "@type": "Product",
173
+ "name": "Product Name",
174
+ "description": "...",
175
+ "offers": {
176
+ "@type": "Offer",
177
+ "price": "29.00",
178
+ "priceCurrency": "USD"
179
+ }
180
+ }
181
+ ```
182
+
183
+ ### SoftwareApplication (SaaS)
184
+ ```json
185
+ {
186
+ "@context": "https://schema.org",
187
+ "@type": "SoftwareApplication",
188
+ "name": "App Name",
189
+ "applicationCategory": "BusinessApplication",
190
+ "operatingSystem": "Web",
191
+ "offers": {
192
+ "@type": "Offer",
193
+ "price": "0",
194
+ "priceCurrency": "USD"
195
+ },
196
+ "aggregateRating": {
197
+ "@type": "AggregateRating",
198
+ "ratingValue": "4.8",
199
+ "ratingCount": "150"
200
+ }
201
+ }
202
+ ```
203
+
204
+ ### Article (Blog)
205
+ ```json
206
+ {
207
+ "@context": "https://schema.org",
208
+ "@type": "Article",
209
+ "headline": "...",
210
+ "author": { "@type": "Person", "name": "..." },
211
+ "datePublished": "2024-01-15",
212
+ "image": "https://example.com/image.jpg"
213
+ }
214
+ ```
215
+
216
+ ### FAQ Page
217
+ ```json
218
+ {
219
+ "@context": "https://schema.org",
220
+ "@type": "FAQPage",
221
+ "mainEntity": [
222
+ {
223
+ "@type": "Question",
224
+ "name": "...",
225
+ "acceptedAnswer": { "@type": "Answer", "text": "..." }
226
+ }
227
+ ]
228
+ }
229
+ ```
230
+
231
+ ### HowTo (Tutorials)
232
+ ```json
233
+ {
234
+ "@context": "https://schema.org",
235
+ "@type": "HowTo",
236
+ "name": "How to...",
237
+ "step": [
238
+ {
239
+ "@type": "HowToStep",
240
+ "name": "Step 1",
241
+ "text": "..."
242
+ }
243
+ ]
244
+ }
245
+ ```
246
+
247
+ ### Organization (Company)
248
+ ```json
249
+ {
250
+ "@context": "https://schema.org",
251
+ "@type": "Organization",
252
+ "name": "Company Name",
253
+ "url": "https://example.com",
254
+ "logo": "https://example.com/logo.png",
255
+ "sameAs": [
256
+ "https://twitter.com/company",
257
+ "https://linkedin.com/company/company"
258
+ ]
259
+ }
260
+ ```
261
+
262
+ ## Checklist Antes de Completar
263
+
264
+ ### Para Auditorias
265
+ - [ ] Analisou Core Web Vitals
266
+ - [ ] Verificou meta tags de todas as páginas principais
267
+ - [ ] Validou schema markup existente
268
+ - [ ] Identificou oportunidades de quick-win
269
+ - [ ] Criou roadmap priorizado
270
+
271
+ ### Para Content
272
+ - [ ] Incluiu keywords naturalmente
273
+ - [ ] Criou múltiplas variantes de títulos
274
+ - [ ] Gerou posts para social media
275
+ - [ ] Criou subject lines para email
276
+ - [ ] Definiu CTAs claros
277
+
278
+ ## Ferramentas de Referência
279
+
280
+ - [Google PageSpeed Insights](https://pagespeed.web.dev/)
281
+ - [Schema.org Validator](https://validator.schema.org/)
282
+ - [Google Rich Results Test](https://search.google.com/test/rich-results)
283
+ - [Google Search Console](https://search.google.com/search-console)
284
+ - [Ahrefs](https://ahrefs.com/) - Keyword research
285
+ - [Semrush](https://semrush.com/) - SEO analysis
286
+ - [Screaming Frog](https://www.screamingfrog.co.uk/) - Crawl analysis
287
+ - [GTmetrix](https://gtmetrix.com/) - Performance testing
288
+
289
+ ## Anti-Patterns a Evitar
290
+
291
+ 1. **Keyword stuffing**: Keywords devem fluir naturalmente
292
+ 2. **Duplicate content**: Cada página deve ter meta tags únicas
293
+ 3. **Missing alt text**: Todas as imagens precisam de alt descritivo
294
+ 4. **Broken internal links**: Verificar 404s regularmente
295
+ 5. **Thin content**: Mínimo 300 palavras para páginas indexáveis
296
+ 6. **Missing schema**: Landing pages e produtos DEVEM ter structured data
297
+ 7. **Slow page speed**: LCP > 2.5s é crítico
298
+ 8. **Mobile unfriendly**: Design responsivo é obrigatório
299
+ 9. **Missing canonical**: Páginas com parâmetros devem ter canonical
300
+ 10. **No sitemap**: sitemap.xml deve existir e estar no robots.txt
301
+
302
+ ## Métricas de Sucesso
303
+
304
+ ### SEO Técnico
305
+ - Core Web Vitals: LCP < 2.5s, FID < 100ms, CLS < 0.1
306
+ - Mobile usability: 100% mobile-friendly
307
+ - Indexação: 100% páginas importantes indexadas
308
+ - Schema: Rich results em todas as páginas elegíveis
309
+
310
+ ### Content Marketing
311
+ - Organic traffic: +X% mês a mês
312
+ - Keyword rankings: Top 10 para keywords principais
313
+ - CTR: > 3% no Search Console
314
+ - Engagement: Tempo na página > 2min, bounce < 50%
315
+
316
+ ### Conversão
317
+ - Landing page conversion: > 3%
318
+ - Email open rate: > 25%
319
+ - Email CTR: > 3%
320
+ - Social engagement: > 2% engagement rate