PAIDEIA — plugin do Claude Code feito por um aluno de dupla graduação em Física & Matemática da KAIST, voltado exclusivamente para estudar para provas

PAIDEIA – um plugin local-first para Claude Code que cria uma base de conhecimento para preparação de provas a partir dos seus materiais de aula

Faço dupla graduação em Física e Matemática na KAIST. Enquanto estudava para provas, vi amigos jogando PDFs inteiros no GPT e comecei a pensar em uma forma mais eficiente; acabei criando meu próprio plugin e o publiquei como open source!

A maioria dos estudantes coloca materiais de aula, tarefas, soluções e provas anteriores de uma vez só em um LLM e pede: “me explica”, “resume”, “cria questões prováveis”. Mas, no estudo real para provas, o importante não é um simples resumo, e sim acompanhar continuamente os padrões de resolução que se repetem naquela disciplina, o estilo de tarefas do professor, os pontos em que eu erro com frequência e as partes com maior chance de cair na prova. Foi por isso que criei o PAIDEIA.

O PAIDEIA foi projetado com uma abordagem local-first para o Claude Code. Se você colocar PDFs de materiais de aula, tarefas e soluções na pasta da disciplina, ele gera uma base de conhecimento de preparação para provas dedicada apenas àquela matéria.

Funcionalidades

• Converte PDFs de materiais de aula/HW/soluções em Markdown
• Extrai padrões de resolução recorrentes das soluções
• Destaca áreas com alta probabilidade de cair na prova com base na cobertura das tarefas
• Gera cartões de padrões, mapa de pontos fracos e cola de uma página
• Gera twin variants de problemas existentes
• Gera provas simuladas
• Lê PDFs de respostas resolvidas à mão via OCR e corrige comparando com a reference solution
• Acumula padrões de erro para refletir isso nos próximos drills e na cola
• Salva todos os resultados como Markdown puro

Contexto

O que universitários precisam não é de “um tutor de IA mais gentil”, e sim de um sistema de estudo por disciplina que continue acumulando meus materiais de aula e meus erros.

As provas geralmente estão mais ligadas ao estilo de um professor específico e à distribuição das tarefas do que ao conhecimento geral. Mesmo no mesmo conceito, importa como a questão costuma ser cobrada, quais padrões de resolução se repetem e em que ponto eu costumo travar. Por isso, o PAIDEIA é mais próximo de um grafo de estudo editável do que de um chatbot conversacional. Quando você erra uma questão, esse erro fica registrado no mapa de pontos fracos e é refletido nos próximos exercícios e na cola.

Local-First

Os resultados não ficam presos dentro de um app específico. Eles permanecem como arquivos Markdown dentro da pasta de cada disciplina e podem ser abertos normalmente em ferramentas como o Obsidian. No OCR, por padrão, é possível usar o fluxo de visão do Claude/Codex e, opcionalmente, também conectar Qwen3-VL ou Tesseract.

Estou compartilhando porque quero validar as funcionalidades com o uso de muitos estudantes de engenharia e áreas afins!

[theoverstructure]

https://github.com/OPTIMETA/PAIDEIA-opencode
https://github.com/OPTIMETA/PAIDEIA-Hermes

Agora você também pode usar o PAIDEIA no OpenCode e no Hermes!

[hanjk94]

Seria bom se também suportasse HTML.

[theoverstructure]

Boa ideia. Assim, acho que também daria para incluir gráficos e algumas figuras. Obrigado pela ideia!

[memevibe82]

Parece que reconheceram os padrões do cérebro dos professores, hein kkk

[theoverstructure]

Hehe, obrigado por ver com bons olhos!

[theoverstructure]

Sou o autor! Como o README é um pouco longo, estou pensando em adicionar um GIF de demonstração de 30 segundos e os resultados do sample-course para facilitar o entendimento rápido.

Antes disso, gostaria muito de pedir conselhos de vocês!

1. Se o formato de plugin do Claude Code representa uma barreira de uso
2. Se o fluxo PDF → extração de padrões → mapa de pontos fracos → cola parece realmente útil para estudar para provas
3. Se a estrutura local-first, que deixa tudo registrado como artifact em Markdown, é atraente

Se vocês deixarem suas opiniões, vou analisar tudo imediatamente! Obrigado.

[toida]

No caso da opção 2, o fluxo parece bom, mas fico curioso para ver qual vai ser o nível real do resultado gerado.

[theoverstructure]

É uma atualização!

Como vocês sugeriram, adicionei ao README um vídeo de demonstração mostrando o fluxo real de funcionamento. Dá para conferir pelo link! https://github.com/TaewoooPark/PAIDEIA

• um opening demo que mostra rapidamente que tipo de problema o PAIDEIA tenta resolver
• uma demo de uso real em que o plugin é executado em linguagem natural no terminal do Claude Code, seguindo o fluxo course materials → análise → weakmap/cheatsheet
• também organizei o README para que dê para ver de imediato que os resultados não ficam presos dentro do app, mas permanecem como artifacts em Markdown

Em especial, houve feedback de que "queriam ver mais ou menos qual é o nível do output real", então reforcei isso para que, em vez de uma explicação simples, seja possível ver a interação real no terminal e os materiais de estudo gerados.

Se continuarem enviando feedback, vou refletir tudo imediatamente. Obrigado!

[theoverstructure]

Pessoalmente, tenho usado isso ativamente nos meus estudos! Principalmente porque, quanto mais eu uso, mais minhas fraquezas vão se acumulando, então sinto bastante que ele vai ficando mais personalizado com o tempo de uso.

[toida]

Seria legal se também tivesse suporte para o codex e o gemini~ haha

[theoverstructure]

Agradecemos pela opinião! No momento, o codex está disponível em um repositório separado! (https://github.com/TaewoooPark/PAIDEIA-codex) Também vamos considerar desenvolver uma versão para o Gemini CLI.