The Socratic method, now available for your AI-written codebase
rederive is a coding-agent skill that refuses to explain your repo to you — instead it quizzes you until you re-derive every design decision yourself.

What it does It’s a skill for Claude Code, Codex, Cursor and roughly 75 other agents that turns any repo — yours or a stranger’s — into a guided re-design exercise. It asks how you would build each part of the system, adds constraints as you answer, and only reveals the actual design once you’ve worked your way there. The pitch is aimed squarely at people who shipped AI-generated code and now need to explain it in an interview or to a coworker.
The interesting bit
While you’re answering questions, a background agent maps the repo: code, import links between files, and the commits where the design changed. It deliberately ignores commit messages, so repos assembled by an AI in three giant commits still get a coherent map. The map holds 5–10 problems in build order, stored in .rederive/map.md — which you’re told not to peek at, because it contains the answers.
Key highlights
- Works on your own repos or any public one (it clones a GitHub URL and starts asking)
- Won’t explain things on purpose — derivation over memorization
- When you’re stuck, it narrows to a few candidate approaches; after two wrong answers it offers to sketch the problem
- Keeps a session log in
.rederive/log.mdnoting where you struggled and what you solved alone - Fully local: no telemetry, and
.rederive/is auto-added to git’s local exclude so it never leaks into commits
Caveats
- Requires
git,bashandpython3on your machine - The “map” quality depends on the background agent’s analysis; the README doesn’t say how it handles very large or polyglot repos
Verdict Worth a look if you’ve vibe-coded something you can’t defend, or you want to onboard onto an unfamiliar open-source repo with actual retention. If you just want answers fast, this tool’s whole personality will annoy you.
Frequently asked
- What is EricJujianZou/rederive?
- rederive is a coding-agent skill that refuses to explain your repo to you — instead it quizzes you until you re-derive every design decision yourself.
- Is rederive open source?
- Yes — EricJujianZou/rederive is open source, released under the MIT license.
- What language is rederive written in?
- EricJujianZou/rederive is primarily written in Python.
- How popular is rederive?
- EricJujianZou/rederive has 1.2k stars on GitHub.
- Where can I find rederive?
- EricJujianZou/rederive is on GitHub at https://github.com/EricJujianZou/rederive.