@polymorphism-tech/morph-spec 3.0.0 → 3.0.1

package/content/.claude/commands/morph-troubleshoot.md

@@ -1,122 +1,122 @@
-# Troubleshoot - Buscar Soluções para Erros
-
-Busca soluções para erros e problemas comuns no desenvolvimento .NET/Blazor/Azure.
-
-## Uso
-
-```
-/morph-troubleshoot <descrição do erro ou keywords>
-```
-
-## Exemplos
-
-```bash
-/morph-troubleshoot blazor.web.js 404
-/morph-troubleshoot DbContext second operation
-/morph-troubleshoot Azure.Identity NU1605
-/morph-troubleshoot Include retorna vazio
-/morph-troubleshoot PendingModelChanges
-```
-
-## Workflow de 3 Níveis
-
-### Nível 1: Índice JSON (Primário)
-
-Primeiro, execute o comando CLI para buscar no índice de problemas conhecidos:
-
-```bash
-npx morph-spec troubleshoot {keywords}
-
-# Opções
---category <cat>     # Filtrar por categoria (blazor, efcore, azure)
---verbose            # Mostrar conteúdo completo da solução
---list-categories    # Listar categorias disponíveis
-```
-
-### Nível 2: Grep nos Standards (Automático)
-
-Se o índice retornar poucos resultados, o CLI automaticamente busca nos arquivos:
-- `framework/standards/*.md`
-- `content/.morph/standards/*.md`
-
-### Nível 3: Web Search (Se necessário)
-
-**IMPORTANTE:** Se os níveis 1 e 2 não encontrarem solução, use o tool **WebSearch** nativo do Claude Code para buscar nas seguintes fontes:
-
-**Queries recomendadas:**
-
-```
-# GitHub Issues (.NET)
-site:github.com/dotnet/aspnetcore {erro}
-site:github.com/dotnet/efcore {erro}
-
-# Stack Overflow
-site:stackoverflow.com [blazor] {erro}
-site:stackoverflow.com [entity-framework-core] {erro}
-site:stackoverflow.com [azure] {erro}
-
-# Documentação Microsoft
-site:learn.microsoft.com {erro}
-site:learn.microsoft.com/azure {erro}
-```
-
-**Exemplo de uso do WebSearch:**
-
-Se o usuário perguntar sobre um erro de SignalR:
-1. Primeiro: `npx morph-spec troubleshoot SignalR connection`
-2. Se não encontrar: WebSearch com `site:github.com/dotnet/aspnetcore SignalR connection closed`
-3. Retornar links relevantes formatados
-
-## Categorias Disponíveis
-
-| Categoria | Descrição |
-|-----------|-----------|
-| `blazor` | Blazor Server/WASM, componentes, lifecycle, renderização |
-| `efcore` | Entity Framework Core, DbContext, migrations, queries |
-| `azure` | Azure services, deploy, identity, Key Vault |
-| `auth` | Authentication, authorization, tokens, claims |
-| `deploy` | Deployment, CI/CD, pipelines, containers |
-
-## Formato de Output
-
-Ao encontrar uma solução, apresente no seguinte formato:
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-🔴 CRITICAL: {título do problema}
-
-📁 Arquivo: {caminho do arquivo com solução}
-📂 Seção: {seção específica}
-
-❌ Erro:
-   {padrão de erro que identifica o problema}
-
-💡 Causa:
-   {explicação da causa raiz}
-
-✅ Solução:
-   {código ou passos para resolver}
-
-📚 Ver completo: morph-spec read {arquivo}
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-```
-
-## Troubleshooting Rápido
-
-### Problemas Mais Comuns
-
-| Erro | Solução Rápida |
-|------|----------------|
-| `blazor.web.js 404` | `<RequiresAspNetWebAssets>true</RequiresAspNetWebAssets>` |
-| `PendingModelChangesWarning` | `dotnet ef migrations add <Name>` antes de update |
-| `DbContext second operation` | Usar `IDbContextFactory` para background tasks |
-| `Include() vazio` | Usar `HasMany(x => x.Nav)` em vez de `HasMany<T>()` |
-| `Azure.Identity NU1605` | Especificar versão explícita no .csproj |
-| `Key Vault não carrega` | Não condicionar ao ambiente (IsDevelopment) |
-| `DefaultAzureCredential lento` | Desabilitar credenciais não usadas |
-
----
-
-**Input:** $ARGUMENTS
+# Troubleshoot - Buscar Soluções para Erros
+
+Busca soluções para erros e problemas comuns no desenvolvimento .NET/Blazor/Azure.
+
+## Uso
+
+```
+/morph-troubleshoot <descrição do erro ou keywords>
+```
+
+## Exemplos
+
+```bash
+/morph-troubleshoot blazor.web.js 404
+/morph-troubleshoot DbContext second operation
+/morph-troubleshoot Azure.Identity NU1605
+/morph-troubleshoot Include retorna vazio
+/morph-troubleshoot PendingModelChanges
+```
+
+## Workflow de 3 Níveis
+
+### Nível 1: Índice JSON (Primário)
+
+Primeiro, execute o comando CLI para buscar no índice de problemas conhecidos:
+
+```bash
+npx morph-spec troubleshoot {keywords}
+
+# Opções
+--category <cat>     # Filtrar por categoria (blazor, efcore, azure)
+--verbose            # Mostrar conteúdo completo da solução
+--list-categories    # Listar categorias disponíveis
+```
+
+### Nível 2: Grep nos Standards (Automático)
+
+Se o índice retornar poucos resultados, o CLI automaticamente busca nos arquivos:
+- `framework/standards/*.md`
+- `content/.morph/standards/*.md`
+
+### Nível 3: Web Search (Se necessário)
+
+**IMPORTANTE:** Se os níveis 1 e 2 não encontrarem solução, use o tool **WebSearch** nativo do Claude Code para buscar nas seguintes fontes:
+
+**Queries recomendadas:**
+
+```
+# GitHub Issues (.NET)
+site:github.com/dotnet/aspnetcore {erro}
+site:github.com/dotnet/efcore {erro}
+
+# Stack Overflow
+site:stackoverflow.com [blazor] {erro}
+site:stackoverflow.com [entity-framework-core] {erro}
+site:stackoverflow.com [azure] {erro}
+
+# Documentação Microsoft
+site:learn.microsoft.com {erro}
+site:learn.microsoft.com/azure {erro}
+```
+
+**Exemplo de uso do WebSearch:**
+
+Se o usuário perguntar sobre um erro de SignalR:
+1. Primeiro: `npx morph-spec troubleshoot SignalR connection`
+2. Se não encontrar: WebSearch com `site:github.com/dotnet/aspnetcore SignalR connection closed`
+3. Retornar links relevantes formatados
+
+## Categorias Disponíveis
+
+| Categoria | Descrição |
+|-----------|-----------|
+| `blazor` | Blazor Server/WASM, componentes, lifecycle, renderização |
+| `efcore` | Entity Framework Core, DbContext, migrations, queries |
+| `azure` | Azure services, deploy, identity, Key Vault |
+| `auth` | Authentication, authorization, tokens, claims |
+| `deploy` | Deployment, CI/CD, pipelines, containers |
+
+## Formato de Output
+
+Ao encontrar uma solução, apresente no seguinte formato:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🔴 CRITICAL: {título do problema}
+
+📁 Arquivo: {caminho do arquivo com solução}
+📂 Seção: {seção específica}
+
+❌ Erro:
+   {padrão de erro que identifica o problema}
+
+💡 Causa:
+   {explicação da causa raiz}
+
+✅ Solução:
+   {código ou passos para resolver}
+
+📚 Ver completo: morph-spec read {arquivo}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Troubleshooting Rápido
+
+### Problemas Mais Comuns
+
+| Erro | Solução Rápida |
+|------|----------------|
+| `blazor.web.js 404` | `<RequiresAspNetWebAssets>true</RequiresAspNetWebAssets>` |
+| `PendingModelChangesWarning` | `dotnet ef migrations add <Name>` antes de update |
+| `DbContext second operation` | Usar `IDbContextFactory` para background tasks |
+| `Include() vazio` | Usar `HasMany(x => x.Nav)` em vez de `HasMany<T>()` |
+| `Azure.Identity NU1605` | Especificar versão explícita no .csproj |
+| `Key Vault não carrega` | Não condicionar ao ambiente (IsDevelopment) |
+| `DefaultAzureCredential lento` | Desabilitar credenciais não usadas |
+
+---
+
+**Input:** $ARGUMENTS

package/content/.claude/settings.local.json

@@ -1,15 +1,15 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(dotnet:*)",
-      "Bash(git:*)",
-      "Read",
-      "Write",
-      "Edit",
-      "Glob",
-      "Grep"
-    ],
-    "deny": []
-  },
-  "model": "claude-sonnet-4-20250514"
-}
+{
+  "permissions": {
+    "allow": [
+      "Bash(dotnet:*)",
+      "Bash(git:*)",
+      "Read",
+      "Write",
+      "Edit",
+      "Glob",
+      "Grep"
+    ],
+    "deny": []
+  },
+  "model": "claude-sonnet-4-20250514"
+}

package/content/.claude/skills/{specialists → level-2-domains/architecture}/prompt-engineer.md

@@ -1,189 +1,189 @@
-# Prompt Engineer
-
-Especialista em engenharia de prompts para LLMs e sistemas de IA. Use PROATIVAMENTE ao construir features de IA, melhorar performance de agentes ou criar system prompts.
-
-## Responsabilidades
-
-1. Criar prompts otimizados para LLMs
-2. Aplicar técnicas avançadas de prompting
-3. Definir formatos de output estruturados
-4. Otimizar prompts existentes
-5. Adaptar prompts para diferentes modelos
-
-## Triggers
-
-Keywords: `prompt`, `prompting`, `system prompt`, `few-shot`, `chain-of-thought`, `llm prompt`, `agent prompt`, `engenharia de prompt`
-
-## Áreas de Expertise
-
-### Otimização de Prompts
-
-- Seleção few-shot vs zero-shot
-- Raciocínio chain-of-thought
-- Role-playing e definição de perspectiva
-- Especificação de formato de output
-- Definição de constraints e limites
-
-### Arsenal de Técnicas
-
-- Constitutional AI principles
-- Recursive prompting
-- Tree of thoughts
-- Self-consistency checking
-- Prompt chaining e pipelines
-
-### Otimização por Modelo
-
-- **Claude**: Ênfase em helpful, harmless, honest
-- **GPT**: Estrutura clara e exemplos
-- **Open models**: Necessidades específicas de formatação
-- **Modelos especializados**: Adaptação de domínio
-
-## Processo de Otimização
-
-1. Analisar caso de uso pretendido
-2. Identificar requisitos e constraints chave
-3. Selecionar técnicas de prompting apropriadas
-4. Criar prompt inicial com estrutura clara
-5. Testar e iterar baseado em outputs
-6. Documentar padrões efetivos
-
-## Formato de Output Obrigatório
-
-**IMPORTANTE:** SEMPRE que criar qualquer prompt, DEVE exibir o texto completo. NUNCA apenas descreva um prompt.
-
-### O Prompt
-```
-[Exibir texto completo do prompt aqui]
-```
-
-### Notas de Implementação
-- Técnicas chave usadas
-- Por que essas escolhas foram feitas
-- Outcomes esperados
-
-## Deliverables
-
-- **O texto do prompt** (exibido completo, formatado)
-- Explicação das escolhas de design
-- Guidelines de uso
-- Exemplos de outputs esperados
-- Benchmarks de performance
-- Estratégias de tratamento de erro
-
-## Padrões Comuns
-
-### Estrutura System/User/Assistant
-```
-<system>
-[Contexto e personalidade]
-</system>
-
-<user>
-[Input do usuário]
-</user>
-```
-
-### Tags XML para Seções Claras
-```xml
-<context>
-[Background information]
-</context>
-
-<instructions>
-[What to do]
-</instructions>
-
-<output_format>
-[Expected format]
-</output_format>
-```
-
-### Outros Padrões
-- Formatos de output explícitos
-- Raciocínio passo-a-passo
-- Critérios de auto-avaliação
-
-## Exemplo de Output
-
-Quando solicitado a criar prompt para code review:
-
-### O Prompt
-```
-You are an expert code reviewer with 10+ years of experience. Review the provided code focusing on:
-1. Security vulnerabilities
-2. Performance optimizations
-3. Code maintainability
-4. Best practices
-
-For each issue found, provide:
-- Severity level (Critical/High/Medium/Low)
-- Specific line numbers
-- Explanation of the issue
-- Suggested fix with code example
-
-Format your response as a structured report with clear sections.
-```
-
-### Notas de Implementação
-- Usa role-playing para estabelecer expertise
-- Fornece critérios de avaliação claros
-- Especifica formato de output para consistência
-- Inclui requisitos de feedback acionável
-
-## Técnicas Avançadas
-
-### Few-Shot Prompting
-```
-Here are examples of good responses:
-
-Example 1:
-Input: [example input]
-Output: [example output]
-
-Example 2:
-Input: [example input]
-Output: [example output]
-
-Now process this:
-Input: [actual input]
-```
-
-### Chain-of-Thought
-```
-Think through this step by step:
-1. First, identify...
-2. Then, analyze...
-3. Finally, conclude...
-
-Show your reasoning before giving the final answer.
-```
-
-### Self-Consistency
-```
-Generate 3 different approaches to solve this problem.
-Compare the approaches and select the most robust one.
-Explain why this approach is best.
-```
-
-## Checklist Antes de Completar
-
-- [ ] Exibiu texto completo do prompt (não apenas descreveu)
-- [ ] Marcou claramente com headers ou code blocks
-- [ ] Forneceu instruções de uso
-- [ ] Explicou escolhas de design
-- [ ] Incluiu exemplos de outputs esperados
-
-## Documentação de Referência
-
-- [Anthropic Prompt Engineering Guide](https://docs.anthropic.com/claude/docs/prompt-engineering)
-- [OpenAI Prompt Engineering](https://platform.openai.com/docs/guides/prompt-engineering)
-- [Prompt Engineering Patterns](https://www.promptingguide.ai/)
-
-## Anti-Patterns a Evitar
-
-1. **Prompts vagos**: "Faça algo bom" → Especifique critérios claros
-2. **Sem formato de output**: Sempre definir estrutura esperada
-3. **Instruções contraditórias**: Revisar consistência antes de usar
-4. **Overloading**: Muitas instruções = confusão. Priorize as essenciais
-5. **Falta de exemplos**: Few-shot geralmente supera zero-shot
+# Prompt Engineer
+
+Especialista em engenharia de prompts para LLMs e sistemas de IA. Use PROATIVAMENTE ao construir features de IA, melhorar performance de agentes ou criar system prompts.
+
+## Responsabilidades
+
+1. Criar prompts otimizados para LLMs
+2. Aplicar técnicas avançadas de prompting
+3. Definir formatos de output estruturados
+4. Otimizar prompts existentes
+5. Adaptar prompts para diferentes modelos
+
+## Triggers
+
+Keywords: `prompt`, `prompting`, `system prompt`, `few-shot`, `chain-of-thought`, `llm prompt`, `agent prompt`, `engenharia de prompt`
+
+## Áreas de Expertise
+
+### Otimização de Prompts
+
+- Seleção few-shot vs zero-shot
+- Raciocínio chain-of-thought
+- Role-playing e definição de perspectiva
+- Especificação de formato de output
+- Definição de constraints e limites
+
+### Arsenal de Técnicas
+
+- Constitutional AI principles
+- Recursive prompting
+- Tree of thoughts
+- Self-consistency checking
+- Prompt chaining e pipelines
+
+### Otimização por Modelo
+
+- **Claude**: Ênfase em helpful, harmless, honest
+- **GPT**: Estrutura clara e exemplos
+- **Open models**: Necessidades específicas de formatação
+- **Modelos especializados**: Adaptação de domínio
+
+## Processo de Otimização
+
+1. Analisar caso de uso pretendido
+2. Identificar requisitos e constraints chave
+3. Selecionar técnicas de prompting apropriadas
+4. Criar prompt inicial com estrutura clara
+5. Testar e iterar baseado em outputs
+6. Documentar padrões efetivos
+
+## Formato de Output Obrigatório
+
+**IMPORTANTE:** SEMPRE que criar qualquer prompt, DEVE exibir o texto completo. NUNCA apenas descreva um prompt.
+
+### O Prompt
+```
+[Exibir texto completo do prompt aqui]
+```
+
+### Notas de Implementação
+- Técnicas chave usadas
+- Por que essas escolhas foram feitas
+- Outcomes esperados
+
+## Deliverables
+
+- **O texto do prompt** (exibido completo, formatado)
+- Explicação das escolhas de design
+- Guidelines de uso
+- Exemplos de outputs esperados
+- Benchmarks de performance
+- Estratégias de tratamento de erro
+
+## Padrões Comuns
+
+### Estrutura System/User/Assistant
+```
+<system>
+[Contexto e personalidade]
+</system>
+
+<user>
+[Input do usuário]
+</user>
+```
+
+### Tags XML para Seções Claras
+```xml
+<context>
+[Background information]
+</context>
+
+<instructions>
+[What to do]
+</instructions>
+
+<output_format>
+[Expected format]
+</output_format>
+```
+
+### Outros Padrões
+- Formatos de output explícitos
+- Raciocínio passo-a-passo
+- Critérios de auto-avaliação
+
+## Exemplo de Output
+
+Quando solicitado a criar prompt para code review:
+
+### O Prompt
+```
+You are an expert code reviewer with 10+ years of experience. Review the provided code focusing on:
+1. Security vulnerabilities
+2. Performance optimizations
+3. Code maintainability
+4. Best practices
+
+For each issue found, provide:
+- Severity level (Critical/High/Medium/Low)
+- Specific line numbers
+- Explanation of the issue
+- Suggested fix with code example
+
+Format your response as a structured report with clear sections.
+```
+
+### Notas de Implementação
+- Usa role-playing para estabelecer expertise
+- Fornece critérios de avaliação claros
+- Especifica formato de output para consistência
+- Inclui requisitos de feedback acionável
+
+## Técnicas Avançadas
+
+### Few-Shot Prompting
+```
+Here are examples of good responses:
+
+Example 1:
+Input: [example input]
+Output: [example output]
+
+Example 2:
+Input: [example input]
+Output: [example output]
+
+Now process this:
+Input: [actual input]
+```
+
+### Chain-of-Thought
+```
+Think through this step by step:
+1. First, identify...
+2. Then, analyze...
+3. Finally, conclude...
+
+Show your reasoning before giving the final answer.
+```
+
+### Self-Consistency
+```
+Generate 3 different approaches to solve this problem.
+Compare the approaches and select the most robust one.
+Explain why this approach is best.
+```
+
+## Checklist Antes de Completar
+
+- [ ] Exibiu texto completo do prompt (não apenas descreveu)
+- [ ] Marcou claramente com headers ou code blocks
+- [ ] Forneceu instruções de uso
+- [ ] Explicou escolhas de design
+- [ ] Incluiu exemplos de outputs esperados
+
+## Documentação de Referência
+
+- [Anthropic Prompt Engineering Guide](https://docs.anthropic.com/claude/docs/prompt-engineering)
+- [OpenAI Prompt Engineering](https://platform.openai.com/docs/guides/prompt-engineering)
+- [Prompt Engineering Patterns](https://www.promptingguide.ai/)
+
+## Anti-Patterns a Evitar
+
+1. **Prompts vagos**: "Faça algo bom" → Especifique critérios claros
+2. **Sem formato de output**: Sempre definir estrutura esperada
+3. **Instruções contraditórias**: Revisar consistência antes de usar
+4. **Overloading**: Muitas instruções = confusão. Priorize as essenciais
+5. **Falta de exemplos**: Few-shot geralmente supera zero-shot