MORPH-SPEC

Desenvolvimento orientado por especificações com agentes AI

by Polymorphism Tech

Instalação •
Começando •
Comandos •
Agentes •
Documentação

📚 Guias de Uso:
Quick Start •
Cheat Sheet •
API Docs

---

O que é MORPH-SPEC?

Methodical Orchestration for Reliable Production-ready SPEC-driven development

MORPH-SPEC é um framework de desenvolvimento orientado por especificações com 17 agentes AI especializados. Cada agente tem expertise em tecnologias específicas e segue workflows estruturados para entregar código production-ready.

Stacks suportadas: .NET/Blazor, .NET/Next.js
Infraestrutura: Azure Bicep (IaC)
Ferramenta: Claude Code

---

Instalação

$3

- Node.js 18+
- Claude Code instalado

$3

bash

Navegue até seu projeto

cd /caminho/do/seu/projeto



Execute o instalador (não precisa instalar nada)

npx @polymorphism-tech/morph-spec init





$3



Se preferir ter o comando disponível globalmente:

bash

npm install -g @polymorphism-tech/morph-spec

morph-spec init



⚠️ Windows + nvm-windows: Comando não reconhecido?



Se você usa nvm-windows para gerenciar versões do Node.js, o npm não adiciona automaticamente os pacotes globais ao PATH. Este é um problema conhecido do nvm-windows.



$3



PowerShell (executar como Administrador):

powershell

Verificar o caminho do npm global

npm config get prefix



Adicionar ao PATH (substitua pelo caminho acima)

$npmPath = "$env:APPDATA\npm"

[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$npmPath", "User")





Depois, feche e reabra o terminal.



$3



O

npx

 funciona sem configurar PATH:

bash

npx @polymorphism-tech/morph-spec init

npx @polymorphism-tech/morph-spec doctor

$3

bash

morph-spec --version

Ou

npx @polymorphism-tech/morph-spec --version

$3

bash

morph-spec doctor  # Detecta problemas de PATH automaticamente





Veja também: Troubleshooting





$3



| Comando | Descrição |

|---------|-----------|

|

morph-spec init

 | Inicializa MORPH no diretório atual |

|

morph-spec init --force

 | Sobrescreve instalação existente |

|

morph-spec update

 | Atualiza projeto para versão mais recente |

|

morph-spec update --templates

 | Atualiza apenas templates |

|

morph-spec update --standards

 | Atualiza apenas standards |

|

morph-spec doctor

 | Verifica saúde e versões da instalação |



$3

bash

morph-spec doctor





O comando

doctor

 verifica:

- ✓ Versão do CLI (se está atualizada)

- ✓ Versão do MORPH no projeto

- ✓ Estrutura de arquivos e configurações



Ou abra seu projeto no Claude Code e execute:



/morph-status





---



Mantendo Atualizado



$3

bash

morph-spec doctor





Isso mostrará se há versões mais recentes disponíveis.



$3



Instalação Global:

bash

Primeiro, atualize o CLI

npm install -g @polymorphism-tech/morph-spec@latest



Depois, atualize seu projeto

cd /caminho/do/seu/projeto

morph-spec update





Usando npx (Recomendado - sempre pega a versão mais recente):

bash

cd /caminho/do/seu/projeto

npx @polymorphism-tech/morph-spec@latest update





$3



O comando

update

 sincroniza:

- ✅ Templates (

.morph/templates/

)

- ✅ Standards (

.morph/standards/

)

- ✅ Agentes (

.morph/config/agents.json

)

- ✅ Comandos Claude (

.claude/commands/

)

- ✅ Skills (

.claude/skills/

)

- ✅ Instruções (CLAUDE.md)



Importante: Seu

config.json

 é preservado!



---



Começando



$3



/morph-proposal minha-feature





Descreva o que quer implementar. O MORPH vai gerar a especificação completa.



$3



Arquivos gerados em

.morph/features/minha-feature/

:

-

spec.md

 - Especificação técnica

-

contracts.cs

 - Interfaces e DTOs

-

decisions.md

 - Decisões arquiteturais



$3



Revise os arquivos gerados e aprove (ou peça ajustes).



$3



/morph-apply minha-feature





O MORPH implementa task por task, com testes a cada etapa.



$3



/morph-archive minha-feature





Move a feature concluída para o arquivo.



---



Como Funciona



┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐

│  SETUP   │ ─▶ │  DESIGN  │ ─▶ │ CLARIFY  │ ─▶ │  TASKS   │ ─▶ │IMPLEMENT │

│          │    │          │    │          │    │          │    │          │

│ Contexto │    │  Spec +  │    │  Q&A +   │    │  Quebra  │    │ Executa  │

│ + Agents │    │Contracts │    │  Edges   │    │  Tasks   │    │ + Testa  │

└──────────┘    └──────────┘    └──────────┘    └──────────┘    └──────────┘

                     ⛔                              ⛔

                  Aprovação                       Aprovação





Pontos de aprovação: O MORPH para em 2 momentos para você revisar antes de continuar.



---



Comandos Claude Code



| Comando | Descrição |

|---------|-----------|

|

/morph-proposal

 | Cria nova feature |

|

/morph-apply

 | Implementa feature aprovada |

|

/morph-status

 | Mostra status do projeto |

|

/morph-archive

 | Arquiva feature concluída |

|

/morph-infra

 | Gerencia infraestrutura (init, validate, deploy) |

|

/morph-costs

 | Estima custos Azure |



---



Agentes



$3



| Agente | Função |

|--------|--------|

| 📐 Standards Architect | Padrões de código e consistência |

| ☁️ Azure Architect | Infraestrutura cloud e IaC |

| 💰 Cost Guardian | Controle de custos |



$3



| Agente | Keywords |

|--------|----------|

| 🔥 Blazor Builder | blazor, razor, component |

| ⚛️ NextJS Expert | nextjs, react, frontend |



$3



| Agente | Keywords |

|--------|----------|

| 🗄️ EF Modeler | database, entity, migration |

| 🤖 MS Agent Expert | agent, ai, semantic kernel |

| ⏰ Hangfire Orchestrator | scheduled, job, background |

| 🎨 UI/UX Designer | wizard, dashboard, complex form |

| 📋 PO/PM Advisor | unclear, requirements, ROI |



$3



| Agente | Keywords |

|--------|----------|

| 💳 Asaas Financial | asaas, pix, boleto, payment |

| 🔐 Clerk Auth | clerk, auth, login |

| 🆔 Azure Identity | identity, entra, microsoft auth |



$3



| Agente | Keywords |

|--------|----------|

| 🏗️ Bicep Architect | bicep, iac, infra |

| 🚀 DevOps Engineer | pipeline, ci/cd, deploy |

| 📦 Container Specialist | docker, container |



---



Exemplos



| Exemplo | Descrição |

|---------|-----------|

| micro-saas | SaaS completo com Blazor + Asaas billing |

| api-nextjs | .NET API + Next.js frontend |

| multi-agent | Sistema multi-agente com Semantic Kernel |



Cada exemplo inclui:

README.md, spec.md, contracts.cs, tasks.md, decisions.md





---



Estrutura do Projeto



Após a instalação, seu projeto terá:



seu-projeto/

├── CLAUDE.md                 # Instruções para o AI

├── .morph/

│   ├── config/               # Configurações

│   │   ├── config.json

│   │   └── agents.json

│   ├── standards/            # Padrões de código

│   │   ├── coding.md

│   │   ├── architecture.md

│   │   └── azure.md

│   ├── templates/            # Templates de código e IaC

│   │   ├── infra/

│   │   ├── integrations/

│   │   └── saas/

│   ├── examples/             # Exemplos completos

│   ├── features/             # Features em desenvolvimento

│   └── archive/              # Features concluídas

└── .claude/

    ├── commands/             # Slash commands

    └── skills/               # Skills dos agentes





---



Templates Incluídos



$3

-

main.bicep, container-app.bicep, sql-database.bicep, storage.bicep, key-vault.bicep, app-insights.bicep





$3

-

asaas-client.cs, asaas-webhook.cs, clerk-config.cs, azure-identity-config.cs





$3

-

subscription.cs, tenant.cs





$3

-

service.cs, repository.cs, component.razor, agent.cs, job.cs, test.cs





---



Custos



O MORPH segue a filosofia "Free tier first":



| Nível | Limite | Requer |

|-------|--------|--------|

| Sem aprovação | Free tier | Nada |

| Com aprovação | Até $10/mês | Confirmação |

| Acima de $10 | Justificativa | ADR |



---



🔧 Troubleshooting



$3



Sintoma: Após

npm install -g

, o comando não é reconhecido.



Diagnóstico:

bash

npm config get prefix  # Ver onde npm instala globalmente

echo $PATH             # Linux/Mac: Verificar se está no PATH

$env:Path              # Windows: Verificar se está no PATH





Causa comum: Você está usando nvm ou nvm-windows, que não adiciona automaticamente npm global ao PATH.



Solução 1 - Usar npx (Recomendado):

bash

npx @polymorphism-tech/morph-spec init





Solução 2 - Adicionar ao PATH:



Linux/Mac:

bash

Adicionar ao ~/.bashrc ou ~/.zshrc

export PATH="$HOME/.npm-global/bin:$PATH"





Windows (PowerShell como Admin):

powershell

$npmPath = "$env:APPDATA\npm"

[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$npmPath", "User")





Verificar correção:

bash

morph-spec --version





---



$3



O que o doctor verifica:

- ✓ Versão do CLI (atualizada?)

- ✓ Versão do MORPH no projeto

- ✓ Comando morph-spec no PATH

- ✓ Estrutura de arquivos (.morph/, CLAUDE.md, etc.)



Se reportar "morph-spec not in PATH":

1. Use

npx

 como alternativa (sempre funciona)

2. Ou siga as instruções acima para adicionar ao PATH



Se reportar arquivos faltando:

bash

morph-spec init --force  # Reinstala estrutura completa





---



$3



Erro:

EPERM: operation not permitted





Causa: Falta de permissões de administrador.



Solução:

1. Abra PowerShell ou CMD como Administrador

2. Execute:

npm install -g @polymorphism-tech/morph-spec





Alternativa: Use

npx

 (não requer admin):

bash

npx @polymorphism-tech/morph-spec init





---



$3



Se você usa nvm-windows para gerenciar versões do Node.js:



Problema conhecido: npm global não vai para PATH automaticamente

Issue oficial: https://github.com/coreybutler/nvm-windows/issues/391



Recomendações:

1. Melhor opção: Use

npx

 para todos os comandos

2. Alternativa: Configure PATH manualmente (ver seção de instalação)

3. Verificar: Execute

morph-spec doctor

 para diagnosticar



---



$3

bash

morph-spec doctor          # Diagnóstico automático

morph-spec --help          # Ver todos os comandos

morph-spec  --help  # Ajuda de comando específico





Suporte:

- 📧 Email: support@polymorphism.com.br

- 🐛 Issues: GitHub



---



📄 Licença e Distribuição



Repositório: Privado (código fonte protegido)

Package npm: Público e gratuito via

@polymorphism-tech/morph-spec`

$3

O MORPH-SPEC framework é software proprietário da Polymorphism Tech. Veja LICENSE para detalhes.

Você PODE:
- ✅ Usar o CLI tool gratuitamente
- ✅ Gerar projetos para uso pessoal ou comercial
- ✅ Modificar código gerado pelos templates
- ✅ Distribuir seus projetos criados com MORPH-SPEC

Você NÃO PODE:
- ❌ Redistribuir ou vender o framework
- ❌ Criar produtos derivados competidores
- ❌ Modificar ou fazer engenharia reversa do framework
- ❌ Remover avisos de copyright

$3

Todo código gerado usando MORPH-SPEC é 100% seu para usar como quiser, incluindo uso comercial.

$3

- 📧 Email: support@polymorphism.com.br
- 🌐 Website: https://polymorphism.com.br
- 📦 npm: @polymorphism-tech/morph-spec

---

Links

- 📦 npm Package
- 📚 Documentação
- 💡 Exemplos
- 🌐 Polymorphism Tech

---

MORPH-SPEC by Polymorphism Tech

MORPH-SPEC

Desenvolvimento orientado por especificações com agentes AI

by Polymorphism Tech

Instalação •
Começando •
Comandos •
Agentes •
Documentação

📚 Guias de Uso:
Quick Start •
Cheat Sheet •
API Docs

---

O que é MORPH-SPEC?

Instalação

$3

- Node.js 18+
- Claude Code instalado

$3

bash

Navegue até seu projeto

cd /caminho/do/seu/projeto



Execute o instalador (não precisa instalar nada)

npx @polymorphism-tech/morph-spec init





$3



Se preferir ter o comando disponível globalmente:

bash

npm install -g @polymorphism-tech/morph-spec

morph-spec init



⚠️ Windows + nvm-windows: Comando não reconhecido?



Se você usa nvm-windows para gerenciar versões do Node.js, o npm não adiciona automaticamente os pacotes globais ao PATH. Este é um problema conhecido do nvm-windows.



$3



PowerShell (executar como Administrador):

powershell

Verificar o caminho do npm global

npm config get prefix



Adicionar ao PATH (substitua pelo caminho acima)

$npmPath = "$env:APPDATA\npm"

[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$npmPath", "User")





Depois, feche e reabra o terminal.



$3



O

npx

 funciona sem configurar PATH:

bash

npx @polymorphism-tech/morph-spec init

npx @polymorphism-tech/morph-spec doctor

$3

bash

morph-spec --version

Ou

npx @polymorphism-tech/morph-spec --version

$3

bash

morph-spec doctor  # Detecta problemas de PATH automaticamente





Veja também: Troubleshooting





$3



| Comando | Descrição |

|---------|-----------|

|

morph-spec init

 | Inicializa MORPH no diretório atual |

|

morph-spec init --force

 | Sobrescreve instalação existente |

|

morph-spec update

 | Atualiza projeto para versão mais recente |

|

morph-spec update --templates

 | Atualiza apenas templates |

|

morph-spec update --standards

 | Atualiza apenas standards |

|

morph-spec doctor

 | Verifica saúde e versões da instalação |



$3

bash

morph-spec doctor





O comando

doctor

 verifica:

- ✓ Versão do CLI (se está atualizada)

- ✓ Versão do MORPH no projeto

- ✓ Estrutura de arquivos e configurações



Ou abra seu projeto no Claude Code e execute:



/morph-status





---



Mantendo Atualizado



$3

bash

morph-spec doctor





Isso mostrará se há versões mais recentes disponíveis.



$3



Instalação Global:

bash

Primeiro, atualize o CLI

npm install -g @polymorphism-tech/morph-spec@latest



Depois, atualize seu projeto

cd /caminho/do/seu/projeto

morph-spec update





Usando npx (Recomendado - sempre pega a versão mais recente):

bash

cd /caminho/do/seu/projeto

npx @polymorphism-tech/morph-spec@latest update





$3



O comando

update

 sincroniza:

- ✅ Templates (

.morph/templates/

)

- ✅ Standards (

.morph/standards/

)

- ✅ Agentes (

.morph/config/agents.json

)

- ✅ Comandos Claude (

.claude/commands/

)

- ✅ Skills (

.claude/skills/

)

- ✅ Instruções (CLAUDE.md)



Importante: Seu

config.json

 é preservado!



---



Começando



$3



/morph-proposal minha-feature





Descreva o que quer implementar. O MORPH vai gerar a especificação completa.



$3



Arquivos gerados em

.morph/features/minha-feature/

:

-

spec.md

 - Especificação técnica

-

contracts.cs

 - Interfaces e DTOs

-

decisions.md

 - Decisões arquiteturais



$3



Revise os arquivos gerados e aprove (ou peça ajustes).



$3



/morph-apply minha-feature





O MORPH implementa task por task, com testes a cada etapa.



$3



/morph-archive minha-feature





Move a feature concluída para o arquivo.



---



Como Funciona



┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐

│  SETUP   │ ─▶ │  DESIGN  │ ─▶ │ CLARIFY  │ ─▶ │  TASKS   │ ─▶ │IMPLEMENT │

│          │    │          │    │          │    │          │    │          │

│ Contexto │    │  Spec +  │    │  Q&A +   │    │  Quebra  │    │ Executa  │

│ + Agents │    │Contracts │    │  Edges   │    │  Tasks   │    │ + Testa  │

└──────────┘    └──────────┘    └──────────┘    └──────────┘    └──────────┘

                     ⛔                              ⛔

                  Aprovação                       Aprovação





Pontos de aprovação: O MORPH para em 2 momentos para você revisar antes de continuar.



---



Comandos Claude Code



| Comando | Descrição |

|---------|-----------|

|

/morph-proposal

 | Cria nova feature |

|

/morph-apply

 | Implementa feature aprovada |

|

/morph-status

 | Mostra status do projeto |

|

/morph-archive

 | Arquiva feature concluída |

|

/morph-infra

 | Gerencia infraestrutura (init, validate, deploy) |

|

/morph-costs

 | Estima custos Azure |



---



Agentes



$3



| Agente | Função |

|--------|--------|

| 📐 Standards Architect | Padrões de código e consistência |

| ☁️ Azure Architect | Infraestrutura cloud e IaC |

| 💰 Cost Guardian | Controle de custos |



$3



| Agente | Keywords |

|--------|----------|

| 🔥 Blazor Builder | blazor, razor, component |

| ⚛️ NextJS Expert | nextjs, react, frontend |



$3



| Agente | Keywords |

|--------|----------|

| 🗄️ EF Modeler | database, entity, migration |

| 🤖 MS Agent Expert | agent, ai, semantic kernel |

| ⏰ Hangfire Orchestrator | scheduled, job, background |

| 🎨 UI/UX Designer | wizard, dashboard, complex form |

| 📋 PO/PM Advisor | unclear, requirements, ROI |



$3



| Agente | Keywords |

|--------|----------|

| 💳 Asaas Financial | asaas, pix, boleto, payment |

| 🔐 Clerk Auth | clerk, auth, login |

| 🆔 Azure Identity | identity, entra, microsoft auth |



$3



| Agente | Keywords |

|--------|----------|

| 🏗️ Bicep Architect | bicep, iac, infra |

| 🚀 DevOps Engineer | pipeline, ci/cd, deploy |

| 📦 Container Specialist | docker, container |



---



Exemplos



| Exemplo | Descrição |

|---------|-----------|

| micro-saas | SaaS completo com Blazor + Asaas billing |

| api-nextjs | .NET API + Next.js frontend |

| multi-agent | Sistema multi-agente com Semantic Kernel |



Cada exemplo inclui:

README.md, spec.md, contracts.cs, tasks.md, decisions.md





---



Estrutura do Projeto



Após a instalação, seu projeto terá:



seu-projeto/

├── CLAUDE.md                 # Instruções para o AI

├── .morph/

│   ├── config/               # Configurações

│   │   ├── config.json

│   │   └── agents.json

│   ├── standards/            # Padrões de código

│   │   ├── coding.md

│   │   ├── architecture.md

│   │   └── azure.md

│   ├── templates/            # Templates de código e IaC

│   │   ├── infra/

│   │   ├── integrations/

│   │   └── saas/

│   ├── examples/             # Exemplos completos

│   ├── features/             # Features em desenvolvimento

│   └── archive/              # Features concluídas

└── .claude/

    ├── commands/             # Slash commands

    └── skills/               # Skills dos agentes





---



Templates Incluídos



$3

-

main.bicep, container-app.bicep, sql-database.bicep, storage.bicep, key-vault.bicep, app-insights.bicep





$3

-

asaas-client.cs, asaas-webhook.cs, clerk-config.cs, azure-identity-config.cs





$3

-

subscription.cs, tenant.cs





$3

-

service.cs, repository.cs, component.razor, agent.cs, job.cs, test.cs





---



Custos



O MORPH segue a filosofia "Free tier first":



| Nível | Limite | Requer |

|-------|--------|--------|

| Sem aprovação | Free tier | Nada |

| Com aprovação | Até $10/mês | Confirmação |

| Acima de $10 | Justificativa | ADR |



---



🔧 Troubleshooting



$3



Sintoma: Após

npm install -g

, o comando não é reconhecido.



Diagnóstico:

bash

npm config get prefix  # Ver onde npm instala globalmente

echo $PATH             # Linux/Mac: Verificar se está no PATH

$env:Path              # Windows: Verificar se está no PATH





Causa comum: Você está usando nvm ou nvm-windows, que não adiciona automaticamente npm global ao PATH.



Solução 1 - Usar npx (Recomendado):

bash

npx @polymorphism-tech/morph-spec init





Solução 2 - Adicionar ao PATH:



Linux/Mac:

bash

Adicionar ao ~/.bashrc ou ~/.zshrc

export PATH="$HOME/.npm-global/bin:$PATH"





Windows (PowerShell como Admin):

powershell

$npmPath = "$env:APPDATA\npm"

[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$npmPath", "User")





Verificar correção:

bash

morph-spec --version





---



$3



O que o doctor verifica:

- ✓ Versão do CLI (atualizada?)

- ✓ Versão do MORPH no projeto

- ✓ Comando morph-spec no PATH

- ✓ Estrutura de arquivos (.morph/, CLAUDE.md, etc.)



Se reportar "morph-spec not in PATH":

1. Use

npx

 como alternativa (sempre funciona)

2. Ou siga as instruções acima para adicionar ao PATH



Se reportar arquivos faltando:

bash

morph-spec init --force  # Reinstala estrutura completa





---



$3



Erro:

EPERM: operation not permitted





Causa: Falta de permissões de administrador.



Solução:

1. Abra PowerShell ou CMD como Administrador

2. Execute:

npm install -g @polymorphism-tech/morph-spec





Alternativa: Use

npx

 (não requer admin):

bash

npx @polymorphism-tech/morph-spec init





---



$3



Se você usa nvm-windows para gerenciar versões do Node.js:



Problema conhecido: npm global não vai para PATH automaticamente

Issue oficial: https://github.com/coreybutler/nvm-windows/issues/391



Recomendações:

1. Melhor opção: Use

npx

 para todos os comandos

2. Alternativa: Configure PATH manualmente (ver seção de instalação)

3. Verificar: Execute

morph-spec doctor

 para diagnosticar



---



$3

bash

morph-spec doctor          # Diagnóstico automático

morph-spec --help          # Ver todos os comandos

morph-spec  --help  # Ajuda de comando específico





Suporte:

- 📧 Email: support@polymorphism.com.br

- 🐛 Issues: GitHub



---



📄 Licença e Distribuição



Repositório: Privado (código fonte protegido)

Package npm: Público e gratuito via

@polymorphism-tech/morph-spec`

$3

Todo código gerado usando MORPH-SPEC é 100% seu para usar como quiser, incluindo uso comercial.

$3

- 📧 Email: support@polymorphism.com.br
- 🌐 Website: https://polymorphism.com.br
- 📦 npm: @polymorphism-tech/morph-spec

---

Links

- 📦 npm Package
- 📚 Documentação
- 💡 Exemplos
- 🌐 Polymorphism Tech

---

MORPH-SPEC by Polymorphism Tech