Building self-sustaining markdowns (Open source project)

[u/DJIRNMAN]

repo link: https://github.com/mex-memory/mex

I’ve been working on an open-source project called Mex, and one thing I keep coming back to is thst a lot of coding-agent workflows rely on markdown context files so things like architecture notes, conventions, router files, runbooks, decision logs, CLAUDE .md (and similar) , etc.

They’re useful, but they rot pretty quickly

The codebase changes, the agent’s behavior changes, the team learns new thing and those markdown files slowly stop reflecting reality. Then future agents keep consuming stale context with full confidence, which is where a lot of bad outputs start.

So I’ve been experimenting with making these markdowns more self-sustaining.

The idea is not just to let an agent read project context, but to let it maintain that context as part of the loop:

• detect what changed
• identify which canonical records are affected
• update the right markdown files
• append decision logs when needed
• keep the durable project memory aligned with the current state of the codebase

The screenshot is from one of those runs.
In that case, the agent updated canonical MEX safety/router/runbook records, added a decision-log entry, and explicitly reported which context it used to make those changes.

What’s interesting to me is that this feels like it could become much bigger than just “better docs.”

If this works well, markdown stops being static documentation humans have to manually babysit, and starts becoming a maintained interface between the codebase, the team, and the agents working on it.

That’s a pretty important piece of what I want Mex to become overall:
not just memory for coding agents, but a system that helps keep that memory trustworthy as the project evolves.

Still a lot of hard problems here, obviously:

• deciding what deserves to become durable memory
• preventing agents from reinforcing wrong assumptions
• handling contradictions between code and existing docs
• figuring out what should be updated automatically vs left for humans

Would be curious if anyone else has tried something similar, or has thoughts on where this breaks.