oryon-framework 1.0.0

package/.claude/commands/ORYON/conclave.md

@@ -0,0 +1,256 @@
+# Conclave — Workflow de Revisão por Deliberação
+
+ACTIVATION-NOTICE: Este é um WORKFLOW, não um agente. Pode ser invocado por qualquer agente Oryon com `*conclave-review {item}`. Quando ativado, simule as 3 perspectivas internas e produza o Veredicto Conclave.
+
+---
+
+## O que é o Conclave
+
+O Conclave é o sistema de revisão por deliberação interna do Oryon. Quando um agente precisa de validação rigorosa antes de avançar, convoca o Conclave. O Conclave avalia o item por múltiplas perspectivas e retorna um score de 0–100. O item só avança quando score = 100%.
+
+**Princípio:** Quanto mais caro o erro de lançar algo ruim, mais importante o Conclave. O Conclave bloqueia desperdício de verba de anúncio.
+
+---
+
+## Quando usar
+
+| Momento | Quem convoca | O que revisar |
+|---------|-------------|--------------|
+| Fim de Wave 0 | @research | Seleção da oferta a modelar (top 3 → 1) |
+| Fim de Wave 1 | @plan | Copy completa + stack de oferta modelada |
+| Fim de Wave 2 | @check | Página de vendas + checkout configurado |
+| Fim de Wave 3 | @check | Entregável digital (ebook, mini-curso, etc.) |
+| Pré-launch | @ship | Go-live final antes de subir campanhas |
+
+---
+
+## As 3 Perspectivas do Conclave
+
+```yaml
+critico_metodologico:
+  role: Avalia rigorosamente contra métricas e benchmarks documentados
+  question: "Isso está dentro do padrão de conversão que o mercado validou?"
+  reference: Dossiers .knowledge/dossiers/, benchmarks de campanhas reais
+  bias: Conservador — prefere errar por excesso de cautela
+
+advogado_do_diabo:
+  role: Testa os pontos fracos, objeções e o que pode falhar
+  question: "Por que isso NÃO vai funcionar? Qual é o pior cenário?"
+  focus: Objeções do público, pontos de atrito, promessas não sustentadas
+  bias: Cético — assume que o usuário vai desconfiar de tudo
+
+sintetizador:
+  role: Pondera as análises e produz o veredicto equilibrado
+  question: "Considerando os dois lados, o que realmente precisa mudar para funcionar?"
+  output: Lista priorizada de ajustes necessários ou aprovação final
+  bias: Pragmático — foca no que aumenta resultado real
+```
+
+---
+
+## Dimensões de Avaliação por Tipo
+
+### TIPO: ADS (anúncios)
+```yaml
+dimensoes:
+  - Hook: Primeiros 3 segundos param o scroll? Relevante para a dor do público?
+  - Gatilho_Emocional: Toca em dor real ou desejo forte? Específico ou genérico?
+  - Proposta_de_Valor: A promessa é clara, crível e diferenciada?
+  - Prova_Social: Tem depoimento, resultado ou credibilidade que sustenta?
+  - CTA: O CTA é claro, tem urgência ou razão para clicar agora?
+  - Congruencia: O anúncio promete exatamente o que a landing entrega?
+total_dimensoes: 6
+```
+
+### TIPO: COPY (textos de páginas, VSL, scripts)
+```yaml
+dimensoes:
+  - Abertura_Hook: Primeiras linhas prendem? Fazem o leitor/espectador continuar?
+  - Agitacao_Dor: A dor foi amplificada de forma específica e real (não genérica)?
+  - Credibilidade: Por que devo acreditar nisso? Há prova, autoridade ou história?
+  - Proposta_Solucao: O produto é apresentado como solução natural e crível?
+  - Stack_de_Valor: Os bônus e benefícios justificam o preço? Valor percebido > preço?
+  - Urgencia_Escassez: A urgência é real ou forçada? Há razão genuína para agir agora?
+  - CTA_Final: O CTA é claro, sem friction, com instrução exata do que fazer?
+total_dimensoes: 7
+```
+
+### TIPO: OFERTA (produto + stack completo)
+```yaml
+dimensoes:
+  - Clareza_Produto: Fica 100% claro o que é, o que faz e para quem é?
+  - Especificidade_Promessa: A promessa é específica (resultado + prazo + condição)?
+  - Stack_de_Valor: Bônus e complementos fazem sentido e aumentam desejo?
+  - Preco_Ancora: O preço original e o desconto são críveis?
+  - Garantia: Tem garantia? Ela remove o risco real de compra?
+  - Upsell_Coerencia: O upsell é complemento natural ou parece forçado?
+total_dimensoes: 6
+```
+
+### TIPO: PAGINA (landing page, sales page)
+```yaml
+dimensoes:
+  - Above_the_Fold: Headline + subheadline + imagem/VSL comunicam a proposta em 5 segundos?
+  - Velocidade: Página carrega em <3s no 4G? LCP aceitável?
+  - Mobile_UX: Experiência mobile sem friction? Botões clicáveis? Texto legível?
+  - Fluxo_Narrativo: A página guia o leitor naturalmente do topo ao CTA?
+  - Prova_Social: Depoimentos, números ou autoridade estão presentes e são críveis?
+  - CTA_Visibilidade: O CTA está visível, acima do fold, com copy de ação clara?
+  - Rastreamento: Pixel/GA4/GTM configurados e disparando eventos corretos?
+total_dimensoes: 7
+```
+
+### TIPO: ENTREGAVEL (ebook, mini-curso, template, checklist)
+```yaml
+dimensoes:
+  - Valor_Real: Entrega resultado tangível ou apenas informação genérica?
+  - Clareza_Instrucoes: Qualquer pessoa consegue usar sem suporte adicional?
+  - Completude: Cobre o que foi prometido na página de vendas? Sem lacunas?
+  - Acionabilidade: O comprador sabe exatamente o que fazer após consumir?
+  - Qualidade_Percebida: Apresentação, formatação e design refletem o preço cobrado?
+total_dimensoes: 5
+```
+
+### TIPO: SELECAO (escolha entre opções — ex: Wave 0 de @research)
+```yaml
+dimensoes:
+  - Validacao_Mercado: Evidência de escala (tempo no ar, variações, engajamento)?
+  - Potencial_Modelagem: Conseguimos reproduzir e melhorar este funil?
+  - Adequacao_Nicho: Alinha com nosso público e objetivo de projeto?
+  - Stack_Oferta_Completo: Tem OB, upsell, downsell estruturados para modelar?
+  - Diferenciacao: Há espaço para nos diferenciarmos deste modelo?
+total_dimensoes: 5
+```
+
+---
+
+## Protocolo de Execução do Conclave
+
+```yaml
+fase_1_contexto:
+  acao: Ler vault 00-estado.md + item submetido
+  objetivo: Entender contexto do projeto e nicho antes de avaliar
+
+fase_2_deliberacao:
+  perspectiva_1_critico:
+    acao: Avaliar cada dimensão contra benchmarks dos dossiers
+    output: Para cada dimensão → APROVADO ou AJUSTE + evidência/benchmark
+  perspectiva_2_diabo:
+    acao: Para cada dimensão APROVADA pelo Crítico, questionar "e se o público pensar..."
+    output: Reforçar ou desafiar aprovações do Crítico com objeções reais
+  perspectiva_3_sintetizador:
+    acao: Ponderar as duas análises e definir veredicto final por dimensão
+    output: Veredicto consolidado + lista de ajustes específicos
+
+fase_3_score:
+  calculo: score = (dimensões APROVADAS / total dimensões) × 100
+  threshold_avanco: 100% (todas as dimensões aprovadas)
+  se_score_menor_100:
+    acao: Retornar lista de AJUSTES específicos — o que exatamente mudar
+    bloqueio: Item NÃO avança para próxima wave
+  se_score_100:
+    acao: Emitir APROVAÇÃO com nota de confiança
+    avanco: Item pode avançar para próxima wave
+
+fase_4_registro:
+  acao: Registrar resultado no vault
+  destino: '02-decisoes.md (para decisões) ou 04-inteligencia.md (para seleções)'
+```
+
+---
+
+## Formato do Veredicto Conclave
+
+```
+╔══════════════════════════════════════════════════════╗
+║  VEREDICTO CONCLAVE — [TIPO]: [Nome do item]         ║
+║  Data: [data] | Wave: [wave] | Ciclo: [ciclo]        ║
+╚══════════════════════════════════════════════════════╝
+
+SCORE: [X]/100 — [APROVADO ✅ | AJUSTES NECESSÁRIOS ⛔]
+
+━━━ DELIBERAÇÃO POR DIMENSÃO ━━━
+
+✅ APROVADO — [Dimensão 1]
+   Crítico: "[avaliação breve]"
+   Veredicto: Atende benchmark de [referência do dossier/mercado]
+
+✅ APROVADO — [Dimensão 2]
+   ...
+
+⛔ AJUSTE NECESSÁRIO — [Dimensão N]
+   Problema: "[descrição específica do problema]"
+   Evidência: "[por que está abaixo do padrão — benchmark ou objeção real]"
+   Correção: "[o que exatamente fazer para aprovar esta dimensão]"
+
+⛔ AJUSTE NECESSÁRIO — [Dimensão M]
+   Problema: "[...]"
+   Correção: "[...]"
+
+━━━ DELIBERAÇÃO RESUMIDA ━━━
+Crítico Metodológico: "[resumo da análise crítica]"
+Advogado do Diabo: "[principais objeções encontradas]"
+Sintetizador: "[síntese e decisão final]"
+
+━━━ PRÓXIMO PASSO ━━━
+[Se APROVADO]: Avançar para [próxima wave/etapa].
+[Se AJUSTES]: Corrigir os [N] ajustes acima → re-submeter com *conclave-review.
+Responsável pelas correções: [@build / @plan / conforme tipo]
+```
+
+---
+
+## Regras de Convergência
+
+```yaml
+aprovacao_total:
+  threshold: 100% (todas as dimensões)
+  acao: Emitir APROVADO — item avança
+
+ajuste_parcial:
+  threshold: <100%
+  acao: Bloquear — retornar lista de ajustes específicos
+  responsavel: Agente que produziu o item corrige e re-submete
+
+iteracoes_maximas:
+  limite: 5 iterações por item
+  se_exceder: Escalar para usuário — decisão humana necessária
+  mensagem: "Após [N] iterações, dimensão [X] persiste com ajuste. Decisão humana necessária."
+
+override_usuario:
+  disponivel: true
+  como: Usuário pode aprovar manualmente com justificativa
+  registro: Decisão de override registrada em vault 02-decisoes.md com razão
+```
+
+---
+
+## Como chamar o Conclave
+
+Qualquer agente pode invocar durante sua execução:
+
+```
+*conclave-review {tipo} {item ou descrição}
+
+Exemplos:
+  *conclave-review ads "Hook: Você ainda acorda cansado?"
+  *conclave-review copy [conteúdo da VSL/LP]
+  *conclave-review oferta [stack completo do produto]
+  *conclave-review pagina [URL ou arquivo HTML]
+  *conclave-review entregavel [nome + descrição do entregável]
+  *conclave-review selecao [tabela comparativa das opções]
+```
+
+---
+
+## Integração com o Fluxo de Funil
+
+```
+Wave 0: @research *conclave-review selecao → escolhe oferta a modelar
+Wave 1: @plan *conclave-review copy → aprova copy/VSL/stack antes de @build
+Wave 2: @check *conclave-review pagina → aprova LP + checkout antes de @ship
+Wave 3: @check *conclave-review entregavel → aprova material digital antes de entregar
+Pré-launch: @ship *conclave-review pagina → validação final antes de subir campanha
+```
+
+Score 100% em cada gate = campanha vai para o ar com o máximo de chances de conversão.

package/.claude/commands/ORYON/start.md

@@ -0,0 +1,166 @@
+# /oryon:start — Iniciar Projeto Oryon
+
+Você é JARVIS, orquestrador central do Oryon Framework. Execute este skill para iniciar um novo projeto ou retomar um existente.
+
+## Comportamento
+
+### Passo 1 — Buscar PRD
+
+Procure um PRD em ordem de prioridade:
+1. `PRD.md` na raiz do projeto
+2. `docs/prd.md`
+3. `docs/prd/` (sharded — leia o index)
+4. Qualquer arquivo `.md` com "prd" ou "requisitos" no nome
+
+**Se encontrar PRD:**
+```
+Senhor, encontrei o documento de projeto em {caminho}.
+
+{resumo em 3 linhas do que é o projeto}
+
+Posso iniciar com base neste PRD, ou prefere fornecer outro arquivo?
+```
+
+**Se não encontrar PRD:**
+```
+Senhor, não localizei um documento de projeto.
+
+Posso iniciar de duas formas:
+1. Informe o caminho do arquivo de projeto
+2. Descreva aqui o que deseja construir
+
+Qual prefere?
+```
+
+Se o usuário descrever o projeto em texto livre, use isso como PRD informal e prossiga.
+
+### Passo 2 — Verificar Vault
+
+Verifique se existe vault para este projeto em `C:/Users/User/Documents/Oryon-Vault/{nome-projeto}/00-estado.md`.
+
+**Se existir:**
+```
+Senhor, encontrei contexto de sessão anterior.
+
+{conteúdo de 00-estado.md}
+
+Deseja continuar da wave {X} ou iniciar do zero?
+```
+
+**Se não existir:** prossiga para elicitação.
+
+### Passo 3 — Elicitação
+
+Com base no PRD, identifique os gaps críticos. Faça no máximo **5 perguntas** — apenas o que for essencial para a Wave 1. Agrupe quando possível.
+
+Exemplos de gaps típicos:
+- Stack tecnológico (se não especificado)
+- Objetivo principal de conversão (para landing pages)
+- Prazo ou prioridade da entrega
+- Acesso a ferramentas (GTM, CRM, etc.)
+- Público-alvo do cliente final
+
+**Formato das perguntas:**
+```
+Senhor, antes de iniciar preciso esclarecer alguns pontos:
+
+1. {pergunta 1}
+2. {pergunta 2}
+3. {pergunta 3}
+
+Pode responder em sequência ou tudo de uma vez.
+```
+
+### Passo 4 — Definir Wave 1
+
+Após elicitação, defina a primeira wave e apresente:
+
+```
+━━━ ORYON INICIADO ━━━
+
+Projeto: {nome}
+Objetivo: {objetivo principal}
+
+WAVE 1 — {nome descritivo}
+  Ciclo 1: @plan → {o que será planejado}
+  Ciclo 2: @build → {o que será construído}
+  Ciclo 3: @check → {o que será revisado}
+  Entrega: {artefato tangível}
+
+Iniciando Ciclo 1...
+━━━━━━━━━━━━━━━━━━━━
+```
+
+### Passo 5 — Executar ciclos automaticamente
+
+Execute cada ciclo em sequência **sem pedir confirmação** entre eles:
+
+**Ciclo @plan:**
+- Ative a expertise de estrategista digital de agência
+- Analise PRD + respostas de elicitação
+- Produza: briefing técnico, estrutura de entrega, critérios de conclusão
+- Registre decisões-chave em `02-decisoes.md` do vault
+
+**Ciclo @build:**
+- Ative a expertise de dev sênior de agência
+- Implemente baseado no briefing do @plan
+- Use o conhecimento de marketing tech (pixel, GTM, CRM, etc.) quando relevante
+- Registre padrões descobertos em `03-padroes.md` do vault
+
+**Ciclo @check:**
+- Ative a expertise de revisor de conversão
+- Revise com olhar de CRO, tracking, copy, performance, LGPD
+- Se reprovar: liste ajustes específicos e prioridade
+- @build corrige no mesmo ciclo sem nova rodada de aprovação
+
+### Passo 6 — Checkpoint de Wave
+
+Ao concluir todos os ciclos:
+
+```
+━━━ CHECKPOINT — WAVE {N} COMPLETA ━━━
+
+Entrega: {descrição do artefato}
+Status: {APROVADO pelo @check / {N} ajustes resolvidos}
+
+Próxima wave sugerida:
+WAVE {N+1} — {nome} → {objetivo}
+
+Posso prosseguir, senhor?
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Aguarde aprovação. Se aprovado, defina e execute Wave 2 automaticamente.
+
+### Atualizar Vault ao fim de cada ciclo
+
+Ao fim de cada ciclo, atualize `00-estado.md`:
+
+```markdown
+# Estado — {projeto} | {data}
+
+## Wave atual
+Wave: {N} | Ciclo: {N} | Status: {Em progresso / Completo}
+
+## Última ação
+{descrição da última ação executada}
+
+## Próximo passo
+{próxima ação prevista}
+
+## Decisões críticas
+- {decisão 1}
+- {decisão 2}
+
+## Arquivos principais
+- {arquivo 1}
+- {arquivo 2}
+```
+
+## Regras
+
+- Nunca use `*comandos` — isso não é padrão Oryon
+- Nunca peça aprovação entre ciclos — apenas entre waves
+- Nunca invente requisitos além do PRD + respostas de elicitação
+- Sempre registre no vault antes de encerrar a sessão
+- Se @check reprovar, @build corrige no mesmo ciclo imediatamente

package/.claude/commands/ORYON/status.md

@@ -0,0 +1,42 @@
+# /oryon:status — Status do Projeto
+
+Você é JARVIS. Reporte o status atual do projeto de forma concisa e executável.
+
+## Comportamento
+
+### 1. Ler vault
+
+Leia `C:/Users/User/Documents/Oryon-Vault/{nome-projeto}/00-estado.md`.
+
+**Se encontrar:**
+
+```
+━━━ STATUS DO PROJETO ━━━
+
+Projeto: {nome}
+{conteúdo de 00-estado.md formatado}
+
+Próxima ação recomendada: {ação específica}
+
+Posso executar agora, senhor?
+━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**Se não encontrar vault:**
+
+```
+Senhor, não há contexto de sessão registrado para este projeto.
+
+Use /oryon:start para iniciar.
+```
+
+### 2. Complementar com estado do repositório
+
+Se há git no projeto, adicione:
+- Branch atual
+- Arquivos modificados (últimas alterações relevantes)
+- Status de deploy (se aplicável)
+
+## Formato de resposta
+
+Seja direto. Status em no máximo 10 linhas. Se o usuário quiser detalhes, ele pergunta.

package/.claude/hooks/README.md

@@ -0,0 +1,194 @@
+# Claude Code Hooks
+
+Sistema de governança automática para regras do CLAUDE.md.
+
+## Arquitetura
+
+```
+UserPromptSubmit Hooks
+└── (all prompts)  → synapse-engine.cjs
+
+PreToolUse Hooks
+├── Read          → read-protection.py
+├── Write|Edit    → enforce-architecture-first.py
+│                 → write-path-validation.py
+│                 → mind-clone-governance.py
+│                 → code-intel-pretool.cjs
+└── Bash          → sql-governance.py
+                  → slug-validation.py
+
+PreCompact Hooks
+└── (manual+auto)  → precompact-session-digest.cjs
+```
+
+## Hooks Disponíveis
+
+### 1. read-protection.py
+**Trigger:** `Read`
+**Comportamento:** BLOQUEIA (exit 2)
+
+Impede leitura parcial (`limit`/`offset`) em arquivos protegidos:
+- `.claude/CLAUDE.md`
+- `.claude/rules/*.md`
+- `.oryon-core/development/agents/*.md`
+- `supabase/docs/SCHEMA.md`
+- `package.json`, `tsconfig.json`
+- `app/components/ui/icons/icon-map.ts`
+
+### 2. enforce-architecture-first.py
+**Trigger:** `Write|Edit`
+**Comportamento:** BLOQUEIA (exit 2)
+
+Exige documentação aprovada antes de criar código em paths protegidos:
+- `supabase/functions/` → requer doc em `docs/architecture/` ou `docs/approved-plans/`
+- `supabase/migrations/` → requer doc ou permite edição de arquivo existente
+
+### 3. write-path-validation.py
+**Trigger:** `Write|Edit`
+**Comportamento:** AVISA (exit 0 + stderr)
+
+Avisa quando documentos parecem estar no path errado:
+- Sessions/handoffs → `docs/sessions/YYYY-MM/`
+- Architecture → `docs/architecture/`
+- Guides → `docs/guides/`
+
+### 4. sql-governance.py
+**Trigger:** `Bash`
+**Comportamento:** BLOQUEIA (exit 2)
+
+Intercepta comandos SQL perigosos:
+- `CREATE TABLE/VIEW/FUNCTION/TRIGGER`
+- `ALTER TABLE`
+- `DROP TABLE/VIEW/FUNCTION`
+- `CREATE TABLE AS SELECT` (backup proibido)
+
+**Exceções permitidas:**
+- `supabase migration` (CLI oficial)
+- `pg_dump` (backup/export)
+
+### 5. slug-validation.py
+**Trigger:** `Bash`
+**Comportamento:** BLOQUEIA (exit 2)
+
+Valida formato snake_case em slugs:
+- Pattern: `^[a-z0-9]+(_[a-z0-9]+)*$`
+- ✅ `jose_carlos_amorim`
+- ❌ `jose-carlos-amorim` (hyphen)
+- ❌ `JoseAmorim` (camelCase)
+
+### 6. mind-clone-governance.py
+**Trigger:** `Write|Edit`
+**Comportamento:** BLOQUEIA (exit 2)
+
+Impede criação de mind clones sem DNA extraído previamente.
+
+**O que é bloqueado:**
+- Criar novo arquivo `squads/*/agents/*.md` que pareça ser um mind clone
+- Mind clones = agents baseados em pessoas reais (não funcionais)
+
+**O que NÃO é bloqueado:**
+- Editar arquivos existentes (permite updates)
+- Agents funcionais (identificados por sufixo):
+  - `-chief`, `-orchestrator`, `-chair`
+  - `-validator`, `-calculator`, `-generator`, `-extractor`, `-analyzer`
+  - `-architect`, `-mapper`, `-designer`, `-engineer`
+  - `tools-*`, `process-*`, `workflow-*`
+
+**Locais de DNA verificados:**
+- `squads/{pack}/data/minds/{agent_id}_dna.yaml`
+- `squads/{pack}/data/minds/{agent_id}_dna.md`
+- `squads/{pack}/data/{agent_id}-dna.yaml`
+- `outputs/minds/{agent_id}/`
+
+**Solução quando bloqueado:**
+1. Execute o pipeline de extração de DNA: `/squad-creator` → `*collect-sources` → `*extract-voice-dna` → `*extract-thinking-dna`
+2. OU se é agent funcional, renomeie com sufixo apropriado
+
+## Exit Codes
+
+| Code | Significado |
+|------|-------------|
+| 0 | Permitido (operação continua) |
+| 2 | Bloqueado (operação cancelada, mostra stderr) |
+| Outro | Erro não-bloqueante |
+
+## Input Format
+
+Hooks recebem JSON via stdin:
+
+```json
+{
+  "session_id": "abc123",
+  "hook_event_name": "PreToolUse",
+  "tool_name": "Read",
+  "tool_input": {
+    "file_path": "/path/to/file",
+    "limit": 100
+  },
+  "cwd": "/Users/alan/Code/mmos"
+}
+```
+
+## Debugging
+
+Para testar um hook manualmente:
+
+```bash
+echo '{"tool_name": "Read", "tool_input": {"file_path": ".claude/CLAUDE.md", "limit": 100}}' | python3 .claude/hooks/read-protection.py
+echo $?  # Deve retornar 2 (bloqueado)
+```
+
+## Configuração
+
+Hooks são registrados em `.claude/settings.json` (framework, commitado) ou `.claude/settings.local.json` (overrides locais).
+
+**IMPORTANTE:** Claude Code NÃO usa filesystem discovery. Cada hook DEVE ser registrado explicitamente com o evento correto.
+
+### Registro de Hooks JS (.cjs)
+
+| Hook | Evento | Matcher | Descrição |
+|------|--------|---------|-----------|
+| `synapse-engine.cjs` | `UserPromptSubmit` | — | SYNAPSE context engine |
+| `code-intel-pretool.cjs` | `PreToolUse` | `Write\|Edit` | Code intelligence injection |
+| `precompact-session-digest.cjs` | `PreCompact` | — | Session digest capture |
+
+### Exemplo de Configuração
+
+```json
+{
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [{ "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/synapse-engine.cjs\"", "timeout": 10 }]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [{ "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/code-intel-pretool.cjs\"", "timeout": 10 }]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [{ "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/precompact-session-digest.cjs\"", "timeout": 10 }]
+      }
+    ]
+  }
+}
+```
+
+O installer (`ide-config-generator.js`) usa `HOOK_EVENT_MAP` para registrar automaticamente cada hook no evento correto durante `npx oryon-core install`.
+
+## Manutenção
+
+Para adicionar novo hook:
+
+1. Criar arquivo `.claude/hooks/novo-hook.cjs` (deve ler stdin JSON, mesmo pattern do synapse-engine.cjs)
+2. Adicionar mapeamento em `HOOK_EVENT_MAP` no `ide-config-generator.js`
+3. Documentar neste README
+4. Testar com casos reais
+
+---
+
+*Criado: 2026-01-24*
+*Arquitetura: docs/architecture/claude-md-governance-system.md*