Gnosis, a knowledge base for what the code can't tell you

For the past few years, I've been frustrated at how we document our products. The code can tell you what you ended up doing, maybe why you ended up doing it (if your team is disciplined about comments/documents), but it can't tell you why you didn't do what you didn't do.

Time and time again, I've seen teams try to change something to a better way, only to realize why it was done the "worse" way in the first place. Documenting decisions not taken is just really hard, and for a long time I've wanted to change it.

With LLMs, we can. LLMs are diligent about documenting, and all you need is an instruction in AGENTS.md. That's why I built gnosis.

Simply tell your agent to run it after planning and when done, and gnosis provides the agent with all direction necessary.

Gnosis tells the agent to document only information it got from the human, not anything it can find by itself, and especially to document why alternatives were rejected. It uses a JSONL append-only log and a SQLite index (for retrieval), making it simple, fast, and convenient.

I'd appreciate it if you tried it out and gave me feedback!