dev-team-kit-fv

v2.71.1: hooks do Codex funcionando no Windows + kit instalavel como plugin no Codex. Os hooks da v2.70.0 falhavam em todo evento no Codex (`hook: SessionStart Failed`, `hook: UserPromptSubmit Failed`) mas passavam rodados a mao. Reproduzido com `codex exec` e stderr do hook redirecionado pra arquivo; causa confirmada no fonte do Codex (`codex-rs/hooks/src/engine/command_runner.rs`): `commandWindows` roda pelo SHELL CONFIGURADO do usuario (PowerShell), nao pelo cmd -- o `cmd.exe /d /q /c for /f %G in ('git rev-parse --show-toplevel') do node %G/...` era parseado como PowerShell e morria com `"git rev-parse --show-toplevel" was unexpected at this time`. Agora `commandWindows` e so `node hooks/scripts/runtime-dispatcher.mjs <Evento>`, valido em PowerShell e cmd; `command` POSIX mantido; validado 5/5 eventos Completed no Codex real. Segundo fix: o Codex ignora `{"source":"github"}` do marketplace no formato Claude (`WARN skipping marketplace plugin with unsupported source`); novo `.agents/plugins/marketplace.json` (primeiro path que o Codex procura) com `source: "./"`, minimo pra nao duplicar versao -- `codex plugin list -m claude-skills-fv` passa a listar `dev-team-kit-fv@claude-skills-fv`. Guia do Codex documenta shell/cwd/env/timeout/schema/trust-por-hash, a armadilha do BOM do PowerShell 5.1, a receita de diagnostico com `--dangerously-bypass-hook-trust`, e o gap de o instalador ainda nao registrar hooks do Codex em repos consumidores. Editar hooks.json invalida o hash de confianca: re-confiar no TUI na proxima sessao. v2.71.0: skills 70 (campaign-research-strategy), 71 (campaign-copywriting) e 72 (campaign-visual-direction) novas -- pipeline de campanha orientado por evidencia (research -> copy -> visual direction), com artefatos JSON tipados entre as etapas (ResearchStrategyArtifact -> CopyDeckArtifact -> CreativeDirectionArtifact), catalogo product-marketing com rotas dedicadas e when_none na rota direct-response pra nao colidir com a skill 50. v2.70.0: hooks portaveis entre Claude Code e Codex -- dispatcher compartilhado `hooks/scripts/runtime-dispatcher.mjs` normaliza eventos/nomes de tool dos dois runtimes e roda os mesmos sensores; cobertura Codex de SessionStart/UserPromptSubmit/PreToolUse/PostToolUse/Stop com fail-open por sensor e diagnostico em `.auto/hook-errors.jsonl`. v2.69.0: skills 68 (character-animation-3d) e 69 (character-pipeline-2d) novas, cobrindo pipeline completo de personagem 3D/2D. Fonte: 2 whitepapers tecnicos originais do usuario (nao material de terceiro sujeito a licenca de conteudo, mas ambos citam ferramentas de terceiro com licencas variadas, preservadas em tabela completa sem esconder as restritivas -- SAM License propria, Spine comercial, TexturePacker comercial, Hunyuan3D Tencent). Skill 68 cobre AccuRIG (tratado como fronteira de certificacao do rig, nao API headless que nao existe) -> Blender CLI headless (bpy, `--background --python`) -> retargeting via delta de quaternion relativo a rest pose -> IA de motion (mapa comparativo de 10 tecnologias: text-to-motion/video-to-motion/pose-estimation/retargeting-tool, com a distincao critica AccuRIG AI Deep Search -- busca semantica em 4500+ motions -- vs modelo de sintese real) -> export GLB/FBX/Alembic, com todos os scripts bpy de referencia preservados na integra (import, semantic bone mapping via BONE_ALIASES, retarget_frame, bake de constraints). Skill 69 assume o pipeline 3D ja pronto via skill 68 e cobre `MotionPlan.json` como contrato (LLM = diretor de intencao/timing/fases/eventos, NUNCA gerador de rotacao de bone -- um MotionResolver deterministico resolve os transforms, reduzindo erro e superficie de prompt injection), as 5 estrategias de producao 2D, geracao 2D nativa via Qwen-Image-Layered/Qwen-Image-Edit com tratamento de occlusion completion, Wan-Animate como motion reference/previs (nunca fonte final de frame -- anti-padrao explicito documentado), ComfyUI como servidor de inferencia headless, ferramentas de rig 2D esqueletal (Blender+Grease Pencil vs Spine CLI vs LoongBones), o CLI unificado `assetctl`, e arquitetura de testes/CI em 5 grupos com build graph content-addressed. Skill 69 ficou pela metade numa rodada anterior (agente bateu limite de sessao da API apos entregar o SKILL.md completo mas antes dos 3 arquivos de references/) -- retomado com um agente novo que leu o SKILL.md ja pronto como especificacao e completou so o que faltava, sem redundancia. Cross-links pequenos adicionados nas skills 66/67 (game-dev) apontando pra 68/69 quando o pedido for pipeline de asset de personagem, nao so arquitetura/codigo de engine. v2.68.0: skill 40 (parallel-dispatcher) ganha mecanismo de arbitragem em caso de discordancia entre agentes -- gap identificado ao investigar o topic 'agent-workflows' do skills.sh: o kit ja faz fan-out paralelo de N reviewers (skill 40, /swarm com 4-agent review), mas nao tinha uma etapa formal pra quando eles discordam sobre o mesmo achado -- hoje agregava/reportava sem resolver a divergencia. Mecanismo escrito 100% do zero (arbitragem por discordancia + gate fail-closed e uma ideia geral de design de sistemas multi-agente, sem atribuicao a nenhuma fonte especifica, porque a fonte que inspirou a investigacao nao tinha licenca declarada e nenhum texto/codigo dela foi usado): um terceiro agente arbitra sem saber qual reviewer disse o que primeiro (evita vies de ancoragem), e a etapa seguinte do pipeline fica bloqueada (fail-closed) ate resolucao -- nunca prossegue silenciosamente com o achado mais otimista. `references/arbitration-disagreement.md` traz o detalhamento completo e um exemplo (achado de seguranca IDOR marcado CRITICAL por um agente e nao-bloqueante por outro). `policies/quality-gates.md` formaliza o gate como padrao reusavel por qualquer skill/comando; `policies/swarm-protocol.md` marca achados divergentes como pending_arbitration na Phase 4 (Synthesize), fora do self-fix ate resolvidos. Investigacao da mesma leva tambem confirmou React Native/Expo (callstackincubator/agent-skills, MIT) como gap real de framework mobile (Tauri = WebView, React Native = bridge nativo, arquiteturas incompativeis) -- registrado como candidato, construcao adiada a pedido do usuario. v2.67.0: varredura ampla do skills.sh por 4 categorias (backend/API/database, testing/security, frontend/React, docs/devops/writing) em paralelo, apos o usuario perguntar se faltava mais alguma skill relevante. Resultado desigual por design: backend achou 2 gaps reais e cirurgicos, absorvidos na skill 03 (backend-api) -- idempotencia (chave derivada da intencao, claim atomico via unique constraint, guard de payload divergente, 3 estrategias de resposta a duplicata em voo, de addyosmani/agent-skills MIT) e recursos avancados de Postgres (Row-Level Security via CREATE POLICY, EXCLUDE USING gist pra prevenir overlap de intervalo, de wshobson/agents MIT). Testing/security nao trouxe nada de novo (kit ja robusto ali) alem de um playbook de Playwright patterns (Page Object Model vs fixtures, debug de teste flaky, sharding paralelo, mock de OAuth/SSO, de currents-dev/playwright-best-practices-skill MIT) absorvido como references/ na skill 05. Frontend/React so achou a View Transition API nativa (vercel-labs/agent-skills MIT) como candidata pontual, absorvida como references/ na skill 12 com acrescimo minimo pro SKILL.md (ja acima do teto de 25KB, mantido no mesmo patamar). Docs/devops/writing bateu num bloqueio real do proprio site: a busca por termo (?q=) exige token OIDC que a sessao nao tem, e nao existe rota de categoria pra devops/documentation/writing -- o agente recusou forcar resultado sem filtro real em vez de inventar candidatas. Nenhuma skill nova criada nesta versao (diferente da v2.66.0) -- so enriquecimento cirurgico de 3 skills existentes (03, 05, 12), confirmando que a rodada anterior ja tinha capturado a maior parte do que valia a pena no registro. v2.66.0: fechamento das 2 investigacoes que a v2.65.0 tinha deixado pendentes. Skills 66 (game-architecture-design) e 67 (game-engine-development) nascem novas cobrindo desenvolvimento de jogos, dominio 100% inexistente no kit ate aqui — duas fontes com perfis de licenca opostos exigiram dois tratamentos diferentes: Yuki001/game-dev-skills (design/arquitetura/balance, denso mas SEM licenca declarada) so serviu de referencia estrutural pra identificar o gap, todo o texto da skill 66 foi escrito do zero, sem copiar frase nenhuma da fonte; Jeffallan/claude-skills (MIT, 11k stars, unica skill de engine real do repo, cobrindo Unity C# e Unreal C++ com codigo de producao) foi portado quase verbatim pra skill 67, com atribuicao explicita e traducao/expansao da prosa em PT-BR. A skill 67 avisa explicitamente que Godot NAO tem cobertura profunda em nenhuma fonte avaliada, em vez de fingir paridade entre os 3 motores. Skill 12 (motion-design) ganha `references/decision-gate-and-review.md` combinando as 3 fontes reais de emilkowalski/skills (MIT) achadas na busca 'animation' do skills.sh: gate de 4 perguntas + varredura por 6 categorias de seam (find-animation-opportunities), glossario reverso de ~30 termos de vocabulario de motion (animation-vocabulary), e checklist de review com hierarquia de remediacao em cascata deletar->reduzir->easing->origem->interrompibilidade->GPU->timing assimetrico->polish->acessibilidade, incluindo o teto de 300ms e o anti-padrao scale(0) (review-animations). SKILL.md da skill 12 passou de 26KB pra 27KB (ja estava acima do teto nominal de 25KB antes desta mudanca, mantido no mesmo patamar em vez de inflar mais). v2.65.0: leva completa de curadoria de fontes externas com 6 agentes em paralelo apos investigacao de 13 fontes do skills.sh (registro oficial da Vercel) + 2 links trazidos direto pelo usuario. Skill 64 (scroll-storytelling) nasce nova a partir de nateherkai/scroll-craft (MIT) — protocolo de entrevista de 8 perguntas antes de gerar qualquer coisa, 4 regras centrais de variedade (nunca repetir device duas vezes seguidas, mundo fotografico como default banindo o 'clay diorama' generico, sem camera continua a menos que o brief peca literalmente, estrutura de pagina como eixo separado de estilo), 8 gramaticas de pagina, kit de 10 devices de scroll, motor vanilla JS/CSS zero-dependencia copiado, cross-linkada com skill 12 (motion generico) e skill 02 (decisao estetica) sem duplicar nenhuma das duas. Skill 65 (using-git-worktrees) eleva o dispatcher enxuto `commands/worktree.md` a protocolo completo via obra/superpowers (MIT) — deteccao de isolamento existente com guard de submodule (evita aninhar worktree dentro de worktree), preferencia por ferramenta nativa (`EnterWorktree`/`ExitWorktree` do proprio harness, descoberto durante a investigacao como exatamente o caso que o protocolo original manda preferir) antes de `git worktree add` cru, e baseline de testes obrigatoria antes de liberar a task ('a dirty baseline makes every later failure ambiguous'). Skill 02 ganha mecanismo de dupla avaliacao cega (duas sub-avaliacoes isoladas, uma de design e outra de evidencia deterministica, que nao veem o output uma da outra) + veredito de especificidade de design, portado de pbakaus/impeccable — **licenca Apache-2.0, nao MIT** (diferente do padrao das outras fontes recentes, sinalizado explicitamente na entrada de Fontes). Skill 12 ganha um laboratorio de 16 microinteracoes GSAP (modal, drawer, dropdown, accordion, tabs, chat com optimistic UI, busca com skeleton, toast, transicao de rota, CRUD sem teleporte de layout, botao async, shake de validacao, like com particulas, progresso) — material do PROPRIO USUARIO do kit, sem risco de licenca (diferente da entrada naocodei.com da v2.64.0), copiado como HTML navegavel em `references/ui-motion-lab-gsap.html` em vez de code-dump no SKILL.md. Duas investigacoes concluidas sem absorcao ainda: game-dev-skills (Yuki001/game-dev-skills e raso em codigo de engine e sem licenca; o artigo da Snyk revelou Jeffallan/claude-skills, MIT, 11k stars, que cobre Unity/Unreal/Godot de verdade — dominio game-dev fica como candidato a multiplas skills especificas, nao uma generica, aguardando decisao do usuario) e busca 'animation' no skills.sh (3 candidatas reais de emilkowalski/skills — gate de decisao de 4 perguntas, glossario de vocabulario de motion, checklist de review com hierarquia de remediacao — mas skill 12 ja esta no teto de 25KB, entrada exigiria novo arquivo em references/, decisao tambem pendente). v2.64.0: skill 12 (motion-design) ganha 5 efeitos JS puro sem framework (stack cards, rolagem com inercia, particulas em canvas, scramble de texto, shader WebGL) extraidos verbatim de naocodei.com/free-code -- gap real, a skill so tinha Framer Motion e GSAP, que pressupoem dependencia instalada. **Fonte sem licenca declarada** (autoria nao identificada no site) -- usuario avisado explicitamente do risco de proveniencia via AskUserQuestion e confirmou 'copia mesmo assim, aceitando o risco' -- decisao dele, registrada como tal, com aviso completo no topo da secao e na entrada de Fontes Externas, nao escondido nem disfarcado de licenca aberta. Codigo extraido direto do runtime do site (via `window.CODIGOS` injetado por JS, nao resumo reescrito) pra garantir fidelidade ao original. Efeito colateral: a adicao levou a skill 12 a 36KB, zerando a nota de tamanho no gate de qualidade (mesma classe de problema que a skill 02 teve nesta mesma sessao) -- resolvido MOVENDO o codigo denso pra `references/naocodei-vanilla-effects.md` (nao com allowlist de excecao como na skill 02, porque a 12 nao e um hub por natureza, so tinha acumulado codigo bruto demais no arquivo principal), deixando um resumo de 3 linhas + link no SKILL.md. Tamanho final 24.9KB, dentro do teto. v2.63.0: correcao pos-commit da secao Beautiful UI na skill 25 (v2.62.0) — o usuario ja tinha passado a URL certa (beautifui.dev) na sessao anterior, mas as falhas de DNS que documentei como 'site instavel' eram na verdade erro meu de digitacao (tentei www.beautifuil.dev e variantes proprias em vez de copiar o valor exato). Usuario apontou o erro direto. Confirmado ao vivo com a URL correta: 20 componentes em 6 categorias (Loading & States, Text & Input, Cards & Feedback, Data Display, Navigation & Organization, Code & Advanced), licenca MIT no rodape, sem link de repo/pacote/CLI publicado no site. Secao da skill 25 reescrita com o conteudo real confirmado, ressalva de 'nao re-verificado' removida e substituida por nota factual sobre o proprio erro de digitacao (nao generalizar como se o site tivesse instabilidade real). v2.62.0: cinco fontes externas curadas em cinco skills numeradas diferentes, todas via subagents em paralelo apos investigacao dedicada. Extend UI (github.com/extend-hq/ui, MIT) e brownies (github.com/franciscop/brownies, MIT) entraram na skill 04 em secoes isoladas (viewer de documento PDF/DOCX/XLSX vs. storage client-side reativo com subscribe) sem colisao de edicao entre os 2 agentes que trabalharam no mesmo arquivo em paralelo. diagram-design (github.com/cathrynlavery/diagram-design, MIT, 25k stars) entrou na skill 10 como catalogo curado de tipos de diagrama pra docs/ADR, com o principio de verificacao geometrica deles reescrito como checklist manual (sem prometer script que nao foi portado) — referencia cruzada na skill 38. morphicons (github.com/guillermolg00/morphicons, MIT) entrou na skill 12 pra morph de icone-pra-icone (play/pause, hamburguer/X), com ressalva de reduced-motion porque o default da lib ignora prefers-reduced-motion por design, divergindo da regra dura ja existente na skill 12. Astryx (github.com/facebook/astryx, MIT, design system oficial do Meta, 12k stars) entrou na skill 02 como opcao de biblioteca de componente pronto — deliberadamente NAO integrado ao motor BM25 recem-portado em v2.61.0, camadas diferentes (decisao de estilo vs. componente pronto ja decidido). Beautiful UI (beautifui.dev) entrou na skill 25 com ressalva honesta: o site ficou instavel durante a sessao (DNS ENOTFOUND em varias tentativas, tanto minhas quanto do agente), entao a secao cita apenas o que foi confirmado por reconhecimento previo, marcado explicitamente como nao re-verificado ao vivo. Efeito colateral pego durante a validacao: skill 02 ja estava em 43KB ANTES desta sessao (divida tecnica de absorcoes anteriores, nao regressao nova), o que zerava a nota de tamanho no gate de qualidade (`scripts/skill-quality-score.mjs`, teto de 25KB) e derrubava o score total abaixo do minimo bloqueante de 20/30. Em vez de fatiar as 5 references/ que ja existem ainda mais as pressas, o script ganhou uma allowlist fixa e documentada de skills 'hub' (que acumulam catalogo/referencia por natureza) isentas do teto de tamanho — 02-ui-ux-design e a unica hoje; revisar manualmente se surgir outra candidata, nao inferir por tamanho sozinho. v2.61.0: skill 02 (UI/UX) ganha motor de busca BM25 + 15 catalogos de decisao de design portados de nextlevelbuilder/ui-ux-pro-max-skill (MIT) — o kit ja tinha absorvido uma parte pequena desse repo em jul/2026 (so anti-padroes por industria), mas o projeto cresceu muito desde entao (84 estilos, 192 paletas, 74 pares de tipografia, 119 guidelines de UX/a11y com codigo, 25 tipos de grafico, 21 stacks). `scripts/design_search_core.py` e o motor BM25 original quase inalterado (stdlib puro, ja testado, calibrado por dominio); `scripts/design_search.py` e um wrapper CLI mais enxuto que o original — nao porta o gerador de design system completo deles (`--design-system`/`--persist`/dials de intensidade), porque essa decisao ja e papel da skill 02 em prosa guiada por contexto do projeto real, duplicar seria ter 2 formas de decidir a mesma coisa. Testado com queries reais em todos os dominios (style, chart, ux, typography, stack) antes de commitar — resultado rico e calibrado, caso 'sem match' tratado com aviso anti-fabricacao (nao confundir ausencia de match no indice local com ausencia de dado real). 2.12MB de dados reais (fontes Google + icones Phosphor com licenca aberta redistribuidos, nao gerados). v2.60.0: checklist de estilo pra output publicado (landing/app/blog) fundida em `policies/anti-ai-writing.md` — usuario trouxe uma instrucao SHOULD/AVOID + lista nomeada de ~50 palavras banidas usada em outro workflow de escrita, pediu pra virar 'skill humanizer' pro kit. Decisao: fundir na policy anti-ai-writing existente (nao criar skill nova) porque ja havia sobreposicao real com os 29 padroes catalogados; so o que era genuinamente novo entrou — banimento total de em dash/ponto-e-virgula/markdown/asteriscos/hashtags em contexto plain-text (landing/app/blog, nao docs tecnicos onde markdown e esperado), lista nomeada de palavras a evitar como checklist de grep literal, regras explicitas de variacao estrutural (paragrafos/frases do mesmo tamanho, listas com bullets identicos, multiplos paragrafos com a mesma abertura gramatical), e transicoes conversacionais falsas ('here's the thing', 'let that sink in') alem do signposting ja catalogado. `/humanize` ganhou flag `--plain` pro modo output publicado. `hooks/scripts/ai-writing-detector.mjs` ganhou 2 padroes novos (transicao falsa, vocabulario de marketing banido) testados contra falso positivo em texto tecnico limpo — as palavras mais genericas da lista (can/may/just/that) ficaram de fora do regex de proposito, alto volume de falso positivo, vira checklist manual em vez de deteccao automatica. Skills 13 (marketing-copy) e 41 (blog-publisher) tiveram o gate atualizado pra citar a nova secao explicitamente; blog-publisher documenta a excecao deliberada de hashtag no bloco LinkedIn (convencao de plataforma, nao AI-tell). v2.59.0: 2 gaps do Ahrefs aplicados a skill 14 (SEO) e taxonomia de citacao em IA aplicada a skill 61 (content-growth-engine) — usuario trouxe 3 artigos (Ahrefs, Backlinko, Sabrina) perguntando se davam pra melhorar as skills; medido gap real por grep antes de aplicar qualquer coisa. Backlinko: protocolo de baseline de citacao em IA da skill 61 ganhou taxonomia de 4 tipos de prompt (avaliacao/reputacao/comparacao/lacuna, evitando que o conjunto vire so um tipo por ser mais facil de escrever), 2-3 execucoes por prompt por sessao (resposta de LLM varia entre rodadas — uma unica rodada mede ruido), conceito de 'ghost ranking' (marca citada como fonte mas concorrente recomendado — pior que nao aparecer, porque parece metrica boa na planilha) e cadencia 'medir semanalmente, agir mensalmente com 4 semanas de tendencia' substituindo o 'mensal' simples que reagia a ruido de uma unica leitura. Ahrefs: skill 14 ganhou FAQ pos-artigo com perguntas reais do leitor (32% de lift de trafego documentado em experimento controlado de 21 posts, marcado com FAQPage schema) e fan-out query mapper (decompor a keyword principal em sub-perguntas e comparar contra o conteudo publicado pra achar buraco de cobertura, antes de fechar a tabela de keywords). Terceiro artigo (Sabrina, still-antes-de-animar pra video) foi implementado por engano fora da selecao do usuario e revertido a pedido dele antes do commit — nao entrou nesta versao. v2.58.0: fix estrutural de fronteira de palavra (`\\b...\\b`) no matcher de roteamento de plugins (`scripts/lib/plugin-catalog.mjs` + `mcp-server/src/lib/plugin-router.ts`) — 5a ocorrencia de trigger curto colidindo por substring (`ui` em equipe, `ux` em fluxo), desta vez corrigido na classe toda em vez de whack-a-mole por `when_none`. v2.49.0: qualidade de design vira VERIFICACAO, nao so descricao — o kit descrevia qualidade sem provar (zero eval para as cinco skills que produzem pixel; rule proibindo indigo em prosa; pre-build-gate sempre saindo com exit 0). Dois checkers novos: check-design-generic (indigo default, system-ui, gradiente AI, preto puro, 100vh sem dvh, repeticao cega de rounded/shadow) e check-contrast (ratio WCAG calculado nos DOIS temas, com pareamento semantico pra nao gerar falso positivo). Hook design-anchor-guard BLOQUEIA escrita de arquivo visual com sinal de default estatistico, com escape hatch 'design-anchor: allow'. cinco evals com secao 'Reprova Se'. bench/ab/score-design.mjs pontua 0-100 cada braco pra 'a regra funcionou?' ter numero. O checker achou #6366f1 no template de blog do proprio kit — corrigido. 61 specialist skills + 43 slash commands for coding agents — orchestrator, backend, frontend, QA, security, deploy, detective-spec, static-analysis, skill-author, program-router, parallel-dispatcher, blog-publisher, blog-screenshot, canary-deployment, zoom-out, handoff-context, post-deploy-canary-monitor, pattern-conformity, research-prep, context-budget, direct-response-copy, ux-research, ui-polish, doubt-driven-review, video-analysis, marketing-reporting-analytics + spec-driven development, anti-AI writing, memory consolidation, executable YAML pipelines + insights dashboard (v2.18.0, 6 tabs). v2.48.0: skill 60 app-reference-architecture — molde de arquitetura reverso-projetado de 3 apps reais do autor em producao (Next.js + Tauri v2, web + APK Android dual) pra um app novo nascer em estrutura ja testada em vez de rederivar auth, pagamento, push e build Tauri do zero a cada projeto. Cobre auth dual (cookie de sessao pra web, Bearer JWT ou token Supabase pro app Tauri, resolvido por UMA funcao central por rota — nunca duplicada rota a rota), o problema do build estatico (script que renomeia — nunca deleta — Server Actions e layouts com getServerSession() antes do next build --output export, restaura tudo num finally, pra uma interrupcao no meio do build nunca deixar o codigo-fonte real quebrado), pagamento dual (Stripe + Google Play Billing — obrigatorio pela politica da Play Store pra assinatura digital dentro de APK, nunca opcional — convergindo numa unica tabela Subscription com platform/status cobrindo grace_period/trialing/account_hold, nunca um campo isPremium solto que dessincroniza; RTDN do Google Play reconciliado por cron diario pois push nao garante entrega), push dual (Web Push/VAPID + FCM via credencial JSON base64 em env var, funcao central que envia pros dois canais e limpa token invalido), e uma tabela de decisao (JWT custom vs Supabase Auth, Prisma vs pg puro, single-app vs monorepo pnpm workspaces, assinatura pura vs ledger de creditos append-only, sincrono vs worker BullMQ) que transforma as divergencias reais dos 3 apps de origem (gastos-app, memrapp, VisaLab) em escolha consciente por tipo de app em vez de copy-paste do primeiro exemplo. Guia detalhado modularizado em 10 arquivos (docs/skill-guides/app-reference-architecture/) por volume (~2500 linhas). v2.47.0: skill 59 closed-loop-revenue — a cadeia clique pago -> evento -> venda -> margem que nenhuma skill cobria (GCLID, measurement plan, margem de contribuicao, conversao offline e smart bidding tinham zero ocorrencia no kit). Identidade nao intercambiavel (GCLID/UTM/transaction_id/CRM, com GCLID persistido no backend junto do lead), backend como fonte de verdade da receita (purchase client-side perde pagamento assincrono e duplica em refresh), reconciliacao com tolerancia declarada que bloqueia escala de midia, e break-even ROAS = 1 / margem de contribuicao (com margem 40%, ROAS 2,0 destroi valor). Lead gen envia venda fechada, nao formulario. Skill 12 ganha shared element/FLIP, feedback multimodal com regra de redundancia, limite de flash WCAG 2.3.1 (risco de convulsao) e secao de quando NAO animar. v2.46.0: skill 58 i18n-localization — o gap mais surpreendente do kit (i18n aparecia 1 vez em tudo: skills, policies e rules; zero ocorrencia de pseudolocale, RTL, expansao de texto ou formatter por locale). i18n e trabalho de arquitetura, nao de tradutor: frase concatenada, botao de largura fixa, data montada a mao e margin-left quebram no contato com outro idioma e nenhum tradutor conserta. Cobre externalizacao com chave semantica, plural via API da plataforma, formatters com armazenamento canonico, +30% de expansao como piso de teste, propriedades logicas para RTL (com o que NAO espelha: numero, logo, icone de midia) e pseudolocale/RTL como regressao. Skill 02 ganha tabela de adocao de design system (Carbon/Fluent/M3/HIG/primitivas por tipo de produto; ancora estetica e design system sao decisoes separadas) e matriz de feedback por gravidade (erro que exige acao nunca e toast). v2.45.0: skill 57 mobile-ux-foundations — as decisoes que antecedem o layout, cada uma ancorada em dado biometrico/fisiologico/comportamental: zona do polegar (75% navegam com polegar, precisao cai a 61% no terco superior, dai navegacao primaria embaixo e acao destrutiva no canto dificil como prevencao), fisiologia do dark mode (preto puro causa halation, smearing OLED e mata elevacao — base e #121212 e elevacao se expressa por superficie mais clara), performance percebida (limiares 100ms/1s/10s, skeleton entre 1-10s, nada abaixo de 1s, progresso determinado acima de 10s) e UX de auth/onboarding (passkey em primeiro plano com bootstrap key e warm handover de 30 dias, NIST SP 800-63B contra regra draconiana de senha, label flutuante, validacao no blur, permission priming). Buraco medido: thumb zone, #121212, passkey, permission priming, haptic, inline validation e floating label tinham zero ocorrencia no kit. v2.44.0: skill 56 responsive-conversion — converte UI desktop-first em mobile e e dona dos padroes de interacao que a conversao expoe: catalogo sintoma-causa-fix (min-width auto como causa real de 'nao pega 100%', dvh vs vh, env(safe-area-inset) pra notch/barra de gestos, caca a scroll horizontal), protocolo de auditoria em 4 fases testado em 320/390/768px, tabela de decisao modal vs bottom sheet com requisitos nao-negociaveis (focus trap, retorno de foco, scroll lock iOS-safe), e confirmacao por reversibilidade (Desfazer pra reversivel, digitacao do nome do recurso pra catastrofica). Preenche buraco medido: safe-area/overflow/dvh/bottom-sheet tinham zero ocorrencia nas 6 skills de UI, e modal aparecia so como numero na tabela de z-index. v2.43.0: /catalog-project sintetiza product (resumo/planos/FAQ), sessions (docs/context/session-*.md) e operations (envs/enderecos/metricas) no manifest — alimenta o app companheiro project-brain (catalogo cross-repo); checa git remote -v antes de gravar secret real e avisa se o repo tem remote configurado. v2.42.0: skill 55 marketing-reporting-analytics — reporting operacional de marketing (relatorio de performance de Ads, setup tecnico GA4/GTM com fases de validacao, auditoria de infraestrutura de dados com severidade, calculadoras de CAC payback e ROI/ROAS), deliberadamente separada da skill 21 (data-analytics cobre o que trackear em produto; 54 cobre como configurar/auditar a ferramenta e o retorno financeiro). v2.41.0: catalogo de roteamento de plugins (plugins/catalog/*.json agrupa as 53 skills em 9 composicoes por tarefa; scripts/route-task.mjs e devkit_route_task retornam a menor composicao util com risco + flag de revisao humana; roteadores CLI e MCP verificados em paridade) + feedback estruturado accepted/overridden/rejected alimentando /insights e /savings com rotacao por tamanho + boot check real via JSON-RPC stdio do MCP server plugado no devkit doctor + CI + fix de path do installer no Windows/Git Bash + expansao de skills 02 (dials numericos, anti-padroes por industria) e 14 (SEO local/e-commerce/internacional) + templates/transitions.css. v2.40.0: skill 53 doubt-driven-review absorvida de addyosmani/agent-skills (MIT) — revisao adversarial EM VOO (nao pos-hoc como skill 11): CLAIM → EXTRACT → DUVIDA (revisor de contexto fresco viesado a refutar) → RECONCILIA → PARA (max 3 ciclos). Incrementos cirurgicos: skill 01 + templates/deep-interview.md ganham disciplina de palpite-anexado por pergunta, sonda 'want vs. should-want', restate com 'fora de escopo' obrigatorio e gate de confirmacao explicito (mesma fonte). v2.39.0: absorcao de ideias (nao codigo) de ponytail (escada de 7 degraus pre-codigo + policy/hook, delete-list review no /simplify e skill 23) e repowise (deducoes por risco na skill 18, risk banding qualitativo no /diff-impact e skill 11, truncamento reversivel _meta.omitted documentado em mcp-builder-patterns.md — so conceitos, repowise e AGPL) + paper COMPILOT PACT 2025 (anti-parada-prematura e feedback categorizado em /loop e /swarm). v2.38.0: skill 52 ui-polish absorvida de jakubkrehel/make-interfaces-feel-better (MIT) — 16 principios de acabamento visual (border radius concentrico, alinhamento optico, sombra vs borda, animacoes interrompiveis, split/stagger, saida sutil, animacao contextual de icone com valores exatos, font smoothing, tabular numbers, text wrapping, image outline, scale on press, skip animation on load, will-change moderado, hit area minima); referencia cruzada em skill 12 (motion-design) e skill 02 (ui-ux-design). v2.37.0: absorcao de 7 ebooks Casa do Codigo — skill 50 ux-research (gap real: discovery qualitativo — entrevista, persona baseada em pesquisa, journey map, teste de usabilidade, arquitetura de informacao; antecede PO 01 e UI/UX 02) + 3 policies de XP (pair-programming, continuous-integration, sustainable-pace, ligadas a skill 37) + incrementos cirurgicos: skill 01 ganha Fundamento de Negocio (validacao de hipotese, MVP, monetizacao, AARRR, product-market fit — do Guia da Startup); skill 14 ganha Keyword Research (KEI, intent, cauda longa) + Off-Page/Link Building (do SEO Pratico); skill 07 ganha Infrastructure as Code (provisionamento declarativo, idempotencia, drift — principios do DevOps na pratica traduzidos pra Terraform/Ansible); skill 38 ganha lentes de coesao/acoplamento, seam distribuido (REST/async/RPC, HATEOAS) e camadas (da Introducao a Arquitetura). Livros de Jogos HTML5 Canvas (nicho <2%) descartados por frequencia. v2.36.0: skill 50 direct-response-copy — copy de direct response destilada de 3 ebooks classicos PT-BR: biblioteca de formulas de headline em 20 categorias de gatilho (357 modelos destilados em formulas parametrizadas), 8 gatilhos mentais + storytelling de venda, copy de Instagram (legenda/engajamento). Gate de integridade obrigatorio: sem claim nao-verificavel, sem depoimento fabricado, escassez so real. Complementa a skill 13 (copy de produto): 13 cobre landing/microcopy/brand voice, 50 cobre ads/pagina de vendas/email/social. v2.35.0: auto-skillify (absorcao parcial do activeloopai/hivemind) — hook UserPromptSubmit que a cada N turnos (default 20) injeta checkpoint perguntando se a atividade recente vale virar learned-skill (3 criterios: nao-googleavel, especifico do codebase, custou debugging). Adapta o skillify-via-Haiku do hivemind ao runtime: delega a decisao ao agente da sessao (ja pago) em vez de forkar LLM. Le a contagem do context-turn-counter. O resto do hivemind ja tinhamos: codebase graph=Graphify, semantic search=.index/vault.db, memory compound=memory-curator. v2.34.0: vault de memoria UNIFICADO ao kit — instalar o kit agora CRIA o vault automaticamente (scripts/init-vault.mjs roda no install.sh: cria estrutura logs/architecture/secrets, CLAUDE.md com as regras de escrita, .gitignore protegendo secrets/, git init). Path PORTAVEL via scripts/vault-resolver.mjs: $CLAUDE_MEMORY_VAULT → ~/.claude-memory (novo padrao, vale Windows/Mac/Linux) → D:/claude-memory (legado). Antes o vault era montado a mao e o path hardcoded; agora kit+memoria sao uma coisa so. Idempotente (nao sobrescreve vault existente). v2.33.0: absorcao obsidian-second-brain (memoria AI-first) — policy memory-write-rules.md aplica anti-fabricacao ao VAULT (false-absence: busque exaustivamente antes de afirmar que nao existe nota/decisao — o failure mode mais comum; no-fabrication: TBD para desconhecido; recency markers '(as of YYYY-MM, fonte)' em claims externos; niveis de confianca) + convencao 'For future Claude' (preambulo de 2-3 linhas que o futuro-Claude le em 10s pra decidir relevancia, no skill 31 session-summary) + comando /reconcile-memory (detecta contradicoes no vault — decisoes revertidas/superadas nunca atualizadas — e resolve: mais novo+autoritativo vence com secao ## History, ambiguo vira flag, evolucao marca superseded). v2.32.0: pre-build-gate (UserPromptSubmit hook) leva o 'pare e decida antes de codar' de cada disciplina (que o /auto tem nas fases) para o MODO PASSIVO — detecta intencao de criacao no prompt e injeta o checklist da disciplina certa: acceptance-criteria (defina done antes de implementar), api-contract (formato de erro + status codes antes da 1a rota), schema-integrity (constraints/FK/indices antes do 1o INSERT), ui-design (ancora estetica antes de estilizar), deploy-readiness (healthcheck/env/graceful-shutdown). 4 novas rules path-scoped por disciplina (rules/backend/, rules/database/, rules/frontend/, rules/common/acceptance-criteria.md). v2.31.0: design-aware /auto — fase UI-DESIGN como gate (PLAN→[UI-DESIGN]→BUILD) que invoca skill 02-ui-ux-design e bloqueia build de arquivo visual ate a ancora estetica estar escolhida; rules/frontend/ui-design.md (path-scoped em .css/.tsx/public) proibe o default generico (#4f46e5 indigo + system-ui), forca escolher 1 ancora; coverage config virou gate HARD no /auto; scope inference (app→fullstack) movido pra rules/common para o modo passivo herdar. Validado por bench A/B real (bench/ab/, 3 rounds) que expos UI generica nos 3 bracos. v2.29.0: claim-verifier (PostToolUse — detecta afirmacoes sem evidencia: 'email enviado', 'deploy OK', 'teste passou'; passa livre se ha exit code 0/HTTP 200/query result) + context-turn-counter (UserPromptSubmit — compact a cada 25 turnos, handoff inteligente a cada 50 usando vault de memoria). v2.28.0: /spec-kit (SDD pipeline unificado specify→plan→tasks→implement + Adversarial Verifier inline), /insights (recomendacoes baseadas em telemetria dos hooks), /swarm com Phase 3 Adversarial Verify (Implementor vs Verifier com goals opostos, spec atualizada em real-time). v2.27.0: investigate-first guard (hook PreToolUse que impede a IA de perguntar o auto-descobrivel — gh user, branch, package manager, porta, versao de runtime — manda investigar primeiro) + policy investigate-first. v2.26.0: silent-failure-hunter (16o subagent, review-only: caca catch{} vazio, swallowed errors, fallbacks perigosos, stack traces perdidos, rollback faltando) + skill 49 context-budget (audita peso de contexto carregado por componente) + /context-budget. v2.25.0: rules system path-scoped (`.claude/rules/` com `paths:` glob, inspirado no ECC), bug-fix da allowlist de subagents, 5 skills stub reescritos com profundidade. v2.24.0: curador AUTONOMO de memoria (inspirado no Hermes Agent) — roda async no SessionStart, faz decay/archive/dedup em JS puro sem gastar LLM e delega so a parte semantica ao agente presente. v2.23.0: absorcao addozhang (skill 48 research-prep, Spring Boot playbook, mem9 patterns). v2.22.0: memory curator nudge. v2.21.0: context-cost guards. v2.20.0: skill 47 pattern-conformity. 16 dispatchable subagents.