PAIDEIA — KAIST Fizik ve Matematik çift anadal öğrencisinin geliştirdiği, sınav çalışmaya özel Claude Code eklentisi

PAIDEIA – Kendi ders materyallerimle sınava hazırlık bilgi tabanı oluşturan, local-first Claude Code eklentisi

KAIST'te fizik ve matematik çift anadal yapıyorum. Sınava çalışırken arkadaşlarımın PDF'leri olduğu gibi GPT'ye yüklediğini görünce daha verimli bir yöntem üzerine düşündüm; bunun üzerine eklentiyi kendim geliştirip açık kaynak olarak yayımladım!

Öğrencilerin çoğu ders materyallerini, ödevleri, çözümleri ve geçmiş sınav sorularını aynı anda LLM'e yükleyip “açıkla”, “özetle”, “muhtemel soru üret” gibi isteklerde bulunuyor. Ancak gerçek sınav hazırlığında önemli olan şey basit bir özet değil; o derste tekrar eden çözüm kalıplarını, hocanın ödev stilini, benim sık hata yaptığım noktaları ve sınavda çıkma olasılığı yüksek bölümleri sürekli takip etmektir. Bu yüzden PAIDEIA'yı yaptım.

PAIDEIA, Claude Code için local-first yaklaşımını benimsiyor. Ders materyalleri, ödev ve çözüm PDF'lerini ders klasörüne koyduğunuzda, yalnızca o derse özel bir sınava hazırlık bilgi tabanı oluşturuyor.

Özellikler

• Ders materyali/HW/çözüm PDF'lerini Markdown'a dönüştürme
• Çözümlerde tekrar eden çözüm kalıplarını çıkarma
• Ödev kapsamına göre sınavda çıkma olasılığı yüksek alanları işaretleme
• Pattern card, zayıflık haritası ve tek sayfalık cheat sheet oluşturma
• Mevcut soruların twin variant sürümlerini üretme
• Deneme sınavı oluşturma
• Elle çözülmüş cevap PDF'lerini OCR ile okuyup reference solution ile karşılaştırarak puanlama
• Hatalı kalıpları biriktirip sonraki drill ve cheat sheet'e yansıtma
• Tüm çıktıları plain Markdown olarak kaydetme

Arka plan

Üniversite öğrencilerinin ihtiyaç duyduğu şey “daha nazik bir yapay zeka öğretmeni” değil, benim ders materyallerimi ve benim hatalarımı sürekli biriktiren ders bazlı bir öğrenme sistemidir.

Sınavlar genellikle genel bilgiden çok belirli bir hocanın tarzına ve ödev dağılımına daha sıkı bağlıdır. Aynı kavram için bile hangi biçimde soru sorulduğu, hangi çözüm kalıplarının tekrar ettiği ve benim en çok nerede takıldığım önemlidir. Bu yüzden PAIDEIA, etkileşimli bir sohbet botundan ziyade düzenlenebilir bir öğrenme grafiğine daha yakındır. Bir soruyu bir kez yanlış yaptığınızda, bu hata zayıflık haritasında kalır ve sonraki alıştırma sorularına ve cheat sheet'e yansır.

Local-First

Çıktılar belirli bir uygulamanın içine hapsolmaz. Ders bazlı klasörlerde Markdown dosyaları olarak kalır ve Obsidian gibi araçlarda da olduğu gibi açılabilir. OCR için varsayılan olarak Claude/Codex'in vision akışı kullanılabilir; isteğe bağlı olarak Qwen3-VL veya Tesseract da bağlanabilecek şekilde tasarlandı.

Birçok mühendislik öğrencisi tarafından kullanılarak özelliklerinin doğrulanmasını istediğim için paylaşıyorum!