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, ADRs help but doing it for everything is just too noisy and time-consuming. What's more, most of the decisions just detail what was decided, which is the easy part.

I've been wanting to change this for a long time, and with LLMs, we now 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!