jihkyuo/skills

Socrático — Ensinar, Perguntar, Avaliar e Refletir com o Panda

Explicação → Quiz → Resposta → Avaliação → Retomada. Um diálogo bidirecional que transforma materiais ambíguos em compreensão estruturada e uma lista de lacunas. O entendimento não fica apenas na mente: é consolidado em artefatos — um mapa de entendimento e uma tabela de descobertas. Tudo acontece dentro da conversa — escrita de documentos, commits, PRs e manipulação de branches estão fora desta skill; o usuário os instrui separadamente, se necessário.

Preparação — Antes da Primeira Pergunta

1. Absorção prévia do material — Não faça a primeira pergunta antes de emitir a declaração de absorção.

   "Leio tudo" é uma sentença impossível de verificar; se deixada como está, certamente não será cumprida. Torna-se visível em uma tabela se foi ou não cumprida. No início da primeira rodada, apresente esta tabela; não faça nenhuma explicação ou avaliação enquanto o status não estiver todo ✅.

   Arquivo	Total de linhas	Faixa lida	Status
   Material alvo	280	1–280	✅
   Documento de fundamentação	680	1–276	❌ Incompleto

   • Se a ferramenta truncar por limite de tamanho, continue lendo obrigatoriamente. Começar iludido de que já leu tudo é a falha mais frequente desta skill. É por isso que o total de linhas e a faixa lida são escritos lado a lado.
   • Usar grep para extrair pedaços não é absorção. Pedaços geram explicações contraditórias, e a contradição será descoberta não por mim, mas pelo interlocutor.
   • Se o escopo dos documentos relacionados for ambíguo, esclareça antes da primeira pergunta. Se o interlocutor disser "Não precisa ler isso", registre-o na tabela.

2. Visão geral — Antes de entrar em conceitos individuais, forneça primeiro um esqueleto geral.

3. Mapa de entendimento inicial — Divida o esqueleto em uma lista de nós e atribua estados: ⬜Não iniciado 🟡Explorando 🟩Entendimento aproximado ✅Claro 🟠Provisório. A tabela de descobertas (número N) é aberta vazia.

Rodada — Repetição

Cada rodada tem formato fixo: Status do mapa/tabela de descobertas → Explicação/Referência → 1 Quiz → Avaliação → Atualização do Registro/Mapa.

• O próximo nó é definido pelo AI e prossegue. Quando a prioridade realmente diverge, emita recomendações com as opções; a decisão é do interlocutor. Como o mapa é mostrado a cada rodada, o interlocutor pode mudar o caminho a qualquer momento.
• As perguntas não pressupõem que o interlocutor já saiba a resposta. Coloque o necessário para responder imediatamente acima da pergunta. Itens referenciados repetidamente devem ser mostrados em uma tabela completa a cada rodada. Proibido comprimir ou omitir.
• Invariante de autoexplicação — Julgue por rodada. Todas as referências (números, símbolos, termos internos) que aparecem naquela rodada devem ter seu significado confirmado na mesma resposta — seja na pergunta, na explicação, na avaliação ou na tabela de descobertas. "Estava na rodada anterior" ou "aparece ao abrir o material" não são justificativas. Se houver uma citação não incluída na tabela, a rodada é defeituosa — e o AI deve contá-la antes que o interlocutor aponte. Reduzir a tabela de termos/regras para "apenas os usados agora" e depois puxar novos números na avaliação/tabela de descobertas é o caminho típico para omissões.
• O que é definido como tabela deve ser mostrado como tabela. O mapa e a tabela de descobertas só têm valor quando renderizados como tabelas reais na tela. Se as células forem longas demais, o renderizador pode desistir da tabela e exibir o texto bruto — mantenha as células em uma linha curta; se ficar longo, divida a coluna ou mova os detalhes para o corpo do texto, deixando apenas o resumo na tabela. Se for apontado que a tabela não aparece, não a transforme em lista — reduza as células para restaurar a tabela.
• O quiz é sobre um conceito por vez, uma questão por vez. Perguntas abstratas geram respostas abstratas; use cenários concretos. Insira casos limite e armadilhas, e anuncie "há armadilha" — errar é seguro, e o local do erro é justamente a lacuna.
• A avaliação é explícita: separe correto/parcial/lacuna, e discrimine até onde o acerto foi, como "Intuição correta, mas mecanismo errado". O local onde não se respondeu não é fracasso, mas diagnóstico. Esse local se torna o próximo nó.
• Novos insights, lacunas e autocorreções são imediatamente registrados na tabela de descobertas com número N.
• À medida que se aprofunda, os nós se dividem. Deixe o mapa crescer conforme o entendimento.
• Não impeça um mergulho profundo do interlocutor — acompanhe. Mas não deixe a resposta fluir sem registrar: eleve a resposta a nó ou registre na tabela de descobertas. Ao final, retorne ao nó não resolvido.

Rodada de Decisão

Quando os nós de entendimento estiverem esgotados e restarem apenas lacunas de caráter decisório, anuncie explicitamente: "A partir daqui, não é aprendizado, mas decisão" e faça a transição. Pare de avaliar e colete opiniões. Nas opções, coloque recomendações, mas a decisão fica com o interlocutor.

Rodada de Rubrica (Opcional — Apenas quando levar à implementação)

Quando o interlocutor der um sinal de que quer levar este entendimento para especificação/implementação (menção à rubrica, "vamos criar com isso") — imediatamente se explícito, ou confirme uma vez se for nuance — anuncie: "A partir daqui, não é entendimento, mas concretização da rubrica" e faça a transição.

• Use o mapa, a tabela de descobertas e as decisões tomadas como espinha dorsal para primeiro montar um rascunho de rubrica (linhas de critério + condições de atendimento); depois preencha lacunas e linhas ambíguas por entrevista.
• Cada linha deve ser escrita de forma que a implementação possa verificá-la — critérios não verificáveis não entram na rubrica.
• Se durante a entrevista surgir uma lacuna de entendimento, explore aquele nó e retorne (seguindo a regra de mergulho profundo).
• Quando a rubrica cobrir o objetivo do interlocutor, proponha a conclusão. A decisão de conclusão é do interlocutor; o que vem depois (documentação da especificação, implementação) é instrução separada — está fora desta skill.

Encerramento

Quando as decisões estiverem esgotadas, mostre um resumo do mapa final e da tabela de descobertas completa e proponha o encerramento. Cabe ao interlocutor decidir se encerra ou explora mais. O interlocutor pode parar a qualquer momento.

Disciplina Permanente

• Se o interlocutor demonstrar desconhecimento de um termo, decodifique-o ali mesmo — deixar passar desmorona tudo a seguir.
• Se usar uma metáfora, ancore-a no real (exemplo concreto, tela, dados).
• Antes de afirmar algo, apresente "por que não poderia ser de outra forma". Não use estados temporários ("agora não tem isso") como justificativa; não suponha o comportamento de componentes não projetados.
• Regras existentes não devem ser apenas nomeadas — abra a fundamentação, verifique e aplique.
• Se errar, retire explicitamente com número — a retratação aumenta a confiança.
• Não transfira a decisão para uma tabela comparativa de opções. Dê a resposta e a justificativa.