Design de skill · pra sua aprovação

/dojo

Skill que instala os loops de aprendizado do "Finding Your Unknowns" no seu fluxo real. Objetivo: o entendimento voltar pra você na mesma velocidade que o trabalho sai. Clica nos chips pra reagir; no final a página monta sua resposta pra colar de volta no Case.

O problema que ela resolve

Você produz rápido (Case, Codex, agentes executam), mas o entendimento não volta na mesma velocidade. Você shipa mais rápido do que aprende. O teto não é capacidade: é linguagem. Sem as palavras do domínio (layout, arquitetura, sistema) você não consegue pedir bem, julgar bem, nem explicar bem.

A skill ataca isso com 3 movimentos ancorados no trabalho que já acontece: antes (ganhar a língua e ver os pontos cegos), durante (registrar desvios e decisões suas), depois (provar que você entendeu antes do "feito").

Os 3 princípios (DNA de todo artefato)

1

Reagir > descrever

Nenhum artefato te pede pra articular do zero. Todos terminam em chips, checkboxes ou templates que montam sua resposta sozinhos. Você aponta, a articulação se monta.

2

Produzir > ler

Explicação que você só lê, evapora (você mesmo cravou isso no teste de inglês). Todo explainer termina com exercício onde VOCÊ completa a estrutura, e todo quiz trava o "feito" até você passar.

3

Ancorado no real

Nada de curso abstrato. A escada usa o pedido que você acabou de fazer. O quiz usa o trabalho que acabou de sair. O blindspot usa o código de verdade. Aprende-se a língua do webhook na semana do webhook.

Os 4 movimentos

01

Escada de vocabulário

antes do trabalho · domínio que você não domina v1

Explainer HTML curto: modelo mental primeiro (o que entra, que caminho percorre, o que sai), depois 5 a 8 termos-chave com "como um profissional falaria" e o erro comum. Fecha com DOIS blocos ativos: exercício de completar e o seu próprio prompt reescrito (antes/depois).

Termo 3 de 6
hierarquia visual
O que o olho vê primeiro, segundo e por último. Profissional diria: "o total a receber é primário, sobe ele; os filtros são secundários, rebaixa". Erro comum: tudo do mesmo tamanho = nada é importante.
Agora você: "nessa tela do financeiro, o dado primário é   e ele tá competindo com  "
02

Blindspot pass

antes do trabalho · área desconhecida do sistema v1

Eu varro o código/contexto real e te devolvo "o que você pediu" contra "no que você tá entrando": minas, história, conceito que falta, convenção da casa. Cada achado com o porquê morde e como contornar. Fecha com seu prompt melhorado incorporando tudo.

Mina
O laudo tem DOIS templates de render
CompactTableTemplate e LabReportTemplate. Mexer só num deles é o erro clássico: a assinatura fica certa no preview e torta no PDF. Já mordeu 2 vezes (jun/2026).
03

Quiz de merge

depois do trabalho · sessão grande concluída v1

Relatório da mudança (modelo mental, decisões não óbvias com o quê/por quê/onde) + 5 ou 6 perguntas de situação, não decoreba. Passou, "feito" liberado com selo. Errou, a página aponta a seção pra reler. Score fica salvo na trilha.

Pergunta 2 de 6 · score 1/6
Um cliente ajusta a altura da assinatura no MyCompanyPage. O laudo antigo, já gerado, muda também?
a) Sim, o PDF é re-renderizado a cada download b) Não, PDF gerado é imutável, só os próximos mudam c) Depende do template escolhido
04

Interview reverso

antes de trabalho grande · pedido ainda vago v2?

Eu te entrevisto, uma pergunta por vez, ordenadas por impacto na arquitetura ("blast radius"). Treina exatamente o "aprender a pedir": você descobre as perguntas que um pedido bom já teria respondido. Marquei como v2 porque roda sem artefato (é só conversa) e dá pra testar informalmente antes de formalizar. Discorda? Chip abaixo.

Como flui numa sessão real

Você pede algo em área nova Case oferece: "quer blindspot ou escada antes?" Artefato HTML abre no browser Você reage (chips) e faz o exercício Trabalho roda Quiz antes do "feito"

Nos dias de crunch você pula tudo com um "hoje não" e nada te bloqueia. A skill é oferta, não pedágio. Exceção configurável: o quiz, que você pode escolher tornar obrigatório pra sessões grandes (decisão D abaixo).

Quando dispara

ComandoO que fazDisparo automático
/dojo escada <tema> Gera a escada de vocabulário do tema, ancorada no trabalho atual Case oferece quando detectar que o pedido usa domínio que você já disse não dominar
/dojo blindspot <área> Varre a área e devolve o mapa de minas + prompt melhorado Case oferece antes de trabalho em parte do sistema que você nunca mexeu
/dojo quiz Relatório + quiz da última sessão de trabalho grande Case oferece ao fechar feature/fix relevante, antes do "feito"
/dojo trilha Abre o índice: vocabulário conquistado, quizzes passados, buracos conhecidos n/d

Onde vive

CoisaLugar
A skill~/case/.claude/skills/dojo/
Artefatos gerados (escadas, blindspots, quizzes)~/case/dojo/2026-07-04-assinatura-laudo.html
Trilha (índice acumulado do que você já domina)~/case/dojo/trilha.html

A trilha é o antídoto contra evaporação: cada termo aprendido e cada quiz passado entra no índice. Quando um termo reaparecer numa sessão futura, o Case usa direto, sem re-explicar. Se você errar de novo algo que já "sabia", volta pra fila.

Decisões pra você bater o martelo

A · Nome da skill
Curto, memorável, você vai digitar isso sempre.
dojo sensei unknowns outro
B · O que entra na v1
Recomendo escada + blindspot + quiz + trilha. Interview fica pra v2 (testável informalmente antes). Marca o que quiser mudar.
escada blindspot quiz trilha interview já na v1
C · Oferta automática
Eu ofereço os movimentos sozinho quando detectar o contexto, ou só quando você chamar?
oferece automático (recomendo) só quando eu chamar
D · Quiz trava o "feito"?
No Thariq, ele só mergeia com quiz 100%. Pra você: quiz obrigatório em sessão grande, ou sempre opcional?
obrigatório em sessão grande (recomendo) sempre opcional sempre obrigatório
E · Termos em inglês nas escadas
O inglês ficou de lado como projeto, mas o vocabulário técnico JÁ É inglês (deploy, render, payload). Escadas podem trazer o termo em inglês com explicação em português, de graça, sem virar aula de inglês.
sim, termo em inglês + explicação PT (recomendo) tudo em PT por enquanto

Sua resposta (montada pelos chips)

Confere, ajusta o que quiser no texto, adiciona comentário livre e cola de volta no Case.