@polymorphism-tech/morph-spec 2.4.0 → 3.0.1

package/CLAUDE.md

@@ -1,6 +1,4 @@
-# MORPH-SPEC - Instruções para Claude Code
-
-**M**ethodical **O**rchestration for **R**eliable **P**roduction-ready **SPEC**-driven development
+# MORPH-SPEC - Instruções para Claude Code (Consumer)
 
 > by Polymorphism Tech
 
@@ -13,179 +11,75 @@ Sistema de desenvolvimento orientado por especificações. Hub de agentes especi
 ### NUNCA:
 - Pular direto para código sem especificação
 - Implementar sem aprovação do design
-- Ignorar os padrões (framework/standards/ ou project/standards/)
-- Criar recursos Azure manualmente no portal (use Bicep)
+- Ignorar padrões em `.morph/standards/`
+- Criar recursos Azure manualmente (use Bicep)
 - Gerar código sem contracts definidos
-- **Tomar decisões técnicas sozinho (infraestrutura, bibliotecas, patterns, schemas)**
 
 ### SEMPRE:
-- Seguir workflow adequado à complexidade (ver WORKFLOWS)
-- Gerar outputs em `.morph/project/outputs/{feature}/`
+- Seguir as 5 fases obrigatórias
+- Gerar outputs em `.morph/features/{feature}/`
 - Documentar decisões em `decisions.md`
 - Checkpoint a cada 3 tasks implementadas
 - Usar Infrastructure as Code (Bicep)
-- Usar exclusivamente Microsoft Agent Framework (.NET 10)
-- Coletar input do usuário na FASE 1.5 (layout, referências, imagens)
-- **Consultar usuário em DECISION POINTS**
 
 ---
 
-## AGENTES E SKILLS
-
-**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)
-
-**Workflow:** Keywords no input → `npx morph-spec detect-agents "{input}"` → retorna agent-ids → Claude ativa agentes → invoca Skills dos detectados
-
-```bash
-npx morph-spec detect-agents "implementar jobs agendados"    # Detectar agentes por keywords
-npx morph-spec detect-agents --verbose "criar dashboard"      # Ver matches detalhados
-npx morph-spec detect                                         # Detectar stack/arquitetura do projeto
-npx morph-spec validate-agents-skills                         # Validar consistência
-```
+## WORKFLOW (5 Fases)
 
-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 |
+| Fase | Gatilho | Ações | Output | Pausa? |
+|------|---------|-------|--------|--------|
+| **1. SETUP** | Feature request | Ler project.md, identificar stack, ativar agentes, criar pasta | proposal.md | Não |
+| **2. DESIGN** | Setup concluído | Spec + contracts + decisions + custos + Bicep | spec.md, contracts.cs, decisions.md | **Sim** |
+| **3. CLARIFY** | Design aprovado | Ambiguidades, perguntas, edge cases | Spec atualizado | Não |
+| **4. TASKS** | Clarificações resolvidas | Quebrar em tasks, ordem, checkpoints, dependências | tasks.md | **Sim** |
+| **5. IMPLEMENT** | Tasks aprovadas | Task por task, checkpoint a cada 3, recap | Código + recap.md | Não |
 
 ---
 
-## WORKFLOWS POR COMPLEXIDADE
-
-O MORPH-SPEC detecta automaticamente a complexidade via `src/lib/complexity-analyzer.js`. Override: `[FAST-TRACK]` ou `[FULL-MORPH]` no pedido.
-
-| Aspecto | Fast Track | Standard | Full MORPH | UI Refresh | Design Impl |
-|---------|-----------|----------|------------|------------|-------------|
-| **Quando** | Bug fixes, ajustes | Features simples | Features complexas | Redesign visual | Prototipo → Codigo |
-| **Arquivos** | ≤ 3 | 3-10 | > 10 | CSS + .razor | .html → .razor |
-| **Fases** | 2 | 4 | 9 (todas) | 3 | 3 |
-| **Pausas** | 1 | 2-3 | 5-6 | 2 | 2 |
-| **Outputs** | Nenhum | proposal, spec, recap | Todos (9+) | checklist, CSS, recap | recap, CSS |
-
-**Detalhes de cada workflow:** Ler `content/.morph/docs/workflows/` para fases completas.
-
-**Keywords de detecção:**
-- **Trivial:** bug, fix, corrigir, ajustar, hotfix, edge case, cor, css
-- **Infra:** azure, bicep, sql, container, deploy, infra
-- **Arquitetura:** sistema, autenticação, integração, pattern, cqrs, subsistema
-- **UI Refresh:** redesign, redesenhar, bonito, visual, estetica, modernizar
-- **Design Impl:** prototipo, prototype, figma, html para, converter design, replicar
-
----
+## ESTRUTURA DO PROJETO
 
-## AS 9 FASES DO WORKFLOW
-
-| Fase | Gatilho | Ações Principais | Output | Pausa? |
-|------|---------|-------------------|--------|--------|
-| **0.5 CONTEXT** | Início sessão (auto) | Detectar framework, projeto, stack, histórico; gerar standards inferidos | context/, inferred.md | Não |
-| **0 PROPOSAL** | Feature request | `npx morph-spec detect`; analisar; gerar proposal.md; registrar agentes | proposal.md | **Sim** |
-| **1 SETUP** | Proposal aprovado | Ler config.json; confirmar stack; ativar agentes; criar pasta outputs | Confirmação | Não |
-| **1.5 UI/UX** | Setup + keywords UI *(condicional)* | Perguntar layout/refs ao usuário; gerar wireframes e specs AGNÓSTICOS (sem escolher lib UI) | ui-*.md | **Sim** |
-| **2 DESIGN** | Contexto confirmado | Gerar spec.md + contracts.cs; DECISION POINTS (lib UI, padrões, dados, infra, SDKs); estimar custos | spec.md, contracts.cs, decisions.md | **Sim** |
-| **3 CLARIFY** | Design aprovado | Identificar ambiguidades; perguntas de clarificação; validar edge cases | Spec atualizado | Não |
-| **4 TASKS** | Clarificações resolvidas | Quebrar spec em tasks T001-TXXX; definir ordem, checkpoints, dependências | tasks.json | **Sim** |
-| **5 IMPLEMENT** | Tasks aprovadas | Implementar task por task; `npx morph-spec task done {feature} {task-id}` após cada; gerar recap.md | Código + recap.md | Não |
-| **6 SYNC** | Implementação + complexidade média/alta *(condicional)* | Promover decisions.md para project/standards/; gerar commit sync | standards/*.md | **Sim** |
-
-**Fases Obrigatórias:** 0, 1, 2, 3, 4, 5
-**Fases Condicionais:** 0.5 (auto), 1.5 (se UI), 6 (se complexo)
-
-### Regras da FASE 5 (IMPLEMENT)
-
-- **SEMPRE** chamar `npx morph-spec task done {feature} {task-id}` após cada task (validators run automatically)
-- **Se validação falhar:** corrigir violações ANTES de re-executar `task done`. NUNCA usar `--skip-validation` sem autorização do usuário
-- **NUNCA** atualizar state.json ou tasks.json manualmente
-- **NUNCA** pular tasks com dependências não completadas
-- Framework gerencia checkpoints automaticamente (a cada 3 tasks, inclui validation summary)
-- Usar `morph-spec phase advance {feature}` para avançar entre fases (valida → avança → mostra próximos passos)
-- Gerar recap: `morph-spec generate recap {feature}` (auto-popula com dados reais de state + validation + contracts)
-
----
-
-## PAUSAS INTERATIVAS
-
-Toda pausa obrigatória termina com **exatamente 3 itens** (mix de ações/perguntas/sugestões):
-
-| Fase | Mix Recomendado |
-|------|----------------|
-| PROPOSAL | 1 ação + 1 pergunta + 1 sugestão |
-| DESIGN | 2 ações + 1 pergunta/sugestão |
-| TASKS | 3 ações (aprovar/repriorizar/adicionar) |
-
-**Template:**
 ```
-⛔ PAUSA OBRIGATÓRIA
-{Contexto breve}
-1. {Emoji} **{Título}** - {Descrição}
-2. {Emoji} **{Título}** - {Descrição}
-3. {Emoji} **{Título}** - {Descrição}
+projeto/
+├── CLAUDE.md
+├── .morph/
+│   ├── project.md                  # Contexto
+│   ├── config/                     # config.json, agents.json
+│   ├── standards/                  # coding, architecture, azure
+│   ├── templates/                  # Templates para outputs
+│   ├── specs/                      # Specs ATIVAS
+│   ├── features/{feature-name}/    # Features EM DESENVOLVIMENTO
+│   │   ├── proposal.md, spec.md, tasks.md
+│   │   ├── contracts.cs, decisions.md, recap.md
+│   └── archive/                    # Features CONCLUÍDAS
+├── .claude/skills/                 # Agent skills
+└── infra/main.bicep + modules/    # IaC
 ```
 
 ---
 
-## DECISION POINTS
+## AGENTES
 
-### Regra: NUNCA decida sozinho sobre arquitetura, dependências externas ou estrutura de dados.
+### Core (Sempre Ativos)
 
-**Requer aprovação do usuário:**
-- Infraestrutura Azure (recursos, SKUs, tiers, custos)
-- Bibliotecas e Frameworks (NuGet, UI libs, auth providers, SDKs)
-- Padrões Arquiteturais (CQRS vs simples, Repository vs EF direto, etc.)
-- Estrutura de Dados (entidades, relacionamentos, normalização)
+| Agente | Responsabilidades |
+|--------|-------------------|
+| **Standards Architect** | Padrões, nomenclatura, revisão |
+| **Azure Architect** | Infra Azure, Bicep, Container Apps |
+| **Cost Guardian** | Custos, alertas, bloqueios |
 
-**Decisões são ENFORCED por validators na FASE 5.** Ao documentar decisão em `decisions.md`, os validators automaticamente ajustam suas regras (ex: "Fluent UI chosen" → blazor-validator valida Fluent patterns; "Hangfire chosen" → blazor-concurrency analyzer ativado).
+### Stack, Specialist, Integration, Infra
 
-**Decisões automáticas permitidas:**
-- Nomenclatura (seguir standards), estrutura de pastas, imports, formatação, tipos primitivos, validações básicas, padrões já em project/standards/
-
-**Template de decisão:**
-```
-🤔 DECISÃO TÉCNICA NECESSÁRIA
-Contexto: {por que decidir agora}
-
-Opção 1: {Nome} - ✅ {vantagens} | ❌ {desvantagens} | ⚡ {complexidade}
-Opção 2: {Nome} - ✅ {vantagens} | ❌ {desvantagens} | ⚡ {complexidade}
-
-💡 Recomendação: {opção} porque {justificativa}
-Qual prefere?
-```
+> **Ref:** Root `CLAUDE.md` para tabela completa de agentes e keywords.
 
 ---
 
-## QUANDO NÃO USAR MORPH
+## LIMITES DE CUSTO
 
-| Não usar MORPH | Sempre usar MORPH |
-|----------------|-------------------|
-| Bug fix simples (< 3 arquivos) | Nova feature com UI |
-| Hotfix urgente | Integração com API externa |
-| Ajuste CSS/typo | Novo subsistema/módulo |
-| Atualizar dependência | Mudança de schema de banco |
-| Pergunta sobre código | Autenticação/autorização |
-
-> **Regra de Ouro:** ARQUITETURA, DEPENDÊNCIAS EXTERNAS ou ESTRUTURA DE DADOS → Use MORPH. CORREÇÃO, AJUSTE ou OPERAÇÃO → Faça diretamente.
-
-Escalação: Se descobrir complexidade maior, `morph-spec state set {feature} workflow full-morph`
+| Nível | Limite | Requisito |
+|-------|--------|-----------|
+| Sem aprovação | Free tier | Nenhum |
+| Com aprovação | Até $10/mês | Confirmação |
+| Acima de $10 | Justificativa | ADR |
 
 ---
 
@@ -199,115 +93,57 @@ Escalação: Se descobrir complexidade maior, `morph-spec state set {feature} wo
 | Recursos dinâmicos (Fabric, Azure AI) | SDK .NET |
 | CI/CD | YAML + Bicep |
 
-Estrutura: `infra/main.bicep` → `infra/modules/*.bicep` + `parameters.{env}.json`
-
 ---
 
-## STATE MANAGEMENT
+## TEMPLATES
 
-```bash
-morph-spec state init                                    # Inicializar
-morph-spec state set {feature} phase {phase}             # Atualizar fase
-morph-spec state set {feature} status {status}           # Atualizar status
-morph-spec state add-agent {feature} {agent-id}          # Adicionar agente
-morph-spec state mark-output {feature} {type}            # Marcar output
-morph-spec state checkpoint {feature} "{nota}"           # Registrar checkpoint
-morph-spec state list                                    # Dashboard
-morph-spec state get {feature}                           # Detalhes
-```
+> SEMPRE use `bin/render-template.js` para renderizar. NUNCA preencha placeholders manualmente.
 
-**Quando atualizar:** Criar proposal → phase proposal + mark-output proposal. Iniciar design → phase design + add-agent. Aprovar design → status approved + mark-output spec/contracts. Implementar → phase implement + tasks.total. Completar task → tasks.completed. Finalizar → status done + mark-output recap.
+### Placeholders: `{{PLACEHOLDER}}`
 
----
+| Placeholder | Exemplo |
+|-------------|---------|
+| `{{FEATURE_NAME}}` | `scheduled-reports` |
+| `{{FEATURE_NAME_PASCAL}}` | `ScheduledReports` |
+| `{{FEATURE_NAME_CAMEL}}` | `scheduledReports` |
+| `{{STACK}}` | `Blazor` |
+| `{{DATE}}`, `{{AUTHOR}}`, `{{NAMESPACE}}` | Auto from config.json |
 
-## COMANDOS
+### CLI
 
-> **npx** para projetos consumidores. **node bin/** apenas para dev do framework.
+```bash
+node bin/render-template.js <template> <output> <vars-json>
+# --verbose: show replacements | --dry-run: preview only
+```
 
-### User Commands
+### Available Templates
 
-**Slash Commands (o que o usuário digita):**
-| Comando | Descrição |
-|---------|-----------|
-| `/morph-proposal {feature}` | Spec pipeline completo (fases 0-4 com pausas e auto-continuação) |
-| `/morph-apply {feature}` | Implementar (fase 5, valida fases anteriores) |
-| `/morph-status` | Dashboard de progresso |
-| `/morph-archive {feature}` | Arquivar feature concluída |
-| `/morph-infra {action}` | Gerenciar infra Bicep (init, validate, plan, deploy) |
-| `/morph-preflight` | Validação pre-deploy Azure |
-| `/morph-troubleshoot {error}` | Troubleshooting de erros |
+**MORPH outputs:** proposal, ui-design-system, ui-mockups, ui-components, ui-flows, spec, contracts.cs, decisions, tasks, recap
 
-**CLI (o que o usuário executa no terminal):**
-| Comando | Descrição |
-|---------|-----------|
-| `morph-spec init` | Inicializar MORPH no projeto |
-| `morph-spec update` | Atualizar templates e standards |
-| `morph-spec doctor` | Check de saúde |
-
-### Framework Commands (Claude internal)
-
-> Comandos usados pelo Claude automaticamente durante o workflow. Usuário NÃO precisa executar.
-
-| Comando | Quando |
-|---------|--------|
-| `morph-spec detect-agents "{text}"` | Detectar agentes na proposta |
-| `morph-spec state <action>` | Gerenciar state.json |
-| `morph-spec task done/start/next` | Gerenciar tasks na implementação |
-| `morph-spec phase advance {feature}` | Avançar entre fases |
-| `morph-spec generate recap/design-system` | Gerar outputs |
-| `morph-spec validate-phase {feature} {phase}` | Validar pré-requisitos |
-| `morph-spec validate/validate-blazor/lint-fluent/...` | Validators |
-| `morph-spec story create/shard/status` | Story-driven development |
-
-### Internal Workflow Skills (auto-invoked by /morph-proposal)
-
-| Skill | Fase | Path |
-|-------|------|------|
-| phase-setup | 1 | `.claude/skills/workflows/phase-setup.md` |
-| phase-uiux | 1.5 | `.claude/skills/workflows/phase-uiux.md` |
-| phase-design | 2 | `.claude/skills/workflows/phase-design.md` |
-| phase-clarify | 3 | `.claude/skills/workflows/phase-clarify.md` |
-| phase-tasks | 4 | `.claude/skills/workflows/phase-tasks.md` |
+**Code:** service.cs, repository.cs, agent.cs, job.cs, test.cs
 
 ---
 
-## ESTRUTURA DE OUTPUTS
+## COMANDOS
 
-```
-.morph/project/outputs/{feature-name}/
-├── proposal.md          # FASE 0
-├── ui-design-system.md  # FASE 1.5 (se front-end)
-├── ui-mockups.md        # FASE 1.5 (se front-end)
-├── ui-components.md     # FASE 1.5 (se front-end)
-├── ui-flows.md          # FASE 1.5 (se front-end)
-├── spec.md              # FASE 2
-├── contracts.cs         # FASE 2
-├── tasks.json           # FASE 4
-├── decisions.md         # FASE 2+ (acumulativo)
-└── recap.md             # FASE 5
-```
+| Comando | Ação |
+|---------|------|
+| `/morph-proposal {feature}` | Spec pipeline completo (fases 0-4, auto-continuação com pausas) |
+| `/morph-apply {feature}` | Implementar feature (fase 5) |
+| `/morph-status` | Dashboard |
+| `/morph-archive {feature}` | Arquivar feature concluída |
+| `/morph-infra {action}` | Gerenciar infra Bicep |
+| `/morph-preflight` | Validação pre-deploy Azure |
+| `/morph-troubleshoot {error}` | Troubleshooting de erros |
 
 ---
 
 ## 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`
-
-### Templates
-- `content/.morph/templates/` - Source (NPM package)
-- `.morph/templates/` - No projeto consumidor (editável, copiado pelo `init`)
-
-### Project Context
-`.morph/project/context/README.md` | `.morph/project/standards/inferred.md` | `.morph/project/standards/*.md` | `.morph/config.json`
-
-### Skills
-- `workflows/` - phase-setup, phase-uiux, phase-design, phase-clarify, phase-tasks, morph-replicate
-- `checklists/` - morph-checklist, simulation-checklist, code-review
-- `integrations/` - asaas-financial, clerk-auth, azure-identity, resend-email
-- `specialists/` - dotnet-senior, code-analyzer, ui-ux-designer, ai-system-architect, ef-modeler, hangfire-orchestrator, testing-specialist, etc.
-- `stacks/` - dotnet-blazor, dotnet-nextjs
-- `infra/` - bicep-architect, devops-engineer, container-specialist
+- `.morph/project.md` — Contexto do projeto
+- `.morph/standards/` — coding, architecture, azure
+- `.morph/templates/` — Templates para outputs
+- `.morph/config/agents.json` — Agentes
 
 ---
 

package/bin/morph-spec.js

@@ -18,6 +18,7 @@ import { sprintStatusCommand } from '../src/commands/sprint-status.js';
 import { stateCommand } from '../src/commands/state.js';
 import { taskDoneCommand, taskStartCommand, taskNextCommand } from '../src/commands/task.js';
 import { generateDesignSystemCommand } from '../src/commands/generate.js';
+import { generateContextCommand } from '../src/commands/generate-context.js';
 import { validateCommand } from './validate.js';
 import { validateBlazorCommand } from '../src/commands/validate-blazor.js';
 import { lintFluentCommand } from '../src/commands/lint-fluent.js';
@@ -179,6 +180,13 @@ generateCommand
     await generateRecap('.', feature, options);
   });
 
+generateCommand
+  .command('context [feature]')
+  .description('Generate CONTEXT.md with full project data for Claude Code')
+  .action(async (feature) => {
+    await generateContextCommand('.', feature);
+  });
+
 // Validation commands (Sprint 4: Continuous Validation)
 program
   .command('validate [validator]')