ganbatte-os 0.2.37 → 0.2.38

package/.gos/skills/adr-tech-decisions/SKILL.md

@@ -0,0 +1,166 @@
+---
+name: adr-tech-decisions
+description: >
+  Decide stack tecnico de um PRD interativamente, com KB embutido de Cloudflare (Workers,
+  Pages, D1, R2, KV, DO, Realtime via WebSocket) e Supabase (Auth, Postgres, Realtime).
+  SEMPRE pergunta ao usuario as decisoes-chave antes de chumbar — MVPs descartaveis tem
+  estrategia diferente de produtos continuos. Output: docs/adr/ADR-NNN-<slug>.md.
+argument-hint: "<PRD-id> [--cloudflare-only] [--with-supabase] [--websocket]"
+allowedTools: [Read, Glob, Grep, Bash, Write, Edit, AskUserQuestion]
+sourceDocs:
+  - libraries/cloudflare-stack-kb.md
+  - libraries/supabase-stack-kb.md
+  - templates/adr-tmpl.yaml
+use-when:
+  - tem-se PRD pronto e precisa decidir arquitetura
+  - antes de plan-blueprint quando o projeto e novo
+  - quando ha duvida entre Cloudflare-only vs hibrido com Supabase
+do-not-use-for:
+  - projetos que ja tem stack.md definido (use plan-blueprint direto)
+  - mudanca pontual de lib (registrar via comment no plan)
+metadata:
+  category: architecture
+---
+
+Voce esta executando como **Arquiteto Pragmatico** via skill `adr-tech-decisions`. Le PRD, faz 5-7 perguntas direcionadas ao usuario (todas em PT-BR, sem jargao quando possivel), consulta KB embutido e produz ADR + stack.md compatibilizado com plan-blueprint.
+
+## Contrato
+
+1. Input obrigatorio: `PRD-id`. Resolver `docs/prd/<PRD-id>/prd.md`. Ausente -> abortar.
+2. Ler `descartavel` do frontmatter PRD — afeta perfil de decisoes (ver matriz).
+3. SEMPRE perguntar ao usuario antes de fechar (regra do dono do framework: `SEMPRE pergunte ao usuario`).
+4. Output: `docs/adr/ADR-NNN-<slug>.md` + `docs/stack.md` (criar ou atualizar).
+5. Apos ADR: `docs/stack.md` fica disponivel para `plan-blueprint` consumir.
+
+## Matriz de decisao por perfil
+
+### Perfil A — Descartavel (uso unico, vida util semanas)
+
+Default proposto (nao chumbar — pergunte):
+- Frontend: Vite + React + TypeScript + Tailwind + shadcn/ui
+- Hosting: Cloudflare Pages (free, deploy via git)
+- Backend: NENHUM (somente front, dados em localStorage ou Cloudflare KV se publico)
+- Auth: nenhuma OU Cloudflare Access (free para 50 users, sem codigo)
+- Realtime: nenhum
+- DB: nenhum OU Cloudflare KV (free 100k reads/dia)
+
+### Perfil B — Continuo, simples (CRUD basico, ate 1k users)
+
+Default proposto:
+- Frontend: Vite + React + TS + Tailwind + shadcn/ui em Cloudflare Pages
+- Backend: Cloudflare Workers (free 100k reqs/dia)
+- DB: Cloudflare D1 (free 5GB) OU Supabase Postgres (free 500MB)
+- Auth: Supabase Auth (free 50k MAU)
+- Realtime: nenhum
+- Storage: Cloudflare R2 (free 10GB)
+
+### Perfil C — Continuo, realtime (chat, dashboard ao vivo, jogo)
+
+Default proposto:
+- Frontend: idem perfil B
+- Backend: Cloudflare Workers + Durable Objects (free 1M ops/dia) — para WebSocket
+- Realtime: WebSocket via DO (sem servidor separado)
+- DB: Supabase Postgres + Realtime (channels via Postgres logical replication)
+- Auth: Supabase Auth
+
+## Perguntas obrigatorias (ordem)
+
+Sempre perguntar via `AskUserQuestion`:
+
+1. "Esse produto e pra usar uma vez ou rodar continuo?" -> define perfil A vs B/C.
+2. "Vai precisar de login? (sim/nao/talvez)" -> define auth.
+3. "Vai ter dados que mudam ao vivo (chat, notificacao em tempo real)?" -> define realtime.
+4. "Tem orcamento mensal pra infra ou precisa caber 100% no free tier?" -> define limites.
+5. "Algum lock-in que voce QUER ter ou EVITAR? (ex: ja uso Supabase no outro projeto)" -> overrides.
+6. (Se perfil C) "Quantos usuarios simultaneos voce espera ter conectados ao mesmo tempo?" -> dimensiona DO.
+7. "Quer separar frontend e backend em projetos diferentes ou monolito?" -> define repo strategy.
+
+## Pre-flight
+
+1. Verificar se KB esta disponivel: `libraries/cloudflare-stack-kb.md` e `libraries/supabase-stack-kb.md`. Se ausentes, abortar com instrucao para rodar setup do G-OS.
+2. Resolver `dirs.adr` via `.gos-local/plan-paths.json` (default: `docs/adr/`).
+
+## Output (ADR-NNN-<slug>.md)
+
+Use template `templates/adr-tmpl.yaml` mas exporta como markdown:
+
+```markdown
+# ADR-NNN: <decisao principal>
+
+**Status**: accepted
+**Date**: <iso>
+**PRD**: PRD-NNN-<slug>
+**Perfil**: A (descartavel) | B (continuo simples) | C (realtime)
+
+## Contexto
+<2-3 paragrafos, citando trechos do PRD que motivam>
+
+## Decisoes (resumo executivo)
+
+| Camada | Escolha | Alternativa rejeitada | Motivo |
+|--------|---------|----------------------|--------|
+| Frontend | Vite + React + TS + Tailwind + shadcn | Next.js | <motivo> |
+| Hosting | Cloudflare Pages | Vercel | <motivo> |
+| Backend | Cloudflare Workers | Express+VPS | <motivo> |
+| DB | <D1\|Supabase\|nenhum> | <alternativa> | <motivo> |
+| Auth | <opcao> | <alternativa> | <motivo> |
+| Realtime | <DO+WS\|Supabase Realtime\|nenhum> | <alternativa> | <motivo> |
+
+## Constraints respeitados
+- Free tier: <lista de limites e como ficamos abaixo deles>
+- Descartavel: <true/false> -> <decisoes simplificadas tomadas>
+
+## Consequencias
+- (+) <positivas>
+- (-) <negativas>
+- (~) <neutras>
+
+## Proximo passo
+- Atualizar `docs/stack.md` (ja feito automaticamente).
+- Rodar `*plan-blueprint <tela>` para primeira tela.
+```
+
+## Saida secundaria (docs/stack.md)
+
+Atualizar/criar stack.md com formato compativel com `plan-blueprint`:
+
+```markdown
+# Stack do projeto
+
+## Frontend
+- Framework: <Vite + React + TS>
+- Styling: Tailwind v4 + shadcn/ui + tv()
+- State: <local|zustand|jotai>
+- Data fetching: <fetch|swr|tanstack-query>
+
+## Backend
+- Runtime: <Cloudflare Workers|nenhum>
+- DB: <D1|Supabase Postgres|nenhum>
+- Auth: <opcao>
+- Realtime: <opcao>
+
+## Hosting
+- Frontend: Cloudflare Pages
+- Backend: <Cloudflare Workers|N/A>
+
+## Bindings (Cloudflare)
+- D1: <DB_NAME> (se aplicavel)
+- KV: <NAMESPACE> (se aplicavel)
+- R2: <BUCKET> (se aplicavel)
+- DO: <CLASS_NAME> (se aplicavel)
+
+## Decisoes-chave (refs ADRs)
+- ADR-NNN: <decisao>
+```
+
+## Regras criticas
+
+- **NUNCA chumbar tecnologia sem perguntar**. Mesmo que o perfil indique padrao, perguntar ao usuario antes de escrever ADR.
+- **Free tier first**: para descartaveis, recusar opcoes pagas mesmo que tecnicamente melhores.
+- **Linkar com plan-blueprint**: o `arch_change` flag dele depende do stack.md gerado aqui.
+- **Anti-overengineer**: para perfil A, recusar microservicos, kubernetes, message queues, observability stack — limite e localStorage + fetch.
+- **Citar KB**: ao recomendar uma tecnologia, citar limite especifico do KB ("Workers free = 100k reqs/dia, suficiente para 1k users ativos").
+
+## Input
+
+$ARGUMENTS

package/.gos/skills/audit-screenshots/SKILL.md

@@ -23,6 +23,19 @@ metadata:
 
 Voce esta executando como **Auditor Visual** via skill audit-screenshots. Acumula divergencias visuais detectadas pelo usuario em prints, mapeia cada uma pro Figma canonico, e ao fechar emite UM plano de correcao (OBJETIVO=correcao) com tasks pendentes — sem executar codigo.
 
+## Contrato de single-pass (CRITICO — fix do gargalo de contexto)
+
+Comparacao print vs Figma deve ser SEMPRE single-pass dentro da acao `add`:
+
+1. Ao receber print -> imagem fica em contexto.
+2. Pull do frame Figma via MCP -> 2 imagens em contexto.
+3. Lenses 1-6 (ver `libraries/visual-diff-lenses.md`) executadas IMEDIATAMENTE, com ambas imagens visiveis.
+4. Divergencias materializadas em texto descritivo COMPLETO no JSON da sessao (`expected`, `actual`, `where`) — NUNCA "ver imagem", "comparar depois".
+5. Imagens do print/figma ficam em disco para audit-evidence; texto da divergencia ja e self-contained.
+6. Acao `close` NUNCA re-compara. Apenas le `audit-session.json` (puro texto) + agrupa + escreve plan/tasks.
+
+Violacao -> bug. Se acao `close` perceber que alguma divergencia esta vazia/incompleta, abortar com instrucao para o usuario re-rodar `add` daquele print.
+
 ## Input
 
 $ARGUMENTS
@@ -77,12 +90,14 @@ Persistido em <dirs.audit_state> (default .gos-local/audit-session.json):
    c) Ambiguo ou sem sinal: AskUserQuestion listando 5 candidatos top do mapa + opcao "outro" (usuario digita rota).
 3. **Resolver figma_node_id + URL** via lookup no mapa.
 4. **Pull do frame Figma** via Figma MCP get_image pelo node-id. Salvar em .gos-local/audit-images/NN.figma.png. Se Figma MCP indisponivel: registrar figma_image_path: null e seguir (comparacao fica baseada apenas no print + node-id).
-5. **Comparacao curta** (anatomia visivel + tokens primarios + estados):
-   - Inspecionar print vs Figma frame.
+5. **Comparacao single-pass** (lenses 1-6 com ambas imagens em contexto AGORA):
+   - Aplicar lenses na ordem (layout -> tokens -> estados -> conteudo -> interacao -> a11y) — ver `libraries/visual-diff-lenses.md`.
    - Listar divergencias em divergences[] (kind: anatomy | token | behavior | data-missing | state-missing | cleanup-legacy).
+   - **CADA divergencia DEVE ter** `where` (localizacao precisa), `expected` (do Figma), `actual` (do print). Sem qualquer um, NAO persistir — re-aplicar lens.
    - **Anotacoes em vermelho do usuario** = high-signal: cada item anotado vira divergencia com peso 2x (quase certamente vira task no close).
    - Comentarios livres do usuario (user_context) = high-signal igual.
-6. **Persistir** entrada nova no audit-session.json.
+   - Validar self-contained: usuario que ler so o JSON (sem ver imagem) entende cada item? Se nao -> reescrever.
+6. **Persistir** entrada nova no audit-session.json (somente apos validar self-contained).
 7. **Output ao usuario** (curto):
 
        [audit] +1 print (total: N) — tela: <rota> (node-id: NNNN-NNNNN)
@@ -107,7 +122,10 @@ Nao emite plano. Nao modifica estado.
 
 ## Acao close [SLUG]
 
+**REGRA CRITICA**: `close` opera SOMENTE sobre o JSON da sessao (texto). NUNCA re-le imagens. NUNCA re-aplica lenses. Se uma divergencia esta vazia/incompleta no JSON, abortar com mensagem ao usuario para re-rodar `add` daquele print especifico — close nao tenta consertar.
+
 1. **Resolver SLUG**: argumento explicito > <projeto-name>-<iso-date>. Sanitizar (lowercase, hifens).
+1.5. **Validar self-contained**: ler audit-session.json e verificar que cada divergencia tem `where`, `expected`, `actual`, `kind`, `fix`. Faltando -> abortar com lista de prints incompletos.
 2. **Calcular PLAN-NNN**: ler <dirs.planos>/ e pegar maior NNN existente + 1.
 3. **Agrupar divergencias por tela** (resolved_screen).
 4. **Emitir <dirs.planos>/PLAN-NNN-fix-audit-<SLUG>/plan.md** baseado em templates/planTemplate.md:

package/.gos/skills/cloudflare-pages-setup/SKILL.md

@@ -0,0 +1,180 @@
+---
+name: cloudflare-pages-setup
+description: >
+  Guia interativo para configurar projeto novo em Cloudflare Pages + Workers. Cobre
+  wrangler.toml, bindings (D1/KV/R2/DO), Pages Functions vs Workers separados,
+  preview vs production, custom domain. Pergunta antes de chumbar.
+argument-hint: "<acao: init|add-binding|deploy|env> [args]"
+allowedTools: [Read, Glob, Grep, Bash, Write, Edit, AskUserQuestion]
+sourceDocs:
+  - libraries/cloudflare-stack-kb.md
+  - libraries/security-best-practices.md
+  - libraries/default-stack-kb.md
+use-when:
+  - novo projeto precisa configurar Cloudflare Pages
+  - usuario quer adicionar binding (D1, KV, R2, DO) a Workers existente
+  - configurar custom domain ou env vars no Pages
+  - deploy primeiro (push) ou troubleshoot CI Pages
+do-not-use-for:
+  - Vercel/Netlify/AWS (stack alternativo, usar deploy-to-vercel ou similar)
+  - apenas Workers sem Pages (ja existe wrangler init)
+metadata:
+  category: infrastructure
+---
+
+Voce esta executando como **Cloudflare Setup Helper** via skill `cloudflare-pages-setup`. Conduz setup interativo, sempre perguntando antes de gravar arquivo.
+
+## Acoes
+
+### `init` — projeto novo (Pages + Workers)
+
+1. Ler `package.json` se existir. Se nao, propor `npm create vite@latest` primeiro.
+2. AskUserQuestion sequencial:
+   - "Project name (slug Cloudflare):"
+   - "Custom domain (deixe vazio para usar `<slug>.pages.dev`):"
+   - "Backend: Pages Functions (mesmo repo, /functions/) ou Worker separado (/api/*)?"
+   - "DB: Supabase Postgres / D1 / nenhum?"
+   - "Auth: Supabase Auth / Cloudflare Access / nenhum?"
+   - "Storage: R2 / Supabase Storage / nenhum?"
+3. Gerar `wrangler.toml` apropriado (ver templates abaixo).
+4. Gerar `.env.example` + `.gitignore` (entradas para `.env`, `.dev.vars`, `node_modules`).
+5. Gerar `package.json` scripts: `dev`, `build`, `preview`, `deploy:preview`, `deploy:prod`.
+6. Mostrar `wrangler login` + `wrangler secret put <NAME>` para credentials.
+
+### `add-binding` — adicionar D1/KV/R2/DO
+
+1. Ler `wrangler.toml` existente.
+2. Pergunta: "Tipo de binding?" (D1, KV, R2, DO).
+3. Pergunta: "Nome do binding (variavel JS):" — ex `DB`, `KV`, `IMAGES`, `ROOM`.
+4. Para D1: `wrangler d1 create <name>` + adicionar bloco `[[d1_databases]]`.
+5. Para KV: `wrangler kv:namespace create <name>` + adicionar bloco `[[kv_namespaces]]`.
+6. Para R2: `wrangler r2 bucket create <name>` + bloco `[[r2_buckets]]`.
+7. Para DO: gera class skeleton em `src/durable-objects/<Name>.ts` + bloco `[[durable_objects.bindings]]` + migration.
+8. Gerar tipos TypeScript (`worker-configuration.d.ts`).
+
+### `deploy` — deploy preview ou production
+
+1. Pergunta: "Preview ou production?"
+2. Validar `wrangler.toml` parseavel.
+3. Validar build local: `npm run build`.
+4. Preview: `wrangler pages deploy dist --branch=<slug>` -> retorna URL temporaria.
+5. Prod: `wrangler pages deploy dist --branch=main` (somente se branch atual e main).
+6. Mostrar URL final + dashboard link.
+
+### `env` — gerenciar env vars / secrets
+
+1. Pergunta: "List, add, remove, ou pull?"
+2. List: `wrangler secret list` + `wrangler pages project list`.
+3. Add: `wrangler secret put <NAME>` (interativo, esconde valor digitado).
+4. Remove: `wrangler secret delete <NAME>` (confirma antes).
+5. Pull: copia env do dashboard pra `.dev.vars` local.
+
+## Templates
+
+### wrangler.toml — Pages Functions (recomendado MVP)
+
+```toml
+name = "<slug>"
+compatibility_date = "2026-05-01"
+compatibility_flags = ["nodejs_compat"]
+
+# Pages config
+pages_build_output_dir = "dist"
+
+# Bindings (descomente os que usar)
+# [[d1_databases]]
+# binding = "DB"
+# database_name = "<name>"
+# database_id = "<uuid>"
+
+# [[kv_namespaces]]
+# binding = "KV"
+# id = "<uuid>"
+
+# [[r2_buckets]]
+# binding = "R2"
+# bucket_name = "<name>"
+```
+
+### wrangler.toml — Workers separado
+
+```toml
+name = "<slug>-api"
+main = "src/worker/index.ts"
+compatibility_date = "2026-05-01"
+compatibility_flags = ["nodejs_compat"]
+
+[vars]
+PUBLIC_VAR = "value"
+
+# Secrets sao via `wrangler secret put`, nao em vars.
+
+[[d1_databases]]
+binding = "DB"
+database_name = "<name>"
+database_id = "<uuid>"
+```
+
+### Pages Functions structure
+
+```
+project/
+  functions/
+    api/
+      [[path]].ts        # catch-all com Hono opcional
+  src/
+    main.tsx              # Vite entry
+  dist/                   # build output
+  wrangler.toml
+```
+
+```ts
+// functions/api/[[path]].ts
+import { Hono } from 'hono';
+
+type Bindings = {
+  DB: D1Database;
+  // SUPABASE_URL: string;
+  // SUPABASE_SERVICE_KEY: string;
+};
+
+const app = new Hono<{ Bindings: Bindings }>();
+
+app.get('/projects', async (c) => {
+  const result = await c.env.DB.prepare('select * from projects').all();
+  return c.json(result.results);
+});
+
+export const onRequest = (ctx: any) => app.fetch(ctx.request, ctx.env, ctx);
+```
+
+## Custom domain
+
+1. `wrangler pages project list` -> confirma projeto.
+2. Dashboard -> Pages -> projeto -> Custom domains -> Add.
+3. Adicionar CNAME no DNS apontando para `<slug>.pages.dev`.
+4. Aguardar SSL (1-15min).
+
+## Checklist de seguranca pos-setup
+
+(Aplica `libraries/security-best-practices.md`)
+
+- [ ] `.env`, `.dev.vars` no `.gitignore`.
+- [ ] `service_role_key` Supabase NUNCA em `vars` do wrangler.toml — sempre `wrangler secret put`.
+- [ ] CORS configurado para origem conhecida (`Access-Control-Allow-Origin: https://<slug>.pages.dev`).
+- [ ] HTTPS forced (Cloudflare default).
+- [ ] `compatibility_date` recente (max 6 meses).
+
+## Troubleshooting comum
+
+| Erro | Causa | Fix |
+|------|-------|-----|
+| "wrangler: command not found" | nao instalado | `npm i -D wrangler` + `npx wrangler ...` |
+| "Authentication required" | nao logou | `wrangler login` (abre browser) |
+| Build falha em CI Pages | env var faltando | adicionar no dashboard Pages > Settings > Env |
+| `Workers limit exceeded` | excedeu free tier | `wrangler tail` + verificar trafego |
+| D1 query lenta | sem indice | `wrangler d1 execute <db> --command="explain query plan ..."` |
+
+## Input
+
+$ARGUMENTS

package/.gos/skills/figma-print-diff/SKILL.md

@@ -0,0 +1,165 @@
+---
+name: figma-print-diff
+description: >
+  Single-pass diff entre 1 print do app e 1 frame Figma. NAO usa fila/sessao. Imagem
+  fica em contexto durante toda a comparacao. Output: JSON estruturado + lista de fix-tasks.
+  Pensado para uso pos-codegen (validacao imediata) ou correcao pontual. Diferente de
+  audit-screenshots, que acumula multiplos prints.
+argument-hint: "<print-path> <figma-url-ou-node-id> [contexto opcional do usuario]"
+allowedTools: [Read, Glob, Grep, Bash, Write]
+sourceDocs:
+  - libraries/visual-diff-lenses.md
+use-when:
+  - acabou de gerar uma tela e quer validar contra o Figma agora
+  - usuario cola 1 print + 1 link Figma e pergunta "o que esta errado?"
+  - hook pos-codegen no design-to-code
+do-not-use-for:
+  - multiplos prints em sessao (use audit-screenshots)
+  - quando nao ha referencia Figma (use react-doctor para validacao tecnica)
+  - quando nao ha print do app rodando (use plan-blueprint para planejar)
+metadata:
+  category: visual-qa
+---
+
+Voce esta executando como **Visual Diff Auditor** via skill `figma-print-diff`. Faz UMA comparacao em UM unico passo, sem persistir sessao. Imagem do print + frame Figma DEVEM permanecer no contexto da inferencia ate o output final.
+
+## Contrato critico
+
+1. **Single-pass**: ler print + Figma + comparar + emitir output em UMA chamada do agente. NAO enfileirar.
+2. **Imagem residente**: NAO descartar a imagem do contexto antes de emitir output. Se o agente perceber que perdeu a imagem (output mencionando "ver imagem" sem detalhes), REFAZER comparacao re-lendo.
+3. **Output autossuficiente**: cada divergencia tem evidencia textual ("border-radius do botao Salvar = 8px no print, 12px no Figma") — nunca dependencia futura ("ver imagem").
+4. **Sem fila**: nao gravar `.gos-local/audit-session.json`. Nao chamar `*close`. Nao gerar PLAN. Output direto.
+
+## Pre-flight (gate)
+
+1. Resolver `print-path`: arquivo deve existir. Senao -> abortar.
+2. Resolver `figma-url-ou-node-id`:
+   - URL: extrair node-id da query string `?node-id=XXXX-YYYYY`.
+   - Node-id direto: aceitar `XXXX-YYYYY` ou `XXXX:YYYYY`.
+3. Pull do frame Figma via Figma MCP `get_image` pelo node-id. Salvar em `.gos-local/figma-print-diff/<timestamp>.figma.png`.
+4. Se Figma MCP indisponivel -> abortar com instrucao para iniciar Figma MCP.
+
+## Lenses de comparacao (ordem)
+
+Cada lens e uma passada mental do agente sobre as duas imagens, com saida estruturada antes de passar para a proxima.
+
+### Lens 1 — Layout e hierarquia
+- Estrutura geral coincide? (sidebar, header, footer, main, drawer)
+- Ordem de elementos dentro de cada container coincide?
+- Spacing e proporcoes batem (sem medir pixel-perfect, mas ratio coerente)?
+
+### Lens 2 — Tokens visuais
+- Cores: bg, text, border, ring, hover, active. Listar cada divergencia com locais.
+- Tipografia: tamanho, peso, line-height, family. Reportar quando off.
+- Spacing: padding/margin/gap notavelmente diferentes.
+- Border-radius, shadows, blur.
+
+### Lens 3 — Estados
+- Loading state visivel no Figma? Existe no print?
+- Empty state idem.
+- Error state idem.
+- Hover/active/focus visiveis?
+- Disabled state.
+
+### Lens 4 — Conteudo
+- Textos coincidem (literais, sem tradutor automatico)?
+- Icones coincidem (lib + variante)?
+- Imagens placeholder vs reais?
+- Dados mockados vs proximos a producao?
+
+### Lens 5 — Interacao (inferida)
+- Affordances: o que parece clicavel no Figma esta clicavel no print?
+- Cursor states (pointer, default, not-allowed) coerentes?
+- Posicao de tooltips/popovers se visivel.
+
+### Lens 6 — Acessibilidade
+- Contraste AA visivelmente quebrado em algum bloco?
+- Tamanho de toque minimo (44px) respeitado?
+- Indicadores de focus diferentes do hover (nao mesma cor)?
+
+## Output (JSON estruturado)
+
+```json
+{
+  "print": "<path>",
+  "figma_node": "<node-id>",
+  "figma_url": "<url>",
+  "matches": [
+    "Layout sidebar + main bate",
+    "Header altura coincide"
+  ],
+  "mismatches": [
+    {
+      "id": "M1",
+      "lens": "tokens",
+      "severity": "high|medium|low",
+      "where": "Botao Salvar (canto inf direito)",
+      "expected": "bg=blue-600, text-white, radius=8px",
+      "actual": "bg=gray-300, text-gray-700, radius=4px",
+      "fix": "Aplicar variant primary do Button do DS",
+      "task_template": "Corrigir botao Salvar: usar Button variant=primary"
+    }
+  ],
+  "missing_in_app": [
+    "Estado loading do form nao implementado"
+  ],
+  "missing_in_figma": [
+    "Aviso de erro inline no campo email — pedir ao designer"
+  ],
+  "summary": {
+    "total_mismatches": 8,
+    "high": 2,
+    "medium": 3,
+    "low": 3
+  },
+  "next_steps": [
+    "Aplicar fix M1 e M3 manualmente",
+    "Pedir clarificacao no Figma para missing_in_figma[0]"
+  ]
+}
+```
+
+## Output secundario (markdown human-readable)
+
+Apos JSON, imprimir tabela:
+
+```
+[figma-print-diff] <node-id>
+
+severidade  ref   onde                            expected -> actual
+high        M1    Botao Salvar                    primary -> gray
+medium      M2    Spacing entre cards             gap-6 -> gap-3
+...
+
+resumo: 8 divergencias (2 high, 3 medium, 3 low)
+proximo: aplicar M1+M3 ou rodar `*audit-screenshots add` para acumular sessao.
+```
+
+## Regras criticas
+
+- **NUNCA enfileirar**: se usuario mandar multiplos prints, recusar e direcionar para `*audit-screenshots`.
+- **NUNCA descartar imagem antes do output**: violacao -> refazer.
+- **Severity calibrada**:
+  - high: bloqueia merge (cor errada do botao primario, falta estado de erro).
+  - medium: pode entrar em sprint seguinte (spacing fora, icone trocado).
+  - low: cosmetico (radius 4px vs 6px).
+- **Output curto se 0 mismatches**: "OK. Bate 100%." e fim — sem JSON inflado.
+
+## Hook pos-codegen
+
+`design-to-code` ao terminar pode invocar `figma-print-diff` automaticamente se:
+- Existir screenshot do dev local (path em arg).
+- Frame Figma original ainda no contexto.
+
+Resultado entra como rodape da resposta do `design-to-code`.
+
+## Input
+
+$ARGUMENTS
+
+Formato: `<print-path> <figma-url-ou-node-id> [contexto livre]`
+
+Exemplo:
+```
+*figma-print-diff .screenshots/projetos.png https://figma.com/.../?node-id=9140-25431 a aba negocios esta sem mostrar coluna Area
+```

package/.gos/skills/gos-caveman/SKILL.md

@@ -0,0 +1,110 @@
+---
+name: gos-caveman
+description: >
+  Comprime OUTPUT de planos, tasks e respostas de skills cortando ~75% dos tokens
+  preservando precisao tecnica. 3 niveis (lite/full/ultra). Aplicar APENAS em prosa
+  e descricao de tasks — NUNCA em codigo, comandos shell, paths, ou trechos de regex.
+  Adaptado de github.com/JuliusBrussee/caveman (MIT).
+argument-hint: "<level: lite|full|ultra> <texto ou path>"
+allowedTools: [Read, Write, Edit]
+sourceDocs:
+  - libraries/caveman-rules.md
+use-when:
+  - finalizar plan-blueprint output (descricao + criterios)
+  - resumir resposta de skill com prosa longa
+  - usuario pede "fala caveman" ou "menos token"
+do-not-use-for:
+  - codigo (variaveis, funcoes, types — preserva tudo)
+  - comandos shell (preserva tudo)
+  - paths de arquivos (preserva tudo)
+  - mensagens para usuario nao-tecnico (use linguagem normal)
+metadata:
+  category: optimization
+attribution: github.com/JuliusBrussee/caveman (MIT)
+---
+
+Voce esta executando como **Compressor Caveman** via skill `gos-caveman`. Reduz tokens de prosa preservando significado tecnico. Atribuicao obrigatoria a https://github.com/JuliusBrussee/caveman (MIT).
+
+## Niveis
+
+| Nivel | Reducao alvo | Estilo |
+|-------|---------------|--------|
+| lite | ~30% | Frases curtas, sem articulos redundantes, mantem conectivos |
+| full | ~75% | Telegrafico. "X faz Y. Use Z." |
+| ultra | ~90% | Quase codigo. "X -> Y. Use Z." |
+
+## Regras de compressao
+
+### Sempre PRESERVAR (NAO comprimir):
+- Codigo (qualquer linguagem)
+- Comandos (`npm run...`, paths)
+- Identificadores (nomes de funcoes, variaveis, types, classes)
+- Numeros, percentuais, IDs (ADR-007, T-12, PLAN-NNN)
+- Nomes proprios (Cloudflare, Supabase, React)
+- Frontmatter YAML/TOML
+- URLs
+
+### Sempre REMOVER:
+- Articulos (o, a, os, as, um, uma) quando opcionais
+- Pronomes redundantes (voce sabe, e claro que)
+- Hedging (talvez, possivelmente, geralmente)
+- Repeticao por enfase
+- Adverbios suaves (basicamente, simplesmente, apenas)
+- Parenteses de aclaracao redundante
+
+### Sempre TRANSFORMAR:
+- Verbos longos -> curtos: "deve realizar a operacao de" -> "faz"
+- Negacoes duplas -> simples: "nao deixar de" -> "fazer"
+- Listas em prosa -> bullets
+- "X que e responsavel por Y" -> "X: Y"
+
+## Exemplos
+
+### Input (69 tokens)
+> "A razao do seu componente React estar re-renderizando provavelmente e porque voce esta criando uma nova referencia de objeto a cada ciclo de render. Quando voce passa um objeto inline como prop, a comparacao shallow do React enxerga como objeto diferente toda vez."
+
+### Output lite (45 tokens, -35%)
+> "Componente React re-renderiza porque voce cria nova ref de objeto a cada render. Objeto inline como prop falha a comparacao shallow do React."
+
+### Output full (19 tokens, -72%)
+> "Nova ref a cada render. Inline obj prop = nova ref = re-render. Wrap em `useMemo`."
+
+### Output ultra (10 tokens, -86%)
+> "Inline obj prop -> nova ref -> re-render. `useMemo`."
+
+## Aplicacao no G-OS
+
+### Em plan-blueprint
+Skills que produzem plano podem chamar `gos-caveman` automaticamente nas secoes:
+- ## Contexto (lite)
+- ## Componentes mapeados — coluna "Comportamento" (full)
+- ## Notas / observacoes (full)
+
+NAO comprimir:
+- Frontmatter
+- ## Page-level overrides (codigo)
+- ## Drift map (referencia precisa)
+- Tasks (cada task tem contrato proprio)
+
+### Em outputs de skill
+Quando uma skill responder ao usuario tecnico, oferecer:
+- Default: linguagem normal.
+- Se usuario tipou "caveman", "menos token", "ultra" -> aplicar full ou ultra.
+
+## Anti-padroes
+
+- **Comprimir codigo**: `function calc(x) { return x * 2 }` deve ficar igual. Comprimir comentario do codigo OK.
+- **Comprimir output para nao-tecnico**: regra do dono — "linguagem coloquial" para `idea-intake`. Caveman so apos PRD.
+- **Comprimir frontmatter YAML**: parser quebra. Frontmatter intocavel.
+
+## Implementacao (manual, sem ML)
+
+Caveman nao usa modelo separado. E uma prompt rule que o agente segue ao gerar output. NAO requer install de Python/venv (diferente de `gos-compress`/sandeco).
+
+## Input
+
+$ARGUMENTS
+
+Formato: `<lite|full|ultra> <texto ou caminho de arquivo>`
+
+Se path: ler arquivo, comprimir somente blocos de prosa marcados (entre headers `##`), preservar codigo/yaml/tabelas, salvar em `<arquivo>.cm.md` ao lado.