@polymorphism-tech/morph-spec 4.3.6 → 4.5.0

package/framework/CLAUDE.md

@@ -0,0 +1,77 @@
+# MORPH-SPEC Runtime Instructions
+
+> by Polymorphism Tech — Spec-driven development for .NET/Blazor/Next.js/Azure
+
+---
+
+## Project Context
+
+@.morph/context/README.md
+
+---
+
+## Critical Rules
+
+**NEVER:**
+- Skip to code without a specification
+- Implement without design approval
+- Ignore standards in `.morph/framework/standards/`
+- Create infrastructure manually
+- Generate code without defined contracts
+
+**ALWAYS:**
+- Follow the mandatory phases
+- Generate outputs in `.morph/features/{feature}/`
+- Document decisions in `decisions.md`
+- Checkpoint every 3 implemented tasks
+- Use Infrastructure as Code
+
+---
+
+## Quick Reference
+
+| Command | Purpose |
+|---------|---------|
+| `/morph-proposal {feature}` | Full spec pipeline (phases 1–4, pauses for approval) |
+| `/morph-apply {feature}` | Implement feature (phase 5) |
+| `/morph-status` | Feature status dashboard |
+| `/morph-preflight` | Pre-implementation validation |
+
+---
+
+## State & Outputs
+
+| Path | Notes |
+|------|-------|
+| `.morph/state.json` | **READ-ONLY** — use `morph-spec` CLI to update |
+| `.morph/features/{feature}/{phase}/` | Feature outputs organized by phase |
+| `.morph/framework/` | **READ-ONLY** — framework files managed by morph-spec |
+| `.morph/config/config.json` | Project configuration (editable) |
+
+---
+
+## Phase Sequence
+
+```
+proposal → setup → [uiux] → design → clarify → tasks → implement → [sync]
+```
+
+Use `morph-spec state show {feature}` to see current phase and pending approval gates.
+
+---
+
+## Agents
+
+Tier-1 and tier-2 MORPH agents are available as native subagents in `.claude/agents/`.
+They can be invoked directly by Claude Code during multi-agent workflows.
+
+---
+
+## Context Window Tip
+
+When using 3+ MCPs, add `"experimental": { "mcpCliMode": true }` to `.claude/settings.json`.
+MCP tools load on-demand instead of all at startup — keeps context clean for actual work.
+
+---
+
+*MORPH-SPEC v4.5.0 by Polymorphism Tech*

package/framework/commands/morph-apply.md

@@ -60,7 +60,7 @@ Para completar as fases de planejamento, execute:
 
 ### Arquivos Necessários
 
-- [ ] Feature existe em `.morph/project/outputs/{feature}/`
+- [ ] Feature existe em `.morph/features/{feature}/`
 - [ ] `spec.md` está aprovado
 - [ ] `tasks.json` tem tasks definidas
 - [ ] `contracts.cs` define as interfaces
@@ -68,10 +68,10 @@ Para completar as fases de planejamento, execute:
 ## Workflow
 
 1. **Carregue o contexto**:
-   - Leia `.morph/project/outputs/{feature}/spec.md`
-   - Leia `.morph/project/outputs/{feature}/tasks.json`
-   - Leia `.morph/project/outputs/{feature}/contracts.cs`
-   - Leia framework/standards/ e .morph/project/standards/ para padrões
+   - Leia `.morph/features/{feature}/1-design/spec.md`
+   - Leia `.morph/features/{feature}/3-tasks/tasks.md`
+   - Leia `.morph/features/{feature}/1-design/contracts.cs`
+   - Leia framework/standards/ e .morph/context/ para padrões
 
 2. **Inicialize state tracking**:
    ```bash
@@ -116,11 +116,11 @@ Para completar as fases de planejamento, execute:
 
 ## Padrões Obrigatórios
 
-Siga sempre (priorize project/standards/ se houver):
+Siga sempre (priorize context/ se houver):
 - `framework/standards/coding.md` - Padrões base do MORPH
-- `.morph/project/standards/coding.md` - Padrões específicos do projeto
-- `.morph/project/standards/architecture.md` - Estrutura de projeto
-- `.morph/project/standards/azure.md` - Recursos e custos
+- `.morph/context/coding.md` - Padrões específicos do projeto
+- `.morph/context/architecture.md` - Estrutura de projeto
+- `.morph/context/azure.md` - Recursos e custos
 
 ---
 

package/framework/commands/morph-archive.md

@@ -1,11 +1,11 @@
 # Archive MORPH Feature
 
-Arquive uma feature concluída, movendo-a de `project/outputs/` para `project/archive/`.
+Arquive uma feature concluída, movendo-a de `features/` para `archive/`.
 
 ## Pré-requisitos
 
 Verifique antes de arquivar:
-- [ ] Feature existe em `.morph/project/outputs/{feature}/`
+- [ ] Feature existe em `.morph/features/{feature}/`
 - [ ] Todas as tasks estão completas
 - [ ] `recap.md` está preenchido
 - [ ] Código está em produção (ou staging)
@@ -13,23 +13,23 @@ Verifique antes de arquivar:
 ## Workflow
 
 1. **Valide a conclusão**:
-   - Leia `.morph/project/outputs/{feature}/tasks.json`
+   - Leia `.morph/features/{feature}/3-tasks/tasks.md`
    - Verifique que todas tasks estão completadas
    - Confirme com o usuário se pode arquivar
 
 2. **Complete o recap**:
-   - Atualize `.morph/project/outputs/{feature}/recap.md`
+   - Atualize `.morph/features/{feature}/4-implement/recap.md`
    - Preencha métricas finais
    - Documente lições aprendidas
 
 3. **Extraia specs**:
    - Se a feature define comportamento permanente
-   - Copie spec relevante para `.morph/project/specs/`
+   - Copie spec relevante para `.morph/specs/`
    - Isso vira a "verdade atual" do sistema
 
 4. **Mova para archive**:
    ```
-   .morph/project/outputs/{feature}/  →  .morph/project/archive/{feature}/
+   .morph/features/{feature}/  →  .morph/archive/{feature}/
    ```
 
 5. **Atualize métricas do projeto**:
@@ -62,7 +62,7 @@ Apresente resumo do arquivamento:
 ╠════════════════════════════════════════════╣
 ║ ARCHIVED TO                                ║
 ╠════════════════════════════════════════════╣
-║ .morph/project/archive/{feature}/          ║
+║ .morph/archive/{feature}/                  ║
 ╚════════════════════════════════════════════╝
 ```
 
@@ -70,7 +70,7 @@ Apresente resumo do arquivamento:
 
 Se houver specs extraídas:
 ```
-Specs extracted to .morph/project/specs/:
+Specs extracted to .morph/specs/:
 - {domain}/spec.md - {description}
 ```
 

package/framework/commands/morph-infra.md

@@ -41,7 +41,7 @@ Quando o usuário solicitar `/morph-infra init`:
        └── app-insights.bicep
    ```
 
-2. Copiar templates de `.morph/templates/infrastructure/...`
+2. Copiar templates de `.morph/framework/templates/infrastructure/...`
 
 3. Substituir placeholders:
    - `{{APP_NAME}}` → nome do projeto

package/framework/commands/morph-proposal.md

@@ -34,10 +34,10 @@ npx morph-spec state get {feature-name}
 
 4. **Crie a estrutura:**
    ```
-   .morph/project/outputs/{feature-name}/
-   ├── proposal.md
-   ├── spec.md (iniciar)
-   └── tasks.json (iniciar)
+   .morph/features/{feature-name}/
+   ├── 0-proposal/proposal.md
+   ├── 1-design/spec.md (iniciar)
+   └── 3-tasks/tasks.md (iniciar)
    ```
 
 5. **Preencha `proposal.md`** baseado em `framework/templates/proposal.md`
@@ -59,7 +59,7 @@ Apresente: resumo da proposta, agentes ativados, custo estimado, 3 itens de paus
 
 ## 3. Após Aprovação do Proposal → FASE 1: SETUP (auto, sem pausa)
 
-**Ler:** `.claude/skills/workflows/phase-setup.md` para instruções detalhadas.
+**Ler:** `.claude/skills/level-1-workflows/phase-setup.md` para instruções detalhadas.
 
 Resumo: carregar contexto do projeto, confirmar stack, listar agentes ativos, atualizar state.
 
@@ -70,14 +70,14 @@ Resumo: carregar contexto do projeto, confirmar stack, listar agentes ativos, at
 ## 4. FASE 1.5: UI/UX (condicional)
 
 Verificar se `uiux-designer` está nos `activeAgents`:
-- **Se SIM:** Ler `.claude/skills/workflows/phase-uiux.md` e executar. **PAUSA OBRIGATORIA** após gerar deliverables UI.
+- **Se SIM:** Ler `.claude/skills/level-1-workflows/phase-uiux.md` e executar. **PAUSA OBRIGATORIA** após gerar deliverables UI.
 - **Se NÃO:** Pular para FASE 2.
 
 ---
 
 ## 5. FASE 2: DESIGN
 
-**Ler:** `.claude/skills/workflows/phase-design.md` para instruções detalhadas.
+**Ler:** `.claude/skills/level-1-workflows/phase-design.md` para instruções detalhadas.
 
 Resumo: gerar spec.md, contracts.cs, decisions.md com ADRs, estimar custos.
 
@@ -89,7 +89,7 @@ Apresente: spec, contracts, decisions, custos. 3 itens de pausa (aprovar, ajusta
 
 ## 6. Após Aprovação do Design → FASE 3: CLARIFY (interativo)
 
-**Ler:** `.claude/skills/workflows/phase-clarify.md` para instruções detalhadas.
+**Ler:** `.claude/skills/level-1-workflows/phase-clarify.md` para instruções detalhadas.
 
 Resumo: identificar ambiguidades, gerar 3-7 perguntas, aguardar respostas, atualizar spec com clarificações e edge cases.
 
@@ -99,7 +99,7 @@ Resumo: identificar ambiguidades, gerar 3-7 perguntas, aguardar respostas, atual
 
 ## 7. FASE 4: TASKS
 
-**Ler:** `.claude/skills/workflows/phase-tasks.md` para instruções detalhadas.
+**Ler:** `.claude/skills/level-1-workflows/phase-tasks.md` para instruções detalhadas.
 
 Resumo: quebrar spec em tasks T001-TXXX, definir dependências, checkpoints, estimativas.
 

package/framework/commands/morph-status.md

@@ -22,7 +22,7 @@ Este comando automaticamente mostra:
 ### 1. Configuração MORPH
 - [ ] `.morph/project.md` existe e está preenchido
 - [ ] `.morph/config/config.json` configurado
-- [ ] `.morph/standards/` presentes
+- [ ] `.morph/framework/standards/` presentes
 
 ### 2. Detalhes de Feature Específica
 
@@ -34,14 +34,14 @@ npx morph-spec state get {feature-name}
 
 ### 3. Features Arquivadas
 
-Verifique `.morph/project/archive/` manualmente se necessário:
+Verifique `.morph/archive/` manualmente se necessário:
 - Quantas features concluídas
 - Tempo total gasto
 - Custo acumulado
 
 ### 4. Specs Ativas
 
-Verifique `.morph/project/specs/` para specs consolidadas.
+Verifique `.morph/specs/` para specs consolidadas.
 
 ## Output
 

package/framework/commands/morph-troubleshoot.md

@@ -37,7 +37,7 @@ npx morph-spec troubleshoot {keywords}
 
 Se o índice retornar poucos resultados, o CLI automaticamente busca nos arquivos:
 - `framework/standards/*.md`
-- `.morph/standards/*.md`
+- `.morph/framework/standards/*.md`
 
 ### Nível 3: Web Search (Se necessário)