@polymorphism-tech/morph-spec 2.4.0 → 3.0.0

package/CLAUDE.md

@@ -30,10 +30,32 @@ Sistema de desenvolvimento orientado por especificações. Hub de agentes especi
 
 ---
 
-## AGENTES E SKILLS
+## AGENTES E SKILLS (v3.0 Hierarchical)
 
-**Agent** = Metadata em `.morph/config/agents.json` (quem sou, quando ativo)
-**Skill** = Implementação em `.claude/skills/{cat}/{id}.md` (como faço, prompts, workflows)
+**MORPH 3.0** usa arquitetura hierárquica de **4 tiers** com **30 agentes** organizados em **squads**:
+
+### Hierarquia (4 Tiers)
+
+**Tier 1: Orchestrators (3)** — Coordenação global
+- `standards-architect` — Chief Architect (Team Lead) — *sempre ativo*
+- `ai-system-architect` — AI/Agent Architect
+- `popm-advisor` — Product/Project Advisor (FASE 0-2 only)
+
+**Tier 2: Domain Leaders (3)** — Líderes de Squad
+- `dotnet-senior` — Backend Squad Leader — *sempre ativo*
+- `azure-architect` — Infrastructure Squad Leader — *sempre ativo*
+- `ui-designer` — UI/UX Squad Leader (FASE 1.5 only)
+
+**Tier 3: Specialists (23)** — Experts por domínio
+- **Backend Squad (10):** `ef-modeler`, `event-architect`, `api-designer`, `nosql-cache-expert`, `ddd-expert`, `hangfire-orchestrator`, `ms-agent-expert`, `asaas-financial`, `clerk-auth`, `resend-email`
+- **Frontend Squad (3):** `blazor-builder`, `nextjs-expert`, `css-specialist`
+- **Infrastructure Squad (5):** `bicep-architect`, `devops-engineer`, `container-specialist`, `observability-expert`, `azure-identity`
+- **Quality Squad (5):** `testing-specialist`, `code-analyzer`, `troubleshooting-expert`, `load-testing-expert`, `documentation-specialist`
+
+**Tier 4: Validators (1)** — Executam em hooks (não teammates)
+- `security-expert` — Valida em TeammateIdle/TaskCompleted hooks
+
+### Agent Detection & Activation
 
 **Workflow:** Keywords no input → `npx morph-spec detect-agents "{input}"` → retorna agent-ids → Claude ativa agentes → invoca Skills dos detectados
 
@@ -46,28 +68,39 @@ npx morph-spec validate-agents-skills                         # Validar consist
 
 Após detectar, registrar: `morph-spec state add-agent {feature} {agent-id}`
 
-### Agentes Disponíveis
-
-| Tipo | Agente | Keywords |
-|------|--------|----------|
-| **Core** | Standards Architect | *(sempre ativo)* |
-| **Core** | Azure Architect | *(sempre ativo)* |
-| **Core** | .NET Senior Engineer | *(sempre ativo)* — ultrathink mode |
-| **Stack** | Blazor Builder | blazor, razor, server-side |
-| **Stack** | NextJS Expert | nextjs, react, api, frontend |
-| **Specialist** | EF Modeler | entity, database, migration, ef core |
-| **Specialist** | Code Analyzer | analyze, review, refactor, clean code, smell, duplicate |
-| **Specialist** | Agent Framework Expert | agent, ai, llm, rag, embedding, workflow, orchestration, mcp, a2a, middleware |
-| **Specialist** | Hangfire Orchestrator | scheduled, job, background, cron |
-| **Specialist** | UI/UX Designer | tela, interface, dashboard, form, chart, wizard, blazor, ui, ux, page, component |
-| **Specialist** | PO/PM Advisor | unclear, requirements, priority, ROI |
-| **Integration** | Asaas Financial | asaas, payment, pix, boleto |
-| **Integration** | Clerk Auth | clerk, auth, login, signup |
-| **Integration** | Azure Identity | identity, entra, microsoft auth |
-| **Integration** | Resend Email | resend, email, transactional, notification |
-| **Infra** | Bicep Architect | bicep, iac, infra, provision |
-| **Infra** | DevOps Engineer | pipeline, ci/cd, deploy, release |
-| **Infra** | Container Specialist | docker, container, containerize |
+### Skills (5 Níveis)
+
+Skills organizados em **hierarquia de 5 níveis** em `content/.claude/skills/`:
+
+- **Level 0: Meta-Skills** — Orquestração high-level (morph-checklist, code-review)
+- **Level 1: Workflows** — Fases MORPH (phase-setup, phase-design, phase-uiux, etc.)
+- **Level 2: Domains** — Expertise por squad (backend/, frontend/, infrastructure/, quality/, ai-agents/, integrations/, architecture/)
+- **Level 3: Technologies** — Patterns específicos de tech (a serem populados)
+- **Level 4: Patterns** — Design patterns (CQRS, Event Sourcing, DDD — a serem populados)
+
+### Agent Teams (Claude Code Integration)
+
+Para **features complexas** (≥5 agentes, multi-domain, ≥15 arquivos), MORPH pode usar **Agent Teams** (Claude Code experimental feature) para execução paralela:
+
+**Quando usar Agent Teams:**
+- ✅ Features high/critical complexity
+- ✅ Multi-domain (backend + frontend + infra)
+- ✅ 3+ módulos independentes
+- ✅ 5+ specialists ativos
+- ❌ NUNCA para trivial/low complexity
+
+**Como funciona:**
+1. `team-orchestrator.js` detecta necessidade de Team
+2. Constrói hierarquia: Team Lead (delegate mode) → Domain Leaders → Specialists
+3. Spawna teammates com prompts hierárquicos
+4. Team Lead coordena, Domain Leaders gerenciam squads, Specialists implementam
+5. Validators rodam em hooks (TeammateIdle, TaskCompleted)
+
+**Enable:** `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` in `settings.local.json`
+
+**Display modes:** `auto` (tmux se disponível) | `in-process` (Shift+Up/Down) | `tmux` (split panes)
+
+**Detalhes:** Ver `framework/standards/agent-teams-workflow.md`
 
 ---
 
@@ -173,6 +206,105 @@ Qual prefere?
 
 ---
 
+## STANDARDS ENFORCEMENT PIPELINE
+
+MORPH 3.0 possui pipeline completo de enforcement automático (Fases 1-6) que garante qualidade e conformidade sem intervenção manual.
+
+### Pipeline Data-Driven
+
+**Fonte única de verdade:**
+- `agents.json` → Mapping agente→validators (27/30 agentes configurados)
+- `framework/standards/` → Padrões C# otimizados (23% token reduction)
+- `decisions.md` → Constraints arquiteturais (flow para validators)
+- `state.json` → Agentes ativos (determina validators executados)
+
+### 3 Níveis de Enforcement
+
+**1. Soft (Context Injection)**
+- Standards automaticamente carregados para agentes via `detect-agents --json`
+- 55k+ caracteres de standards por agente
+- Inclui: coding, architecture, blazor-*, css-*, agent-framework-*
+- Sem compressão (200k context window disponível)
+
+**2. Medium (Validation)**
+- Validators detectam violações e mostram warnings
+- Executam em `morph-spec task done` ANTES de marcar task completo
+- 7 validators disponíveis: architecture, packages, blazor, blazor-concurrency, blazor-state, css, design-system
+- Resultados por-validator + summary consolidado
+
+**3. Hard (Gates)**
+- `advance-phase` bloqueia avanço em falhas críticas:
+  - **Spec Gate:** Bloqueia design → clarify/tasks se contracts.cs tem violações C#
+  - **Design System Gate:** Bloqueia tasks → implement se UI agents ativos sem design system
+- Gates fornecem mensagens de erro acionáveis + soluções
+
+### Validações Automáticas
+
+**Spec Validator (FASE 2):**
+- ❌ UPPER_SNAKE_CASE em constants (deve ser PascalCase)
+- ❌ Async methods sem CancellationToken parameter
+- ❌ Methods retornando Task sem sufixo `Async`
+- ⚠️ Classes não-sealed (warning)
+- ⚠️ DTOs como class em vez de record (warning)
+
+**Design System Validator (FASE 5):**
+- ❌ Hardcoded colors fora da palette do design system
+- ❌ Inline styles em arquivos .razor
+- Valida contra 4 níveis: feature-output > project-markdown > generated-css > existing-css-variables
+
+**Contract Compliance (FASE 5):**
+- Valida que código implementado segue contracts.cs
+- Checa interfaces declaradas vs implementadas
+- Detecta métodos faltantes ou assinaturas incorretas
+
+### Decision Constraints (ADR-Driven)
+
+Ao documentar decisão em `decisions.md`, validators ajustam automaticamente:
+
+```markdown
+## ADR-001: UI Library Choice
+**Status:** Accepted
+**Decision:** Use Fluent UI Blazor
+```
+
+→ Validator `blazor` recebe `{ uiLib: "fluent" }` → valida patterns Fluent-specific
+
+```markdown
+## ADR-002: Architecture Pattern
+**Status:** Accepted
+**Decision:** Implement CQRS pattern
+```
+
+→ Validator `architecture` recebe `{ pattern: "cqrs" }` → checa Commands/Queries/Handlers
+
+### Comandos de Validação
+
+```bash
+# Auto-execução (integrado ao workflow)
+morph-spec task done {feature} {task-id}          # Validators rodam automaticamente
+morph-spec phase advance {feature}                # Gates checam pré-requisitos
+
+# Manual (troubleshooting)
+morph-spec validate {feature}                     # Rodar todos validators
+morph-spec validate {feature} --validator=blazor  # Validator específico
+morph-spec validate {feature} --verbose           # Output detalhado
+```
+
+### Bypass de Emergência
+
+**NUNCA use sem autorização explícita do usuário:**
+```bash
+morph-spec task done {feature} {task-id} --skip-validation  # Emergências APENAS
+morph-spec phase advance {feature} --skip-warnings          # Ignora warnings (não errors)
+```
+
+**Quando permitido:**
+- Deploy urgente de hotfix crítico
+- Validator com bug conhecido (registrar issue)
+- Usuário aprovou explicitamente bypass temporário
+
+---
+
 ## QUANDO NÃO USAR MORPH
 
 | Não usar MORPH | Sempre usar MORPH |
@@ -292,7 +424,7 @@ morph-spec state get {feature}                           # Detalhes
 ## REFERÊNCIAS
 
 ### Standards (framework/standards/)
-`coding.md` | `architecture.md` | `azure.md` | `agent-framework-setup.md` | `agent-framework-workflows.md` | `agent-framework-production.md` | `agent-framework-blazor-ui.md` | `passkeys-auth.md` | `vector-search-rag.md` | `dotnet10-migration.md` | `fluent-ui-blazor.md` | `migration-guide.md`
+`coding.md` | `architecture.md` | `azure.md` | `agent-framework-setup.md` | `agent-framework-workflows.md` | `agent-framework-production.md` | `agent-framework-blazor-ui.md` | `agent-teams-workflow.md` | `passkeys-auth.md` | `vector-search-rag.md` | `dotnet10-migration.md` | `fluent-ui-blazor.md` | `migration-guide.md`
 
 ### Templates
 - `content/.morph/templates/` - Source (NPM package)

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