ganbatte-os 0.2.36 → 0.2.38

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.

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

@@ -0,0 +1,134 @@
+---
+name: gos-compress
+description: >
+  Comprime INPUT de prompts longos antes de enviar a outra skill ou subagent, usando
+  LLMLingua-2 da Microsoft (modelo XLM-RoBERTa local). Reducao tipica 40-60% sem perda
+  semantica. Wrapper sobre sandeco-token-reduce. Requer setup unico (~1GB modelo HuggingFace).
+argument-hint: "<acao: setup|compress|init> [args]"
+allowedTools: [Read, Write, Bash]
+sourceDocs:
+  - libraries/gos-compress-setup.md
+use-when:
+  - precisa passar contexto longo (>2000 tokens) para subagent/skill
+  - usuario pede "comprimir contexto" ou "reduzir tokens"
+  - prototype-orchestrator avancando entre fases com PRD/intake longos
+do-not-use-for:
+  - textos curtos (<500 tokens — nao compensa)
+  - codigo (perde semantica precisa)
+  - frontmatter, tabelas estruturadas (parser quebra)
+metadata:
+  category: optimization
+attribution: github sandeco/sandeco-token-reduce + microsoft/llmlingua-2
+---
+
+Voce esta executando como **Compressor de Input** via skill `gos-compress`. Wrapper sobre sandeco-token-reduce + LLMLingua-2 da Microsoft.
+
+## Pre-flight: setup unico
+
+Antes do primeiro uso, o `.venv` precisa existir em `skills/gos-compress/.venv/`.
+
+### Verificar
+```bash
+test -d <skill-dir>/.venv && echo "ready" || echo "needs-setup"
+```
+
+### Setup (1x apenas, ~1GB download)
+```bash
+python "<skill-dir>/scripts/setup.py"
+```
+
+Setup faz:
+- Cria `.venv`
+- Instala `llmlingua` + `anthropic`
+- Baixa `microsoft/llmlingua-2-xlm-roberta-large-meetingbank` (~1GB) em `~/.cache/huggingface/`
+- Idempotente
+
+## Acoes
+
+### `setup` — instala/atualiza modelo
+```
+*gos-compress setup
+```
+
+### `compress` — comprime arquivo ou texto
+```
+*gos-compress compress --file path/to/long.md --rate 0.4
+*gos-compress compress --file path/to/long.md --rate 0.4 --output path/comprimido.md
+*gos-compress compress --text "texto longo" --rate 0.5
+```
+
+Parametros:
+| Flag | Default | Descricao |
+|------|---------|-----------|
+| `--rate` | 0.4 | Fracao de tokens a manter (0.5 leve, 0.2 agressivo) |
+| `--file` | — | Path do arquivo |
+| `--text` | — | Texto direto |
+| `--output` | — | Salva resultado em arquivo |
+| `--json` | false | Output JSON com stats |
+
+### `init` — alias para setup
+
+## Taxa recomendada por uso
+
+| Caso | Rate | Justificativa |
+|------|------|---------------|
+| Intake -> PRD | 0.5 | Preservar nuance |
+| PRD -> ADR | 0.4 | Decisoes precisam contexto |
+| ADR -> Plan | 0.4 | Padrao |
+| Long thread -> resumo | 0.3 | Pode perder detalhe |
+| Codigo (NAO USAR) | — | Use Read direto |
+
+## Pipelines no G-OS
+
+### Em prototype-orchestrator
+Entre fases consecutivas, comprimir output da fase anterior antes de passar:
+
+```
+intake.md (4000 tokens)
+  -> gos-compress rate=0.5
+  -> intake.compressed (2000 tokens)
+  -> input para prd-from-intake
+```
+
+### Em plan-blueprint
+Quando rodando com `--compress-context`, comprimir `docs/stack.md` + `docs/prd/PRD-NNN/prd.md` + `docs/adr/*.md` antes de injetar no contexto.
+
+## Output JSON (programatico)
+
+```json
+{
+  "compression": {
+    "compressed_prompt": "<texto>",
+    "origin_tokens": 312,
+    "compressed_tokens": 124,
+    "ratio": 2.52,
+    "saving": 188,
+    "rate_requested": 0.4
+  }
+}
+```
+
+## Anti-uso
+
+- Codigo: LLMLingua remove tokens "menos relevantes" semanticamente, mas codigo precisa preservacao exata.
+- Tabelas: estrutura `|---|` quebra.
+- YAML frontmatter: idem.
+- Skill `idea-intake` outputs: usuario nao-tecnico pode confundir prosa fragmentada.
+
+## Pre-processamento automatico (sandeco)
+
+Antes de comprimir, sandeco aplica `strip_markdown()`:
+- Remove `---`, grid de tabelas, `**bold**` (mantem texto), `##` headers (mantem texto), checkboxes, code fences, linhas vazias multiplas.
+
+Reducao base ~6% antes do modelo entrar.
+
+## Force tokens preservados
+
+Sempre preservados pelo modelo (sandeco config):
+- `\n`, `.`, `,`, `?`, `!`, `:`
+- Negacoes PT: `nao`, `sem`, `nenhum`, `nunca`, `nem`, `nenhuma`
+- Tokens com digitos (IDs, ms, percentuais) via `force_reserve_digit=True`
+
+## Input
+
+$ARGUMENTS