Página de Aprendizagem sem Dor

Transforme seus materiais de estudo em uma página web por disciplina, permitindo que você estude sequencialmente, aprenda corretamente e verifique seu domínio com exercícios. Uma disciplina é um projeto de longo prazo: novos materiais podem ser adicionados semanalmente; na época de provas, as seções relevantes são abertas na mesma página. Quando o usuário não possui materiais, primeiro ajude a planejar uma trilha de aprendizado, encontrar recursos confiáveis e depois crie a página.

Zero. Configuração do Ambiente (Adaptação para diferentes agentes de IA)

Esta skill foi originalmente escrita para Claude. Abaixo estão as instruções para implementação em outros agentes (Codex, WorkBuddy, etc.). Siga as regras do texto principal; quando as capacidades do ambiente diferirem, trate conforme aqui.

Leitura de arquivos: Use as ferramentas de arquivo ou scripts disponíveis para ler a pasta fornecida pelo usuário (PDF, PPT, DOCX, imagens). Se não for possível fazer OCR, informe ao usuário quais páginas não foram lidas.
Conexão com a internet: Use ferramentas de busca para planejamento do zero e verificação de fatos; se não houver, avise e peça ao usuário que forneça os materiais.
Perguntas: Faça todas as perguntas de uma só vez; se houver uma ferramenta de perguntas com opções, use-a.
Localização da página web: Por padrão, salve em _pagina_aprendizagem/ dentro da pasta da disciplina (se não houver pasta da disciplina, crie <nome_disciplina>_pagina_aprendizagem/ no diretório de trabalho atual): index.html é a página completa (arquivo único, dados embutidos, abre diretamente no navegador); data/curso.json é a fonte de dados principal; img/ contém capturas de tela das fontes. Se possível, publique uma versão hospedada, mas a pasta local é sempre a fonte primária.
A página web não pode chamar IA: Onde o texto principal diz "Peça ao Claude para organizar na página web / usar recursos de sample, db, assets", substitua por armazenamento em localStorage e forneça um botão "Copiar tudo (para usar com IA)", para que o usuário envie o conteúdo de volta para você organizar.
Validação: Quando puder executar Python, execute python3 scripts/validar_curso.py <caminho>/data/curso.json até que não haja erros; quando puder usar um navegador ou navegador headless, abra index.html para verificar a renderização e interatividade; se não puder fazer a verificação, informe ao usuário.

Um. Definir a Especificação

Primeiro, determine a categoria com base na fala e nos materiais do usuário. Se não for possível, faça uma única pergunta (máximo 3 perguntas). Se o usuário não estiver presente, escolha a categoria mais razoável e, na entrega, informe qual foi escolhida e por quê.

Tipo	Situação Típica	Objetivo	Ênfase
Aprendizagem Autodidata	Apenas livro-texto, transcrição de curso online, artigo; não é para prova	Compreender e aprender corretamente	Explicar clara e corretamente; verificar com questões de compreensão; sem análise de prova, sem cronômetro
Introdução Leve	Apenas desconhece um conceito ou tópico pequeno, quer uma introdução rápida; tempo total estimado de estudo < 3 horas	Construir rapidamente uma compreensão correta	Sem roteiro, sem confirmação; definir o roteiro e gerar a página diretamente (veja "4.3")
Aprendizagem Autodidata: Planejamento do Zero	Sabe apenas o que quer estudar, não tem materiais	Aprender do básico ao avançado	Primeiro pesquise, planeje o roteiro, encontre cursos e livros autoritativos; após o usuário confirmar o roteiro, crie a página; a explicação deve ser gradual (veja "4.2")
Acompanhamento de Curso	Durante o semestre, recebe slides e transcrições de aula semanalmente ou a cada duas semanas	Acompanhar o curso, entender o conteúdo semanal	Atualização incremental; avançar por semana; alinhamento rigoroso com o escopo do curso
Preparação para Prova: Intensiva	Próximo da prova, pouco tempo	Dominar os tópicos de alta pontuação rapidamente	Calibração com a prova; estudar apenas o essencial e importante; testar diretamente com provas reais
Preparação para Prova: Aprofundada	Quer uma nota alta, tempo suficiente	Dominar verdadeiramente	Calibração com a prova; explicar todos os pontos de conhecimento dentro do escopo; primeiro fazer simulados, deixar as provas reais para o final

Informações necessárias a serem obtidas (não pergunte se puder inferir dos materiais):

Objetivo do estudo: compreender, acompanhar o curso ou se preparar para prova
Quais materiais possui
Nível de conhecimento atual
Data limite ou data da prova
Tempo disponível por dia para estudar
Formato da prova: idioma de resposta, permissão para consultar anotações, restrições de calculadora

A mesma disciplina pode começar como "Acompanhamento de Curso" e depois, no final do semestre, adicionar "Preparação para Prova". Nesse caso, não crie uma nova página; abra a seção de preparação na página existente (veja Seção 3).

Dois. Arquivo de Dados do Curso

Cada disciplina mantém um curso.json, a partir do qual a página é gerada. Para atualizar, modifique este arquivo e regenere a página.

Salve em dois lugares para garantir continuidade na próxima conversa:

data/curso.json na pasta da página web
_pagina_aprendizagem/curso.json na pasta da disciplina do usuário (quando possível escrever)

Antes de atualizar, leia este arquivo. Se não for encontrado em nenhum dos dois lugares, restaure a partir da página publicada e informe o usuário.

{
  "curso": {"codigo":"…", "nome":"…", "perfil":"autodidata|autodidata-plano|curso|prova-intensiva|prova-aprofundada",
             "prova": {"data":"…", "formato":"…", "idioma_resposta":"pt|en", "permitido":"…"}},
  "fontes": [{"id":"S03A1", "arquivo":"…", "url":"…", "tipo":"aula|transcricao|livro|tutorial|laboratorio|trabalho|prova_modelo|prova_anterior|info_prova|web", "semana":3, "adicionado":"…"}],
  "modulos": [{"id":"M-sql-basico", "nome":"…", "ordem":5}],
  "pontos": [{
    "id":"sql-left-join",        // ID estável, nunca modificar após geração
    "no":57,                      // Número de exibição, reordenar a cada geração
    "titulo":"Conteúdo em uma frase",
    "modulo":"M-sql-basico",
    "semana":5,
    "nivel":3,                     // 3 Essencial / 2 Importante / 1 Secundário / 0 Não cai na prova (autodidata pode não classificar)
    "profundidade":"aplicar",      // reconhecer (recall) / explicar (explain) / aplicar (apply) / transferir (transfer)
    "pre":[{"id":"sql-inner-join", "tipo":"duro"}, {"id":"nulo", "tipo":"suave", "porque":"IS NULL"}],
    "fonte":[{"origem":"S05A1", "pagina":24}, {"origem":"S05A1-transcricao", "tempo":"32:10"}],
    "ref_prova":["Prova Modelo 2 Q2A"],
    "dominio":"Que tipo de questão indica domínio (uma frase, deve ser verificável com questões)",
    "status":"ativo|mesclado|obsoleto",
    "alterado":"Data: o que mudou",
    "nota":"Não cai na prova / Complemento / O professor disse…"
  }],
  "narrativa": [{"de":"M-arvore", "para":"M-rf", "porque":"Uma frase: qual problema o módulo anterior deixou e como o próximo resolve"}],
  "aulas": [{"id":"A-s05", "trilha":"aprender|revisar", "titulo":"…", "pontos":[…], "passos":[…],
               "narrativa":[{"papel":"Problema|Ideia|Ação|Resultado|Novo Problema", "texto":"Uma ou duas frases", "formula":"Opcional, forma mais simples", "passos":[3,4]}]}],
  "questoes": [ … veja Seção Oito … ],
  "registro_alteracoes": [{"data":"…", "resumo":"…", "adicionados":[…], "alterados":[…], "conflitos":[…] }],
  "notas_curso": [{"data":"…", "nota":"Preferências ou correções específicas deste curso (ex., notação, módulo que precisa ser explicado mais profundamente). Em atualizações futuras, sempre cumprir."}]
}

Regras:

ID estável: Progresso, marcações, erros são armazenados por ID, portanto, o progresso do usuário não é perdido após atualizações.
Não exclua pontos de conhecimento. Marque os desnecessários como obsoleto; os mesclados como mesclado, apontando para o novo ID.
pre contém apenas pré-requisitos diretos. duro significa que deve ser aprendido primeiro; suave significa que apenas um conceito é usado, especifique qual.

Três. Estrutura da Página: Uma página por disciplina

Toda a disciplina está em uma página (_pagina_aprendizagem/index.html, veja "Zero. Configuração do Ambiente"). Use abas no topo para alternar entre seções e hash de URL para navegação (ex., #mapa, #aula/A-s05/3, #q/q-id), facilitando links entre seções.

Seções e o que é exibido em cada tipo

| Seção | Conteúdo | Autodidata (inclui planejamento do zero) | Acompanhamento de Curso | Preparação para Prova | |---|---|---|---| | Mapa | Grafo de módulos, todos os pontos de conhecimento (caixas de seleção, pré-requisitos, fontes), progresso, painel "Atualização desta semana" | ✓ (para planejamento do zero, é a trilha de aprendizado, com recursos recomendados) | ✓ | ✓, adicione "Perspectiva de Prova" | | Aula | Explicação passo a passo, com autoavaliação em cada passo | ✓ (por capítulo ou fase) | ✓ (por semana) | ✓, adicione "Trilha de Revisão" | | Prática | Questões autorais por ponto de conhecimento (simulados também aqui, com etiquetas); filtrar por "não dominado" é o caderno de erros | ✓ | ✓ | ✓ | | Prova | Fatos da prova, prioridade dos materiais, tabela por questão, peso dos módulos, lista do que não cai, o que o professor disse | — | — | ✓ | | Simulados | Incorporados na página de Prática, filtro por etiqueta "Simulado", sem seção separada | — | — | Versão aprofundada | | Provas Anteriores | Provas modelo e anos anteriores (manual de questões) | — | — | ✓ (versão aprofundada: mantenha lacrada até o final) | | Rascunho Cheat Sheet | Guarde durante o estudo o que não quer decorar; depois, a IA organiza e gera uma folha de consulta (veja Seção 6, item 5) | — | — | ✓ (quando a prova permite consulta) |

O grafo deve ser gerado

Toda página deve ter um grafo de conhecimento na seção Mapa. Independentemente da especificação, prazo ou se a confirmação foi pulada, o grafo deve ser gerado. Pré-requisitos também devem ser incluídos (ex., ao estudar "O que é API", desenhe cliente, servidor, requisição HTTP como pré-requisitos).
Apenas duas exceções: o conteúdo é muito estreito (apenas 1–3 pontos de conhecimento) ou não há relação de precedência entre os pontos. Nesse caso, escreva uma frase explicando por que não há grafo.
Quando o tempo for curto, reduza os passos da aula e a quantidade de questões, mas não remova o grafo.

Layout de Navegação (Prioridade para Aula e Prática)

Aula e Prática são o corpo principal; Mapa, Prova e Trilha de Aprendizado são visões gerais e não devem ocupar a maior parte do topo.
O topo deve ter uma barra fixa de uma linha: código da disciplina + abas das seções principais + botões pequenos para contagem regressiva / progresso / termos / código de progresso. Seções principais: Aula (padrão), Prática (subpáginas: Exercícios, Provas Anteriores), Visão Geral (subpáginas: Mapa, Prova, Trilha de Aprendizado), Cheat Sheet (quando tiver função de rascunho).
A segunda linha contém as abas das subpáginas da seção principal atual e uma linha de entrada para Cheat Sheet (expande quando em foco).
A seção Prova é mantida em todas as páginas de preparação; o conteúdo não muda após ser escrito; a Trilha de Aprendizado pode mudar com o progresso; coloque na Visão Geral.

Baixo custo de aprendizado

A pessoa que recebe a página não deve precisar aprender a usá-la primeiro.
Na primeira vez que cada seção for aberta, exiba uma linha de explicação clara no topo (pode ser fechada), como "Não marque 'Dominado' para questões que você não tem certeza; filtrar por 'Não Dominado' é seu caderno de erros".
Use apenas um tipo de cartão de questão em todo o site: enunciado → opções ou campo de entrada → dica / ver resposta → caixa de seleção "Dominado" no canto superior direito. Autoavaliação na aula, exercícios, provas anteriores: todos usam o mesmo formato.
Botões com texto de ação ("Ver resposta", "Próximo"), não apenas ícones; minimize filtros e interruptores em uma página; não implemente funcionalidades pouco usadas.
Dê apenas uma entrada e um estado para a mesma ação; evite estados semelhantes como "Corrigido", "Desfazer", "Dominado" coexistindo.

Todas as operações persistentes devem ser reversíveis

Quem recebe uma página nova vai clicar em tudo para testar. Portanto, toda operação que persiste deve permitir a restauração ao estado anterior, sem deixar rastros.
Interruptores ("Dominado", marcação de conhecimento, passo "Concluído"): clique novamente para desfazer; não permita apenas marcar, sem desmarcar.
Registros de respostas: cada questão deve ter um botão "Refazer" para limpar a resposta e o feedback, voltando ao estado inicial.
Operações que podem perder dados (limpar, remover, importar): após a ação, exiba uma barra de notificação "Limpo · Desfazer" no rodapé. Dentro de cerca de 8 segundos, clicar em "Desfazer" restaura completamente. Não use confirm() do navegador.
- A limpeza do cronômetro, remoção de itens do Cheat Sheet, importação de código de progresso usam esta barra.
- A remoção do Cheat Sheet é uma exclusão suave: mova para "Removidos Recentemente" no rodapé da página; pode ser recuperada mesmo após o tempo da barra.
- Antes de importar um código de progresso, faça um backup automático do progresso atual.
Redefinição total: no modal do código de progresso, coloque "Limpar todos os meus registros", para quem quer recomeçar. Antes de limpar, faça um backup automático; após limpar, o mesmo modal mantém o botão "Restaurar registro anterior".
Implementação: antes de cada escrita que possa perder dados, tire um snapshot da parte do estado afetada; desfazer é escrever o snapshot de volta. O backup da redefinição total é armazenado em uma chave separada do localStorage, sobrescrito apenas na próxima redefinição.

Como lidar com a coexistência dos modos de aprendizado e prova

Apenas um Mapa: forneça um alternador "Visão de Aprendizado / Visão de Prova":
- Visão de Aprendizado: organizado por semana ou capítulo, exibindo todos os pontos de conhecimento.
- Visão de Prova: organizado por peso na prova; pontos de conhecimento fora do escopo da prova ficam esmaecidos; exibe etiquetas de origem da prova e trilha de aprendizado.
As duas visões compartilham o mesmo conjunto de progresso.
Aula dividida em duas trilhas:
- Trilha de Aprendizado: aulas semanais durante o semestre, mantidas permanentemente.
- Trilha de Revisão: novas aulas adicionadas durante a preparação para a prova, organizadas pela trilha de aprendizado. A trilha de revisão não repete o que já foi aprendido: pontos de conhecimento já estudados recebem apenas um cartão de revisão compacto, com link para a explicação original na trilha de aprendizado, e complementa com a perspectiva da prova (como a questão é feita, profundidade necessária, erros comuns). Apenas tópicos que caem na prova e não foram bem explicados na trilha de aprendizado são explicados em detalhes.
Apenas um banco de questões: as autoavaliações regulares e os simulados de preparação ficam juntos, filtrados por etiquetas. O caderno de erros é compartilhado entre os modos.
Prova e Provas Anteriores: essas seções aparecem apenas durante a preparação para a prova. O manual de provas anteriores pertence à preparação, não ao modo de aprendizado.

Funcionalidades gerais da página

Topo: nome da disciplina, tipo, progresso total, contagem regressiva para a prova (quando em preparação).
Cronômetro: colocado no canto superior direito de cada cartão de passo (posição visível, não apenas na barra lateral), exibindo "Tempo neste passo: mm:ss · Total na disciplina", atualizado a cada segundo; botões "Pausar / Continuar" e "Limpar" (limpa apenas o passo atual; após limpar, exibe barra "Desfazer"); o estado de pausa persiste entre os passos; pausa automaticamente ao mudar para outra aba; o tempo é registrado no passo ou questão atual.
Modal da narrativa principal: a qualquer momento, pode abrir a narrativa lógica da aula atual, destacando "Você está aqui" (veja Seção 7 "Narrativa Lógica").
Modal de glossário (bilíngue, com uma frase de explicação cada); para cursos de matemática/estatística, adicione um tradutor de símbolos.
Links para slides: use caminhos relativos para os PDFs originais na pasta da disciplina, com #page=N (o leitor de PDF do navegador pula para a página correspondente); transcrições marcam pontos de tempo; recursos online fornecem links originais.
Código de progresso: exporte um texto para enviar à IA, que assim saberá onde você tem dificuldades. A importação apenas adiciona marcações, não remove; antes de importar, um backup automático permite desfazer.
Todos os estados são armazenados no localStorage com a chave "código_disciplina + ID estável"; leitura e escrita sempre com try/catch.
Uma paleta de cores unificada, com modo escuro, consistente em toda a disciplina.
Adaptado para dispositivos móveis: barras laterais empilhadas no topo, tabelas com rolagem horizontal, adaptação para áreas seguras.
Fórmulas com MathJax SVG (tex-svg); regras de notação e formatação na Seção 7 "Formatação e Notação".
Grafo: para muitos pontos de conhecimento, use Graphviz para calcular o layout antecipadamente e desenhe um SVG clicável e com zoom na página: ao clicar em um ponto, destaque todos os seus pré-requisitos e sucessores; "Ver por questão" destaca todos os pontos necessários para uma determinada questão. Grafos pequenos no nível de módulo podem usar Mermaid.
Capturas de tela das fontes: exporte apenas as páginas dos slides referenciadas pelos pontos de conhecimento (use ferramentas de linha de comando como pdftoppm para exportar PNG diretamente do PDF, sem visualizar página por página, consumindo poucos tokens), salve em img/ na pasta da página; clique na referência para abrir a imagem (navegadores não abrem páginas específicas de PPT, portanto, use capturas de tela).
Os dados da página são incorporados diretamente no index.html; data/curso.json é a fonte principal salva separadamente.

Quatro. Criação (Com Materiais)

1. Leitura dos Materiais

Use as ferramentas de arquivo disponíveis para ler a pasta fornecida pelo usuário ou os arquivos enviados. Leia cada arquivo por completo: digitalizações e manuscritos precisam de OCR; imagens precisam ser examinadas página por página.
As transcrições de aulas e textos de cursos online são igualmente importantes: exemplos falados, ênfases ("Isso vai cair na prova", "Muitos erram aqui"), explicações não presentes nos slides devem ser extraídas e marcadas com o ponto de tempo.
Primeiro, forneça ao usuário uma lista dos arquivos lidos, indicando quais não puderam ser lidos.

2. Escopo e Precisão

Acompanhamento de Curso e Preparação para Prova: o escopo é definido pelos slides e aulas; não adicione conteúdo extracurricular. Conhecimentos de fundo necessários devem ser marcados como "Complemento". A notação deve coincidir com os slides.
Aprendizagem Autodidata: o escopo é definido pelo objetivo de aprendizado do usuário; os materiais são apenas um ponto de partida. Se os materiais forem confusos ou tiverem erros, você pode complementar com explicações autoritativas, mas indique isso. As transcrições de cursos online geralmente contêm erros de reconhecimento e lapsos; corrija com base no contexto e verifique fatos e fórmulas críticas com fontes confiáveis. Indique incertezas.

3. Extrair Pontos de Conhecimento

Granularidade fina: cada item deve ensinar uma única coisa (definição, propriedade, método, tipo de questão ou armadilha). Se um item contiver duas coisas que podem ser verificadas separadamente, divida.
Para aprendizado, a profundidade segue primeiro o que os materiais ensinam: se o material deriva, vá até explain; se fizer exemplos, vá até apply. Para autodidata, defina pelo objetivo do usuário.

4. Construir o Grafo

Forme um grafo direcionado acíclico (DAG). Se aparecer um ciclo, é sinal de que a extração está errada; refaça.
Para Acompanhamento de Curso: organize por semana; dentro da semana, por dependência. Para Autodidata: organize completamente por dependência.
Use Mermaid flowchart para o grafo de módulos: linhas sólidas para pré-requisitos obrigatórios, linhas tracejadas para uso de apenas um conceito (especifique qual); cores para distinguir importância; números de identificação nos nós. Abaixo do grafo, um parágrafo resumindo as principais linhas.

5. Confirmar o Grafo Antes de Gerar

O principal a ser confirmado pelo usuário é o grafo de conhecimento, não a rota de módulos. Procedimento: primeiro, extraia todos os pontos de conhecimento, um por um, e embaralhe; a partir dos pontos exigidos pelas questões da prova (ou objetivo de aprendizado), encontre seus pré-requisitos, pré-requisitos dos pré-requisitos, etc., formando o grafo. As relações de pré-requisito devem cruzar módulos (ex., uma questão do Módulo 8 usa ferramentas do Módulo 7, conceitos de disciplinas anteriores), para que a explicação da página seja mais fluida que a dos materiais escolares.
A numeração dos pontos de conhecimento segue a ordem de "pré-requisito imediato": cada pré-requisito é colocado exatamente antes de seu primeiro uso; não empilhe todo o conteúdo introdutório no início.
Você pode publicar primeiro uma versão da página contendo apenas Mapa, Prova e Trilha de Aprendizado, para que o usuário confirme diretamente no grafo interativo; após a confirmação, gere as aulas e o banco de questões em lotes.
Conhecimentos pré-requisitos também podem ser transformados em disciplinas separadas por fonte (ex., "Matrizes e Posto (Pré-requisito Rápido)"), com cada disciplina listando no passo 0 "Verifique se você já domina isso (de outras disciplinas)" e fornecendo links.
Peça ao usuário para confirmar o grafo apenas quando ele puder avaliar: usuários com slides, escopo da prova ou conhecimento básico relevante podem confirmar. Não peça confirmação a iniciantes, pois eles não podem julgar; a IA verifica com os slides ou fontes autoritativas e insere diretamente na página.
Ao pular a confirmação (seja por o usuário ser iniciante ou por falta de tempo), o grafo ainda é gerado e colocado na seção Mapa.

Quatro.2. Sem Materiais: Planejar o Roteiro Primeiro

1. Esclarecer o Objetivo

Até que nível deseja aprender, para que finalidade (ler artigos, fazer projetos, entrevistas, interesse)
Se tem conhecimento básico relacionado
Quanto tempo por semana

Não pergunte se puder inferir da conversa.

2. Pesquisar

Com acesso à internet, encontre recursos reconhecidos na área: cursos abertos universitários (página do curso, slides, vídeos), livros clássicos, documentação oficial, revisões. Priorize fontes originais e autoritativas; anote os links e os capítulos ou aulas específicos.
Compare os currículos de 2–3 fontes autoritativas, resuma as principais áreas, quais são básicas, quais são avançadas e as relações de precedência entre elas.

3. Apresentar o Roteiro de Aprendizado e Pedir Confirmação

Panorama da Área: quais são as principais áreas; para o objetivo do usuário, quais são obrigatórias e quais podem ser deixadas para depois.
Verificação de Pré-requisitos: quais bases são necessárias. Se o usuário não tiver certeza do que sabe, forneça 3–5 questões de diagnóstico; ajuste o ponto de partida com base nos resultados.
Recurso Principal: recomende um curso ou livro como linha principal, os demais como complemento, explicando o motivo (autoridade, dificuldade adequada, disponibilidade gratuita).
Roteiro por Fases: cada fase deve especificar:
- Objetivo de aprendizado (verificável)
- Conceitos principais
- Recursos recomendados (capítulos ou aulas específicos, com links)
- Tempo estimado
- Forma de verificação da fase
Explique entre as fases "o que a fase anterior resolveu e qual novo problema esta fase vai resolver".
Peça ao usuário para confirmar o objetivo, o tempo e o recurso principal. O grafo de conhecimento não precisa de confirmação do usuário: a IA verifica com fontes autoritativas e insere diretamente na página.

4. Após a Confirmação do Roteiro, Criar a Página

A trilha de aprendizado é o mapa. Os materiais pesquisados são registrados como fontes (type web ou textbook), e cada ponto de conhecimento é marcado com sua fonte.
A explicação é escrita pela IA com base nessas fontes; fatos e fórmulas críticas devem ser verificados, com links originais fornecidos para leitura aprofundada.
Quando o usuário obtiver posteriormente livros, transcrições ou slides, trate como novos materiais e faça uma atualização incremental (Seção 5): adicione fontes, aprofunde o nível, não recomece do zero.

5. Abordagem de Ensino Gradual

Cada passo começa com uma pergunta, fenômeno ou necessidade. Primeiro, faça o usuário pensar; ele pode escolher um palpite; depois, revele a resposta e a lógica.
Cada passo é pequeno, usando o que já foi aprendido para introduzir algo novo.
Para partes difíceis, comece com o caso particular mais simples e depois generalize.
Ao final de cada fase, faça um resumo: agora você pode fazer o quê, e quais problemas o conhecimento atual não resolve (que serão abordados na próxima fase).

Quatro.3. Introdução Leve (Duração Total < 3 horas)

1. Como Determinar

Se as duas condições a seguir forem atendidas, trate como introdução leve:

O usuário pergunta sobre um conceito ou tópico pequeno, como "O que é X", "Introdução ao X", "Quero saber sobre X"
O tempo total estimado de estudo é menor que 3 horas, aproximadamente não mais que 15 pontos de conhecimento, 1–3 aulas

Acima disso, mude para "Aprendizagem Autodidata" ou "Planejamento do Zero".

2. Fluxo

Não faça perguntas, a menos que o próprio tópico não esteja claro.
Não envie roteiro para confirmação: defina os pontos de conhecimento e a ordem por conta própria e gere a página diretamente.
Quando não souber o nível do usuário, considere-o um "iniciante inteligente". Os pré-requisitos necessários não exigem estudo prévio; no passo 0, forneça uma "cola de pré-requisitos": explique cada pré-requisito em uma frase.
Com acesso à internet, use a pesquisa para verificar fatos e fórmulas críticas e forneça links nas fontes.

3. Página Simplificada

Mantenha apenas três seções:
- Aula: 1–3 aulas, cada uma com 5–10 passos
- Prática: 1–2 questões por ponto de conhecimento
- Mapa Simplificado: grafo pequeno de conhecimento, incluindo pré-requisitos (ex., ao estudar API: cliente, servidor, HTTP), mais uma linha principal
Sem seções de Prova, Simulados, Provas Anteriores, cronômetro, fila de revisão ou código de progresso.
Ainda preservado:
- Comece com a intuição, depois a definição, um exemplo ao longo de toda a aula
- Caixa "Em português claro" (para disciplinas de exatas)
- Narrativa lógica ao final de cada aula
- Critério de domínio para cada ponto de conhecimento e autoavaliação, com explicações direcionadas quando errar
A última página deve conter "O que aprender a seguir". Se o usuário quiser se aprofundar, pode evoluir para "Aprendizagem Autodidata" ou "Planejamento do Zero", expandindo na mesma página. Portanto, o curso.json também deve ser salvo normalmente neste momento.

Cinco. Atualização Incremental (Semanal ou Quinzenal)

Leia curso.json e os novos materiais.
Extraia os pontos de conhecimento dos novos materiais e compare um a um com os pontos existentes, classificando em uma das situações abaixo:

Situação	Tratamento
Conteúdo completamente novo, pré-requisitos já existentes	Adicione
Extensão ou aprofundamento de um ponto de conhecimento existente	Crie um novo ponto de conhecimento, com o antigo como pré-requisito `duro`; não o coloque dentro do antigo
Mesma coisa que um ponto de conhecimento existente	Não crie novo. Adicione a nova fonte ao ponto antigo; se a profundidade aumentou, atualize `depth`
O professor corrigiu conteúdo anterior	Modifique o ponto antigo, escreva em `alterado`, adicione a marca "Corrigido" na página
Pré-requisito adicionado posteriormente (o novo conteúdo é, na verdade, a base de um ponto antigo)	Adicione este pré-requisito; adicione a aresta de pré-requisito ao ponto antigo. Aulas já publicadas não são reordenadas; na nova aula, adicione um cartão "Revisão" com link para o ponto antigo, explicando como agora pode ser compreendido de forma diferente
Conflito entre materiais novos e antigos (notação ou terminologia diferente)	Registre ambas as versões, marque como "A confirmar"; na entrega, pergunte ao usuário qual versão usar
Após adicionar arestas, surge um ciclo	Divida o ponto de conhecimento que estava muito agregado; marque o ID antigo como `mesclado`, apontando para os novos IDs
Novo tópico	Crie um novo módulo. Se o novo conteúdo puder ser encaixado em um módulo existente, expanda esse módulo; não renomeie módulos aleatoriamente

Validação: todos os IDs apontados por pre existem e estão ativos; o grafo não tem ciclos; nenhum ponto de conhecimento aparece antes de seu pré-requisito duro (exceto para pré-requisitos adicionados posteriormente, mas com cartão de revisão).
Pontos de conhecimento com conteúdo alterado devem receber a marca "Atualizado, recomendamos revisar", preservando as marcações originais do usuário.
Escreva no registro_alteracoes e exiba no painel "Atualização desta semana" do Mapa: quantos foram adicionados, quantos foram corrigidos, quantos pré-requisitos foram adicionados posteriormente, quais estão "A confirmar".
Regere a página e escreva de volta na mesma pasta da página da web (se for uma versão hospedada, publique no mesmo endereço); o caminho ou link do usuário permanece inalterado.

Seis. Preparação para Prova

1. Usar a Prova como Âncora, Reverter para os Pontos de Conhecimento

Classifique os materiais por prioridade: Alvo são as provas modelo ou provas de anos anteriores com gabarito oficial, Referência são outras provas e trabalhos, Linha principal ainda são os slides, tutoriais e laboratórios como complemento.
Divida as questões: cada questão é dividida em subquestões, depois em habilidades que ela testa; liste "pontos de conhecimento necessários para acertar esta subquestão".
Escopo reverso: a partir desses pontos de conhecimento, siga os pré-requisitos duros para trás, obtendo todos os pontos de conhecimento necessários para a prova. Pontos fora desse escopo são rebaixados para secundários ou não relevantes.
Calibração da profundidade: defina a profundidade com base na forma como a questão é feita. Quando o mesmo ponto de conhecimento é testado em várias questões, use o nível mais profundo:
- Julgamento, escolha → recall
- Explicação, comparação, por quê → explain
- Cálculo, escrita de código, desenho, execução passo a passo → apply
- Novo cenário, integração, design → transfer
Verificação de lacunas:
- Conteúdo necessário para a prova, mas não presente nos slides → escreva uma explicação de senso comum, marque "Não presente nos slides"
- Conteúdo presente nos slides, mas explicitamente excluído pelo edital da prova → marque como "Não cai na prova"
- Conteúdo que caiu em anos anteriores, mas não está nos slides deste ano → liste separadamente
Escreva os resultados na seção Prova: tabela por questão (questão → pontos de conhecimento → peso), tabela de peso dos módulos, lista do que não cai, comentários do professor (com data), padrões de provas anteriores, modelos de resposta gerais.
Trilha de aprendizado: divida de acordo com o tempo disponível do usuário. As aulas sempre são organizadas por módulo do curso (um módulo, uma aula; pré-requisitos também são aulas separadas por fonte), para reuso futuro; a trilha de aprendizado apenas referencia os passos das aulas ("Hoje, estude os passos X da aula Y"), não divide aulas por dia. Cada segmento lista os números a serem estudados, explica por que estão ali e com quais questões verificar o aprendizado. A versão intensiva inclui uma versão mínima alternativa e lista os números que "podem ser cortados primeiro"; a versão aprofundada é organizada por dia, incluindo conteúdo novo e revisões programadas.

2. Versão Intensiva vs. Versão Aprofundada

	Versão Intensiva	Versão Aprofundada
Escopo	Essencial e Importante	Todos os pontos do escopo reverso
Explicação	Até o suficiente para resolver as questões	Explicar completamente no nível calibrado; para nível `transfer`, incluir variações
Prática	Testar diretamente com provas reais	Primeiro fazer simulados; depois de proficiente, fazer as provas reais
Provas Anteriores	Usar durante o estudo	Lacradas: só desbloquear questões correspondentes após atingir proficiência nos simulados daquele tipo; no final, simular com tempo total

Quando o tempo for insuficiente, corte na seguinte ordem: primeiro, reduza a explicação de pontos secundários; depois, reduza a quantidade de questões; por último, comprima os passos das aulas. O grafo e a seção Prova não devem ser cortados.

3. Simulados (Obrigatório na Versão Aprofundada)

Para cada tipo de questão da prova, crie 3–6 simulados: testam as mesmas habilidades, com cenários e dados diferentes, dificuldade não inferior à da prova real. Cada um deve ser marcado com o tipo de questão da prova real correspondente (ex., "Tipo Prova Modelo 2 Q2D") e as habilidades testadas.
Ordem de criação: primeiro, questões de habilidade única; depois, questões de habilidades combinadas; por último, questões com o mesmo nível de integração das provas reais.
Após a conclusão de cada módulo, inclua imediatamente os simulados desse módulo.
Os simulados são colocados na página de Prática, com a etiqueta "Simulado", sem seção separada.

4. Manual de Provas Anteriores

Os módulos são ordenados pelo peso na prova; o Módulo 0 é sobre informações da prova e estratégia de resposta; cada módulo começa com uma caixa "Obrigatório saber".
Cada questão inclui: etiqueta de nível (Gabarito oficial / Gabarito deduzido, deduzido marcado como não oficial), fonte e peso, questão original, tradução para o português (quando a prova for em inglês), raciocínio, resposta em modo recolhido por padrão, caixa de seleção "Dominado". Cada subquestão usa o cartão de questão padrão do site.
Quando a prova é em inglês, primeiro forneça uma resposta pronta para copiar, depois explique em português por que respondeu assim.
Um cronômetro para a prova inteira (com tempo predefinido, pode pausar e limpar) e um interruptor "Expandir / Recolher todas as respostas". Não implemente funcionalidades de uso raro, como cronômetro por questão, realce de texto, categorização de erros.

5. Rascunho do Cheat Sheet (Adicione sempre que a prova permitir consulta)

Uma linha de entrada no topo da página: cole o texto e pressione Enter para salvar; LaTeX é renderizado automaticamente; pode colar imagens diretamente (armazenadas como data URL). Colar em qualquer lugar da página Cheat Sheet também salva.
Cada item registra o contexto da colagem (qual aula, qual passo, qual ponto de conhecimento). Os itens são armazenados no localStorage.
Botão "Copiar tudo (para usar com IA)": o usuário envia o conteúdo com o contexto para a IA, que organiza as anotações soltas em itens legíveis (título + corpo, explicação em português, termos em inglês preservados, fórmulas em LaTeX) e os escreve de volta nos dados da página; o texto original é preservado, com alternância de visualização.
Cartão clicável para seleção (multisseleção), menu de contexto "Remover selecionados" (com confirmação dentro da página, não confirm()); no celular, use botões da barra de ferramentas. A remoção é suave: pode ser desfeita com a barra de notificação ou recuperada de "Removidos Recentemente".
Uso: ao criar a folha de consulta, o conteúdo do rascunho é colocado como a "parte menos consolidada" em uma pequena seção; o restante é gerado automaticamente pela IA com base no curso.

Sete. Escrita da Explicação

Comum a todos os tipos

Cada aula começa com o passo 0: qual problema esta aula resolve; após estudar, você deve ser capaz de... (lista de itens verificáveis).
Primeiro, a intuição; depois, a definição; em seguida, um exemplo. Um exemplo percorre toda a aula, sendo reutilizado nos passos seguintes.
Frases curtas, em linguagem clara, sem rodeios. Explicação em português, preservando termos originais em inglês; quando a prova é em inglês, cada passo marca as palavras-chave em inglês.
A aula exibe apenas um passo por vez; botões "Anterior" / "Próximo" no rodapé. No topo do cartão: "Passo N · Tempo estimado: M minutos · ID do ponto de conhecimento · Termo em inglês".
Barra lateral em três níveis, claramente distinguíveis e sem aglomeração:
- Unidade (Pré-requisitos, Módulo X……): título dobrável, com cor de fundo e progresso; apenas a unidade atual é expandida por padrão; registre apenas as ações de expandir/recolher feitas manualmente pelo usuário (não trate o toggle de inicialização do <details> como ação do usuário)
- Aula: uma linha por aula, bolinha colorida do módulo à esquerda, etiqueta de progresso à direita; a aula atual é destacada com borda; aulas não geradas ficam esmaecidas
- Passos: expandido apenas dentro da aula atual, conectados por uma linha vertical do tempo; cada passo tem um círculo numerado à esquerda (✓ quando concluído), fonte menor, tempo à direita; o botão "Narrativa desta aula" fica acima da lista de passos
No cartão, use os seguintes blocos de conteúdo conforme necessário:
- Caixa de fórmula/definição principal
- Caixa "Em português claro"
- Caixa de exemplo
- Caixa de ponto de prova: marque a fonte; ao clicar "Próximo", expanda linha por linha
- Caixa de ponto cego comum
- Caixa de escrita de resposta
- "Apenas para saber" (fonte pequena)
- Cartão de revisão (para atualizações incrementais)
- Autoavaliação
Mesmo na preparação para a prova, o assunto deve ser explicado de forma compreensível: as provas modelo representam apenas os tipos de questão e exemplos típicos, não significam que o que está fora do escopo não vai cair. O objetivo é aprender; a prova é apenas um teste.
- A motivação de "Por que aprender isso agora" deve ser motivação da disciplina (qual problema o passo anterior deixou, como este passo resolve), não "porque vai cair na prova"; a fonte da questão é listada separadamente no final do passo
- Pontos de conhecimento fora do escopo da prova ainda são colocados na aula e explicados claramente, apenas marcados como secundários

Formato Fixo para a Explicação de Cada Passo

Cada passo segue a ordem abaixo. Pule os itens que não se aplicam, mas não altere a ordem:

Por que aprender agora: uma frase, com a motivação da disciplina (qual problema o passo anterior deixou, como este passo resolve)
Intuição: 1–3 frases, ou use números concretos do exemplo contínuo para levantar a questão
Caixa de definição / fórmula principal: a fórmula em linha separada, centralizada
Em português claro: logo abaixo da fórmula, primeiro explique símbolo por símbolo (o que é, forma: número/vetor/matriz, aleatório ou fixo), depois uma frase sobre "como o resultado muda quando uma variável aumenta"
Caixa de exemplo: use o exemplo contínuo, substitua números e calcule, uma linha por passo
Caixa de ponto cego comum (se houver)
Autoavaliação: 1–2 questões, exatamente para verificar o critério de domínio deste passo
Fonte da questão: no final, em letras pequenas, liste as subquestões da prova real que testam este passo

Formatação e Notação Fixas (Referência: Aula de Revisão MAST90138)

Em linha ou em bloco: símbolos curtos em linha ( $\hat\beta_1$ ); definições, fórmulas principais e conclusões a serem memorizadas em bloco centralizado.
Cadeia de dedução: use aligned, alinhamento pelo sinal de igual, cada linha com \quad\text{(justificativa)} para uma justificativa curta; inequações ou fórmulas muito longas também usam aligned com várias linhas, para não quebrar o cartão.
Cálculo numérico em três etapas fixas: primeiro a fórmula → depois a substituição dos números → depois o resultado, com 3–4 algarismos significativos; todos os valores numéricos verificados com código.
Use apenas \text{} para palavras curtas em fórmulas, não frases longas em português.
Use LaTeX genuíno para notação, consistente com os slides: vetores e matrizes em negrito (\mathbf{X}, \boldsymbol\beta); onde necessário, use caligráfico (informação de Fisher \mathcal I, modelo \mathcal M, distribuição normal \mathcal N); operadores e nomes de distribuições em fonte romana (\operatorname{Var}, \mathrm{SS}_{\text{res}}, \mathrm{Bin}). Não use Unicode para montar fórmulas (XᵀX, β̂, F(2,4) etc.); isso também se aplica a títulos de pontos de conhecimento, critérios de domínio, opções, dicas e traduções de provas. Apenas os rótulos dos nós do grafo SVG podem ser em texto puro.
Defina um conjunto de macros no MathJax (ex., \X, \bb, \SSres, \FI), compartilhado em todo o site, garantindo consistência; ao usar \boldsymbol, carregue o pacote boldsymbol. Strings LaTeX em Python sempre usem r"…".
Nas fórmulas, não escreva diretamente < ou >: quando os dados são inseridos na página via innerHTML, <p em $\rk(\X)<p$ é interpretado pelo navegador como o início de uma tag HTML, engolindo o trecho seguinte e expondo código incompleto como $\rk(\X). Ao gerar a página, processe uniformemente: percorra todas as strings de dados

…

[truncado para tradução]

Perguntar na sua IA favorita

Documentação