invos 1.0.0

package/kit/conteudo/_fila.md

@@ -0,0 +1,12 @@
+# Fila de conteúdo
+
+> Máx. 5 ideias ativas. Voz e exemplos: `marca/marca.md`.
+
+| data | ideia (1 linha) | formato | status | dono | prova / origem |
+|------|-----------------|---------|--------|------|----------------|
+| | | post · story · carrossel · thread | ideia · rascunho · publicado | agente \| humano | |
+
+## Em destaque (1 só)
+
+- **Peça da semana:** (vazio)
+- **Done quando:** publicado ou enviado

package/kit/docs/audit-enxugamento-sieve.md

@@ -0,0 +1,187 @@
+# Auditoria de Enxugamento — INVOS
+
+**Data:** 2026-07-24  
+**Escopo:** `/Users/felipealves/FelipeOS/projetos/Felipe.aiOS/projetos/invos`  
+**Persona:** Empresário solo / prestador de serviço  
+**Read-only:** Nenhum arquivo foi editado.
+
+---
+
+## 1. Veredito (5 linhas)
+
+**Score: 6/10** — O core INVOS (memoria + clientes + session skills + proposta + social-content) é enxuto e funcional. O problema é **gordura opcional que veio junto**: 22 skills (10+ nunca usadas por empresário solo semanalmente), 3 squads (só 1 é MVP real), e README/AGENTS.md com seções duplicadas. Risco principal: **modelo fraco vai carregar description de 22 skills no boot** e se confundir com triggers sobrepostos (notion vs google-workspace vs composio; humanizer vs stop-slop).
+
+---
+
+## 2. Tabela KEEP (essencial dia a dia)
+
+| Path | Por quê | Freq. esperada |
+|------|---------|----------------|
+| `memoria/` (9 arquivos) | Cérebro do negócio. Sem isso não existe INVOS. | Toda sessão |
+| `clientes/_index.md` + `_template/` | Pipeline de vendas + duplicar cliente. Core do prestador. | Toda sessão |
+| `marca/marca.md` + `assets/` | Identidade visual pra propostas e posts. | Toda sessão (via proposta/social-content) |
+| `conteudo/_fila.md` | Fila de conteúdo pra postar. | Semanal |
+| `.agents/skills/session-start` | Boot. Não negocia. | Toda sessão |
+| `.agents/skills/session-end` | Arquivamento. | Toda sessão |
+| `.agents/skills/session-checkpoint` | Checkpoint proativo. | Durante sessão |
+| `.agents/skills/onboard` | Primeira configuração. | 1x (depois arquivar) |
+| `.agents/skills/proposta` | Proposta comercial HTML. Ferramenta #1 do prestador. | Quinzenal |
+| `.agents/skills/social-content` | Posts/legendas texto. Leve, rápido. | Semanal |
+| `.agents/skills/instagram-carrossel` | Carrossel IG. MVP (1-2 HTML + caption). | Semanal |
+| `.agents/skills/design-marca` | Extrair branding de site. | Mensal |
+| `scripts/validar.sh` | Valida integridade do kit. | Pós-edit |
+| `scripts/smoke-estado.sh` | Smoke test de coerência. | Pós-edit |
+| `AGENTS.md` | Fonte de verdade de operação. | Toda sessão (lido pelo agente) |
+| `COMECE-AQUI.md` | Setup inicial. | 1x (depois não lido) |
+
+---
+
+## 3. Tabela TRIM (manter mas encolher)
+
+| Path | O que cortar | Ganho |
+|------|-------------|-------|
+| `AGENTS.md` | **Seção "Proactive Content — Formato Seriado"** (linhas 76-110): 35 linhas de tutorial de conteúdo que o empresário solo não precisa ler no boot. Mover para `conhecimento/formato-seriado.md` e referenciar 1 linha. | -800 tokens boot |
+| `AGENTS.md` | **Tabela "Dia a dia do prestador"** (linhas 36-49): duplica o que já está em `COMECE-AQUI.md` Passo 5. Manter 3 linhas essenciais + link. | -400 tokens |
+| `AGENTS.md` | **Tabela "Skills disponíveis"** (linhas 138-153): redundante com o trigger natural das skills. Manter só as 5 core + 1 linha "outras sob demanda". | -300 tokens |
+| `AGENTS.md` | **Tabela "Squads disponíveis"** (linhas 155-163): o empresário não usa squads. Manter 1 linha: "Squads: instagram-carrossel (produção), brand, advisory-board — detalhes em `.agents/squads/`." | -150 tokens |
+| `README.md` | **Seções "O problema" + "Como funciona"** (linhas 31-150): 120 linhas de marketing. O ZIP é a venda; o README é ref. Manter tabela "Core do dia a dia" + link pra COMECE-AQUI. | -3.000 tokens (mas não lido no boot) |
+| `COMECE-AQUI.md` | **Passo 0 + Passo 2** (linhas 38-87): explicação óbvia ("abra a pasta no agente"). Manter só Passo 1 (renomear) + Passo 3 (onboard). | -500 tokens |
+| `.agents/skills/humanizer` | Manter, mas **renomear trigger** para "humanizer-ptbr" e adicionar `aliases: [tira-ia, limpa-texto]` — empresário não sabe o que é "humanizer". | Clareza |
+| `.agents/skills/stop-slop` | Mesmo caso. Aliases: `tira-ia-en, clean-english`. | Clareza |
+
+---
+
+## 4. Tabela CUT / Opcional (fora do core ou mover)
+
+| Path | Motivo | Se mover: para onde |
+|------|--------|---------------------|
+| `.agents/skills/llm-wiki` | Knowledge base interligada. **507 linhas.** Empresário solo não usa wiki. É ferramenta de dev/pesquisador. | `addons/llm-wiki/` ou deletar |
+| `.agents/skills/popular-web-designs` | 54 templates de design systems. **214 linhas.** Empresário não pede "faz igual Stripe". É pra dev frontend. | `addons/popular-web-designs/` ou deletar |
+| `.agents/skills/pd-ikigai` | Encontrar ideia de negócio. **Uma vez na vida.** Não é operação diária. | `addons/pd-ikigai/` |
+| `.agents/skills/audit` | Auditoria Four Cs. Roda 1x por semana no máximo. Não precisa estar no boot. | Manter em skills mas sem trigger automático |
+| `.agents/skills/apple/*` (2) | **macOS only.** 50% do ICP usa Windows. Se incluir, colocar guard: `if platform != darwin: skip`. | `addons/apple/` ou condicional |
+| `.agents/skills/productivity/notion` | Notion é opcional. Empresário solo pode não usar. | `addons/notion/` |
+| `.agents/skills/productivity/google-workspace` | Gmail/Calendar. Opcional. Composio já cobre. | `addons/google-workspace/` |
+| `.agents/skills/productivity/maps` | Geocode/POIs. Nenhum prestador precisa disso. | `addons/maps/` ou deletar |
+| `.agents/skills/productivity/nano-pdf` | Editar PDFs. Nicho. | Manter mas sem destaque |
+| `.agents/skills/productivity/ocr-and-documents` | Extrair texto de PDFs. Nicho. | Manter mas sem destaque |
+| `.agents/skills/productivity/powerpoint` | Criar .pptx. Raramente usado. | `addons/powerpoint/` |
+| `.agents/squads/advisory-board` | 11 conselheiros (Naval, Thiel, Munger...). **Overkill total** pra empresário solo. Nunca vai usar. | `addons/advisory-board/` ou deletar |
+| `.agents/squads/brand` | 7 especialistas de branding. **Overkill.** `design-marca` já cobre o essencial. | `addons/brand/` |
+| `integracoes/composio/` | Opcional. Só se o empresário pedir. | Manter como está (já é opcional) |
+
+---
+
+## 5. Conflitos e Ambiguidade de Trigger
+
+| Par de skills | Conflito | Recomendação |
+|---------------|----------|--------------|
+| `social-content` vs `instagram-carrossel` | Ambas criam conteúdo IG. "Post" vs "Carrossel" é a linha, mas modelo fraco vai confundir. | **Já resolvido no AGENTS.md**: social-content = texto, carrossel = visual. Manter. |
+| `humanizer` vs `stop-slop` | Uma é PT-BR, outra EN. Mas trigger "tira-ia" é ambíguo. | Adicionar alias claro: `humanizer-ptbr` e `stop-slop-en`. |
+| `notion` vs `google-workspace` vs `composio` | Três ways de acessar dados. Notion = banco. Google = email/calendário. Composio = CLI. Modelo fraco vai chamar a errada. | **Cortar notion e google-workspace do core.** Composio já cobre CLI. Se precisar, volta via addon. |
+| `proposta` vs `design-marca` | Proposta já lê `marca/marca.md`. Design-marca extrai de site. Conflito: "extrai minha marca" → design-marca. "faz proposta" → proposta. | OK. Sem conflito real. |
+| `session-start` vs `onboard` | Session-start detecta template e chama onboard. OK. | Sem conflito. |
+| `llm-wiki` vs `memoria/` | Duas formas de knowledge base. llm-wiki é interligada; memoria/ é simples. Modelo fraco vai misturar. | **Cortar llm-wiki.** Memória já resolve. |
+
+---
+
+## 6. Boot Mínimo para Modelo Fraco
+
+### O que o agente DEVE ler no session-start (ordem):
+
+1. `AGENTS.md` (enxugado, ~4.000 tokens)
+2. Skill `session-start` → lê automaticamente:
+   - `memoria/empresa.md`
+   - `memoria/projetos.md`
+   - `memoria/decisoes.md`
+   - `memoria/insights.md`
+   - `memoria/ativo.md`
+   - `clientes/_index.md`
+   - `marca/marca.md`
+   - Último `memoria/historico/`
+
+### O que NUNCA carregar no boot:
+
+- `README.md` (12.8KB de marketing)
+- `SECURITY.md` (só sob demanda)
+- `.agents/skills/*/SKILL.md` (corpo completo — só description)
+- `.agents/squads/` (só se pedir)
+- `integracoes/` (só se pedir)
+- `llm-wiki`, `popular-web-designs`, `pd-ikigai` (nunca no boot)
+- `apple/*`, `productivity/*` (só se platform check passar)
+
+### Checklist de 10s se AGENTS.md estiver gordo:
+
+```
+[ ] AGENTS.md tem < 6.000 bytes?
+[ ] Tabela "Dia a dia" tem < 8 linhas?
+[ ] Tabela "Skills disponíveis" tem < 8 linhas?
+[ ] Seção "Proativo" tem < 15 linhas?
+[ ] Não há seção de marketing/tutorial?
+[ ] Link pra COMECE-AQUI.md (não duplica)?
+[ ] Total skills listadas no boot: < 8?
+[ ] Squads: 1 linha + link?
+```
+
+---
+
+## 7. Plano de Enxugamento em 3 Ondas
+
+### Onda 1 (hoje, zero risco de quebrar fluxo comercial)
+
+1. **AGENTS.md**: mover "Formato Seriado" para `conhecimento/formato-seriado.md` (-800 tokens)
+2. **AGENTS.md**: enxugar tabela "Dia a dia" de 14 para 5 linhas (-400 tokens)
+3. **AGENTS.md**: enxugar tabela "Skills disponíveis" de 14 para 6 linhas (-300 tokens)
+4. **AGENTS.md**: enxugar tabela "Squads" de 4 para 1 linha (-150 tokens)
+5. **Renomear triggers**: `humanizer` → `humanizer-ptbr`, `stop-slop` → `stop-slop-en`
+
+**Resultado**: AGENTS.md de ~9.2KB para ~5.5KB (~1.400 tokens economizados no boot)
+
+### Onda 2 (semana, mover para addons)
+
+1. Mover `llm-wiki/` → `addons/llm-wiki/`
+2. Mover `popular-web-designs/` → `addons/popular-web-designs/`
+3. Mover `pd-ikigai/` → `addons/pd-ikigai/`
+4. Mover `apple/` → `addons/apple/` (com guard de platform)
+5. Mover `productivity/notion/` → `addons/notion/`
+6. Mover `productivity/google-workspace/` → `addons/google-workspace/`
+7. Mover `productivity/maps/` → `addons/maps/`
+8. Mover `productivity/powerpoint/` → `addons/powerpoint/`
+9. Mover `.agents/squads/advisory-board/` → `addons/advisory-board/`
+10. Mover `.agents/squads/brand/` → `addons/brand/`
+
+**Resultado**: Skills core de 22 para 12. Squads de 3 para 1.
+
+### Onda 3 (só se ICP não usar)
+
+1. Se empresário não usa `ocr-and-documents` → mover pra addon
+2. Se não usa `nano-pdf` → mover pra addon
+3. Se não usa `audit` → mover pra addon (já é semanal)
+4. Se `composio` nunca é pedido → mover pra addon
+5. Consolidar `session-start` + `session-end` em 1 skill com flags (economiza 1 SKILL.md)
+
+---
+
+## 8. NÃO Recomendo
+
+- Apagar `memoria/` ou `session-*` (core do sistema)
+- Fundir `social-content` no `instagram-carrossel` (já decidido: texto vs visual)
+- Inventar features novas
+- Mover `proposta`, `design-marca`, `onboard` (core do prestador)
+- Mudar `clientes/_template` ou `_index` (pipeline funcional)
+
+---
+
+## 5 Decisões — RESOLVIDO (Felipe, 2026-07-24)
+
+| # | Proposta Sieve | Decisão produto |
+|---|----------------|-----------------|
+| 1 | Mover llm-wiki + popular-web → addons | **NÃO.** Empresário digital pesquisa e cria site/UI p/ si e clientes. |
+| 2 | Mover squads advisory + brand → addons | **NÃO.** Bônus sob demanda (mentes/branding). |
+| 3 | Mover productivity/* → addons / Composio | **NÃO** (exceto maps). Skill nativa Gmail/Notion/PPTX > CLI Composio no dia a dia. Composio = IG/TikTok/Telegram etc. |
+| 4 | Mover apple → addons | **NÃO.** Manter Reminders/Notes. |
+| 5 | Enxugar AGENTS por KB | **Parcial.** Otimizar **linhas/clareza**, não podar regra útil (engessa o sistema). |
+
+**Única corte aprovado:** skill **`maps`** removida (sem encaixe; humano usa Google Maps).
+
+Ver também: `memoria/decisoes.md` § Skills & enxugamento.

package/kit/docs/cli.md

@@ -0,0 +1,62 @@
+# CLI INVOS — `npx invos`
+
+## Como rodar localmente (dev)
+
+```bash
+# Na raiz do kit invos
+cd /caminho/invos
+
+# npm link (registra comando invos global)
+npm link packages/cli
+
+# Ou rodar direto
+node packages/cli/bin/invos.js --help
+
+# Ou via npm
+npm run invos -- init
+```
+
+## Comandos MVP
+
+| Comando | Descrição |
+|---------|-----------|
+| `invos init [dir]` | Cria novo projeto INVOS (copia kit + lock + symlinks) |
+| `invos install` | Instala skills/scripts em diretório existente |
+| `invos update [--dry-run]` | Atualiza shipped, preserva user data |
+| `invos doctor [--fix]` | Valida instalação |
+
+## Smokes
+
+```bash
+# 1. Init
+node packages/cli/bin/invos.js init /tmp/invos-smoke
+
+# 2. Install (em repo existente)
+cd /tmp/invos-smoke
+node /caminho/packages/cli/bin/invos.js install
+
+# 3. Doctor
+node /caminho/packages/cli/bin/invos.js doctor
+
+# 4. Update (preserva USER)
+echo "USER DATA" > memoria/perfil.md
+node /caminho/packages/cli/bin/invos.js update --dry-run
+```
+
+## Kit source detection
+
+1. `INVOS_KIT_PATH` env var (se definido)
+2. Relativo ao bin do CLI (`../../..` quando em `packages/cli/`)
+3. Fallback: `process.cwd()`
+
+## Publicação
+
+```bash
+# npm login (com conta com acesso)
+npm publish packages/cli
+```
+
+Após publicado:
+```
+npx invos init meu-negocio
+```

package/kit/docs/hotmart-webhook.md

@@ -0,0 +1,96 @@
+# Hotmart Webhook — INVOS
+
+> Endpoint que recebe eventos do Hotmart (2.0.0) após compra do INVOS.
+
+## URL canônica
+
+```
+https://inovadigitalid.com/api/hotmart-invos
+```
+
+## Como configurar no Hotmart
+
+1. Acesse o **formulário do Hotmart** do produto INVOS
+2. Aba **Webhook**
+3. **URL:** `https://inovadigitalid.com/api/hotmart-invos`
+4. **Versão:** 2.0.0
+5. **Hottok:** o valor da env `HOTMART_HOTTOK` (opcional — gera 503 sem ele em produção)
+6. **Eventos marcados:**
+   - ✅ PURCHASE_APPROVED
+   - ✅ COMPLETE (se houver)
+   - ✅ REFUNDED
+   - ✅ CHARGEBACK
+
+## Eventos tratados
+
+| Evento | Ação |
+|--------|------|
+| `PURCHASE_APPROVED` | Extrai buyer email/name, envia e-mail com instruções de instalação via Resend |
+| `COMPLETE` | Mesmo que PURCHASE_APPROVED |
+| `REFUNDED` | Log com tag `revoke` |
+| `CHARGEBACK` | Log com tag `revoke` |
+
+## Validação
+
+- Header `X-Hottok` **ou** query param `hottok` — se `HOTMART_HOTTOK` estiver setado, o valor deve bater
+- Se `HOTMART_HOTTOK` estiver vazio em produção (`VERCEL_ENV=production`): **503**
+- Se vazio em dev: aceita com warning implícito
+
+## E-mail: Hotmart vs Resend
+
+**Não precisa Resend** se a Hotmart já envia e-mail de entrega pós-compra (área de membros / conteúdo do produto).  
+Configure o **conteúdo do e-mail da Hotmart** com: link do repo + “abra no agente e diga Segue o COMECE-AQUI”.
+
+Resend no webhook só se quiser **segundo** e-mail técnico nosso (`INVOS_SEND_EMAIL=1` + `RESEND_API_KEY`).
+
+## Env vars
+
+| Var | Obrigatória | Descrição |
+|-----|-------------|-----------|
+| `HOTMART_HOTTOK` | Recomendado | Token do form Hotmart (header/body) |
+| `INVOS_SEND_EMAIL` | Não | Só `1` se quiser e-mail via Resend (default: off) |
+| `RESEND_API_KEY` | Não | Só com INVOS_SEND_EMAIL=1 |
+| `RESEND_FROM` | Não | Remetente Resend |
+| `INVOS_GITHUB_URL` | Não | Link no e-mail Resend (default: github.com/felipenalves/invos) |
+
+## Body esperado (Hotmart 2.0.0)
+
+```json
+{
+  "id": "evt_abc123",
+  "event": "PURCHASE_APPROVED",
+  "data": {
+    "buyer": { "email": "comprador@email.com", "name": "João" },
+    "product": { "id": 12345, "name": "INVOS — Business Memory for AI Agents" },
+    "purchase": { "status": "approved", "transaction": "tx_abc" }
+  }
+}
+```
+
+## Response
+
+```json
+{ "ok": true, "event": "PURCHASE_APPROVED" }
+```
+
+Sempre 200 (a menos que validação falhe). Hotmart espera resposta rápida.
+
+## Logs
+
+Payload é logado com email/name mascarados (`***@***`). Eventos financeiros (REFUNDED/CHARGEBACK) são logados com tag `revoke`.
+
+## Teste local
+
+```bash
+curl -X POST http://localhost:3000/api/hotmart-invos \
+  -H "Content-Type: application/json" \
+  -H "X-Hottok: meu-hottok-dev" \
+  -d '{
+    "id": "test_1",
+    "event": "PURCHASE_APPROVED",
+    "data": {
+      "buyer": { "email": "teste@teste.com", "name": "Teste" },
+      "product": { "id": 999, "name": "INVOS Dev" }
+    }
+  }'
+```

package/kit/docs/lab-user.md

@@ -0,0 +1,35 @@
+# Lab — Testar CLI como comprador
+
+> Sandbox isolado pra testar o fluxo `invos init/install/update/doctor`.
+
+## Sandbox
+
+```
+/Users/felipealves/FelipeOS/projetos/Felipe.aiOS/projetos/invos-TEST
+```
+
+## Rodar
+
+```bash
+bash /Users/felipealves/FelipeOS/projetos/Felipe.aiOS/projetos/invos-TEST/scripts/lab-user-flow.sh
+```
+
+O script:
+
+1. Cria `user-home/` via `invos init`
+2. Roda `invos doctor` (valida 6/6 files, 7/7 dirs)
+3. Simula dados do usuário (USER MARKER)
+4. Roda `invos update` e verifica que USER foi preservado
+5. Cria `user-existing-app/` com README.md
+6. Roda `invos install` e verifica que README foi preservado
+7. Roda `doctor` no existing app
+
+Exit 0 = tudo ok.
+
+## Reset
+
+```bash
+bash /Users/felipealves/FelipeOS/projetos/Felipe.aiOS/projetos/invos-TEST/scripts/lab-reset.sh
+```
+
+Remove `user-home/` e `user-existing-app/`.

package/kit/docs/prd-invos-cli.md

@@ -0,0 +1,264 @@
+# PRD — INVOS CLI (`npx invos`)
+
+> Product Requirements Document · Kit Privado · CLI-first
+
+---
+
+## 1. Visão
+
+INVOS = **cérebro do negócio** (intelligence) com 5 raios:
+
+| Raio | Função |
+|------|--------|
+| **Oferta** | Proposta, precificação, escopo |
+| **Aquisição** | Pipeline, clientes, leads, conteúdo |
+| **Vendas** | Follow-up, fechamento, objeção |
+| **Entrega** | Projetos, arquivos, revisões, prazos |
+| **Operação** | Memória, regras, sessões, histórico |
+
+Pasta = **SaaS de arquivos**. O CLI é o orquestrador que instala, atualiza e diagnostica o sistema.
+
+## 2. Modelo de distribuição
+
+- **Kit privado** (pago via Hotmart ou similar)
+- Freemium futuro possível (kit público limitado)
+- CLI = caminho **principal** de acesso
+- Checkout integrado: landing page + entrega automática via Hotmart/GitHub token
+
+## 3. Comandos
+
+### 3.1 `npx invos init`
+
+Cria novo projeto INVOS do zero.
+
+```bash
+npx invos init [--name <slug>] [--dir <path>]
+```
+
+- Gera estrutura completa: `AGENTS.md`, `MEMORY.md`, `SECURITY.md`, `.env.example`, `COMECE-AQUI.md`, `memoria/`, `marca/`, `clientes/`, `conteudo/`, `scripts/`, `.agents/skills/`, `.agents/squads/`
+- `--name`: slug do negócio (ex: `ana-studio`)
+- `--dir`: diretório destino (default: `./<name>`)
+- Pós-init: `npx invos doctor` para verificar
+
+### 3.2 `npx invos install`
+
+Instala INVOS em **repo existente**. Inspirado em `npx aiox-core install`.
+
+```bash
+cd /meu-projeto && npx invos install
+```
+
+- Adiciona `.agents/skills/`, `.agents/squads/`, `memoria/` (se ausente), `scripts/`, `marca/`
+- Cria `AGENTS.md` com `@AGENTS.md` se `CLAUDE.md` existe (link simbólico de documentação)
+- Cria `INVOS-LOCK.json`
+- **Nunca** sobrescreve: `memoria/` preenchida, `clientes/*` (exceto `_template`), `marca/` com conteúdo real, `conteudo/` real, `.env`
+
+### 3.3 `npx invos update`
+
+Atualiza sistema e skills.
+
+**Sobe (shipped → local):**
+
+| Sobe | Não sobe |
+|------|----------|
+| `.agents/skills/*` | `memoria/*` (dados do usuário) |
+| `.agents/squads/*` | `clientes/<slug>/*` (exceto `_template`) |
+| `AGENTS.md` (shipped) | `marca/marca.md` se preenchido |
+| `scripts/*` | `conteudo/*` real |
+| `COMECE-AQUI.md` | `.env` |
+| `MEMORY.md` | `clientes/_index.md` |
+| `SECURITY.md` | |
+| `templates/` (`clientes/_template`, `marca/assets/`) | |
+
+**Política de AGENTS.md custom:**
+
+Se o AGENTS.md do usuário divergiu do shipped:
+1. Renomeia shipped para `AGENTS.md.shipped.bak`
+2. Warn: `⚠️ AGENTS.md customizado — backup em AGENTS.md.shipped.bak`
+3. Oferece opções: `replace` (sobrescreve) | `skip` (mantém custom)
+
+Sem machineId, sem rastreamento. Apenas diff contra `AGENTS.md.shipped.sha256` no lock.
+
+### 3.4 `npx invos doctor`
+
+Diagnóstico do sistema INVOS.
+
+```bash
+npx invos doctor [--fix]
+```
+
+- Verifica estrutura de pastas essenciais
+- Verifica skills presentes (vs manifesto)
+- Verifica lock file
+- `--fix`: tenta corrigir problemas comuns (pastas faltando, symlinks quebrados)
+
+### 3.5 `npx invos uninstall`
+
+Remove estrutura INVOS do projeto.
+
+```bash
+npx invos uninstall [--force]
+```
+
+- Remove `.agents/`, `memoria/`, `marca/`, `clientes/`, `conteudo/`, `scripts/`
+- Restaura `INVOS-LOCK.json` backup se existir
+- `--force`: não pede confirmação
+
+### 3.6 `npx invos pack` (fase 2)
+
+Empacota skills ou o kit completo para distribuição.
+
+```bash
+npx invos pack [--output <dir>] [--scope skills|kit]
+```
+
+- Escopo `skills`: empacota `.agents/skills/` para reuso
+- Escopo `kit`: snapshot completo do kit (sem dados do usuário)
+
+## 4. Manifesto e lock
+
+### 4.1 `INVOS.json` (manifesto PRODUCT / SEED / USER)
+
+```json
+{
+  "version": "1.0.0",
+  "manifest": "PRODUCT",
+  "product": {
+    "name": "invos",
+    "type": "kit",
+    "distribution": "private",
+    "checkout": "hotmart+github"
+  },
+  "seed": {
+    "skills": ["session-start", "session-end", "session-checkpoint", "onboard",
+               "proposta", "design-marca", "social-content", "instagram-carrossel",
+               "humanizer-ptbr", "stop-slop", "audit", "pd-ikigai", "notion"],
+    "squads": ["instagram-carrossel", "advisory-board", "brand", "hormozi-squad"],
+    "templates": ["clientes/_template", "marca/assets"]
+  },
+  "user": {
+    "installedAt": "2026-07-24",
+    "projectDir": ".",
+    "branch": "develop"
+  }
+}
+```
+
+Três seções:
+- **PRODUCT**: versão, tipo, distribuição (só no repo oficial)
+- **SEED**: o que o `install`/`init` planta
+- **USER**: metadados da instalação local (gerado pelo CLI)
+
+### 4.2 `INVOS-LOCK.json`
+
+```json
+{
+  "version": "1.0.0",
+  "shippedSha": {
+    "AGENTS.md": "abc123...",
+    ".agents/skills/session-start/SKILL.md": "def456..."
+  },
+  "custom": {
+    "AGENTS.md": "skip" // ou "replace"
+  },
+  "installedAt": "2026-07-24T10:00:00Z",
+  "updatedAt": null
+}
+```
+
+- `shippedSha`: sha256 de cada arquivo shipped para diff no update
+- `custom`: decisão do usuário sobre arquivos divergentes
+- Usado por `doctor` e `update`
+
+## 5. Multi-harness
+
+Skills canônicas vivem em `.agents/skills/`. Para Claude Code, cria-se `.claude/skills/` com symlinks:
+
+```
+.claude/skills/session-start -> ../../.agents/skills/session-start
+.claude/skills/session-end   -> ../../.agents/skills/session-end
+```
+
+Outros harness (Cursor, Gemini, Codex) leem de `.agents/skills/` diretamente.
+
+## 6. Fluxos
+
+### 6.1 Primeira vez (comprou)
+
+```
+Compra na Hotmart
+  → recebe link do GitHub (token automático)
+  → npx invos init --name meu-negocio
+  → npx invos doctor
+  → Pronto!
+```
+
+### 6.2 Já tem projeto
+
+```
+cd /meu-projeto-existente
+npx invos install
+  → adiciona skills + memoria + scripts
+  → não mexe em dados existentes
+npx invos doctor
+```
+
+### 6.3 Atualizar
+
+```
+npx invos update
+  → baixa último shipped
+  → preserva USER
+  → avisa se AGENTS.md custom
+```
+
+### 6.4 Checkout integrado (fase 2)
+
+Landing page INVOS → compra Hotmart → gatilho webhook → GitHub release + token → `npx invos init` ou `install` pronto na máquina do comprador.
+
+## 7. MVP (2 semanas)
+
+| O que | Entrega |
+|-------|---------|
+| `npx invos init` | Gera estrutura completa |
+| `npx invos install` | Instala em repo existente |
+| `npx invos doctor` | Valida instalação |
+| `npx invos update` | Atualiza skills shipped |
+| `INVOS.json` + `INVOS-LOCK.json` | Manifesto e lock |
+| Multi-harness | Symlinks `.claude/skills/` |
+| AGENTS.md custom policy | `.bak` + skip/replace |
+
+**Fora do MVP:**
+
+- `npx invos uninstall`
+- `npx invos pack`
+- Checkout LP integrado (apenas MVP de CLI)
+- Freemium público
+- `npx invos upgrade` (para versões pagas)
+
+## 8. Non-goals
+
+- **Não é framework de agentes** — não substitui OpenSquad, LangChain, CrewAI
+  (INVOS inspira version pin + kit update, mas não vira clone do opensquad)
+- **Não é CMS** — conteúdo é markdown, não banco
+- **Não é SaaS multi-tenant** — cada instalação é independente
+- **Não tem telemetria** — sem machineId, sem tracking
+- **Não substitui Hotmart** — CLI não gerencia pagamentos; só recebe token
+
+## 9. Critérios de aceite
+
+| # | Critério | Como verificar |
+|---|----------|----------------|
+| 1 | `npx invos init --name x` gera `x/` com estrutura completa | `ls x/` mostra AGENTS.md, MEMORY.md, memoria/, .agents/ |
+| 2 | `npx invos install` em repo vazio adiciona skills sem quebrar nada | `git status` mostra novos arquivos, nenhum removido |
+| 3 | `npx invos doctor` retorna exit 0 em kit completo | `echo $?` = 0 |
+| 4 | `npx invos update` não sobrescreve `memoria/perfil.md` preenchido | `cat memoria/perfil.md` mantém conteúdo |
+| 5 | AGENTS.md custom gera `.bak` + warn | `ls AGENTS.md.shipped.bak` existe |
+| 6 | Symlinks `.claude/skills/*` apontam para `.agents/skills/*` | `readlink .claude/skills/session-start` = `../../.agents/skills/session-start` |
+| 7 | Lock file contém sha256 dos shipped | `cat INVOS-LOCK.json` mostra `shippedSha` |
+
+## 10. Referência
+
+- OpenSquad (inspiração version pin): https://www.npmjs.com/package/opensquad
+- AIOX `npx aiox-core install` (inspiração install em repo existente)
+- INVOS atual: `projetos/invos-TEST` (sandbox de validação)