@polymorphism-tech/morph-spec 3.2.0 → 4.2.0

package/CLAUDE.md

@@ -52,6 +52,173 @@ cp stacks/{stack}/CLAUDE.md seu-projeto/CLAUDE.md
 
 ---
 
+## WORKFLOW DETECTION SYSTEM (Detecção Automática de Complexidade)
+
+O framework agora detecta **AUTOMATICAMENTE** o workflow apropriado baseado na análise do pedido do usuário.
+
+### 5 Tipos de Workflow
+
+| Workflow | Complexidade | Arquivos | Linhas | Keywords Exemplo |
+|----------|--------------|----------|--------|------------------|
+| **fast-track** | Trivial | ≤3 | ≤50 | bug, fix, corrigir, css, typo |
+| **standard** | Média | 3-10 | 50-500 | paginação, filtro, refactor, export |
+| **full-morph** | Alta | >10 | >500 | sistema, autenticação, integração, cqrs |
+| **design-impl** | N/A | N/A | N/A | prototype, figma, html para, replicar |
+| **ui-refresh** | N/A | N/A | N/A | redesign, modernizar, aesthetic, bonito |
+
+### Como Funciona
+
+**1. Quando Criar Feature:**
+
+```bash
+# Detecção automática
+npx morph-spec feature create user-pagination \
+  --request "add pagination to users table"
+
+# Output:
+🔍 Analyzing request...
+✓ Detected workflow: standard (85% confidence)
+  Matched keyword: "paginação"
+  Estimated: 5 files, ~200 lines
+
+📋 Created feature: user-pagination
+    Phase: proposal
+    Workflow: standard
+```
+
+**2. Análise Manual (Opcional):**
+
+```bash
+npx morph-spec detect-workflow "implement complete authentication system"
+
+# Output:
+Detected Workflow: full-morph (92% confidence)
+
+Criteria Match:
+  ✓ Keywords: "authentication", "complete", "system"
+  ✓ Estimated: 15 files, ~800 lines
+  ✓ Infrastructure: detected
+
+Phases to Run:
+  1. CONTEXT
+  2. PROPOSAL - ⏸️ Pause for approval
+  3. SETUP
+  4. UI/UX - ⏸️ Pause for approval
+  5. DESIGN - ⏸️ Pause for approval
+  6. CLARIFY
+  7. TASKS - ⏸️ Pause for approval
+  8. IMPLEMENT
+  9. SYNC - ⏸️ Pause for approval
+
+Phases Skipped: None (all mandatory for full-morph)
+
+Alternative Workflows:
+  - standard (15%): If scope reduced to basic login only
+```
+
+### Workflow Behaviors
+
+#### fast-track (Trivial)
+- **Objetivo:** Correções rápidas, ajustes CSS, edge cases
+- **Fases:** Quick Analysis (proposal+setup+design combinados) → Implement
+- **Fases Puladas:** UIUX, CLARIFY, TASKS, SYNC
+- **Outputs:** Apenas commit message (sem .md files)
+- **Exemplo:** "fix typo in login button"
+
+#### standard (Média Complexidade)
+- **Objetivo:** Features simples, refatorações, otimizações
+- **Fases:** PROPOSAL (simplificado) → DESIGN (conciso) → TASKS (se >5 tasks) → IMPLEMENT
+- **Fases Puladas:** SETUP (contexto já carregado), UIUX (sem frontend significativo), CLARIFY (spec claro), SYNC (decisões táticas)
+- **Outputs:** proposal.md, spec.md, recap.md (minimal)
+- **Exemplo:** "add pagination to users table"
+
+#### full-morph (Alta Complexidade)
+- **Objetivo:** Sistemas completos, arquitetura, integrações
+- **Fases:** TODAS (9 fases obrigatórias)
+- **Fases Puladas:** Nenhuma
+- **Outputs:** Completo (proposal, ui-*, spec, contracts, tasks, decisions, recap)
+- **Exemplo:** "implement complete authentication system with OAuth"
+
+#### design-impl (Prototipo → Código)
+- **Objetivo:** Converter HTML, Figma, mockups para código funcional
+- **Fases:** ANÁLISE DO PROTÓTIPO → TASKS (lista de telas) → IMPLEMENT (por tela)
+- **Fases Puladas:** PROPOSAL, DESIGN técnico, CLARIFY, SYNC
+- **Outputs:** recap.md, .razor code, CSS
+- **Exemplo:** "convert HTML prototype to Blazor components"
+
+#### ui-refresh (Redesign Visual)
+- **Objetivo:** Mudanças apenas visuais, sem lógica de negócio
+- **Fases:** ANÁLISE VISUAL → DESIGN SYSTEM (simplificado) → IMPLEMENT (por página)
+- **Fases Puladas:** SETUP completo, CONTRACTS, TASKS detalhadas, INFRA, CLARIFY, SYNC
+- **Outputs:** design-refresh-checklist.md, CSS, .razor pages, recap.md
+- **Exemplo:** "redesign dashboard to look more modern"
+
+### Algoritmo de Detecção
+
+O sistema usa 4 fatores ponderados:
+
+1. **Keywords (40%):** Matching de palavras-chave (PT + EN)
+2. **Complexity (30%):** Estimativa de arquivos/linhas/componentes
+3. **Priority (20%):** Workflows específicos > genéricos
+4. **Context (10%):** Condições especiais (has prototype? existing pages?)
+
+**Penalties:**
+- -50% para workflows sem keyword match (exceto full-morph)
+
+**Boosts:**
+- +20% para workflows com 3+ keywords matched
+
+### Override Manual
+
+```bash
+# Forçar workflow específico
+npx morph-spec state set user-auth workflow full-morph
+
+# Re-detectar após mudanças no pedido
+npx morph-spec state detect-workflow user-auth \
+  "implement basic login only (no OAuth)"
+
+# Output:
+🔄 Re-analyzing request...
+✓ New workflow: standard (78% confidence)
+  Previous: full-morph
+  Reason: Scope reduced - no OAuth, no registration
+```
+
+### Configurações de Workflow
+
+Workflows são definidos em `framework/workflows/configs/*.json`:
+
+```json
+{
+  "id": "standard",
+  "criteria": {
+    "minFiles": 3,
+    "maxFiles": 10,
+    "minLines": 50,
+    "maxLines": 500
+  },
+  "keywords": ["paginação", "pagination", "filtro", "filter"],
+  "phases": {
+    "run": ["proposal", "design", "tasks", "implement"],
+    "skip": ["setup", "uiux", "clarify", "sync"]
+  },
+  "priority": 2
+}
+```
+
+### Documentação Completa
+
+Veja `framework/workflows/` para:
+- **docs/STORY-DRIVEN-DEVELOPMENT.md:** Filosofia do sistema
+- **docs/{workflow}.md:** Detalhes de cada workflow (5 arquivos)
+- **configs/{workflow}.json:** Configurações executáveis (5 arquivos)
+- **README.md:** Guia completo do sistema de workflows
+
+**REGRA CRÍTICA:** Confie na detecção automática. Override manual apenas se houver contexto que o sistema não detectou (ex: "parece grande mas já temos 80% do código pronto").
+
+---
+
 ## APPROVAL GATES (Portões de Aprovação)
 
 O sistema agora rastreia aprovações explícitas para cada fase crítica em `state.json`.
@@ -214,6 +381,103 @@ Fix these issues before proceeding.
 
 ---
 
+## CLAUDE CODE HOOKS (Validação em Hooks)
+
+O framework integra com o sistema de hooks do Claude Code para validação automática em eventos Git e Agent Teams.
+
+### Arquitetura de Hooks
+
+**Universal (framework/hooks/):** Hooks compartilhados por todas as stacks
+- **pre-commit/**: `agents.sh`, `specs.sh`, `orchestrator.sh`
+- **commit-msg/**: `conventional-commits.sh` (Conventional Commits format)
+- **pre-push/**: `run-tests.sh` (executa test suite completo)
+- **agent-teams/**: `teammate-idle.js`, `task-completed.js`, `phase-advanced.js`
+
+**Stack-Specific (stacks/{stack}/.morph/hooks/):** Hooks específicos de cada stack
+- **pre-commit/**: `tests-csharp.sh` (blazor-azure), `tests-typescript.sh` (nextjs-supabase)
+
+### Instalação de Git Hooks
+
+```bash
+# No diretório .git/hooks do projeto
+cd .git/hooks
+
+# Pre-commit (valida agents.json, spec.md, executa testes)
+ln -sf ../../framework/hooks/pre-commit/orchestrator.sh pre-commit
+chmod +x pre-commit
+
+# Commit-msg (valida formato Conventional Commits)
+ln -sf ../../framework/hooks/commit-msg/conventional-commits.sh commit-msg
+chmod +x commit-msg
+
+# Pre-push (executa suite de testes antes de push)
+ln -sf ../../framework/hooks/pre-push/run-tests.sh pre-push
+chmod +x pre-push
+```
+
+### Configuração de Agent Teams Hooks
+
+Adicione em `.claude/settings.local.json`:
+
+```json
+{
+  "hooks": {
+    "TeammateIdle": "node framework/hooks/agent-teams/teammate-idle.js {feature}",
+    "TaskCompleted": "node framework/hooks/agent-teams/task-completed.js {feature} {taskId}",
+    "PhaseAdvanced": "node framework/hooks/agent-teams/phase-advanced.js {feature} {fromPhase} {toPhase}"
+  }
+}
+```
+
+### Validators com Hook Behavior
+
+5 validators tier-4 configurados em `agents.json` com `hook_behavior`:
+
+| Validator | Hook Triggers | Valida | Bloqueia? |
+|-----------|---------------|--------|-----------|
+| **security-expert** | TeammateIdle, TaskCompleted | SQL injection, XSS, Secrets | ✅ Sim |
+| **architecture-expert** | TeammateIdle, TaskCompleted | DbContext injection, async/await, DI order | ✅ Sim |
+| **packages-validator** | TaskCompleted | NuGet conflicts, .NET 10 compatibility | ✅ Sim |
+| **design-system-validator** | TeammateIdle | CSS palette, spacing, typography | ⚠️ Warning |
+| **blazor-concurrency-validator** | TaskCompleted | DbContext lifecycle, async void, JSInterop | ✅ Sim |
+
+### Como Funciona
+
+**Git Hooks:**
+```
+git commit → pre-commit hook → orchestrator.sh
+    ├─ Executa framework/hooks/pre-commit/*.sh (universal)
+    └─ Executa .morph/hooks/pre-commit/*.sh (stack-specific)
+    ↓
+commit-msg hook → valida formato Conventional Commits
+    ↓
+git push → pre-push hook → executa test suite
+```
+
+**Agent Teams Hooks:**
+```
+Teammate idle → TeammateIdle hook
+    ├─ Carrega agents.json
+    ├─ Filtra validators com hook_triggers: ["TeammateIdle"]
+    ├─ Executa validators via hook-executor.js
+    └─ Bloqueia se errors > 0 e blocks_on_fail: true
+```
+
+### Bypass (Não Recomendado)
+
+```bash
+# Pular hooks Git
+git commit --no-verify
+git push --no-verify
+
+# Pular validação de task
+npx morph-spec task done feature-name task-id --skip-validation
+```
+
+**IMPORTANTE:** Veja `framework/hooks/README.md` para documentação completa de hooks.
+
+---
+
 ## AGENT INVOCATION PATTERNS (Spawning de Agentes)
 
 Use **Task tool** para spawnar subagentes quando apropriado.
@@ -399,11 +663,9 @@ Para features grandes, use `metadata.json` para acesso rápido (reduz uso de tok
 # 1. Antes de trabalhar na feature, leia metadata.json
 cat .morph/project/outputs/user-auth/metadata.json
 
-# 2. Metadata auto-atualizado após cada task
+# 2. Metadata é auto-atualizado após cada task
 # (Configurado em llm-interaction.json: "updateFrequency": "on_task_done")
-
-# 3. Ou gere manualmente
-npx morph-spec generate metadata user-auth
+# NOTA: Não há comando manual para gerar metadata - sempre auto-gerado
 ```
 
 ### Configuração
@@ -625,14 +887,97 @@ morph-spec-framework/
 
 ## TEMPLATES
 
-> SEMPRE use `bin/render-template.js` para renderizar. NUNCA preencha placeholders manualmente.
+> **Template System v2.0** - Organizado por tecnologia, reutilizável entre stacks, powered by Handlebars
+
+### Overview
+
+Templates estão em `framework/templates/` organizados por **tecnologia** (não por stack):
+- `code/dotnet/` - Templates .NET (service, repository, component, etc.)
+- `code/typescript/` - Templates TypeScript (contracts, etc.)
+- `code/sql/` - Templates SQL (Supabase migrations, RLS policies)
+- `infrastructure/azure/` - Bicep templates para Azure
+- `infrastructure/docker/` - Dockerfiles e Docker Compose
+- `integrations/` - Integrações (Asaas, Clerk, Azure Identity)
+- `ui/` - Design systems (CSS, Fluent/Mud themes)
+- `saas/` - Multi-tenant patterns
+
+**Por quê tecnologia?** Permite reutilizar templates entre stacks (ex: service.cs funciona para blazor-azure E nextjs-supabase).
+
+### CLI Commands
+
+```bash
+# Listar todos os templates
+morph-spec template list
+
+# Filtrar por categoria/tecnologia
+morph-spec template list --category code
+morph-spec template list --phase implement
+
+# Ver detalhes de um template
+morph-spec template show dotnet-backend-service --preview
+
+# Renderizar template (usando Handlebars)
+morph-spec template render dotnet-backend-service UserService.cs '{
+  "FEATURE_NAME": "user-auth",
+  "NAMESPACE": "MyApp.Services"
+}'
+
+# Customizar template (criar override stack-specific)
+morph-spec template customize dotnet-backend-service --stack blazor-azure
+```
+
+### Handlebars Helpers (v2.0)
+
+**✅ USE (novo):**
+
+| Helper | Input | Output | Uso |
+|--------|-------|--------|-----|
+| `{{pascalCase str}}` | `user-auth` | `UserAuth` | Classes |
+| `{{camelCase str}}` | `user-auth` | `userAuth` | Variables |
+| `{{snakeCase str}}` | `user-auth` | `user_auth` | SQL |
+| `{{titleCase str}}` | `user-auth` | `User Auth` | Titles |
+| `{{pluralize str}}` | `user` | `users` | Collections |
+
+**❌ DEPRECADO (v1.0):**
+
+| Placeholder | Status | Use Instead |
+|-------------|--------|-------------|
+| `{{FEATURE_NAME_PASCAL}}` | ❌ Deprecated | `{{pascalCase FEATURE_NAME}}` |
+| `{{FEATURE_NAME_CAMEL}}` | ❌ Deprecated | `{{camelCase FEATURE_NAME}}` |
+| `{{FEATURE_NAME_SNAKE}}` | ❌ Deprecated | `{{snakeCase FEATURE_NAME}}` |
+
+### Variáveis Padrão (auto-injetadas)
 
 | Placeholder | Exemplo |
 |-------------|---------|
 | `{{FEATURE_NAME}}` | `scheduled-reports` |
-| `{{FEATURE_NAME_PASCAL}}` | `ScheduledReports` |
 | `{{STACK}}` | `Blazor` ou `NextjsSupabase` |
-| `{{DATE}}`, `{{AUTHOR}}`, `{{NAMESPACE}}` | Auto from config.json |
+| `{{DATE}}` | `2026-02-17` |
+| `{{YEAR}}` | `2026` |
+| `{{TIMESTAMP}}` | `2026-02-17T19:38:00Z` |
+| `{{NAMESPACE}}` | Auto from config.json |
+| `{{AUTHOR}}` | Auto from config.json |
+
+### Stack Overrides
+
+Templates são resolvidos com fallback automático:
+1. `stacks/{stack}/.morph/templates/` (override stack-specific)
+2. `.morph/templates/` (override project-local)
+3. `framework/templates/` (fallback padrão)
+
+Para customizar um template:
+```bash
+morph-spec template customize dotnet-backend-service --stack blazor-azure
+# Edite: stacks/blazor-azure/.morph/templates/code/dotnet/backend/service.cs
+```
+
+### Documentação Completa
+
+Veja `framework/templates/README.md` para:
+- Estrutura completa de diretórios
+- Todos os helpers Handlebars disponíveis
+- Como criar novos templates
+- Migração v1 → v2
 
 ---
 

package/README.md

@@ -488,18 +488,6 @@ MORPH-SPEC possui **30 agentes** organizados em 4 tiers hierárquicos com squads
 
 ---
 
-## Exemplos
-
-| Exemplo | Descrição |
-|---------|-----------|
-| [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`
-
----
-
 ## Estrutura do Projeto
 
 Após a instalação, seu projeto terá:
@@ -523,7 +511,6 @@ seu-projeto/
 │   │   ├── infra/
 │   │   ├── integrations/
 │   │   └── saas/
-│   ├── examples/             # Exemplos completos
 │   ├── features/             # Features em desenvolvimento
 │   └── archive/              # Features concluídas
 └── .claude/
@@ -703,7 +690,7 @@ Todo código gerado usando MORPH-SPEC é **100% seu** para usar como quiser, inc
 
 - [npm Package](https://www.npmjs.com/package/@polymorphism-tech/morph-spec)
 - [Documentação](docs/)
-- [Exemplos](stacks/blazor-azure/.morph/examples/)
+- [Wiki (Base de Conhecimento)](.wiki/) - 33 artigos sobre .NET, Azure, IA, SaaS e Claude Code
 - [Polymorphism Tech](https://polymorphism.com.br)
 
 ---

package/bin/detect-agents.js

@@ -15,7 +15,7 @@
 import { readFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
-import { resolveAgentsConfigPath } from '../src/lib/stack-resolver.js';
+import { resolveAgentsConfigPath } from '../src/lib/stacks/stack-resolver.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const frameworkRoot = join(__dirname, '..');

package/bin/morph-spec.js

@@ -1,44 +1,70 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { program } from 'commander';
 import chalk from 'chalk';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import { readFileSync } from 'fs';
-import { setGlobalStack } from '../src/lib/stack-resolver.js';
-
-import { initCommand } from '../src/commands/init.js';
-import { updateCommand } from '../src/commands/update.js';
-import { doctorCommand } from '../src/commands/doctor.js';
-import { detectCommand } from '../src/commands/detect.js';
-import { detectAgentsCommand } from '../src/commands/detect-agents.js';
-import { syncCommand } from '../src/commands/sync.js';
-import { createStoryCommand } from '../src/commands/create-story.js';
-import { shardSpecCommand } from '../src/commands/shard-spec.js';
-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 { setGlobalStack } from '../src/lib/stacks/stack-resolver.js';
+
+// Project commands
+import { initCommand } from '../src/commands/project/init.js';
+import { updateCommand } from '../src/commands/project/update.js';
+import { doctorCommand } from '../src/commands/project/doctor.js';
+import { detectCommand } from '../src/commands/project/detect.js';
+import { detectAgentsCommand } from '../src/commands/project/detect-agents.js';
+import { detectWorkflowCommand } from '../src/commands/project/detect-workflow.js';
+import { syncCommand } from '../src/commands/project/sync.js';
+
+// Feature commands
+import { createStoryCommand } from '../src/commands/feature/create-story.js';
+import { shardSpecCommand } from '../src/commands/feature/shard-spec.js';
+import { sprintStatusCommand } from '../src/commands/feature/sprint-status.js';
+
+// State commands
+import { stateCommand } from '../src/commands/state/state.js';
+import { validatePhaseCommand } from '../src/commands/state/validate-phase.js';
+import { rollbackPhaseCommand } from '../src/commands/state/rollback-phase.js';
+import { advancePhaseCommand } from '../src/commands/state/advance-phase.js';
+import { approveCommand, rejectCommand, approvalStatusCommand } from '../src/commands/state/approve.js';
+
+// Task commands
+import { taskDoneCommand, taskStartCommand, taskNextCommand } from '../src/commands/tasks/task.js';
+
+// Generation commands
+import { generateDesignSystemCommand, generateMetadataCommand } from '../src/commands/generation/generate.js';
+import { generateContextCommand } from '../src/commands/generation/generate-context.js';
+
+// Validation commands
 import { validateCommand } from './validate.js';
-import { validateBlazorCommand } from '../src/commands/validate-blazor.js';
-import { lintFluentCommand } from '../src/commands/lint-fluent.js';
-import { analyzeBlazorConcurrencyCommand } from '../src/commands/analyze-blazor-concurrency.js';
-import { validateBlazorStateCommand } from '../src/commands/validate-blazor-state.js';
-import { validateCssCommand } from '../src/commands/validate-css.js';
-import { LearningSystem } from '../src/lib/learning-system.js';
-import troubleshootCommand from '../src/commands/troubleshoot.js';
-import { validatePhaseCommand } from '../src/commands/validate-phase.js';
-import { sessionSummaryCommand } from '../src/commands/session-summary.js';
-import { rollbackPhaseCommand } from '../src/commands/rollback-phase.js';
-import { advancePhaseCommand } from '../src/commands/advance-phase.js';
-import { approveCommand, rejectCommand, approvalStatusCommand } from '../src/commands/approve.js';
-import { spawnTeamCommand } from '../src/commands/spawn-team.js';
-import capturePatternProgram from '../src/commands/capture-pattern.js';
-import searchPatternsProgram from '../src/commands/search-patterns.js';
-import { generateMetadataCommand } from '../src/commands/generate.js';
-import migrateStateProgram from '../src/commands/migrate-state.js';
-import upgradeProgram from '../src/commands/upgrade.js';
+import { validateBlazorCommand } from '../src/commands/validation/validate-blazor.js';
+import { lintFluentCommand } from '../src/commands/validation/lint-fluent.js';
+import { analyzeBlazorConcurrencyCommand } from '../src/commands/validation/analyze-blazor-concurrency.js';
+import { validateBlazorStateCommand } from '../src/commands/validation/validate-blazor-state.js';
+import { validateCssCommand } from '../src/commands/validation/validate-css.js';
+
+// Template commands
+import { templateListCommand } from '../src/commands/templates/template-list.js';
+import { templateShowCommand } from '../src/commands/templates/template-show.js';
+import { templateRenderCommand } from '../src/commands/templates/template-render.js';
+import { templateCustomizeCommand } from '../src/commands/templates/template-customize.js';
+import { templateValidateCommand } from '../src/commands/templates/template-validate.js';
+
+// Agent commands
+import { spawnTeamCommand } from '../src/commands/agents/spawn-team.js';
+
+// Learning commands
+import capturePatternProgram from '../src/commands/learning/capture-pattern.js';
+import searchPatternsProgram from '../src/commands/learning/search-patterns.js';
+
+// Utility commands
+import troubleshootCommand from '../src/commands/utils/troubleshoot.js';
+import { sessionSummaryCommand } from '../src/commands/utils/session-summary.js';
+import migrateStateProgram from '../src/commands/utils/migrate-state.js';
+import upgradeProgram from '../src/commands/utils/upgrade.js';
+
+// Libraries
+import { LearningSystem } from '../src/lib/learning/learning-system.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
@@ -97,6 +123,14 @@ program
   .option('-i, --ids-only', 'Output only agent IDs (one per line)')
   .action(detectAgentsCommand);
 
+program
+  .command('detect-workflow <input...>')
+  .description('Detect appropriate workflow for a feature request')
+  .option('-v, --verbose', 'Show detailed detection reasoning')
+  .option('-j, --json', 'Output as JSON')
+  .option('-p, --project-path <path>', 'Project path (default: current directory)')
+  .action(detectWorkflowCommand);
+
 program
   .command('sync')
   .description('Sync standards from feature decisions')
@@ -335,6 +369,60 @@ learnCommand
     console.log(chalk.green('\n✅ Knowledge base reset\n'));
   });
 
+// Template management commands
+const templateCommand = program
+  .command('template')
+  .description('Template management (list | show | render | customize | validate)');
+
+templateCommand
+  .command('list')
+  .description('List all available templates')
+  .option('--category <category>', 'Filter by category (documentation, code, infrastructure, context, examples)')
+  .option('--phase <phase>', 'Filter by phase (proposal, design, implement, etc.)')
+  .option('--stack <stack>', 'Filter by stack (blazor-azure, nextjs-supabase)')
+  .option('--required', 'Show only required templates')
+  .action(templateListCommand);
+
+templateCommand
+  .command('show <template-id>')
+  .description('Show detailed information about a template')
+  .option('--show-path', 'Show resolved template file path')
+  .option('--preview', 'Show first 20 lines of template content')
+  .option('--stack <stack>', 'Stack for path resolution (default: blazor-azure)')
+  .option('--project-path <path>', 'Project path (default: current directory)')
+  .action(templateShowCommand);
+
+templateCommand
+  .command('render <template-id> <output-path> <variables-json>')
+  .description('Render a template with variables')
+  .option('--dry-run', 'Preview without writing file')
+  .option('--stack <stack>', 'Stack for template resolution (default: blazor-azure)')
+  .option('--project-path <path>', 'Project path (default: current directory)')
+  .option('-v, --verbose', 'Show detailed output')
+  .action(templateRenderCommand);
+
+templateCommand
+  .command('customize <template-id>')
+  .description('Copy framework template to project for customization')
+  .option('--stack <stack>', 'Target stack (default: blazor-azure)')
+  .option('--local', 'Copy to project .morph/templates/ instead of stack')
+  .option('--force', 'Overwrite existing customized template')
+  .option('--project-path <path>', 'Project path (default: current directory)')
+  .option('-v, --verbose', 'Show detailed output')
+  .action(templateCustomizeCommand);
+
+templateCommand
+  .command('validate [template-id]')
+  .description('Validate template(s) for correct Handlebars syntax')
+  .option('--category <category>', 'Validate templates in specific category')
+  .option('--technology <technology>', 'Validate templates for specific technology')
+  .option('--include-deprecated', 'Include deprecated templates')
+  .option('--show-valid', 'Show valid templates in output')
+  .option('--strict', 'Exit with error on warnings')
+  .option('--project-path <path>', 'Project path (default: current directory)')
+  .option('-v, --verbose', 'Show detailed validation information')
+  .action(templateValidateCommand);
+
 // Troubleshooting command
 program
   .command('troubleshoot <keywords...>')

package/bin/validate.js

@@ -20,7 +20,7 @@ import chalk from 'chalk';
 import { validatePackages } from '../src/lib/validators/package-validator.js';
 import { validateArchitecture } from '../src/lib/validators/architecture-validator.js';
 import { validateContrast } from '../src/lib/validators/ui-contrast-validator.js';
-import { LearningSystem } from '../src/lib/learning-system.js';
+import { LearningSystem } from '../src/lib/learning/learning-system.js';
 
 const VALIDATORS = {
   packages: {

package/docs/getting-started.md

@@ -97,11 +97,6 @@ seu-projeto/
 │   │       ├── subscription.cs        # Modelo de assinaturas
 │   │       └── tenant.cs              # Multi-tenancy
 │   │
-│   ├── examples/                      # Exemplos completos
-│   │   ├── micro-saas/                # Blazor + Asaas billing
-│   │   ├── api-nextjs/                # .NET API + Next.js
-│   │   └── multi-agent/               # Semantic Kernel agents
-│   │
 │   ├── specs/                         # Specs ativas
 │   ├── features/                      # Features em desenvolvimento
 │   └── archive/                       # Features concluídas