Context-Engineered Study System for Claude Code Acts as Persistent Tutor

Persistent Study System for Claude Code

A developer has created a context-engineered study system that transforms Claude Code into a persistent tutor across sessions. The system tracks progress, probes understanding, works through exercises with users, and adapts to individual learning styles over time.

System Architecture and Files

The system uses structured markdown files to shape agent behavior:

• CLAUDE.md defines the five-step study process: user notes → agent notes → recall check → exercises → contextualization
• profile.md tracks user identity, strengths, gaps, and learning methods — updated by the agent over time
• progress.md tracks exactly where users left off so the agent can resume there in the next session

Session logs and recall check results carry forward between sessions, allowing the agent to remember previous struggles. The system includes a pdf_pages.py tool that lets the agent extract specific chapter pages from full book PDFs.

Setup and Usage

New users clone the repository, run pip install pymupdf, then execute claude. The agent detects fresh starts and walks users through setup. The system is oriented around textbooks, with the developer noting that forcing the agent to read book chapters grounds it in structured learning that regular sessions lack.

Adaptive Features

At the end of every session, the agent reflects on the study process itself and proposes changes, causing the CLAUDE.md file to evolve based on what actually works for each user. A process changelog tracks how the system improves over time. The developer plans to push updates based on personal improvements but notes that anyone can maintain their own version.

Applications and Configuration

The system is generalizable to any technical book but can also be used for interview preparation and LeetCode practice. The .gitignore file is configured so personal data (profile, progress, session history, PDFs) stays local while the system itself remains shareable. While currently textbook-oriented, the developer suggests it could be tweaked for project-based learning.