I built a workflow that forces AI agents to teach you the code they write

As a developer, I got a bit scared and fed-up of blindly merging massive pull requests and losing context on my own codebase, so I built FluencyLoop.

https://github.com/baokhang83/fluencyloop

It is an open-source, local-first workflow plugin for Claude Code and Codex that ensures your code and your codebase fluency are produced together.

Instead of letting an agent dump raw code, it tracks your technical familiarity locally and pauses to explain complex architectural choices or rejected alternatives only on topics you do not know yet. It also produces documentation and tracks the decisions it makes along the way.

Try it out ! It feels really good to get the AI caring for my understanding 🤣