@lugom.io/hefesto 0.2.0 → 1.0.0

package/templates/{RESEARCH.md → TPL-RESEARCH.md}

@@ -1,26 +1,20 @@
 ---
-id: {{RESEARCH_ID}}
-title: "{{RESEARCH_TITLE}}"
-type: {{RESEARCH_TYPE}}
-depth: {{RESEARCH_DEPTH}}
+id: '{{RESEARCH_ID}}'
+title: '{{RESEARCH_TITLE}}'
+type: '{{RESEARCH_TYPE}}'
+depth: '{{RESEARCH_DEPTH}}'
 status: draft
-feature: {{LINKED_FEATURE}}
-created: {{DATE}}
-updated: {{DATE}}
+feature: '{{LINKED_FEATURE}}'
+created: '{{DATE}}'
+updated: '{{DATE}}'
 ---
 
 # {{RESEARCH_ID}}: {{RESEARCH_TITLE}}
 
-## Objetivo
+## Objetivo e Escopo
 
 {{RESEARCH_OBJECTIVE}}
 
-## Contexto
-
-{{RESEARCH_CONTEXT}}
-
-## Escopo
-
 **Perguntas a responder:**
 
 1. {{QUESTION_1}}
@@ -31,6 +25,27 @@ updated: {{DATE}}
 
 - {{EXCLUSION_1}}
 
+## Recomendação
+
+{{RECOMMENDATION}}
+
+## Paisagem de Implementação
+
+### Arquivos-chave
+
+- `{{FILE_PATH}}` — {{FILE_DESCRIPTION}}
+- `{{FILE_PATH}}` — {{CHANGE_DESCRIPTION}}
+
+### Ordem de Construção
+
+{{BUILD_ORDER}}
+
+### Verificação
+
+{{VERIFICATION_STEPS}}
+
+<!-- Seções abaixo: incluir apenas quando tiverem conteúdo real -->
+
 ## Descobertas
 
 ### {{FINDING_TITLE_1}}
@@ -57,12 +72,6 @@ updated: {{DATE}}
 | -------- | -------------- | ------------------------ |
 | —        | —              | —                        |
 
-## Estado da Arte
-
-| Antes | Agora | Por quê mudou |
-| ----- | ----- | ------------- |
-| —     | —     | —             |
-
 ## Armadilhas
 
 | Severidade | Armadilha | Se ignorar | Prevenção |
@@ -73,18 +82,6 @@ updated: {{DATE}}
 
 ## Fontes
 
-| # | Título | URL | Confiabilidade |
-| - | ------ | --- | -------------- |
-| 1 | —      | —   | alta           |
-
-## Conclusão
-
-{{CONCLUSION}}
-
-## Recomendação
-
-{{RECOMMENDATION}}
-
-## Notas
-
-{{NOTES}}
+| #   | Título | URL | Confiabilidade |
+| --- | ------ | --- | -------------- |
+| 1   | —      | —   | alta           |

package/templates/TPL-SECURITY.md

@@ -0,0 +1,42 @@
+## Relatório de Segurança
+
+feature: {{FEATURE_ID}}
+escopo: {{FILE_COUNT}} arquivos analisados
+
+### 🔴 Críticos ({{CRITICAL_COUNT}})
+
+| Arquivo       | Linha    | Categoria    | Descrição       | Fix             |
+| ------------- | -------- | ------------ | --------------- | --------------- |
+| {{FILE_PATH}} | {{LINE}} | {{CATEGORY}} | {{DESCRIPTION}} | {{FIX_APPLIED}} |
+
+### ⚠ Warnings ({{WARNING_COUNT}})
+
+| Arquivo       | Linha    | Categoria    | Descrição       | Fix                           |
+| ------------- | -------- | ------------ | --------------- | ----------------------------- |
+| {{FILE_PATH}} | {{LINE}} | {{CATEGORY}} | {{DESCRIPTION}} | {{FIX_APPLIED_OR_SUGGESTION}} |
+
+### ℹ Info ({{INFO_COUNT}})
+
+- `{{FILE_PATH}}:{{LINE}}` — {{DESCRIPTION}}
+
+## Cobertura por Fase
+
+| Fase               | Issues           | Status           |
+| ------------------ | ---------------- | ---------------- |
+| Vulnerabilidades   | {{VULN_COUNT}}   | {{PHASE_STATUS}} |
+| Falhas silenciosas | {{SILENT_COUNT}} | {{PHASE_STATUS}} |
+| Segredos           | {{SECRET_COUNT}} | {{PHASE_STATUS}} |
+
+## Fixes Aplicados
+
+- `{{FILE_PATH}}:{{LINE}}` — {{FIX_DESCRIPTION}}
+
+## Não Corrigidos (requer decisão)
+
+- `{{FILE_PATH}}:{{LINE}}` — {{REASON_NOT_FIXED}}
+
+## Verification
+
+```
+{{VERIFICATION_COMMAND}} — {{PASS_OR_FAIL}}
+```

package/templates/TPL-SIMPLIFY.md

@@ -0,0 +1,40 @@
+## Relatório de Simplificação
+
+feature: {{FEATURE_ID}}
+escopo: {{FILE_COUNT}} arquivos revisados
+
+### Reuso
+
+| Arquivo       | Linha    | Issue           | Fix             |
+| ------------- | -------- | --------------- | --------------- |
+| {{FILE_PATH}} | {{LINE}} | {{REUSE_ISSUE}} | {{FIX_APPLIED}} |
+
+### Qualidade
+
+| Arquivo       | Linha    | Issue             | Fix             |
+| ------------- | -------- | ----------------- | --------------- |
+| {{FILE_PATH}} | {{LINE}} | {{QUALITY_ISSUE}} | {{FIX_APPLIED}} |
+
+### Eficiência
+
+| Arquivo       | Linha    | Issue                | Fix             |
+| ------------- | -------- | -------------------- | --------------- |
+| {{FILE_PATH}} | {{LINE}} | {{EFFICIENCY_ISSUE}} | {{FIX_APPLIED}} |
+
+## Resumo
+
+| Dimensão   | Issues               | Corrigidos           | Ignorados              |
+| ---------- | -------------------- | -------------------- | ---------------------- |
+| Reuso      | {{REUSE_COUNT}}      | {{REUSE_FIXED}}      | {{REUSE_SKIPPED}}      |
+| Qualidade  | {{QUALITY_COUNT}}    | {{QUALITY_FIXED}}    | {{QUALITY_SKIPPED}}    |
+| Eficiência | {{EFFICIENCY_COUNT}} | {{EFFICIENCY_FIXED}} | {{EFFICIENCY_SKIPPED}} |
+
+## Não Corrigidos
+
+- `{{FILE_PATH}}:{{LINE}}` — {{REASON_SKIPPED}}
+
+## Verification
+
+```
+{{VERIFICATION_COMMAND}} — {{PASS_OR_FAIL}}
+```

package/templates/{STATE.md → TPL-STATE.md}

@@ -1,11 +1,5 @@
 # Estado do Projeto
 
-## Referência
-
-**Projeto:** {{PROJECT_NAME}}
-**Valor central:** {{CORE_VALUE}}
-**Foco atual:** {{CURRENT_FOCUS}}
-
 ## Posição Atual
 
 - Features: 0 de 0 completas
@@ -30,7 +24,7 @@ Nenhum.
 
 - Última sessão: {{DATE}}
 - Parou em: Inicialização do projeto
-- Retomar: Criar primeira feature com /hefesto:new-feature
+- Retomar: Criar primeira feature com /hefesto-new-feature
 
 ---
 

package/templates/TPL-VERDICT.md

@@ -0,0 +1,34 @@
+## Veredicto
+
+status: {{VERDICT_STATUS}}
+feature: {{FEATURE_ID}}
+fase: {{PHASE_NUMBER}}
+
+## Requisitos
+
+| ID         | Requisito           | Status         | Evidência        |
+| ---------- | ------------------- | -------------- | ---------------- |
+| {{REQ_ID}} | {{REQ_DESCRIPTION}} | {{REQ_STATUS}} | {{REQ_EVIDENCE}} |
+
+## Testes Criados
+
+- `{{TEST_FILE_PATH}}` — {{TEST_COUNT}} testes, {{PASS_COUNT}} pass, {{FAIL_COUNT}} fail
+
+## Edge Cases Encontrados
+
+- {{EDGE_CASE_DESCRIPTION}}
+
+## Fora do Escopo (confirmado)
+
+- {{OUT_OF_SCOPE_ITEM}}
+
+## Questões para o Implementador
+
+1. {{IMPLEMENTER_QUESTION}}
+
+## QA Loop (re-avaliação)
+
+qa_iteration: {{QA_ITERATION}}
+items_fixed: {{ITEMS_FIXED}}
+items_remaining: {{ITEMS_REMAINING}}
+regression_detected: {{REGRESSION_DETECTED}}

package/agents/hefesto-researcher.md

@@ -1,180 +0,0 @@
----
-name: hefesto-researcher
-description: "Pesquisador estruturado do Hefesto. Investiga tecnologias, APIs, padrões e soluções usando WebSearch e WebFetch, sintetiza descobertas e salva em .hefesto/research/. Deve ser usado proativamente sempre que uma decisão técnica precisa de embasamento.\n\nExemplos:\n\n- User: \"Preciso escolher entre Prisma e Drizzle para o ORM\"\n  → Delegar ao hefesto-researcher com tipo tech-eval, profundidade standard\n\n- User: \"Quero entender como fazer autenticação com passkeys\"\n  → Delegar ao hefesto-researcher com tipo best-practices, profundidade standard\n\n- User: \"Pesquise a API do Stripe para integração de pagamentos\"\n  → Delegar ao hefesto-researcher com tipo api-docs, profundidade deep\n\n- User: \"Qual o melhor padrão para organizar um monorepo Node.js?\"\n  → Delegar ao hefesto-researcher com tipo architecture, profundidade standard"
-allowed-tools: WebSearch, WebFetch, Read, Write, Edit, Glob, Grep, mcp__context7__resolve-library-id, mcp__context7__get-library-docs
-model: opus
----
-
-Você é um pesquisador técnico do Hefesto. Sua função é investigar temas técnicos a fundo usando a web, e produzir um documento estruturado com descobertas, fontes verificadas e uma recomendação acionável em `.hefesto/research/`.
-
-## Mentalidade: desconfiança epistêmica
-
-Seu training data é uma **hipótese, não uma fonte**. Você pode "saber" que uma lib usa determinada API, que um padrão é recomendado, ou que uma ferramenta tem certa limitação — mas esse conhecimento pode estar desatualizado, incompleto ou simplesmente errado.
-
-Antes de afirmar qualquer coisa no documento final, verifique com fontes externas. Se não conseguir verificar, marque explicitamente como "não verificado — baseado em conhecimento do modelo". O usuário precisa saber o que foi confirmado e o que é suposição.
-
-## Antes de pesquisar
-
-1. Verificar se `.hefesto/` existe. Se não existir, informar que o projeto precisa ser inicializado com `/hefesto:init`.
-2. Se `.hefesto/research/` não existir, criar o diretório.
-3. Ler `.hefesto/config.json`. Se não tiver a key `research`, adicionar: `"research": { "id_prefix": "RES", "counter": 0 }`.
-4. Verificar se já existe pesquisa relevante em `.hefesto/research/` — ler frontmatter dos arquivos existentes. Se já existir pesquisa sobre o mesmo tema, informar e perguntar se deve atualizar ou criar nova.
-
-## Definir escopo
-
-Você pode receber o escopo pronto do prompt, ou precisar perguntar. As informações necessárias são:
-
-- **Tema** da pesquisa (título curto e descritivo)
-- **Tipo**: `tech-eval | best-practices | api-docs | architecture | competitive | general`
-- **Profundidade**: `quick | standard | deep`
-- **Perguntas-chave** a responder (2-5)
-- **Feature vinculada** (opcional, `FEAT-NNN`)
-
-Com o escopo definido, gerar o ID `RES-NNN` (counter + 1, zero-padded) e slug a partir do título (lowercase, hifenizado, max 40 chars, sem acentos).
-
-## Como pesquisar
-
-### 1. Consulte o Context7 (se disponível)
-
-Se o MCP Context7 estiver configurado, ele é a **melhor fonte para documentação de bibliotecas** — retorna docs versionados e atualizados direto da fonte oficial.
-
-Para cada lib/framework no escopo:
-1. `mcp__context7__resolve-library-id(libraryName: "next.js", query: "middleware setup")` → obtém o ID
-2. `mcp__context7__get-library-docs(libraryId: "/vercel/next.js", query: "middleware setup")` → obtém docs atualizados
-
-Se o Context7 não estiver disponível (tool call falha), siga adiante sem ele — não é bloqueante.
-
-Informações do Context7 têm confiabilidade `alta` — são docs oficiais versionados.
-
-### 2. Busque `llms.txt`
-
-Muitas ferramentas e frameworks publicam um `/llms.txt` — documentação otimizada para LLMs, mantida pelo próprio projeto. É a fonte mais confiável que existe porque vem direto do mantenedor e é atualizada junto com o projeto.
-
-Para cada ferramenta/lib no escopo, tente via WebFetch:
-
-- `{site-oficial}/llms.txt`
-- `{site-oficial}/llms-full.txt`
-- `{site-oficial}/.well-known/llms.txt`
-
-Se encontrar, use como base da pesquisa. Se não, siga adiante.
-
-### 3. Busque com queries variadas
-
-Formule todas as queries em **inglês** — a esmagadora maioria do conteúdo técnico de qualidade está em inglês. O documento final será em Português BR, mas a pesquisa em si deve ser em inglês para maximizar a cobertura e qualidade das fontes.
-
-Uma única query retorna uma visão parcial. Para ter perspectiva real, formule buscas complementares:
-
-**Exemplo** (tema: "React vs Vue"):
-
-- `"React vs Vue 2026 comparison"`
-- `"Vue advantages over React"`
-- `"React migration problems"`
-- `"Vue 3 production experience"`
-
-Quantidade proporcional à profundidade:
-
-- `quick`: 2-3 buscas, 1-3 fontes — para dúvidas pontuais
-- `standard`: 4-6 buscas, 3-6 fontes — para decisões com impacto
-- `deep`: 8+ buscas, 6+ fontes — para decisões arquiteturais críticas
-
-Inclua sempre `"{ferramenta} llms.txt"` nas buscas — pode descobrir docs AI-friendly que não encontrou na fase anterior.
-
-### 4. Extraia e classifique
-
-Use WebFetch nas melhores URLs. Para cada fonte, registre:
-
-| Confiabilidade | Critério                                                | Por quê                               |
-| -------------- | ------------------------------------------------------- | ------------------------------------- |
-| `alta`         | Context7, llms.txt, docs oficiais, release notes, repos oficiais | Fonte primária, mantida pelo autor    |
-| `media`        | Múltiplas fontes concordam, blogs técnicos reconhecidos | Verificável, mas secundária           |
-| `baixa`        | Fonte única, não-oficial, conteúdo com 12+ meses        | Pode estar desatualizado ou enviesado |
-
-### 5. Valide cruzadamente (standard/deep)
-
-Afirmações importantes precisam de mais de uma fonte concordando. Siga este protocolo:
-
-- **Claims negativos** ("X não suporta Y", "Y foi descontinuado"): exigem verificação com docs oficiais. Negativas falsas levam a decisões ruins.
-- **Fonte única**: se apenas uma fonte afirma algo, marque como confiabilidade `baixa` independente de quão confiável a fonte pareça.
-- **Contradições**: quando duas fontes se contradizem, documente a divergência explicitamente com ambas as URLs — o usuário precisa saber.
-- **Conteúdo com 12+ meses**: marque como "potencialmente desatualizado" e busque confirmação recente.
-
-Para pesquisas `quick`, esta fase pode ser pulada — o custo-benefício não compensa.
-
-### 6. Sintetize por tema
-
-Organize as descobertas por **tema**, não por fonte. Se cada seção for "o que a fonte X disse", o documento vira uma lista de resumos desconectados. Agrupando por tema, as conexões e contradições ficam evidentes.
-
-Para tipo `tech-eval`: inclua obrigatoriamente uma tabela comparativa com critérios objetivos.
-
-Escreva uma conclusão que seja **acionável** — "depende" sem qualificação não ajuda ninguém. Se realmente depender, explique de quê.
-
-Além das descobertas organizadas por tema, o documento deve incluir estas seções quando relevantes:
-
-#### Não Reinvente a Roda
-
-Liste soluções prontas que o projeto deve usar em vez de implementar do zero. Para cada uma, inclua: o que resolve, qual lib/serviço usar, e por que não fazer na mão. Isso evita que o projeto gaste tempo em problemas já resolvidos.
-
-**Exemplo:**
-
-- **Validação de email**: use uma lib como `zod` ou `valibot` — regex customizado vai falhar em edge cases (emails com `+`, domínios internacionais).
-
-#### Estado da Arte
-
-Compare a abordagem antiga vs. a moderna para o domínio pesquisado. Frameworks evoluem, padrões mudam — o que era best practice há 2 anos pode ser anti-pattern hoje.
-
-**Exemplo:**
-| Antes | Agora | Por quê mudou |
-|---|---|---|
-| REST + polling | WebSockets / SSE | Menor latência, menos overhead |
-| JWT em localStorage | HttpOnly cookies | XSS não consegue ler cookies httponly |
-
-#### Armadilhas
-
-Liste erros comuns e riscos do domínio pesquisado, classificados por severidade:
-
-- **Crítico** — pode exigir reescrita se ignorado (ex: escolher banco sem suporte a transações quando o domínio exige ACID)
-- **Moderado** — causa retrabalho significativo (ex: não paginar queries desde o início)
-- **Menor** — incômodo, mas corrigível facilmente (ex: não configurar logging estruturado)
-
-Para cada armadilha, inclua: o que acontece se ignorar e como prevenir.
-
-### 7. Checklist de qualidade
-
-Antes de salvar o documento, passe por cada item. Se algum falhar, corrija antes de prosseguir:
-
-- [ ] Todas as perguntas do escopo foram respondidas
-- [ ] Claims críticos verificados em 2+ fontes independentes
-- [ ] Claims negativos ("X não suporta Y") verificados com docs oficiais
-- [ ] Nenhuma afirmação baseada apenas em training data sem marcação
-- [ ] URLs presentes para todas as fontes autoritativas
-- [ ] Confiabilidade (alta/media/baixa) atribuída a cada fonte
-- [ ] Contradições entre fontes documentadas explicitamente
-- [ ] Seção "Não Reinvente a Roda" incluída (quando relevante)
-- [ ] Seção "Armadilhas" incluída (quando relevante)
-- [ ] Conclusão é acionável — dá uma direção clara
-- [ ] Revisão final: "O que posso ter deixado passar?"
-
-## O que você entrega
-
-1. Leia o template de `.hefesto/templates/RESEARCH.md` para a estrutura base
-2. Crie `.hefesto/research/RES-NNN-slug.md` preenchido com as descobertas
-3. No frontmatter, defina `status: done`
-4. Atualize `.hefesto/config.json` incrementando `research.counter`
-5. Atualize `.hefesto/STATE.md` mencionando a pesquisa concluída
-6. Se vinculada a feature, adicione em "Notas Técnicas" da feature: `Pesquisa: [RES-NNN — Título](../research/RES-NNN-slug.md)`
-
-Retorne:
-
-- Caminho do arquivo criado
-- Resumo em 2-3 frases com as principais descobertas e a recomendação
-
-## Regras
-
-- Todos os textos no documento devem ser em Português BR
-- Organize por tema, não por fonte — isso é o que torna a pesquisa realmente útil
-- Se WebSearch/WebFetch não estiverem disponíveis, informe e peça ao usuário para fornecer URLs manualmente
-- Nunca invente fontes ou URLs — se não encontrou, diga que não encontrou
-- Para `tech-eval`, a tabela comparativa não é opcional — é o core do entregável
-- Se uma fonte é de baixa confiabilidade, marque como tal em vez de omiti-la — transparência é mais útil que curadoria silenciosa
-- Se seu training data contradiz as fontes verificadas, as fontes vencem — atualize sua conclusão
-- IDs são sequenciais e nunca reutilizados

package/commands/hefesto/init.md

@@ -1,67 +0,0 @@
----
-description: "Inicializa o Hefesto no projeto atual. Use /hefesto:init para criar a estrutura .hefesto/ e começar a organizar o desenvolvimento."
----
-
-# Hefesto Init
-
-Inicializa a estrutura `.hefesto/` no projeto atual.
-
-## O que fazer
-
-1. Verificar se `.hefesto/` já existe. Se existir, avisar o usuário e perguntar se quer reinicializar.
-2. Perguntar ao usuário:
-   - Nome do projeto
-   - Descrição curta (2-3 frases)
-   - Valor central (a única coisa que DEVE funcionar)
-   - Restrições principais (stack, prazo, plataforma, etc.)
-3. Criar a estrutura de diretórios:
-   ```
-   .hefesto/
-   ├── PROJECT.md
-   ├── ROADMAP.md
-   ├── STATE.md
-   ├── config.json
-   ├── features/
-   └── research/
-   ```
-4. Preencher PROJECT.md com as respostas do usuário.
-5. Gerar STATE.md inicial com posição "Inicializando".
-6. Gerar ROADMAP.md vazio.
-7. Gerar config.json com valores padrão:
-   ```json
-   {
-     "version": "0.1.0",
-     "project": { "name": "", "language": "pt-BR" },
-     "runtime": "claude",
-     "feature": { "id_prefix": "FEAT", "counter": 0 },
-     "research": { "id_prefix": "RES", "counter": 0 },
-     "lifecycle": { "auto_update_state": true }
-   }
-   ```
-8. Informar o usuário que o projeto foi inicializado e sugerir `/hefesto:new-feature` para criar a primeira feature.
-9. Verificar se o MCP Context7 está configurado (checar se `.mcp.json` existe e contém `context7`). Se não estiver, sugerir a instalação:
-
-   ```
-   O Hefesto usa o Context7 para consultar documentação atualizada de bibliotecas
-   durante pesquisas. Para habilitar, adicione ao .mcp.json do projeto:
-   ```
-
-   ```json
-   {
-     "mcpServers": {
-       "context7": {
-         "command": "npx",
-         "args": ["-y", "@upstash/context7-mcp"]
-       }
-     }
-   }
-   ```
-
-   Se o usuário quiser instalar, criar ou atualizar o `.mcp.json` adicionando a entrada do Context7 (preservando outros MCPs existentes). Se não quiser, seguir sem — o Context7 é opcional.
-
-## Notas
-
-- Todos os textos gerados devem ser em Português BR.
-- O config.json deve ser atualizado com o nome do projeto informado pelo usuário.
-- Se `.hefesto/` já existir e o usuário não quiser reinicializar, abortar sem modificar nada.
-- O Context7 é opcional mas recomendado — melhora a qualidade das pesquisas com docs versionados.

package/commands/hefesto/new-feature.md

@@ -1,50 +0,0 @@
----
-description: "Cria uma nova feature no Hefesto. Use /hefesto:new-feature para definir uma nova feature com visão, fluxo do usuário, requisitos e fases de implementação."
----
-
-# Hefesto New Feature
-
-Cria um novo documento de feature em `.hefesto/features/`.
-
-## Pré-requisitos
-
-Verificar se `.hefesto/` existe. Se não existir, sugerir `/hefesto:init` primeiro.
-
-## O que fazer
-
-1. Ler `.hefesto/templates/FEATURE.md` como base para o novo arquivo de feature.
-2. Ler `.hefesto/config.json` para obter o próximo ID disponível.
-3. Perguntar ao usuário:
-   - Título da feature (curto, descritivo)
-   - Visão (o que entrega e por que existe)
-   - Fluxo do usuário (passos que o usuário percorre)
-   - Requisitos principais (testáveis, centrados no usuário)
-   - O que está fora do escopo
-4. Com base nas respostas, propor fases de implementação:
-   - Cada fase deve ser atômica (executável em uma sessão)
-   - Listar arquivos que serão criados/modificados
-   - Definir tarefas concretas e critérios de aceitação
-5. Gerar o ID: `FEAT-NNN` onde NNN é o counter + 1, zero-padded.
-6. Gerar o slug a partir do título (lowercase, hifenizado, max 40 chars).
-7. Criar o arquivo `.hefesto/features/FEAT-NNN-slug.md` com o conteúdo.
-8. Atualizar `.hefesto/config.json` incrementando o counter.
-9. Atualizar `.hefesto/ROADMAP.md` adicionando a nova feature na tabela.
-10. Atualizar `.hefesto/STATE.md` se for a primeira feature ou se nenhuma estiver ativa.
-
-## Formato do arquivo
-
-O arquivo segue o template narrativo unificado com frontmatter YAML:
-
-```yaml
----
-id: FEAT-NNN
-title: "Título"
-status: draft
-created: YYYY-MM-DD
-updated: YYYY-MM-DD
-phases_total: N
-phases_done: 0
----
-```
-
-Seguido pelas seções: Visão, Fluxo do Usuário, Requisitos, Fora do Escopo, Implementação (com Fases), Notas Técnicas.

package/commands/hefesto/status.md

@@ -1,46 +0,0 @@
----
-description: "Mostra o estado atual do projeto Hefesto. Use /hefesto:status para ver progresso, features ativas, bloqueios e próximos passos."
----
-
-# Hefesto Status
-
-Exibe o estado atual do projeto gerenciado pelo Hefesto.
-
-## Pré-requisitos
-
-Verificar se `.hefesto/` existe. Se não existir, informar que o projeto não foi inicializado e sugerir `/hefesto:init`.
-
-## O que fazer
-
-1. Ler `.hefesto/STATE.md` e exibir o conteúdo formatado.
-2. Ler `.hefesto/ROADMAP.md` e calcular progresso geral.
-3. Listar todas as features em `.hefesto/features/` com seus status (ler frontmatter de cada arquivo).
-4. Apresentar um resumo ao usuário:
-
-```
-📊 Estado do Projeto: [nome]
-
-Progresso: [██████░░░░] 60% (3 de 5 features)
-
-Feature ativa: FEAT-003 — Título (Fase 2 de 4)
-
-Features:
-  ✅ FEAT-001 — Título (done)
-  ✅ FEAT-002 — Título (done)
-  🔄 FEAT-003 — Título (active — fase 2/4)
-  📋 FEAT-004 — Título (ready)
-  📝 FEAT-005 — Título (draft)
-
-Pesquisas: 2 concluídas, 1 em andamento
-  🔍 RES-001 — Avaliação de ORMs (done)
-  🔍 RES-002 — Padrões de autenticação (done)
-  🔄 RES-003 — APIs de pagamento (in-progress)
-
-Bloqueios: Nenhum
-
-Próximo passo: Continuar execução da Fase 2 de FEAT-003
-```
-
-5. Listar pesquisas em `.hefesto/research/` com seus status (ler frontmatter de cada arquivo).
-6. Se houver bloqueios em STATE.md, destacá-los.
-7. Sugerir próxima ação com base no estado atual.

package/commands/hefesto/update.md

@@ -1,31 +0,0 @@
----
-description: "Atualiza o Hefesto para a versão mais recente. Use /hefesto:update para atualizar commands, skills, hooks e templates sem perder o estado do projeto."
----
-
-# Hefesto Update
-
-Atualiza o toolkit Hefesto para a versão mais recente do npm.
-
-## Pré-requisitos
-
-Verificar se `.hefesto/` existe. Se não existir, informar que o projeto não foi inicializado e sugerir `/hefesto:init`.
-
-## O que fazer
-
-1. Ler `.hefesto/config.json` e anotar a versão atual (`version`).
-2. Executar o comando de atualização:
-   ```bash
-   npx @lugom.io/hefesto@latest
-   ```
-3. Verificar o output do comando. Se houver erro, informar o usuário e sugerir ação corretiva.
-4. Ler `.hefesto/config.json` novamente e comparar a versão com a anterior.
-5. Informar o resultado ao usuário:
-   - Se atualizou: mostrar versão anterior → nova versão
-   - Se já estava na última versão: informar que está atualizado
-
-## Notas
-
-- O installer preserva `.hefesto/` existente (PROJECT.md, STATE.md, ROADMAP.md, features/, config.json).
-- O que é atualizado: commands, skills, hooks, templates.
-- Não usar `--global` a menos que o usuário peça explicitamente.
-- Se o usuário pedir para atualizar um runtime específico (ex: `--gemini`), passar a flag correspondente.

package/templates/PROJECT.md

@@ -1,28 +0,0 @@
-# {{PROJECT_NAME}}
-
-## O Que É
-
-{{PROJECT_DESCRIPTION}}
-
-## Valor Central
-
-{{CORE_VALUE}}
-
-## Contexto
-
-{{CONTEXT}}
-
-## Restrições
-
-- **Stack**: {{STACK_CONSTRAINT}}
-- **Prazo**: {{DEADLINE_CONSTRAINT}}
-
-## Decisões
-
-| Decisão | Justificativa | Resultado |
-| ------- | ------------- | --------- |
-| —       | —             | —         |
-
----
-
-_Última atualização: {{DATE}}_

package/templates/ROADMAP.md

@@ -1,23 +0,0 @@
-# Roadmap
-
-## Visão Geral
-
-{{PROJECT_NAME}} — {{PROJECT_DESCRIPTION}}
-
-## Features
-
-| ID  | Título | Status | Fases | Progresso |
-| --- | ------ | ------ | ----- | --------- |
-| —   | —      | —      | —     | —         |
-
-## Legenda
-
-- `draft` — Em definição
-- `ready` — Pronta para execução
-- `active` — Em andamento
-- `done` — Completa e verificada
-- `blocked` — Bloqueada
-
----
-
-_Atualizado automaticamente ao concluir features._