@polymorphism-tech/morph-spec 3.0.1 → 3.2.0

package/LICENSE

@@ -1,72 +1,72 @@
-Proprietary License
-
-Copyright (c) 2024-2025 Polymorphism Tech
-All rights reserved.
-
-MORPH-SPEC Framework - Proprietary Software License
-
-1. GRANT OF LICENSE
-
-Subject to the terms and conditions of this License, Polymorphism Tech ("Licensor")
-grants you a limited, non-exclusive, non-transferable license to:
-
-a) Install and use the MORPH-SPEC CLI tool for personal or commercial projects
-b) Use the generated templates and code in your own projects
-c) Modify generated code for your specific use cases
-
-2. RESTRICTIONS
-
-You may NOT:
-
-a) Redistribute, sell, lease, or sublicense the MORPH-SPEC framework itself
-b) Modify, decompile, reverse engineer, or create derivative works of the framework
-c) Remove or modify any copyright notices or proprietary markings
-d) Use the framework to create competing products or services
-e) Publicly fork or redistribute the source code
-f) Share access credentials to private repositories
-
-3. OWNERSHIP
-
-The MORPH-SPEC framework, including all code, documentation, templates, and
-associated materials, remains the exclusive property of Polymorphism Tech.
-
-4. GENERATED CODE
-
-Code and projects generated using MORPH-SPEC are yours to use, modify, and
-distribute as you see fit, including commercial use.
-
-5. SUPPORT AND UPDATES
-
-- CLI tool updates are provided via npm registry
-- Support is available at: support@polymorphism.tech
-- Documentation updates are included with each release
-
-6. WARRANTY DISCLAIMER
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-
-7. LIMITATION OF LIABILITY
-
-IN NO EVENT SHALL POLYMORPHISM TECH BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-8. TERMINATION
-
-This license is effective until terminated. Your rights under this license will
-terminate automatically without notice if you fail to comply with any term of
-this license.
-
-9. CONTACT
-
-For licensing inquiries, custom licenses, or commercial support:
-Email: contact@polymorphism.com.br
-Website: https://polymorphism.com.br
-
----
-
-MORPH-SPEC v2.0.0
-by Polymorphism Tech
+Proprietary License
+
+Copyright (c) 2024-2025 Polymorphism Tech
+All rights reserved.
+
+MORPH-SPEC Framework - Proprietary Software License
+
+1. GRANT OF LICENSE
+
+Subject to the terms and conditions of this License, Polymorphism Tech ("Licensor")
+grants you a limited, non-exclusive, non-transferable license to:
+
+a) Install and use the MORPH-SPEC CLI tool for personal or commercial projects
+b) Use the generated templates and code in your own projects
+c) Modify generated code for your specific use cases
+
+2. RESTRICTIONS
+
+You may NOT:
+
+a) Redistribute, sell, lease, or sublicense the MORPH-SPEC framework itself
+b) Modify, decompile, reverse engineer, or create derivative works of the framework
+c) Remove or modify any copyright notices or proprietary markings
+d) Use the framework to create competing products or services
+e) Publicly fork or redistribute the source code
+f) Share access credentials to private repositories
+
+3. OWNERSHIP
+
+The MORPH-SPEC framework, including all code, documentation, templates, and
+associated materials, remains the exclusive property of Polymorphism Tech.
+
+4. GENERATED CODE
+
+Code and projects generated using MORPH-SPEC are yours to use, modify, and
+distribute as you see fit, including commercial use.
+
+5. SUPPORT AND UPDATES
+
+- CLI tool updates are provided via npm registry
+- Support is available at: support@polymorphism.tech
+- Documentation updates are included with each release
+
+6. WARRANTY DISCLAIMER
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+7. LIMITATION OF LIABILITY
+
+IN NO EVENT SHALL POLYMORPHISM TECH BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+8. TERMINATION
+
+This license is effective until terminated. Your rights under this license will
+terminate automatically without notice if you fail to comply with any term of
+this license.
+
+9. CONTACT
+
+For licensing inquiries, custom licenses, or commercial support:
+Email: contact@polymorphism.com.br
+Website: https://polymorphism.com.br
+
+---
+
+MORPH-SPEC v2.0.0
+by Polymorphism Tech

package/README.md

@@ -1,7 +1,7 @@
 <h1 align="center">MORPH-SPEC</h1>
 
 <p align="center">
-  <strong>Desenvolvimento orientado por especificações com agentes AI</strong><br>
+  <strong>Framework de desenvolvimento spec-driven com 30 agentes AI especializados</strong><br>
   <em>by Polymorphism Tech</em>
 </p>
 
@@ -20,7 +20,7 @@
 </p>
 
 <p align="center">
-  <strong>📚 Guias de Uso:</strong>
+  <strong>Guias de Uso:</strong>
   <a href="QUICKSTART.md">Quick Start</a> •
   <a href="CHEATSHEET.md">Cheat Sheet</a> •
   <a href="docs/README.md">API Docs</a>
@@ -32,11 +32,80 @@
 
 **M**ethodical **O**rchestration for **R**eliable **P**roduction-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.
+MORPH-SPEC é um framework de desenvolvimento orientado por especificações com **30 agentes AI especializados** organizados em 4 tiers hierárquicos. 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)
+**Stacks suportadas:** .NET 10/Blazor, .NET 10/Next.js, Node.js, Monorepos
+**Infraestrutura:** Azure Bicep (IaC) + Docker
 **Ferramenta:** Claude Code
+**Validação:** Pipeline automático de enforcement com gates por fase
+**Auto-Detecção:** ✨ LLM-powered context detection (v3.1+)
+
+---
+
+## 🚀 Novidade v3.0: LLM Interaction Enhancements
+
+MORPH-SPEC v3.0 torna o framework **explícito e orientado** para Claude Code com 8 melhorias fundamentais:
+
+### 1. **Approval Gates** (Portões de Aprovação)
+- ✅ Rastreamento explícito de aprovações em `state.json`
+- 🚫 Bloqueio de transições de fase até aprovação explícita
+- 📝 Comandos: `approve`, `reject`, `approval-status`
+
+### 2. **Checkpoint Automation** (Validação Automática)
+- 🔍 Auto-validação a cada 3 tasks (T003, T006, T009...)
+- 🛡️ 4 validators: architecture, packages, security, design-system
+- 🚧 Bloqueia progresso se falhas detectadas
+
+### 3. **Stricter Phase Validation** (Validação Estrita)
+- 🎯 State machine com transições válidas
+- 📋 Validação de conteúdo (spec.md, tasks.json)
+- 5️⃣ Sistema de 5 gates de validação
+
+### 4. **Agent Team Spawning** (Spawning de Agentes)
+- 🤖 Detecção automática quando spawnar (5+ agents, 15+ files, multi-domain)
+- 🏗️ Comando `spawn-team` gera configs para Task tool
+- 📄 Templates prontos para agent context
+
+### 5. **Metadata Generation** (Geração de Metadados)
+- 📊 Auto-gera `metadata.json` após cada task
+- ⚡ Reduz uso de tokens em 60-80%
+- 🔗 Links rápidos para spec, tasks, decisões
+
+### 6. **Learning System** (Sistema de Aprendizado)
+- 📚 11 patterns pré-configurados (389 linhas)
+- 🔎 Busca: `search-patterns "{keyword}"`
+- 📝 Captura: `capture-pattern {feature} success "Description"`
+
+### 7. **MCP Template Enhancement** (Templates Dinâmicos)
+- 🌐 17 placeholders com dados do projeto
+- 📈 Injeta: files, coverage, compliance, commits
+- 🎨 Templates: `proposal-with-mcp.md`, `spec-with-mcp.md`
+
+### 8. **Interactive Decisions** (Decisões Estruturadas)
+- 💬 Templates para AskUserQuestion
+- 🎯 6 padrões documentados (scope, architecture, validation, etc.)
+- 📖 Guia completo em `.morph/templates/decision-prompts.md`
+
+**Configuração:** `.morph/config/llm-interaction.json` com 3 presets (strict, lightweight, no-guardrails)
+
+**Documentação:** [docs/llm-interaction-config.md](docs/llm-interaction-config.md)
+
+**Migration:** `npx morph-spec upgrade --preset strict`
+
+---
+
+## ✨ Novidade v3.1: Auto-Detecção Inteligente
+
+MORPH-SPEC agora **detecta automaticamente** o contexto do seu projeto usando Claude Code:
+
+- 🤖 **LLM Analysis**: Analisa package.json, .csproj, README, estrutura de pastas
+- 🎯 **90%+ Accuracy**: Few-shot learning com exemplos reais (Next.js, Blazor, Monorepo)
+- 🔒 **Privacy-First**: Processamento local, zero chamadas externas de API
+- 🛡️ **Secret Sanitization**: Redação automática de API keys, passwords, tokens
+- 🧙 **Wizard Fallback**: Wizard interativo de 7 perguntas se LLM falhar
+- ⚡ **Zero Manual Work**: Gera `.morph/project.md` e `config.json` em segundos
+
+**Saiba mais:** [docs/cli-auto-detection.md](docs/cli-auto-detection.md)
 
 ---
 
@@ -67,7 +136,7 @@ morph-spec init
 ```
 
 <details>
-<summary><strong>⚠️ Windows + nvm-windows: Comando não reconhecido?</strong></summary>
+<summary><strong>Windows + nvm-windows: Comando não reconhecido?</strong></summary>
 
 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](https://github.com/coreybutler/nvm-windows/issues/391).
 
@@ -115,13 +184,19 @@ Veja também: [Troubleshooting](#troubleshooting)
 
 | Comando | Descrição |
 |---------|-----------|
-| `morph-spec init` | Inicializa MORPH no diretório atual |
+| `morph-spec init` | Inicializa MORPH e **detecta automaticamente** o contexto do projeto ✨ |
+| `morph-spec init --wizard` | Inicializa com wizard manual (sem auto-detecção LLM) |
+| `morph-spec init --skip-detection` | Inicializa sem detectar contexto (configuração manual) |
 | `morph-spec init --force` | Sobrescreve instalação existente |
-| `morph-spec update` | Atualiza projeto para versão mais recente |
+| `morph-spec update` | Atualiza projeto e **re-analisa contexto** automaticamente ✨ |
+| `morph-spec update --wizard` | Atualiza com wizard manual |
+| `morph-spec update --skip-detection` | Atualiza sem re-analisar contexto |
 | `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 |
 
+> ✨ **Novo em v3.1+:** Auto-detecção inteligente de stack, arquitetura e infraestrutura usando Claude Code!
+
 ### Verificar Instalação
 
 ```bash
@@ -129,9 +204,9 @@ 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
+- 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:
 ```
@@ -171,12 +246,12 @@ npx @polymorphism-tech/morph-spec@latest update
 ### 3. O que é atualizado?
 
 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)
+- 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!
 
@@ -209,7 +284,7 @@ Revise os arquivos gerados e aprove (ou peça ajustes).
 /morph-apply minha-feature
 ```
 
-O MORPH implementa task por task, com testes a cada etapa.
+O MORPH implementa task por task, com validação automática a cada etapa.
 
 ### 5. Arquivar
 
@@ -225,74 +300,191 @@ Move a feature concluída para o arquivo.
 
 ```
 ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
-│  SETUP   │ ─▶ │  DESIGN  │ ─▶ │ CLARIFY  │ ─▶ │  TASKS   │ ─▶ │IMPLEMENT │
+│ PROPOSAL │ -> │  DESIGN  │ -> │ CLARIFY  │ -> │  TASKS   │ -> │IMPLEMENT │
 │          │    │          │    │          │    │          │    │          │
 │ Contexto │    │  Spec +  │    │  Q&A +   │    │  Quebra  │    │ Executa  │
-│ + Agents │    │Contracts │    │  Edges   │    │  Tasks   │    │ + Testa  │
+│ + Agents │    │Contracts │    │  Edges   │    │  Tasks   │    │ + Valida │
 └──────────┘    └──────────┘    └──────────┘    └──────────┘    └──────────┘
-                     ⛔                              ⛔
-                  Aprovação                       Aprovação
+                     |                               |              |
+                 Spec Gate                    Design System     Validation
+                (C# checks)                     Gate          Pipeline
 ```
 
 **Pontos de aprovação:** O MORPH para em 2 momentos para você revisar antes de continuar.
 
+**Gates de validação (v3):**
+- **Spec Gate** (Design -> Clarify): Valida contratos C# — CancellationToken, PascalCase, async suffix, sealed classes, records para DTOs
+- **Design System Gate** (Tasks -> Implement): Bloqueia se features de UI não tiverem design system definido
+- **Validation Pipeline** (cada task done): Roda validators baseados nos agentes ativos da feature
+
 ---
 
-## Comandos Claude Code
+## Novidades v3 — Validation Pipeline
+
+O v3 transforma MORPH de ferramentas isoladas em um **pipeline integrado de validação**:
+
+| Feature | O que faz | Comando |
+|---------|-----------|---------|
+| **Validation Pipeline** | Roda validators automaticamente ao completar tasks | `morph-spec task done` |
+| **Standards Injection** | Carrega standards relevantes por agente automaticamente | `morph-spec detect-agents --json` |
+| **Design System Gate** | Bloqueia FASE 5 se features UI não tiverem design system | `morph-spec phase advance` |
+| **Spec Validation** | Valida contratos C# na FASE 2, antes de implementar | `morph-spec phase advance` |
+| **Decision Constraints** | ADRs em decisions.md configuram validators automaticamente | Automático |
+| **Auto Recap** | Gera recap.md a partir de dados reais do projeto | `morph-spec generate recap` |
+| **Smart Phase Advance** | Avança fases com gates de validação obrigatórios | `morph-spec phase advance` |
+
+**Fluxo de dados:**
+```
+agents.json (30 agentes)
+    |-> detect-agents -> state.json (agentes ativos)
+    |-> standards-context-injector -> standards por agente
+    |-> validation-runner -> validators por agente
+decisions.md (ADRs)
+    |-> decision-constraint-loader -> constraints para validators
+```
+
+---
+
+## Comandos
+
+### Claude Code (Slash Commands)
 
 | Comando | Descrição |
 |---------|-----------|
-| `/morph-proposal <nome>` | Cria nova feature |
-| `/morph-apply <nome>` | Implementa feature aprovada |
+| `/morph-proposal <nome>` | Cria nova feature (fases 0-4 com pausas) |
+| `/morph-apply <nome>` | Implementa feature aprovada (fase 5) |
 | `/morph-status` | Mostra status do projeto |
 | `/morph-archive <nome>` | Arquiva feature concluída |
 | `/morph-infra <ação>` | Gerencia infraestrutura (init, validate, deploy) |
-| `/morph-costs` | Estima custos Azure |
+| `/morph-preflight` | Validação pre-deploy Azure |
+| `/morph-troubleshoot <erro>` | Busca soluções para erros |
+
+### CLI Completo
+
+| Comando | Descrição |
+|---------|-----------|
+| **Setup** | |
+| `morph-spec init` | Inicializa MORPH no diretório |
+| `morph-spec update` | Atualiza para versão mais recente |
+| `morph-spec doctor` | Verifica saúde da instalação |
+| `morph-spec detect` | Detecta stack, arquitetura, patterns |
+| `morph-spec detect-agents <input>` | Detecta agentes + complexidade + standards |
+| **Fases e Tasks** | |
+| `morph-spec phase advance <feature>` | Avança fase com gates de validação |
+| `morph-spec validate-phase <feature> <phase>` | Valida pré-requisitos de uma fase |
+| `morph-spec task done <feature> <ids>` | Completa tasks (roda validação antes) |
+| `morph-spec task start <feature> <id>` | Marca task como in_progress |
+| `morph-spec task next <feature>` | Mostra próxima task sugerida |
+| `morph-spec rollback <feature> <phase>` | Rollback para fase anterior |
+| **Geração** | |
+| `morph-spec generate design-system <md>` | Gera CSS + temas C# de ui-design-system.md |
+| `morph-spec generate recap <feature>` | Gera recap.md automático |
+| `morph-spec generate context [feature]` | Gera CONTEXT.md para Claude Code |
+| **Validação** | |
+| `morph-spec validate [validator]` | Validação de código (packages, architecture, contrast) |
+| `morph-spec validate-blazor [path]` | Valida patterns Fluent UI Blazor |
+| `morph-spec validate-blazor-state [path]` | Valida session state Blazor |
+| `morph-spec validate-css [path]` | Valida classes CSS em Razor files |
+| `morph-spec analyze-blazor-concurrency [path]` | Detecta concurrency issues em DbContext |
+| `morph-spec lint-fluent [path]` | Lint de patterns Fluent UI |
+| **State** | |
+| `morph-spec state list` | Lista todas as features |
+| `morph-spec state get <feature>` | Detalhes de uma feature |
+| `morph-spec state set <feature> <key> <value>` | Atualiza propriedade |
+| `morph-spec state checkpoint <feature> "nota"` | Cria checkpoint |
+| **Story-Driven** | |
+| `morph-spec story create <feature> <id>` | Cria story com Dev Notes |
+| `morph-spec story shard <feature>` | Divide spec em shards (90% token savings) |
+| `morph-spec story status <feature> <action>` | Gerencia sprint status |
+| **Learning** | |
+| `morph-spec learn analyze` | Aprende com histórico do projeto |
+| `morph-spec learn insights` | Mostra patterns aprendidos |
+| `morph-spec learn suggest [category]` | Sugestões por categoria |
+| **Outros** | |
+| `morph-spec troubleshoot <keywords>` | Busca soluções para erros |
+| `morph-spec session-summary <feature>` | Resumo da sessão atual |
+| `morph-spec sync` | Sincroniza standards de decisions |
 
 ---
 
 ## Agentes
 
-### Sempre Ativos
+MORPH-SPEC possui **30 agentes** organizados em 4 tiers hierárquicos com squads:
+
+### Tier 1 — Orchestrators (3)
+
+| Agente | Função | Ativação |
+|--------|--------|----------|
+| **Standards Architect** | Chief Architect, padrões e consistência | Sempre ativo |
+| **AI System Architect** | Arquitetura de sistemas multi-agente | Por keyword |
+| **PO/PM Advisor** | Requisitos, ROI, business value | Por keyword |
+
+### Tier 2 — Domain Leaders (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 |
+| Agente | Squad | Ativação |
+|--------|-------|----------|
+| **Dotnet Senior** | Backend (10 specialists) | Sempre ativo |
+| **Azure Architect** | Infraestrutura (5 specialists) | Sempre ativo |
+| **UI/UX Designer** | Frontend (3 specialists) | Por keyword |
 
-### Por Stack
+### Tier 3 — Specialists (23)
+
+<details>
+<summary><strong>Backend Squad (10)</strong></summary>
 
 | Agente | Keywords |
 |--------|----------|
-| 🔥 **Blazor Builder** | blazor, razor, component |
-| ⚛️ **NextJS Expert** | nextjs, react, frontend |
+| **EF Modeler** | database, entity, migration, ef core |
+| **Event Architect** | event, service bus, cqrs, real-time |
+| **API Designer** | rest, graphql, grpc, openapi |
+| **NoSQL/Cache Expert** | cosmos, redis, cache, blob storage |
+| **DDD Expert** | ddd, aggregate, bounded context |
+| **Hangfire Orchestrator** | scheduled, job, background, cron |
+| **MS Agent Expert** | agent, ai, microsoft agent framework, mcp, a2a |
+| **Asaas Financial** | asaas, pix, boleto, payment |
+| **Clerk Auth** | clerk, login, signup, oauth |
+| **Resend Email** | resend, email, transactional email |
+</details>
 
-### Especialistas
+<details>
+<summary><strong>Frontend Squad (3)</strong></summary>
 
 | 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 |
+| **Blazor Builder** | blazor, razor, component, fluent ui |
+| **NextJS Expert** | nextjs, react, shadcn, server actions |
+| **CSS Specialist** | css, design system, theme, design tokens |
+</details>
 
-### Integrações
+<details>
+<summary><strong>Infrastructure Squad (5)</strong></summary>
 
 | Agente | Keywords |
 |--------|----------|
-| 💳 **Asaas Financial** | asaas, pix, boleto, payment |
-| 🔐 **Clerk Auth** | clerk, auth, login |
-| 🆔 **Azure Identity** | identity, entra, microsoft auth |
+| **Bicep Architect** | bicep, iac, infra, provision |
+| **DevOps Engineer** | pipeline, ci/cd, deploy, github actions |
+| **Container Specialist** | docker, container, container apps |
+| **Observability Expert** | monitoring, logging, tracing, app insights |
+| **Azure Identity** | identity, entra, passkeys, managed identity |
+</details>
 
-### Infraestrutura
+<details>
+<summary><strong>Quality Squad (5)</strong></summary>
 
 | Agente | Keywords |
 |--------|----------|
-| 🏗️ **Bicep Architect** | bicep, iac, infra |
-| 🚀 **DevOps Engineer** | pipeline, ci/cd, deploy |
-| 📦 **Container Specialist** | docker, container |
+| **Testing Specialist** | test, unit, integration, e2e, xunit, bunit |
+| **Code Analyzer** | analyze, review, refactor, clean code, solid |
+| **Troubleshooting Expert** | debug, troubleshoot, root cause, diagnose |
+| **Load Testing Expert** | load test, k6, stress test, scalability |
+| **Documentation Specialist** | readme, api docs, deployment guide |
+</details>
+
+### Tier 4 — Validators (1)
+
+| Agente | Função | Ativação |
+|--------|--------|----------|
+| **Security Expert** | SQL injection, XSS, secrets, CSRF | Sempre ativo (hooks) |
 
 ---
 
@@ -300,9 +492,9 @@ Move a feature concluída para o arquivo.
 
 | Exemplo | Descrição |
 |---------|-----------|
-| [micro-saas](content/.morph/examples/micro-saas/) | SaaS completo com Blazor + Asaas billing |
-| [api-nextjs](content/.morph/examples/api-nextjs/) | .NET API + Next.js frontend |
-| [multi-agent](content/.morph/examples/multi-agent/) | Sistema multi-agente com Semantic Kernel |
+| [micro-saas](stacks/blazor-azure/.morph/examples/micro-saas/) | SaaS completo com Blazor + Asaas billing |
+| [api-nextjs](stacks/blazor-azure/.morph/examples/api-nextjs/) | .NET API + Next.js frontend |
+| [multi-agent](stacks/blazor-azure/.morph/examples/multi-agent/) | Sistema multi-agente com Microsoft Agent Framework |
 
 Cada exemplo inclui: `README.md`, `spec.md`, `contracts.cs`, `tasks.md`, `decisions.md`
 
@@ -318,11 +510,15 @@ seu-projeto/
 ├── .morph/
 │   ├── config/               # Configurações
 │   │   ├── config.json
-│   │   └── agents.json
-│   ├── standards/            # Padrões de código
+│   │   └── agents.json       # 30 agentes em 4 tiers
+│   ├── standards/            # Padrões de código (26 arquivos)
 │   │   ├── coding.md
 │   │   ├── architecture.md
-│   │   └── azure.md
+│   │   ├── azure.md
+│   │   ├── blazor-*.md       # Lifecycle, state, pitfalls, EF Core
+│   │   ├── css-*.md          # Naming, animations
+│   │   ├── agent-framework-*.md  # Setup, workflows, production, blazor-ui
+│   │   └── ...
 │   ├── templates/            # Templates de código e IaC
 │   │   ├── infra/
 │   │   ├── integrations/
@@ -332,7 +528,7 @@ seu-projeto/
 │   └── archive/              # Features concluídas
 └── .claude/
     ├── commands/             # Slash commands
-    └── skills/               # Skills dos agentes
+    └── skills/               # Skills dos agentes (31+ arquivos)
 ```
 
 ---
@@ -365,7 +561,7 @@ O MORPH segue a filosofia **"Free tier first"**:
 
 ---
 
-## 🔧 Troubleshooting
+## Troubleshooting
 
 ### Comando `morph-spec` não encontrado
 
@@ -409,10 +605,10 @@ morph-spec --version
 ### `morph-spec doctor` reporta problemas
 
 **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.)
+- 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)
@@ -465,12 +661,12 @@ morph-spec <comando> --help  # Ajuda de comando específico
 ```
 
 **Suporte:**
-- 📧 Email: support@polymorphism.com.br
-- 🐛 Issues: [GitHub](https://github.com/lucasPolymorphism/morph-spec-framework/issues)
+- Email: support@polymorphism.com.br
+- Issues: [GitHub](https://github.com/lucasPolymorphism/morph-spec-framework/issues)
 
 ---
 
-## 📄 Licença e Distribuição
+## Licença e Distribuição
 
 **Repositório:** Privado (código fonte protegido)
 **Package npm:** Público e gratuito via `@polymorphism-tech/morph-spec`
@@ -480,16 +676,16 @@ morph-spec <comando> --help  # Ajuda de comando específico
 O MORPH-SPEC framework é software proprietário da Polymorphism Tech. Veja [LICENSE](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
+- 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
+- Redistribuir ou vender o framework
+- Criar produtos derivados competidores
+- Modificar ou fazer engenharia reversa do framework
+- Remover avisos de copyright
 
 ### Código Gerado
 
@@ -497,18 +693,18 @@ Todo código gerado usando MORPH-SPEC é **100% seu** para usar como quiser, inc
 
 ### Suporte
 
-- 📧 Email: support@polymorphism.com.br
-- 🌐 Website: https://polymorphism.com.br
-- 📦 npm: [@polymorphism-tech/morph-spec](https://www.npmjs.com/package/@polymorphism-tech/morph-spec)
+- Email: support@polymorphism.com.br
+- Website: https://polymorphism.com.br
+- npm: [@polymorphism-tech/morph-spec](https://www.npmjs.com/package/@polymorphism-tech/morph-spec)
 
 ---
 
 ## Links
 
-- 📦 [npm Package](https://www.npmjs.com/package/@polymorphism-tech/morph-spec)
-- 📚 [Documentação](docs/)
-- 💡 [Exemplos](content/.morph/examples/)
-- 🌐 [Polymorphism Tech](https://polymorphism.com.br)
+- [npm Package](https://www.npmjs.com/package/@polymorphism-tech/morph-spec)
+- [Documentação](docs/)
+- [Exemplos](stacks/blazor-azure/.morph/examples/)
+- [Polymorphism Tech](https://polymorphism.com.br)
 
 ---