← all repositories
EricJujianZou/rederive

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.

★1.2k stars Python Coding AssistantsLearning
rederive
Too new to rank. Velocity needs a few days of history.
not enough history yet
star history

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.md noting 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, bash and python3 on 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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.