Roadmap

s13. F12 — A skill em uso real: adequar o que já existe

estávelseed-ds-roadmap.md v2.82 · §s13seção 14 de 18s13-f12-a-skill-em-uso-real-adequar-o-que-ja-existe.md · MD5 0006489c

Título completo no canon: F12 — A skill em uso real: adequar o que já existe ✅ FECHADA em 2026-09-19 (aberta no MANIFESTO §234 · gate respondido verbatim no §234.5: "V-SK1: b · V-SK2: a · V-SK3: a · V-SK4: nenhum" · vereditos do §235 · fechamento, fase 2 do aceite e publicação no §236)

Por que existe. Na semana do lançamento oficial do DS para a empresa, o decisor pediu nos dois apps de chat (SEED Chat no Claude Code, Clara no Lovable) "adeque ao novo DS" e precisou corrigir a IA seis vezes (medido: 2 + 6). O reconhecimento em cinco frentes (relatórios em 09-pesquisa/2026-09-19-reconhecimento-skill-pos-lancamento/) mediu a causa: a IA lê UMA fatia (ou um recorte) e para, ignora ponteiros que já viu, não roda a ficha (0 execuções nas duas superfícies) e não envia o pedido de cobertura; a skill não tem modo de adequação e a ficha está além dos 5.000 tokens que sobrevivem à compactação; o §46 não aponta para o §93 (o rail metálico vive lá); 25,7 % a 40,2 % dos bytes das fatias são histórico. Ele decidiu o completo (V-SK1 = b): além da camada gerada, cada seção do canon separa o histórico num bloco próprio no fim. Regra nova de método: Opus 5 para o profundo, Sonnet 5 para o que tem roteiro, Fable orquestra.

Brick	O que	Modelo	Estado
F12.1	A skill no `gen-skill.py`: < 500 linhas, inegociável nos primeiros 5.000 tokens, modo ADEQUAÇÃO com checklist copiável e plano validado, mínimo por tarefa, faixas de regra lidas do canon, mapa por canônico, regra de consulta de `consulta_bloco.py`, guardas SK novas	Opus 5	✅ entregue e consolidada em 2026-09-19 (48 min medidos × 6–8 h; MANIFESTO §236.2–§236.3): SKILL.md 438 linhas, modo ADEQUAÇÃO, receitas compactas + `references/receitas.md`, SK-12..SK-15; e o frontmatter virou YAML válido para qualquer plataforma (a description entre aspas; SK-1 mede a forma; o Lovable recusava o zip — §236.5) e a versão passou a cobrir o texto redigido (`2026.09.19+22a3085b`)
F12.2	`conferir-peca.py --alvo <pasta>`: censo do app consumidor, CP-1/2/4/13 no HTML servido, CP-14 material, ficha de adequação com denominador; cobaia = SEED Chat `911d70d`	Opus 5	✅ entregue e consolidada em 2026-09-19 (≈ 1 h 12 medidos × 6–8 h; §236.2): `conferir-peca.py --alvo` provado em cobaia e em repositório real; a cobaia do aceite o rodou sem dica (ficha inicial 1·2·2·4 → 8·2·1·3 com DOM) e achou a `CP-P9` (o CP-13 reprova tela sem topbar, contra SH1/SH21)
F12.3a	`seed-consulta.json`: §46/§55 corrigidos; `_secoes` (em_uma_frase · vocabulario · nao_cobre · conceitos) e `_receitas`; frases ≤ 15 palavras com cobertura impressa	Opus 5	✅ entregue e consolidada em 2026-09-19 (≈ 1 h 44 medidos × 6–8 h; §236.2): 290 frases, 154 `_secoes`, 40 conceitos, 9 receitas; frases > 15 palavras 147 → 3 declaradas
F12.3b	Camada de IA: `_cabecalho` × `_changelog`, "Em uma frase" + "Vocabulário" no topo da fatia, estado por máquina no cabeçalho e no `indice-ia.json`, `NN-historico.md`, página por conceito, `llms.txt` por intenção, guardas novas, reconstituição byte a byte mantida	Opus 5	✅ entregue e consolidada em 2026-09-19 (≈ 2 h 09 medidos × 8–10 h; §236.2): estado por máquina, `NN-historico.md`, conceitos, roteamento por intenção; CI-11/CI-13 em regime de baseline (§236.3)
F12.4	Canon: §46→§93, raio antes da história, "SUPERSEDID" abrindo enunciado, e o bloco `### Histórico da seção` em cada seção dos quatro canônicos de construção (só mover)	Opus 5	✅ entregue e consolidada em 2026-09-19 (≈ 1 h 42 medidos × 12–16 h; §236.2): 72 blocos `### Histórico da seção`, §46→§93, raio antes da história; LF puro 124 preservado; reconstituição byte a byte 12 de 12
F12.5	Estudo conta + tema no shell → `SH-P16` (decisão dele, folha própria)	Sonnet 5	✅ entregue e DECIDIDO em 2026-09-19 (30 min medidos × 4–6 h; MANIFESTO §235.2, verbatim: "V-SH16.1: b · V-SH16.2: (…) na parte inferior da rail · V-SH16.3: a · veto: nenhum") — nasce o SH21 (menu de conta com Perfil · Tema · Sair; avatar na topbar ou, sem topbar, na base do rail; tema segue o sistema até a pessoa escolher, guardado por conta); aplicação = F12.9
F12.6	Triagem dos 5 pedidos de cobertura recebidos + o do rodapé do rail (18/09)	Sonnet 5	✅ entregue e DECIDIDO em 2026-09-19 (14 min medidos × 2–3 h; MANIFESTO §235.1): LC-13 e LC-14 nascem em ⏸ aguarda; LC-15/16/17/18 abertas; PC-0009 descartado (já era a MR-P20); banco atualizado
F12.7	Eval com linha de base ANTES das mudanças (`claude plugin eval`, 4 casos) e a prova final nas duas cobaias	Sonnet 5	✅ fechada em 2026-09-19 (fase 1 ≈ 51 min × 6–8 h; fase 2 7 min + 300 s; §236.4 e §236.6): linha de base Δ +0,83..+1,00; com a skill nova nenhuma regressão real (duas quedas de placar são do instrumento — caso envelhecido pelo SH21 e grader que só aceita `Read`); cobaia real do SEED Chat sem dica: mediu antes de editar, rail metálico e tema no menu do avatar sem ajuda, "o que não muda" declarado — parou no teto de 120 turnos; cobaia da Clara no Lovable (remix, sem tocar o publicado): a skill NÃO foi lida nem em prosa nem com `/seed-ds` pela API — 0 consultas ao DS em 2 rodadas, "DS flat" inventado; nascem `SK-P3` e `SK-P4`
F12.8	Consumidores: `CLAUDE.md` do SEED Chat e do ERP, conhecimento da Clara no Lovable, republicação da skill nas três superfícies	Sonnet 5	✅ fechada em 2026-09-19 (11 min medidos × 1–2 h; §236.5–§236.6): ERP = PR #72 contra `dev` (promoção é dele); SEED Chat = `CLAUDE.md` + `AGENTS.md` editados (commit local `3ae35fc` deles, sem push — a sessão deles publica); skill republicada nas três superfícies (instalada · zip publicado · workspace do Lovable, versão `2026.09.19+22a3085b`); o texto de conhecimento da Clara no Lovable continua esperando o "sim" dele
F12.9	O menu de conta no shell (SH21) — o `shell_bloco.py` emite o avatar e o menu (Perfil · Tema · Sair) nas telas com casca; sem topbar (tela-chat), o avatar na base do rail acima do botão do SH19; suíte do shell com os asserts do menu (abrir, Esc, clique fora, foco preso e devolvido); CP-13 mede; régua rasterizada nos dois temas; o texto do SH21 no canon é da sessão principal, depois da F12.4	Opus 5	✅ entregue e consolidada em 2026-09-19 (1 h 49 medidos × 6–8 h; §236.2–§236.3): avatar + menu de conta (Perfil · Tema · Sair) nas onze telas com casca, na base do rail no `tela-chat`; suítes 97·0 / 63·0 / 55·0; SH21 no §46.6 (componentes v1.67); resposta ao ponteiro dos avatares consertada na consolidação (HV1)

Pendências: SH-P16 (o produto tem alternador de tema e bloco de conta no shell? onde?) FECHOU com o veredito do §235.2 (SH21) e a aplicação da F12.9. NASCEM no fechamento (MANIFESTO §236.7, códigos lidos na linha UC-3 do rito): CP-P9 (o CP-13 do conferidor reprova "topbar ausente" contra SH1/SH21 — achado da cobaia do aceite) · CP-P10 (--alvo não procura segredo no repositório do app) · SK-P2 (SKILL.md a ≈ 11,2 mil tokens por invocação) · SK-P3 (suíte do eval: caso envelhecido, grader estreito, varredura só com sandbox, teto de turnos da cobaia) · SK-P4 (a skill não dispara no Lovable: 0 leituras em 2 rodadas da cobaia da Clara — medir "Automatic use" e o gatilho no compositor, e levar a ordem ao Conhecimento do projeto) · SH-P17 (só o tela-chat mostra produto sem topbar) · PR-P10 (gen-indice.py carimba hora — não determinístico) · CT-P13 (trilha do shell a 390 px: 4,52 → 4,41). Aberta ainda: a promoção do PR #72 do ERP (dele) e a gravação do conhecimento da Clara no Lovable (espera o "sim" dele).