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

 (github.com/TaewoooPark)
20 puan yazan theoverstructure 2026-05-26 | 11 yorum | WhatsApp'ta paylaş

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!

İlgili okumalar

11 yorum

 
theoverstructure 10 일 전

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

Artık OpenCode ve Hermes'te de PAIDEIA'yı kullanabilirsiniz!
 
hanjk94 27 일 전

HTML desteği de olsa iyi olurdu.
 
theoverstructure 27 일 전

Güzel bir fikir. Böyle yaparsanız grafikler veya bazı figürler de dahil edilebilir. Fikir için teşekkürler!
 
memevibe82 29 일 전

Profesörlerin beyinlerini örüntü tanımayla çözmüşler demek vay be
 
theoverstructure 29 일 전

Haha, olumlu bakmanız için teşekkür ederim!
 
theoverstructure 29 일 전

Gönderiyi paylaşan benim! README biraz uzun olduğu için, hızlıca anlaşılabilecek 30 saniyelik bir demo GIF’i ve sample-course çıktısını eklemeyi düşünüyorum.

Bundan önce birçok kişiden tavsiye almak istiyorum!

  1. Claude Code plugin formatının kullanım eşiği oluşturup oluşturmadığı
  2. PDF → pattern çıkarımı → zayıflık haritası → cheat sheet akışının gerçek sınav çalışmasında işe yarar görünüp görünmediği
  3. Markdown artifact olarak bırakılan local-first yapının cazip olup olmadığı

Görüşlerinizi paylaşırsanız hemen değerlendireceğim! Teşekkürler
 
toida 29 일 전
  1. durumda akış iyi görünüyor ama gerçek çıktının ne kadar iyi olacağını görmek heyecan verici.
 
theoverstructure 29 일 전

Güncelleme!

Tavsiye ettiğiniz gibi README’ye gerçek çalışma akışını gösteren bir demo videosu ekledim. Linkten inceleyebilirsiniz! https://github.com/TaewoooPark/PAIDEIA

  • PAIDEIA’nın hangi problemi çözmeye çalıştığını hızlıca gösteren açılış demosu
  • Claude Code terminalinde eklentiyi doğal dille çalıştırıp course materials → analiz → weakmap/cheatsheet akışıyla devam eden gerçek kullanım demosu
  • Ortaya çıkan çıktının uygulamanın içinde sıkışıp kalmayıp Markdown artifact olarak kalması yapısını da README’de doğrudan görülebilecek şekilde düzenledim

Özellikle “gerçek çıktıların ne kadar üretildiğini merak ediyorum” şeklinde geri bildirimler olduğu için, basit bir açıklama yerine gerçek terminal etkileşimini ve üretilen öğrenme çıktılarının görünmesini sağlayacak şekilde güçlendirdim.

Geri bildirim vermeye devam ederseniz hemen yansıtacağım. Teşekkürler!
 
theoverstructure 29 일 전

Ben de bunu kişisel olarak öğrenmede aktif şekilde kullanıyorum! Özellikle kullandıkça zayıf yönlerim biriktiği için, kullanım süresi uzadıkça daha kişiselleşmesini hissedilir biçimde deneyimlediğimi düşünüyorum.
 
toida 29 일 전

Codex ya da Gemini desteği de olursa güzel olur gibi~ haha
 
theoverstructure 29 일 전

Görüşünüz için teşekkürler! codex şu anda ayrı bir repo olarak destekleniyor! (https://github.com/TaewoooPark/PAIDEIA-codex) Gemini CLI’ı geliştirmeyi de değerlendireceğiz.