@polymorphism-tech/morph-spec 4.7.2 → 4.8.4

package/framework/skills/level-1-workflows/phase-setup/SKILL.md

@@ -1,171 +1,169 @@
----
-name: phase-setup
-description: MORPH-SPEC Phase 1 (Setup). Reads project context, detects tech stack, activates relevant agents via detect-agents, and confirms the feature environment. Use at the start of every MORPH-SPEC feature workflow after proposal approval to load standards and initialize the context.
-argument-hint: "[feature-name]"
-user-invocable: false
-allowed-tools: Read, Write, Edit, Bash, Glob, Grep
----
-
-# MORPH Setup - FASE 1
-
-> INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
-
-Inicialize o contexto e prepare o ambiente para uma feature aprovada.
-
-## Pré-requisitos
-
-- [ ] Feature tem `proposal.md` criado (FASE 0 concluída)
-- [ ] Proposal foi aprovado pelo usuário
-- [ ] Agentes foram detectados e registrados no state
-
-## Ferramentas Recomendadas
-
-> **Ref:** `framework/skills/level-0-meta/tool-usage-guide/SKILL.md` para guia completo.
-> **Ref:** `framework/standards/integration/mcp/mcp-tools.md` para referência MCP.
-
-| Ação | Ferramenta | Alternativa |
-|------|------------|-------------|
-| Verificar state | **Bash** `npx morph-spec state get` | — |
-| Detectar agentes + standards | **Bash** `npx morph-spec detect-agents --json` | — |
-| Ler contexto do projeto | **Read** `.morph/context/README.md` | — |
-| Ler config | **Read** `.morph/config.json` | — |
-| Escanear estrutura do projeto | **Glob** `src/**/*.{ts,tsx,cs}` | — |
-| Metadata do repositório | **GitHub MCP** `get_repo()` | **Bash** `gh repo view --json` |
-| Atualizar state | **Bash** `npx morph-spec state set` | — |
-
-**MCPs desta fase:** GitHub (opcional — metadata do repo).
-
-**Anti-padrões:**
-- ❌ Task agent para detectar stack (detect-agents CLI já faz isso)
-- ❌ WebSearch para info local do projeto (use Read/Glob)
-- ❌ Ler agents.json manualmente (detect-agents retorna standards processados)
-
----
-
-## Workflow
-
-### CHECKPOINT DE ENTRADA: Verificar Pré-requisitos
-
-**⏸️ Antes de prosseguir com setup:**
-
-- [ ] `proposal.md` existe em `.morph/features/$ARGUMENTS/`?
-- [ ] Proposal foi apresentado e aprovado pelo usuário?
-- [ ] Feature foi registrada no state?
-
-**❌ Se alguma checkbox NÃO estiver marcada:**
-→ Voltar para FASE 0 (Proposal)
-
----
-
-### Passo 1: Verificar State
-
-Confirme que a feature existe no state:
-
-```bash
-npx morph-spec state get $ARGUMENTS
-```
-
-Se não existir, volte para FASE 0 (proposal).
-
-### Passo 2: Carregar Contexto e Standards Automaticamente
-
-**Use detect-agents --json para obter standards context:**
-
-```bash
-npx morph-spec detect-agents --json "{feature description from proposal}"
-```
-
-O output JSON contém `standardsSummary` com todos os standards relevantes para cada agente ativo:
-
-```json
-{
-  "standardsSummary": {
-    "blazor-builder": {
-      "standards": ["blazor-lifecycle", "blazor-state", "coding", ...],
-      "fullContent": "# blazor-lifecycle\n\n...",  // Full standards text
-      "count": 10
-    }
-  }
-}
-```
-
-**Standards resolution order** (automático):
-1. `.morph/context/*.md` (project overrides - highest priority)
-2. `.morph/framework/standards/*.md` (AI Agent Framework, Azure)
-3. `framework/standards/*.md` (Blazor, CSS, .NET)
-4. `.morph/context/inferred.md` (always loaded if exists)
-
-**Contexto geral** (leia manualmente):
-- `.morph/context/README.md` - Overview do projeto
-- `.morph/config.json` - Configurações
-
-### Passo 3: Confirmar Stack
-
-Baseado no proposal e contexto, confirme:
-- Stack tecnológica (Blazor Server, Next.js, etc.)
-- Padrões arquiteturais aplicáveis
-- Componentes reutilizáveis existentes
-
-### Passo 4: Listar Agentes Ativos
-
-Mostre os agentes detectados no proposal:
-
-```bash
-npx morph-spec state get $ARGUMENTS
-```
-
-Parse o JSON e liste os `activeAgents` com seus emojis e responsabilidades (consulte `.morph/framework/agents.json`).
-
-### Passo 5: Atualizar State
-
-Marque a feature como na fase SETUP:
-
-```bash
-npx morph-spec state set $ARGUMENTS phase setup
-npx morph-spec state set $ARGUMENTS status in_progress
-```
-
-## Outputs
-
-**Apresente ao usuário:**
-
-1. **Contexto carregado**:
-   - Nome do projeto
-   - Stack confirmado
-   - Standards aplicáveis
-
-2. **Agentes ativos**:
-   - Lista de agentes com emojis
-   - Responsabilidades de cada um
-
-## Critérios de Avanço
-
-- [x] Contexto do projeto carregado
-- [x] Standards identificados (framework + project)
-- [x] Stack confirmado
-- [x] Agentes listados
-- [x] State atualizado para phase: setup
-
----
-
-## Integração com Superpowers
-
-> Disponível quando o plugin `superpowers` está instalado.
-
-| Skill | Quando Usar | Invocação |
-|-------|-------------|-----------|
-| `using-git-worktrees` | Se feature requer isolamento do workspace | `Skill(superpowers:using-git-worktrees)` |
-
----
-
-## Outputs desta Fase
-
-<!-- morph:outputs:proposal -->
-| Output | Caminho |
-|--------|---------|
-| `proposal` | `.morph/features/{feature}/0-proposal/proposal.md` |
-<!-- /morph:outputs -->
-
----
-
+---
+name: phase-setup
+description: MORPH-SPEC Phase 1 (Setup). Reads project context, detects tech stack, activates relevant agents by reading agents.json, and confirms the feature environment. Use at the start of every MORPH-SPEC feature workflow after proposal approval to load standards and initialize the context.
+argument-hint: "[feature-name]"
+user-invocable: false
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep
+cliVersion: "4.8.4"
+---
+
+# MORPH Setup - FASE 1
+
+> INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
+
+Inicialize o contexto e prepare o ambiente para uma feature aprovada.
+
+## Pré-requisitos
+
+- [ ] Feature tem `proposal.md` criado (FASE 0 concluída)
+- [ ] Proposal foi aprovado pelo usuário
+- [ ] Agentes foram detectados e registrados no state
+
+## Ferramentas Recomendadas
+
+> **Ref:** `framework/skills/level-0-meta/tool-usage-guide/SKILL.md` para guia completo.
+> **Ref:** `framework/standards/integration/mcp/mcp-tools.md` para referência MCP.
+
+| Ação | Ferramenta | Alternativa |
+|------|------------|-------------|
+| Verificar state | **Bash** `npx morph-spec state get` | — |
+| Detectar agentes + standards | **Read** `.morph/framework/agents.json` → match keywords → **Bash** `npx morph-spec state add-agent` | — |
+| Ler contexto do projeto | **Read** `.morph/context/README.md` | — |
+| Ler config | **Read** `.morph/config.json` | — |
+| Escanear estrutura do projeto | **Glob** `src/**/*.{ts,tsx,cs}` | — |
+| Metadata do repositório | **GitHub MCP** `get_repo()` | **Bash** `gh repo view --json` |
+| Atualizar state | **Bash** `npx morph-spec state set` | — |
+
+**MCPs desta fase:** GitHub (opcional — metadata do repo).
+
+**Anti-padrões:**
+- ❌ Chamar `detect-agents` CLI (não existe — leia `.morph/framework/agents.json` diretamente)
+- ❌ Task agent para detectar stack (leia agents.json e faça o match de keywords inline)
+- ❌ WebSearch para info local do projeto (use Read/Glob)
+
+---
+
+## Workflow
+
+### CHECKPOINT DE ENTRADA: Verificar Pré-requisitos
+
+**⏸️ Antes de prosseguir com setup:**
+
+- [ ] `proposal.md` existe em `.morph/features/$ARGUMENTS/`?
+- [ ] Proposal foi apresentado e aprovado pelo usuário?
+- [ ] Feature foi registrada no state?
+
+**❌ Se alguma checkbox NÃO estiver marcada:**
+→ Voltar para FASE 0 (Proposal)
+
+---
+
+### Passo 1: Verificar State
+
+Confirme que a feature existe no state:
+
+```bash
+npx morph-spec state get $ARGUMENTS
+```
+
+Se não existir, volte para FASE 0 (proposal).
+
+### Passo 2: Detectar Agentes e Carregar Standards
+
+**Leia agents.json diretamente e faça o match de keywords:**
+
+1. Leia `.morph/framework/agents.json`
+2. Extraia título e descrição da feature de `0-proposal/proposal.md`
+3. Para cada agente no JSON, verifique se alguma keyword do campo `keywords[]` aparece no texto da proposta
+4. Adicione os agentes correspondentes ao state:
+
+```bash
+npx morph-spec state add-agent $ARGUMENTS {agent-id}
+# Exemplo:
+npx morph-spec state add-agent $ARGUMENTS dotnet-senior
+npx morph-spec state add-agent $ARGUMENTS ef-modeler
+```
+
+**Para carregar standards dos agentes detectados:**
+- Para cada agente ativo, leia os standards referenciados pelo campo `standards[]` em `agents.json`
+- Os arquivos de standard ficam em `.morph/framework/standards/{path}`
+
+**Standards resolution order** (manual):
+1. `.morph/context/*.md` — project overrides (maior prioridade)
+2. `.morph/framework/standards/` — standards instalados pelo morph-spec
+3. `framework/standards/` — standards do pacote npm (fallback)
+
+**Contexto geral** (leia sempre):
+- `.morph/context/README.md` — Overview do projeto
+- `.morph/config/config.json` — Configurações
+
+### Passo 3: Confirmar Stack
+
+Baseado no proposal e contexto, confirme:
+- Stack tecnológica (Blazor Server, Next.js, etc.)
+- Padrões arquiteturais aplicáveis
+- Componentes reutilizáveis existentes
+
+### Passo 4: Listar Agentes Ativos
+
+Mostre os agentes detectados no proposal:
+
+```bash
+npx morph-spec state get $ARGUMENTS
+```
+
+Parse o JSON e liste os `activeAgents` com seus emojis e responsabilidades (consulte `.morph/framework/agents.json`).
+
+### Passo 5: Atualizar State
+
+Marque a feature como na fase SETUP:
+
+```bash
+npx morph-spec state set $ARGUMENTS phase setup
+npx morph-spec state set $ARGUMENTS status in_progress
+```
+
+## Outputs
+
+**Apresente ao usuário:**
+
+1. **Contexto carregado**:
+   - Nome do projeto
+   - Stack confirmado
+   - Standards aplicáveis
+
+2. **Agentes ativos**:
+   - Lista de agentes com emojis
+   - Responsabilidades de cada um
+
+## Critérios de Avanço
+
+- [x] Contexto do projeto carregado
+- [x] Standards identificados (framework + project)
+- [x] Stack confirmado
+- [x] Agentes listados
+- [x] State atualizado para phase: setup
+
+---
+
+## Integração com Superpowers
+
+> Disponível quando o plugin `superpowers` está instalado.
+
+| Skill | Quando Usar | Invocação |
+|-------|-------------|-----------|
+| `using-git-worktrees` | Se feature requer isolamento do workspace | `Skill(superpowers:using-git-worktrees)` |
+
+---
+
+## Outputs desta Fase
+
+<!-- morph:outputs:proposal -->
+| Output | Caminho |
+|--------|---------|
+| `proposal` | `.morph/features/{feature}/0-proposal/proposal.md` |
+<!-- /morph:outputs -->
+
+---
+
 Continuar automaticamente para próxima fase (UI/UX se detectado, ou Design).