spec-first-claude 0.2.0 → 0.4.0

package/templates/.claude/commands/extract.md

@@ -1,137 +1,137 @@
-# /extract $ARGUMENTS
-
-Skill atômica de extração. Lê insumos brutos do PM/ e gera PRD ou TRD.
-$ARGUMENTS = nome (ex: setup_projeto, feat_cadastro_cliente)
-
-## Multi-agent
-
-| Agente | Modelo | Papel |
-|--------|--------|-------|
-| **Reader** (1 por arquivo) | Sonnet | Lê e cataloga 1 arquivo. Não interpreta, apenas cataloga |
-| **Analyzer** | Opus | Cruza fontes, detecta gaps/contradições, gera documento final |
-
-## Pré-condições
-
-| # | Validação | Se falhar |
-|---|-----------|-----------|
-| 1 | $ARGUMENTS informado | Parar → "Informe o nome" |
-| 2 | `docs/PM/$ARGUMENTS/` existe com arquivos | Parar → "Pasta vazia ou inexistente" |
-| 3 | `.context.md` existe | Parar → "Execute /feature ou /setup-projeto primeiro" |
-| 4 | Status é `not_started` ou `extract_done` | Se posterior → "Extração já aprovada" |
-
-## Passos
-
-### 1. Ler contexto
-- `.context.md` → tipo (feature/setup) e documento (PRD/TRD)
-- `discovery.md` (se existir) → análise profunda prévia dos insumos
-- `docs/Estrutura/` se existir
-- Template: tipo=feature → `PRD.template.md` | tipo=setup → `TRD.template.md`
-
-> Se `discovery.md` existir: usar mapa do sistema e perguntas já respondidas como contexto
-> enriquecido. Resultado: menos ambiguidades, melhor estruturação.
-
-### 2. Inventariar insumos
-Para cada arquivo em `docs/PM/$ARGUMENTS/` (ignorar .gitkeep):
-- Calcular hash SHA-256 (primeiros 8 chars)
-- Se `.extract-log.md` existe → classificar: NOVO / MODIFICADO / INALTERADO
-- Se não existe → todos são NOVOS
-
-### 3. Processar (simulando Reader por arquivo)
-Para cada arquivo NOVO ou MODIFICADO:
-
-| Formato | O que extrair |
-|---------|---------------|
-| .md, .txt | Requisitos, regras, contexto, restrições |
-| .sql | Entidades, campos, tipos, constraints, índices |
-| .html | Telas, campos, ações, validações, rotas, permissões |
-| .xml, .json | Fluxos, decisões, configurações |
-| .csv | Dados tabulares, mapeamentos |
-| .png, .jpg, .pdf | Análise visual (wireframes, mockups) |
-| Não identificado | Registrar como NÃO IDENTIFICADO, gerar ambiguidade |
-
-### 4. Gerar documento (simulando Analyzer)
-- Consolidar todas informações por seção do template
-- Detectar contradições entre fontes → ambiguidade
-- Detectar gaps (seções sem info) → ambiguidade
-- **Validar Checklist de Temas Críticos** (ver abaixo) — temas ausentes viram ambiguidades obrigatórias
-- Nunca inferir regra de negócio — se não explícito, é ambiguidade
-- IDs estáveis: RN-001 nunca renumera, novos continuam sequência
-- Rastreabilidade: cada info aponta pro arquivo fonte
-
-#### Checklist de Temas Críticos
-
-Após consolidar os Readers, verificar se os insumos cobrem os temas abaixo.
-Se um tema **não foi mencionado em nenhum insumo**, gera **ambiguidade obrigatória**.
-
-**Para TRD (setup):**
-
-| # | Tema | Se ausente |
-|---|------|------------|
-| 1 | **Autenticação** (JWT, OAuth, API Key, Session?) | Ambiguidade: "Nenhum mecanismo de autenticação definido" |
-| 2 | **Autorização / Roles** (perfis, RBAC, ABAC, quem acessa o quê) | Ambiguidade: "Perfis de acesso e regras de autorização não definidos" |
-| 3 | **Separação de serviços** (monolito, microserviços, API vs Worker) | Ambiguidade: "Arquitetura de serviços não definida" |
-| 4 | **Ambientes** (dev, staging, prod, Docker, CI/CD) | Ambiguidade: "Estratégia de ambientes e deploy não definida" |
-| 5 | **Dados sensíveis** (PII, LGPD, criptografia, masking) | Ambiguidade: "Tratamento de dados sensíveis / LGPD não mencionado" |
-
-**Para PRD (feature):**
-
-| # | Tema | Se ausente |
-|---|------|------------|
-| 1 | **Autenticação requerida** (quais endpoints públicos vs autenticados?) | Ambiguidade: "Não definido quais operações exigem autenticação" |
-| 2 | **Permissões / Roles** (quais perfis podem executar cada ação?) | Ambiguidade: "Não definido quais perfis têm acesso a cada operação" |
-| 3 | **Validações de entrada** (regras, limites, formatos) | Ambiguidade: "Validações de entrada não detalhadas" |
-| 4 | **Tratamento de erros** (cenários de falha, mensagens) | Ambiguidade: "Cenários de erro e mensagens ao usuário não definidos" |
-| 5 | **Impacto em dados existentes** (migração necessária?) | Ambiguidade: "Impacto em dados existentes não avaliado" |
-
-> O Analyzer NÃO inventa respostas — se não está nos insumos, PERGUNTA.
-
-### 5. Gerar roadmap de produto faseado (APENAS no setup)
-Quando tipo=setup, o Analyzer encontra informações que não são infraestrutura
-(regras de negócio, jornadas, telas, fluxos). Em vez de descartar, organizar em
-`backlog_extraido.md` como **roadmap faseado** com entregáveis incrementais.
-
-O Analyzer deve:
-1. Identificar funcionalidades, entidades, regras de negócio, jornadas, telas
-2. Mapear dependências entre elas (ex: agendamento depende de cadastro de clientes)
-3. Agrupar em **fases de entrega** por dependência + complexidade
-4. Para cada fase: definir entregável + critério de done
-5. Sugerir **1 feature única** com nome descritivo (ex: `feat_mvp`)
-6. Usar template `backlog-extraido.template.md`
-
-**Princípio**: Entregáveis contínuos — cada fase entrega valor e pode ir pra produção.
-Máximo 4-5 fases. Fase 1 sempre = fundação/cadastros base.
-
-Este arquivo:
-- É gerado APENAS no setup (não em features)
-- Serve como roadmap quando o usuário for criar `/feature`
-- O /extract da feature usa as fases como referência para o PRD
-
-### 6. Gerar `.extract-log.md`
-```markdown
-# Extract Log — $ARGUMENTS
-
-## Extração N — {{ISO_DATETIME}}
-| Arquivo | Hash | Classificação | Status | Seções alimentadas |
-|---------|------|---------------|--------|--------------------|
-```
-
-### 6. Atualizar `.context.md`
-```yaml
-status: "extract_done"
-ultima_skill: "/extract"
-atualizado_em: "{{ISO_DATETIME}}"
-```
-
-## Re-extração
-- Merge ADITIVO com documento existente (nunca remove info de inalterados)
-- Seções afetadas marcadas com `<!-- ATUALIZADO: re-extração -->`
-- Novos IDs continuam sequência
-
-## Erros
-| Erro | Ação |
-|------|------|
-| Pasta vazia | Parar, listar formatos aceitos |
-| .context.md não existe | Parar, sugerir /feature ou /setup-projeto |
-| Nenhum arquivo novo/modificado | Informar "Nenhuma alteração detectada" |
-| Arquivo não identificado | Registrar no log, gerar ambiguidade |
-| Contradição entre arquivos | Gerar ambiguidade citando os dois |
+# /extract $ARGUMENTS
+
+Skill atômica de extração. Lê insumos brutos do PM/ e gera PRD ou TRD.
+$ARGUMENTS = nome (ex: setup_projeto, feat_cadastro_cliente)
+
+## Multi-agent
+
+| Agente | Modelo | Papel |
+|--------|--------|-------|
+| **Reader** (1 por arquivo) | Sonnet | Lê e cataloga 1 arquivo. Não interpreta, apenas cataloga |
+| **Analyzer** | Opus | Cruza fontes, detecta gaps/contradições, gera documento final |
+
+## Pré-condições
+
+| # | Validação | Se falhar |
+|---|-----------|-----------|
+| 1 | $ARGUMENTS informado | Parar → "Informe o nome" |
+| 2 | `docs/PM/$ARGUMENTS/` existe com arquivos | Parar → "Pasta vazia ou inexistente" |
+| 3 | `.context.md` existe | Parar → "Execute /feature ou /setup-projeto primeiro" |
+| 4 | Status é `not_started` ou `extract_done` | Se posterior → "Extração já aprovada" |
+
+## Passos
+
+### 1. Ler contexto
+- `.context.md` → tipo (feature/setup) e documento (PRD/TRD)
+- `discovery.md` (se existir) → análise profunda prévia dos insumos
+- `docs/Estrutura/` se existir
+- Template: tipo=feature → `PRD.template.md` | tipo=setup → `TRD.template.md`
+
+> Se `discovery.md` existir: usar mapa do sistema e perguntas já respondidas como contexto
+> enriquecido. Resultado: menos ambiguidades, melhor estruturação.
+
+### 2. Inventariar insumos
+Para cada arquivo em `docs/PM/$ARGUMENTS/` (ignorar .gitkeep):
+- Calcular hash SHA-256 (primeiros 8 chars)
+- Se `.extract-log.md` existe → classificar: NOVO / MODIFICADO / INALTERADO
+- Se não existe → todos são NOVOS
+
+### 3. Processar (simulando Reader por arquivo)
+Para cada arquivo NOVO ou MODIFICADO:
+
+| Formato | O que extrair |
+|---------|---------------|
+| .md, .txt | Requisitos, regras, contexto, restrições |
+| .sql | Entidades, campos, tipos, constraints, índices |
+| .html | Telas, campos, ações, validações, rotas, permissões |
+| .xml, .json | Fluxos, decisões, configurações |
+| .csv | Dados tabulares, mapeamentos |
+| .png, .jpg, .pdf | Análise visual (wireframes, mockups) |
+| Não identificado | Registrar como NÃO IDENTIFICADO, gerar ambiguidade |
+
+### 4. Gerar documento (simulando Analyzer)
+- Consolidar todas informações por seção do template
+- Detectar contradições entre fontes → ambiguidade
+- Detectar gaps (seções sem info) → ambiguidade
+- **Validar Checklist de Temas Críticos** (ver abaixo) — temas ausentes viram ambiguidades obrigatórias
+- Nunca inferir regra de negócio — se não explícito, é ambiguidade
+- IDs estáveis: RN-001 nunca renumera, novos continuam sequência
+- Rastreabilidade: cada info aponta pro arquivo fonte
+
+#### Checklist de Temas Críticos
+
+Após consolidar os Readers, verificar se os insumos cobrem os temas abaixo.
+Se um tema **não foi mencionado em nenhum insumo**, gera **ambiguidade obrigatória**.
+
+**Para TRD (setup):**
+
+| # | Tema | Se ausente |
+|---|------|------------|
+| 1 | **Autenticação** (JWT, OAuth, API Key, Session?) | Ambiguidade: "Nenhum mecanismo de autenticação definido" |
+| 2 | **Autorização / Roles** (perfis, RBAC, ABAC, quem acessa o quê) | Ambiguidade: "Perfis de acesso e regras de autorização não definidos" |
+| 3 | **Separação de serviços** (monolito, microserviços, API vs Worker) | Ambiguidade: "Arquitetura de serviços não definida" |
+| 4 | **Ambientes** (dev, staging, prod, Docker, CI/CD) | Ambiguidade: "Estratégia de ambientes e deploy não definida" |
+| 5 | **Dados sensíveis** (PII, LGPD, criptografia, masking) | Ambiguidade: "Tratamento de dados sensíveis / LGPD não mencionado" |
+
+**Para PRD (feature):**
+
+| # | Tema | Se ausente |
+|---|------|------------|
+| 1 | **Autenticação requerida** (quais endpoints públicos vs autenticados?) | Ambiguidade: "Não definido quais operações exigem autenticação" |
+| 2 | **Permissões / Roles** (quais perfis podem executar cada ação?) | Ambiguidade: "Não definido quais perfis têm acesso a cada operação" |
+| 3 | **Validações de entrada** (regras, limites, formatos) | Ambiguidade: "Validações de entrada não detalhadas" |
+| 4 | **Tratamento de erros** (cenários de falha, mensagens) | Ambiguidade: "Cenários de erro e mensagens ao usuário não definidos" |
+| 5 | **Impacto em dados existentes** (migração necessária?) | Ambiguidade: "Impacto em dados existentes não avaliado" |
+
+> O Analyzer NÃO inventa respostas — se não está nos insumos, PERGUNTA.
+
+### 5. Gerar roadmap de produto faseado (APENAS no setup)
+Quando tipo=setup, o Analyzer encontra informações que não são infraestrutura
+(regras de negócio, jornadas, telas, fluxos). Em vez de descartar, organizar em
+`backlog_extraido.md` como **roadmap faseado** com entregáveis incrementais.
+
+O Analyzer deve:
+1. Identificar funcionalidades, entidades, regras de negócio, jornadas, telas
+2. Mapear dependências entre elas (ex: agendamento depende de cadastro de clientes)
+3. Agrupar em **fases de entrega** por dependência + complexidade
+4. Para cada fase: definir entregável + critério de done
+5. Sugerir **1 feature única** com nome descritivo (ex: `feat_mvp`)
+6. Usar template `backlog-extraido.template.md`
+
+**Princípio**: Entregáveis contínuos — cada fase entrega valor e pode ir pra produção.
+Máximo 4-5 fases. Fase 1 sempre = fundação/cadastros base.
+
+Este arquivo:
+- É gerado APENAS no setup (não em features)
+- Serve como roadmap quando o usuário for criar `/feature`
+- O /extract da feature usa as fases como referência para o PRD
+
+### 6. Gerar `.extract-log.md`
+```markdown
+# Extract Log — $ARGUMENTS
+
+## Extração N — {{ISO_DATETIME}}
+| Arquivo | Hash | Classificação | Status | Seções alimentadas |
+|---------|------|---------------|--------|--------------------|
+```
+
+### 6. Atualizar `.context.md`
+```yaml
+status: "extract_done"
+ultima_skill: "/extract"
+atualizado_em: "{{ISO_DATETIME}}"
+```
+
+## Re-extração
+- Merge ADITIVO com documento existente (nunca remove info de inalterados)
+- Seções afetadas marcadas com `<!-- ATUALIZADO: re-extração -->`
+- Novos IDs continuam sequência
+
+## Erros
+| Erro | Ação |
+|------|------|
+| Pasta vazia | Parar, listar formatos aceitos |
+| .context.md não existe | Parar, sugerir /feature ou /setup-projeto |
+| Nenhum arquivo novo/modificado | Informar "Nenhuma alteração detectada" |
+| Arquivo não identificado | Registrar no log, gerar ambiguidade |
+| Contradição entre arquivos | Gerar ambiguidade citando os dois |

package/templates/.claude/commands/feature.md

@@ -1,60 +1,60 @@
-# /feature $ARGUMENTS
-
-Orquestrador de feature. Cria contexto PRD, chama /extract e para no checkpoint.
-$ARGUMENTS = nome da feature (ex: feat_cadastro_cliente)
-
-## Execução
-
-### Convenção de nomes
-- Features: `feat_nome_descritivo`
-- Bugs: `bug_nome_descritivo`
-- Tasks técnicas: `task_nome_descritivo`
-
-### Pré-condições
-
-| # | Validação | Se falhar |
-|---|-----------|-----------|
-| 1 | $ARGUMENTS foi informado | Parar → "Informe o nome. Ex: /feature feat_cadastro_cliente" |
-| 2 | `docs/PM/$ARGUMENTS/` existe e tem arquivos | Parar → "Crie a pasta e adicione insumos" |
-| 3 | `docs/Estrutura/` está populado | Parar → "Execute /setup-projeto antes" |
-| 4 | `.context.md` não existe ou status é `not_started` | Se avançado → "Feature já em andamento. Para re-extrair, use /extract $ARGUMENTS" |
-
-### Passos
-
-1. Carregar `docs/Estrutura/` para contexto do projeto
-2. Criar `docs/Desenvolvimento/$ARGUMENTS/` se não existir
-3. Criar `.context.md`:
-```yaml
----
-nome: "$ARGUMENTS"
-tipo: "feature"
-documento: "PRD"
-pm_path: "docs/PM/$ARGUMENTS/"
-status: "not_started"
-ultima_skill: "/feature"
-atualizado_em: "{{ISO_DATETIME}}"
----
-```
-4. Sugerir /sf-discovery (RECOMENDADO):
-```
-📋 Recomendo rodar /sf-discovery antes da extração para análise profunda dos insumos.
-Quer rodar /sf-discovery docs/PM/$ARGUMENTS/ agora? (s/n)
-```
-Se SIM → rodar discovery, salvar discovery.md em docs/Desenvolvimento/$ARGUMENTS/
-Se NÃO → pular direto para extract
-
-5. Executar /extract $ARGUMENTS
-6. CHECKPOINT — Parar e informar:
-```
-✅ PRD gerado em docs/Desenvolvimento/$ARGUMENTS/PRD.md
-
-Revise o documento. Quando estiver satisfeito, execute:
-  /design $ARGUMENTS
-
-Se precisar adicionar mais insumos:
-  /extract $ARGUMENTS
-```
-
-### Notas
-- Pode ser executado múltiplas vezes (uma por feature)
-- Pipeline inclui /merge-delta no final (diferente do setup)
+# /feature $ARGUMENTS
+
+Orquestrador de feature. Cria contexto PRD, chama /extract e para no checkpoint.
+$ARGUMENTS = nome da feature (ex: feat_cadastro_cliente)
+
+## Execução
+
+### Convenção de nomes
+- Features: `feat_nome_descritivo`
+- Bugs: `bug_nome_descritivo`
+- Tasks técnicas: `task_nome_descritivo`
+
+### Pré-condições
+
+| # | Validação | Se falhar |
+|---|-----------|-----------|
+| 1 | $ARGUMENTS foi informado | Parar → "Informe o nome. Ex: /feature feat_cadastro_cliente" |
+| 2 | `docs/PM/$ARGUMENTS/` existe e tem arquivos | Parar → "Crie a pasta e adicione insumos" |
+| 3 | `docs/Estrutura/` está populado | Parar → "Execute /setup-projeto antes" |
+| 4 | `.context.md` não existe ou status é `not_started` | Se avançado → "Feature já em andamento. Para re-extrair, use /extract $ARGUMENTS" |
+
+### Passos
+
+1. Carregar `docs/Estrutura/` para contexto do projeto
+2. Criar `docs/Desenvolvimento/$ARGUMENTS/` se não existir
+3. Criar `.context.md`:
+```yaml
+---
+nome: "$ARGUMENTS"
+tipo: "feature"
+documento: "PRD"
+pm_path: "docs/PM/$ARGUMENTS/"
+status: "not_started"
+ultima_skill: "/feature"
+atualizado_em: "{{ISO_DATETIME}}"
+---
+```
+4. Sugerir /sf-discovery (RECOMENDADO):
+```
+📋 Recomendo rodar /sf-discovery antes da extração para análise profunda dos insumos.
+Quer rodar /sf-discovery docs/PM/$ARGUMENTS/ agora? (s/n)
+```
+Se SIM → rodar discovery, salvar discovery.md em docs/Desenvolvimento/$ARGUMENTS/
+Se NÃO → pular direto para extract
+
+5. Executar /extract $ARGUMENTS
+6. CHECKPOINT — Parar e informar:
+```
+✅ PRD gerado em docs/Desenvolvimento/$ARGUMENTS/PRD.md
+
+Revise o documento. Quando estiver satisfeito, execute:
+  /design $ARGUMENTS
+
+Se precisar adicionar mais insumos:
+  /extract $ARGUMENTS
+```
+
+### Notas
+- Pode ser executado múltiplas vezes (uma por feature)
+- Pipeline inclui /merge-delta no final (diferente do setup)

package/templates/.claude/commands/merge-delta.md

@@ -1,70 +1,70 @@
-# /merge-delta $ARGUMENTS
-
-Skill atômica pós-dev. Aplica Delta Specs do SDD em docs/Estrutura/.
-$ARGUMENTS = nome (ex: feat_cadastro_cliente)
-
-## Agente: Integrator (Sonnet)
-Meticuloso com consistência. Aplica apenas o que Delta Specs diz.
-
-## Pré-condições
-
-| # | Validação | Se falhar |
-|---|-----------|-----------|
-| 1 | $ARGUMENTS informado | Parar |
-| 2 | `.context.md` com status `dev_done` | Se anterior → "/dev primeiro" |
-| 3 | `.context.md` tipo é `feature` | Se setup → "Setup não usa merge-delta" |
-| 4 | `sdd.md` §11 Delta Specs preenchida | Parar |
-| 5 | `docs/Estrutura/` populado | Parar |
-
-## Passos
-
-### 1. Ler SDD §11 Delta Specs
-
-| Tipo | Significado |
-|------|------------|
-| ADDED | Elemento novo (tabela, endpoint, tela) |
-| MODIFIED | Elemento existente alterado |
-| REMOVED | Elemento removido |
-
-### 2. Mapear para docs alvo
-
-| Elemento | Doc |
-|----------|-----|
-| Tabelas, colunas, índices | Modelo_Dados.md |
-| Endpoints, contratos | API.md |
-| Decisões arquiteturais | Arquitetura.md + ADRs.md |
-| Infra | Infraestrutura.md |
-| Segurança | Seguranca.md |
-| Stack | Stack.md |
-| Visão/escopo | Visao.md |
-
-### 3. Aplicar deltas
-Para cada delta, no doc alvo:
-- ADDED → adicionar conteúdo na seção apropriada
-- MODIFIED → localizar e atualizar elemento
-- REMOVED → remover ou marcar deprecated
-
-### 4. Registrar changelog (em cada doc afetado)
-```markdown
-## Changelog
-| Data | Feature | Tipo | Descrição |
-|------|---------|------|-----------|
-| {{data}} | $ARGUMENTS | ADDED | ... |
-```
-
-### 5. Validar consistência
-- Referências quebradas? Reportar.
-- REMOVED deixou órfãos? Reportar.
-
-### 6. Atualizar
-- `.context.md` → status: `done`
-- `progresso.md` global → feature concluída
-- Informar ao usuário docs atualizados
-
-## Erros
-| Erro | Ação |
-|------|------|
-| Status não é dev_done | Parar |
-| Tipo é setup | Parar — setup não usa merge-delta |
-| Delta Specs vazia | Marcar done (legítimo em refactors) |
-| Elemento não encontrado | Parar, pedir resolução |
+# /merge-delta $ARGUMENTS
+
+Skill atômica pós-dev. Aplica Delta Specs do SDD em docs/Estrutura/.
+$ARGUMENTS = nome (ex: feat_cadastro_cliente)
+
+## Agente: Integrator (Sonnet)
+Meticuloso com consistência. Aplica apenas o que Delta Specs diz.
+
+## Pré-condições
+
+| # | Validação | Se falhar |
+|---|-----------|-----------|
+| 1 | $ARGUMENTS informado | Parar |
+| 2 | `.context.md` com status `dev_done` | Se anterior → "/dev primeiro" |
+| 3 | `.context.md` tipo é `feature` | Se setup → "Setup não usa merge-delta" |
+| 4 | `sdd.md` §11 Delta Specs preenchida | Parar |
+| 5 | `docs/Estrutura/` populado | Parar |
+
+## Passos
+
+### 1. Ler SDD §11 Delta Specs
+
+| Tipo | Significado |
+|------|------------|
+| ADDED | Elemento novo (tabela, endpoint, tela) |
+| MODIFIED | Elemento existente alterado |
+| REMOVED | Elemento removido |
+
+### 2. Mapear para docs alvo
+
+| Elemento | Doc |
+|----------|-----|
+| Tabelas, colunas, índices | Modelo_Dados.md |
+| Endpoints, contratos | API.md |
+| Decisões arquiteturais | Arquitetura.md + ADRs.md |
+| Infra | Infraestrutura.md |
+| Segurança | Seguranca.md |
+| Stack | Stack.md |
+| Visão/escopo | Visao.md |
+
+### 3. Aplicar deltas
+Para cada delta, no doc alvo:
+- ADDED → adicionar conteúdo na seção apropriada
+- MODIFIED → localizar e atualizar elemento
+- REMOVED → remover ou marcar deprecated
+
+### 4. Registrar changelog (em cada doc afetado)
+```markdown
+## Changelog
+| Data | Feature | Tipo | Descrição |
+|------|---------|------|-----------|
+| {{data}} | $ARGUMENTS | ADDED | ... |
+```
+
+### 5. Validar consistência
+- Referências quebradas? Reportar.
+- REMOVED deixou órfãos? Reportar.
+
+### 6. Atualizar
+- `.context.md` → status: `done`
+- `progresso.md` global → feature concluída
+- Informar ao usuário docs atualizados
+
+## Erros
+| Erro | Ação |
+|------|------|
+| Status não é dev_done | Parar |
+| Tipo é setup | Parar — setup não usa merge-delta |
+| Delta Specs vazia | Marcar done (legítimo em refactors) |
+| Elemento não encontrado | Parar, pedir resolução |