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

Details

External ID

47920641

Source

HN

Company

—

Product

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

Website domain

github.com

Launched

April 27, 2026

Cohort

—

Upvotes

6

Upvotes percentile

0.2808483290488432

Tags

—

Fetched at

Sept. 7, 2026, 9:26 p.m.

Updated at

Sept. 7, 2026, 9:26 p.m.

Description

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, 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!

• Source listing
• Website