ganbatte-os 0.2.36 → 0.2.37

package/.gos/agents/profiles/ganbatte-os-master.md

@@ -250,6 +250,19 @@ routing_matrix:
       Transições de status são VINCULANTES com pós-condição: cada task DEVE sair de pendente
       antes da próxima — se o executor não chamar progress-tracker, abortar (bug PLAN-006).
 
+  audit_screenshots:
+    triggers: ["*audit-screenshots", audit screenshots, auditar print, comparar com figma, "essa tela esta errada", "isso aqui esta divergindo", auditoria visual, prints divergentes]
+    target: skill:audit-screenshots
+    pre_action: Validate .gos-local/plan-paths.json + docs/figma-screen-map.md exist (path em campo `figma_screen_map`). Ausência aborta com instrução clara.
+    notes: |
+      Skill conversacional. Recebe N prints (anotados ou nao) ao longo da sessao,
+      mapeia cada print -> tela -> Figma frame via figma-screen-map.md, acumula
+      divergencias. Ao receber `close [SLUG]` emite UM plano `PLAN-NNN-fix-audit-<SLUG>`
+      com tasks pendentes — NAO executa codigo. Plano gerado e input direto pra
+      *execute-plan e *validate-plan (mesmo template).
+      Quando o usuario cola imagem sem comando explicito, assumir `*audit-screenshots add`.
+      Anotacoes em vermelho do usuario = high-signal (peso 2x na decisao de virar task).
+
   validate_plan:
     triggers: [validate, validar plano, "*validate-plan", validate plan, revisar plano, plano implementado]
     target: skill:validate-plan

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

@@ -0,0 +1,201 @@
+---
+name: audit-screenshots
+description: Skill conversacional. Recebe N prints (anotados ou nao) da aplicacao em uma sessao. Mapeia print -> tela -> Figma frame via docs/figma-screen-map.md. Acumula divergencias entre inputs. Ao fechar, emite UM plano de correcao com tasks pendentes (sem executar). Mesmo template do *plan — output e input direto pra *execute-plan.
+argument-hint: "<acao> [contexto]   # acao: add | list | close [SLUG] | discard"
+allowedTools: [Read, Glob, Grep, Bash, Write, Edit, AskUserQuestion]
+sourceDocs:
+  - skills/plan-blueprint/SKILL.md
+  - skills/plan-to-tasks/SKILL.md
+  - templates/planTemplate.md
+  - templates/taskTemplate.md
+use-when:
+  - usuario cola print + diz "isso aqui esta errado"
+  - usuario pede "compara essa tela com Figma e abre tasks"
+  - usuario quer agrupar varias divergencias em UM plano de correcao
+  - usuario menciona "auditoria visual" ou "tela X esta divergindo do Figma"
+do-not-use-for:
+  - executar correcao (use *execute-plan apos *audit-screenshots close)
+  - planejar tela nova (use *plan)
+  - validar plano executado (use *validate-plan)
+metadata:
+  category: planning
+---
+
+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.
+
+## Input
+
+$ARGUMENTS
+
+Formato: <acao> [SLUG-opcional]
+
+Acoes:
+- add (default quando o usuario cola imagem) — registra 1+ prints na sessao corrente
+- list — imprime resumo da sessao (prints, telas resolvidas, divergencias acumuladas)
+- close [SLUG] — fecha sessao + emite plano PLAN-NNN-fix-audit-<SLUG-ou-iso>
+- discard — zera sessao corrente (apaga audit-session.json + audit-images/)
+
+Quando o usuario simplesmente cola imagem sem comando explicito, assumir add automaticamente.
+
+## Pre-requisitos (gate)
+
+1. Resolver paths via .gos-local/plan-paths.json. Ausente -> abortar e instruir rodar *plan ou criar manualmente o arquivo.
+2. Resolver dirs.figma_screen_map (campo figma_screen_map em plan-paths.json; default: <dirs.docs>/figma-screen-map.md). Arquivo ausente -> abortar com mensagem clara: "rode *audit-screenshots apenas em projetos que mantenham docs/figma-screen-map.md (mapa canonico tela->Figma)".
+3. Resolver dirs.audit_state (campo audit_session_file; default: <projeto>/.gos-local/audit-session.json).
+4. Ler dirs.audit_state se existir — sessao em curso. Senao, criar sessao nova ao primeiro add.
+
+## Estado da sessao
+
+Persistido em <dirs.audit_state> (default .gos-local/audit-session.json):
+
+    {
+      "session_id": "audit-2026-05-06T14-22-03",
+      "created_at": "<iso>",
+      "screenshots": [
+        {
+          "n": 1,
+          "image_path": ".gos-local/audit-images/01.png",
+          "user_context": "tabela negocios mostrando coluna Area com -",
+          "resolved_screen": "/dashboard/projetos/[id]?tab=negocios",
+          "figma_node_id": "9140-25431",
+          "figma_url": "https://www.figma.com/design/.../?node-id=9140-25431",
+          "figma_image_path": ".gos-local/audit-images/01.figma.png",
+          "divergences": [
+            { "kind": "data-missing", "where": "coluna Area", "fix": "seed/endpoint deve popular project.area" },
+            { "kind": "token", "where": "row hover", "fix": "bg-muted/50 (Figma) vs bg-transparent (atual)" }
+          ]
+        }
+      ]
+    }
+
+## Acao add
+
+1. **Salvar imagem(s)** colada(s) pelo usuario em .gos-local/audit-images/NN.png (n = ultimo + 1; multiplas imagens na mesma mensagem viram NN, NN+1, ...). Criar diretorio se necessario.
+2. **Identificar tela** (prioridade):
+   a) Mencao explicita do usuario na mesma mensagem ("e a aba negocios", "/dashboard/projetos/123") -> matchar no figma-screen-map.md.
+   b) Heuristica visual: ler titulo/breadcrumb/URL visivel no print (use modelo multimodal pra extrair texto). Match por substring contra a coluna "Rota app" do mapa.
+   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.
+   - Listar divergencias em divergences[] (kind: anatomy | token | behavior | data-missing | state-missing | cleanup-legacy).
+   - **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.
+7. **Output ao usuario** (curto):
+
+       [audit] +1 print (total: N) — tela: <rota> (node-id: NNNN-NNNNN)
+       divergencias detectadas: <K> (alta-confianca: <H>)
+       proximo: cole outro print, *audit-screenshots list, ou *audit-screenshots close
+
+## Acao list
+
+Le audit-session.json e imprime tabela:
+
+    [audit-session <session_id>] iniciada <created_at>
+
+    #  print              tela                                     divergencias
+    1  audit-images/01    /dashboard/projetos/[id]?tab=negocios    3 (1 alta)
+    2  audit-images/02    /dashboard/projetos                      5 (3 alta)
+    3  audit-images/03    /dashboard/financiadores                 2
+
+    total: 10 divergencias em 3 telas
+    proximo: *audit-screenshots close [SLUG-opcional] -> emite PLAN-NNN-fix-audit-<SLUG>
+
+Nao emite plano. Nao modifica estado.
+
+## Acao close [SLUG]
+
+1. **Resolver SLUG**: argumento explicito > <projeto-name>-<iso-date>. Sanitizar (lowercase, hifens).
+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:
+   - Frontmatter: objetivo: correcao, audit_session: <session_id>, created_at: <iso>, status: pendente, figma_url: <primeiro figma_url da sessao>.
+   - Secao ## Contexto: lista os prints com user_context resumido.
+   - Secao ## Componentes mapeados: 1 linha por divergencia (Componente = inferir do where).
+   - Secao ## Interacoes & Estados: 1 bullet por divergencia tipo behavior ou state-missing.
+   - Secao ## Page-level overrides: 1 linha por divergencia tipo token (decisao default (a) className na pagina; usuario pode reclassificar depois).
+   - Secao ## Backend pendings: 1 linha por divergencia tipo data-missing.
+   - ## Drift map: copia das divergencias detectadas (usado por validate-plan no fechamento).
+   - ## Cleanup de starter legado: divergencias tipo cleanup-legacy se houver.
+5. **Emitir tasks/T-NN-<componente>-<fix-slug>.md** (1 task por divergencia, agrupando triviais por componente):
+   - Frontmatter: status: pendente, priority: P1 (high-signal -> P0), area: ui-ux (token/anatomy) ou area: frontend (behavior/data-missing).
+   - interaction_target: ou override_target: populado quando aplicavel.
+   - Campo novo: audit_evidence: audit-evidence/NN.png apontando pro print original.
+6. **Copiar evidencias** pra <dirs.planos>/PLAN-NNN-fix-audit-<SLUG>/audit-evidence/:
+   - Prints originais (NN.png).
+   - Figma frames capturados (NN.figma.png).
+   - Cada um nomeado igual ao indice da sessao.
+7. **Emitir context.md** padrao (template contextTemplate.md).
+8. **Atualizar progress.txt** via progress-tracker set-current apontando pro plano novo.
+9. **Rodar gate determistico** node <repo>/.gos/scripts/integrations/check-plan.js <plano>:
+   - Exit 0 -> seguir.
+   - Exit != 0 -> abortar e devolver saida do check-plan.
+10. **Arquivar sessao**: mover audit-session.json pra .gos-local/audit-archive/<session_id>.json. NAO apagar imagens (ficam em audit-images/ pra historico).
+11. **Output final**:
+
+        [audit-screenshots] PLAN-NNN-fix-audit-<SLUG> criado
+
+        prints processados: <N>
+        telas afetadas:     <K>
+        tasks criadas:      <T> (<P0> P0 / <P1> P1)
+
+        plano:    docs/plans/PLAN-NNN-fix-audit-<SLUG>/plan.md
+        tasks:    docs/plans/PLAN-NNN-fix-audit-<SLUG>/tasks/ (T tasks)
+        progress: atualizado (status=pendente)
+
+        proximo passo: *execute-plan PLAN-NNN-fix-audit-<SLUG>  (Codex IDE)
+
+## Acao discard
+
+1. Confirmacao inline obrigatoria: AskUserQuestion com 2 opcoes (Sim, descartar tudo / Nao, manter sessao).
+2. Confirmado: apagar .gos-local/audit-session.json + diretorio .gos-local/audit-images/ (todos os prints + frames Figma da sessao corrente).
+3. Output: [audit] sessao descartada (N prints removidos).
+
+## Resolver de tela (parser do figma-screen-map.md)
+
+figma-screen-map.md e markdown com tabelas | Tela | ... | Rota app | node-id | ... |.
+
+Algoritmo:
+1. Ler arquivo.
+2. Extrair todas tabelas via regex (linhas iniciando com |).
+3. Pra cada tabela, identificar coluna Rota app e node-id (case-insensitive, varia entre tabelas).
+4. Construir lookup {rota_normalizada: {node_id, secao, label}} (normalizar = lowercase, remover query strings opcionais).
+5. Match por:
+   - Equality exato: rota visivel no print bate com chave do lookup -> resolvido.
+   - Substring: rota do print contem chave do lookup -> resolvido com warning.
+   - Multiplos matches: AskUserQuestion listando candidatos.
+6. Suportar query strings (?tab=negocios) como parte da rota (mapas separam abas).
+
+## Acoplamento com pipeline
+
+- Plano gerado e input direto pra *execute-plan e *validate-plan — segue 100% o template padrao + frontmatter compativel.
+- Sub-fases 1.5 (drift map) e 1.6 (cleanup legado) do plan-blueprint NAO rodam aqui (audit JA e o drift map empirico). Mas se legacy_starter_dirs declarado em plan-paths.json, divergencias tipo cleanup-legacy sao detectadas durante add e viram tasks T-NN-cleanup-legacy-<slug>.
+- Schema gate (Fase 2.4) NAO roda aqui — divergencias tipo data-missing viram entrada em ## Backend pendings direto, sem confronto com Postman/Prisma (audit assume usuario sabe o que esta vendo).
+- progress-tracker segue identico — plano de audit aparece no progress.txt como qualquer outro.
+
+## Regras criticas
+
+- **Sem execucao**: skill NUNCA modifica codigo da aplicacao. Ela cria plano + tasks (status: pendente). User roda *execute-plan separado se quiser.
+- **Sessao persistente**: state em .gos-local/audit-session.json permite acumular prints entre invocacoes ate close. Sessao orfa (nao fechada por dias) eh ok — discard limpa.
+- **Mapeamento canonico obrigatorio**: sem figma-screen-map.md, skill aborta. Esse arquivo eh o contrato tela<->Figma do projeto.
+- **Anotacoes em vermelho = high-signal**: peso 2x na decisao de virar task. Sem anotacao, ainda detecta automaticamente, mas com peso menor.
+- **Output e input do pipeline existente**: nao reinventa template, usa templates/planTemplate.md + taskTemplate.md.
+
+## Model guidance
+
+| Escopo | Modelo |
+|--------|--------|
+| add com 1-2 prints simples | sonnet |
+| add com print complexo (10+ divergencias visiveis) | opus |
+| close com 5+ telas / 20+ tasks geradas | opus |
+| list / discard | haiku |
+
+## Instructions
+
+1. Ao receber imagem sem comando explicito, assumir *audit-screenshots add.
+2. NUNCA executar codigo da aplicacao — skill so planeja.
+3. Sessao persiste em .gos-local/ ate close ou discard.
+4. Plano gerado SEMPRE roda check-plan.js antes de devolver controle ao usuario.
+5. Ao final do close, instruir o usuario do proximo passo (*execute-plan PLAN-NNN-fix-audit-<SLUG>).

package/.gos/skills/execute-plan/SKILL.md

@@ -86,6 +86,11 @@ Comparacao:
 
 Pre-flight smoke nao substitui o visual gate por task — ele captura gaps grandes (componente faltando, KPI row ausente) que viraram tasks novas em PLAN-004/PLAN-005.
 
+**Drift map como input adicional**: se `<dirs.planos>/<PLAN-NNN-slug>/drift-map.md` existir (gerado na Fase 1.5 do `plan-blueprint`), pre-flight smoke consome cada linha:
+- Para cada divergencia listada: validar override aplicado (grep das classes/props declaradas em `## Page-level overrides`) OU task de implementacao agendada (grep `override_target:` ou `interaction_target:` nos frontmatter de `tasks/T-*.md`).
+- Item sem encaminhamento (sem override aplicado E sem task agendada) = task `T-000-XX` pre-flight com `priority: P0`, prepend na fila, renumera tasks subsequentes.
+- Drift map ausente: nao bloqueia (pipeline antigo continua funcionando).
+
 ## Loop por task
 
 Iterar tasks em ordem de `seq`. Antes de executar cada task, **classificar**:

package/.gos/skills/plan-blueprint/SKILL.md

@@ -128,6 +128,33 @@ Política Figma vs Storybook (ver Fase 2):
 
 > Story define API/anatomia do componente; refinamentos cosméticos da página são aceitos via override registrado em `## Page-level overrides`. **Em conflito visual, Figma da página vence**.
 
+### 1.5 Drift map antecipado
+
+Executa ANTES de Fase 3 emitir tasks. Materializa divergências Figma↔Storybook por componente para que cada uma vire override (a/b/c) ou task explícita logo no plano, evitando o padrão PLAN-005 (39 deltas descobertos durante execução).
+
+Para cada componente em "Componentes mapeados":
+
+a) **Screenshot do Figma**: via Figma MCP `get_image` pelo node-id do componente OU export do frame. Salva em `<dirs.planos>/<PLAN-NNN-slug>/drift/<Componente>.figma.png`. Reusa imagem existente entre re-runs (cache).
+b) **Screenshot da story canônica**: usa Storybook estático (`<dirs.storybook>/storybook-static`) ou local rodando. Salva em `<dirs.planos>/<PLAN-NNN-slug>/drift/<Componente>.story.png`. Se nem estático nem local: pula esse componente com warning.
+c) **Diff curto**: cria `<dirs.planos>/<PLAN-NNN-slug>/drift/<Componente>.diff.md` com 3 colunas (Anatomia diff, Token diff, Estados ausentes). Inspeção visual + grep no CSS extraído via Figma MCP. Sem pixel-diff.
+d) **Drift map cumulativo**: `<dirs.planos>/<PLAN-NNN-slug>/drift-map.md` lista canônica de TODAS divergências detectadas. Cada linha alimenta `## Page-level overrides` (decisão a/b/c) OU vira task na Fase 3 com `override_target:` ou `interaction_target:` apontando.
+
+Bloqueio:
+- Figma MCP indisponível E Storybook indisponível → `drift-map.md` = `"drift detection skipped: missing tooling (Figma MCP + Storybook)"`. Warning único, NÃO bloqueia.
+- Figma MCP disponível mas Storybook ausente → roda apenas captura Figma; diff fica vazio mas registra `figma_url` por componente para usar em execute-plan.
+- Ambos disponíveis → drift map é input obrigatório da Fase 3 (cada divergência DEVE ter encaminhamento override OU task).
+
+### 1.6 Cleanup de starter legado
+
+Detecção: ler `.gos-local/plan-paths.json` campo opcional `legacy_starter_dirs: []` (ex.: `["src/figma-make/", "tmp/stitch-export/"]`). Vazio OU ausente → pula esta sub-fase. Preenchido:
+
+a) Para cada componente em "Componentes mapeados", `grep` o nome do componente nos `legacy_starter_dirs`. Match → registrar em `<dirs.planos>/<PLAN-NNN-slug>/legacy-cleanup.md` com path do arquivo legado encontrado.
+b) Para a tela alvo (`<dirs.app>/<rota-da-tela>`), `grep` por imports oriundos de `legacy_starter_dirs`. Match → registrar arquivo + linha em `legacy-cleanup.md`.
+c) **Fase 3 emite tasks `T-NN-cleanup-legacy-<slug>`** (uma por arquivo legado) com `cleanup_target: <path>` no frontmatter. Ordem: cleanup roda DEPOIS da implementação real do componente DS (depende do `interaction_target` correspondente estar `concluido`), ANTES de fechar o plano.
+d) Sem o campo `legacy_starter_dirs`: comportamento atual preservado 100%. Projetos sem starter legado não pagam custo desta sub-fase.
+
+Por que: declara "código Make/Stitch não fica" como contrato do pipeline, não como lembrança humana task-a-task.
+
 ## Fase 2 — Aderência à Stack
 
 **Modo padrão (sem `--allow-arch-change`)**: SOMENTE referenciar a stack já registrada em `stack.md`. Para cada dado/ação da tela, listar:
@@ -140,6 +167,17 @@ Saída desta fase é uma seção **"Aderência à Stack"** no plano — não red
 
 **Modo `--allow-arch-change`**: pode propor alteração. Gerar ADR em `dirs.adr` (template `templates/adr-tmpl.yaml`) ANTES de prosseguir. Plano referencia o ADR e marca `arch_change: true` no frontmatter.
 
+### 2.4 Schema/contrato gate (executa antes de Fase 3)
+
+Quando a tela exibe ou consome dados, validar contrato backend ANTES de emitir tasks frontend dependentes — evita o padrão PLAN-012/013 (schema descoberto incompleto durante execução).
+
+a) Para cada campo exibido na tela (extraído de "Componentes mapeados" + "Interações & Estados"):
+   - **Postman**: `grep` do endpoint esperado em `<dirs.postman>`. Endpoint ausente → entrada em `## Backend pendings` tipo `endpoint-missing`, gap-key formato `endpoint-<rota>-missing`.
+   - **Prisma/SQL**: ler arquivos declarados em `plan-paths.json` campo `backend_schema_files: []` (ex.: `["packages/api/prisma/schema.prisma"]`). Campo ausente → entrada `field-missing: <table>.<field>`, gap-key formato `field-<table>-<field>-missing`.
+b) Cada entrada gerada cria task ClickUp via `mcp__clickup__clickup_create_task` (assignee `112010775` ou override `ASSIGNEE`, list `clickup.backend_list_id`) ANTES da Fase 3 emitir tasks frontend dependentes. ClickUp ID grava em `## Backend pendings`.
+c) Tasks frontend que dependem do campo recebem frontmatter `depends_on_backend: [<gap-key>]` automaticamente — `*execute-plan` já trata como `bloqueada-backend`.
+d) Nenhum dos arquivos declarados existe (sem Postman E sem `backend_schema_files`) → warning único, NÃO bloqueia. Plano segue sem schema gate.
+
 ### 2.5 Backend gaps → ClickUp automático
 
 Postman é o **contrato backend**. Para cada dado/ação da tela:

package/.gos/skills/registry.json

@@ -24,6 +24,7 @@
     { "slug": "plan-blueprint", "path": "skills/plan-blueprint/SKILL.md" },
     { "slug": "progress-tracker", "path": "skills/progress-tracker/SKILL.md" },
     { "slug": "execute-plan", "path": "skills/execute-plan/SKILL.md" },
-    { "slug": "validate-plan", "path": "skills/validate-plan/SKILL.md" }
+    { "slug": "validate-plan", "path": "skills/validate-plan/SKILL.md" },
+    { "slug": "audit-screenshots", "path": "skills/audit-screenshots/SKILL.md" }
   ]
 }

package/.gos/skills/validate-plan/SKILL.md

@@ -75,6 +75,8 @@ Apos o loop:
 
 1. **Cobertura de comportamento**: ler `## Interações & Estados` em `plan.md`. Para cada bullet (slug): existe AO MENOS 1 task com `interaction_target:` apontando pra ele E status `concluido`? Bullet sem cobertura -> plano permanece em `validacao` (registrar em `T-NNN-NN.notes.md` da task mais proxima do dominio).
 2. **Cobertura de overrides**: ler `## Page-level overrides`. Cada linha com decisao (a/b/c) tem task `concluido` cobrindo? grep do `override_target:` correspondente nos frontmatter de tasks. Override sem cobertura -> plano permanece em `validacao`.
+2.1. **Cobertura de drift map**: ler `## Drift map` (e `<plano>/drift-map.md` se existir). Cada linha tem override implementado OU task `concluido` cobrindo? Linha sem encaminhamento -> plano permanece em `validacao` (registrar em `T-NNN-NN.notes.md` da task mais proxima).
+2.2. **Cleanup legado**: para cada task com frontmatter `cleanup_target: <path>`, confirmar que o arquivo foi removido. Comando: `git log --diff-filter=D --name-only --since=<plan.created_at> -- <path>` deve retornar match OU `git diff --staged --name-only --diff-filter=D` contem `<path>`. Falha -> task volta a `validacao` (nao auto-conclui).
 3. **Checklist do plano**: ler `## Checklist de aceite` em `plan.md`. Itens nao marcados -> plano permanece em `validacao` mesmo se todas as tasks fecharam.
 4. **Backend pendings**: ler `## Backend pendings`. Para cada linha com `ClickUp ID`:
    - Consultar `mcp__clickup__clickup_get_task <ID>`.

package/.gos/templates/planTemplate.md

@@ -57,6 +57,24 @@ Decisões possíveis:
 - **(b) Nova variant na story** — override aparece em ≥3 telas do projeto; vira variant reusável (ex.: `flat`, `seamless`).
 - **(c) Exceção documentada** — override específico desta tela e não merece variant; documentado aqui sem propagar pra story.
 
+## Drift map
+
+> Gerado em Fase 1.5 do `plan-blueprint`. Side-by-side Figma vs Storybook por componente. Cada linha JÁ reconciliada para override (a/b/c) OU task explícita. Vazio = drift detection rodou sem divergências OU foi pulado por falta de tooling (Figma MCP + Storybook).
+
+| Componente | Divergência | Resolução | Referência |
+|------------|-------------|-----------|------------|
+|            |             |           |            |
+
+> Path dos artefatos: `drift/<Componente>.figma.png`, `drift/<Componente>.story.png`, `drift/<Componente>.diff.md`. Cumulativo em `drift-map.md`.
+
+## Cleanup de starter legado
+
+> Gerado em Fase 1.6. Listado quando `.gos-local/plan-paths.json` declara `legacy_starter_dirs`. Cada linha vira task `T-NN-cleanup-legacy-<slug>` com `cleanup_target: <path>` no frontmatter. Vazio = projeto sem starter legado declarado OU nenhum match encontrado.
+
+| Path legado | Substituto DS | Task |
+|-------------|---------------|------|
+|             |               |      |
+
 ## Componentes ausentes
 
 > Listar componentes não cobertos pelo DS. Cada um vira task de criação separada (priorizar reuso/extensão antes de propor novo).
@@ -111,6 +129,9 @@ Decisões possíveis:
 - [ ] **States**: skeleton/empty/error/loading implementados conforme matriz acima
 - [ ] **Refetch**: dispara após mutações (POST/PATCH/DELETE)
 - [ ] **Seed**: popula TODOS os campos exibidos no Figma (sem `-` em colunas mapeadas)
+- [ ] **Drift map**: cada linha de `## Drift map` (Fase 1.5) tem override implementado OU task `concluido` cobrindo
+- [ ] **Cleanup legado**: tasks com `cleanup_target:` removeram os arquivos declarados (nenhum import de `legacy_starter_dirs` sobrevive na tela)
+- [ ] **Schema/contrato gate**: nenhum campo da tela referencia coluna/endpoint inexistente sem entrada correspondente em `## Backend pendings`
 - [ ] <critério específico da tela 1>
 - [ ] <critério específico da tela 2>
 

package/.gos/templates/taskTemplate.md

@@ -12,6 +12,7 @@ valida_em: <referência ao critério no checklist do plano>
 depends_on_backend: []   # opcional — gap-keys da tabela ## Backend pendings do plano pai
 interaction_target: []   # opcional — bullets de "## Interações & Estados" do plano pai que esta task implementa/preserva (ex.: ["row-click-drawer-view", "submit-create"])
 override_target: []      # opcional — linhas de "## Page-level overrides" do plano pai que esta task resolve (ex.: ["StatCard:flat-variant"])
+cleanup_target: null     # opcional — path absoluto/relativo de arquivo legado que esta task remove (ex.: "src/figma-make/ProjetosPage.tsx"). validate-plan exige deleção observável no diff.
 assignees: []
 links: []
 ---
@@ -36,6 +37,7 @@ links: []
 - [ ] **Visual gate aprovado** (relatório em `T-NNN-NN.notes.md` com 5 seções: anatomia, tokens, variants, densidade, comportamentos)
 - [ ] **Comportamentos**: cada `interaction_target` declarado tem handler/estado implementado e observável no diff
 - [ ] **Overrides**: cada `override_target` declarado foi aplicado conforme decisão (a/b/c) registrada em `## Page-level overrides`
+- [ ] **Cleanup**: quando `cleanup_target:` declarado, arquivo foi removido (`git diff --staged` mostra deleção)
 - [ ] Tests/CI verdes
 - [ ] Sem regressões
 - [ ] <métrica específica>

package/CLAUDE.md

@@ -48,7 +48,7 @@ Todo texto gerado deve passar por correcao ortografica e remocao de padroes de I
 gos-master | architect | dev | devops | po | qa | sm | squad-creator | ux-design-expert
 
 ### Skills (invoke via /gos:skills:{slug})
-design-to-code | figma-implement-design | figma-make-analyzer | make-code-triage | make-version-diff | component-dedup | frontend-dev | interface-design | react-best-practices | react-doctor | sprint-planner | clickup | plan-to-tasks | agent-teams | git-ssh-setup | stack-profiler | plan-blueprint | progress-tracker | execute-plan | validate-plan
+design-to-code | figma-implement-design | figma-make-analyzer | make-code-triage | make-version-diff | component-dedup | frontend-dev | interface-design | react-best-practices | react-doctor | sprint-planner | clickup | plan-to-tasks | agent-teams | git-ssh-setup | humanizer | weekly-update | slack-review | stack-profiler | plan-blueprint | progress-tracker | execute-plan | validate-plan | audit-screenshots
 
 ### IDEs suportadas (npm run sync:ides gera adapters)
 Claude Code | Cursor | Gemini CLI | Qwen Code | Antigravity | Opencode | Kilo Code | **Codex IDE Extension** (ambiente de execucao, comando primario `*execute-plan`)
@@ -69,6 +69,14 @@ State machine: `pendente -> em-andamento -> validacao -> concluido`. Estado late
 
 **Politica Figma vs Storybook**: story define API/anatomia do componente; em conflito visual cosmetico (bg, border, padding, radius), Figma da pagina vence — divergencia e registrada em `## Page-level overrides` do plano com decisao a/b/c (a=className, b=variant nova, c=excecao documentada). Sem essa disciplina, refinamentos da pagina viram retrabalho no fim (caso PLAN-005: 54 deltas em 26 rodadas).
 
+**Drift map automatico (Fase 1.5 do `*plan`)**: com Figma MCP + Storybook disponiveis, `*plan` gera `<plano>/drift-map.md` antes de emitir tasks — screenshots side-by-side por componente; cada divergencia vira override ou task explicita. Sem essa etapa, ~70% das divergencias viraram retrabalho durante execucao.
+
+**Cleanup de starter legado (Fase 1.6)**: `.gos-local/plan-paths.json` campo `legacy_starter_dirs: ["src/figma-make/", ...]` faz `*plan` emitir tasks `T-NN-cleanup-legacy-<slug>` automaticamente para arquivos do starter. Sem o campo, comportamento atual preservado.
+
+**Schema/contrato gate (Fase 2.4)**: `.gos-local/plan-paths.json` campo `backend_schema_files: [...]` (Postman + Prisma) faz `*plan` validar contrato antes de emitir tasks frontend; gaps viram task ClickUp + entrada em `## Backend pendings`.
+
+**Skill `*audit-screenshots`**: conversacional. Recebe N prints anotados em uma sessao, resolve cada print -> tela -> Figma frame via `docs/figma-screen-map.md`, compara, e ao fechar emite UM plano de correcao com tasks pendentes (sem executar). Acoplado ao mesmo template — output e input valido para `*execute-plan`/`*validate-plan`.
+
 Paths do projeto-cliente sao resolvidos via `.gos-local/plan-paths.json` — nada hardcoded. Nesse arquivo declara-se onde estao `docs/plans/`, `docs/postman/`, `docs/regras-de-negocio/`, design system, etc. Cada projeto/dev pode organizar diferente.
 
 Playbook completo: `.gos/playbooks/plan-creation-playbook.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ganbatte-os",
-  "version": "0.2.36",
+  "version": "0.2.37",
   "description": "Framework operacional para design-to-code, squads de entrega e sprint sync com ClickUp.",
   "bin": {
     "gos": ".gos/scripts/cli/gos-cli.js"