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, ADRs help but doing it for everything is just too noisy and time-consuming. What's more, most of the decisions just…
What it does
In the maker’s words, at launch
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!
Does the same job
all alternatives →- IPI published a book to save you from my software architecture mistakes2024 · leanpub.com · ▲100
Hey HN, I just wanted to share that after five months of intense work and countless caffeine-fueled writing sessions, "Master Software Architecture: A Pragmatic Guide" is now available. Writing this book was a crazy time. I entirely focused on it, and it took exactly 753 hours of writing, editing, and image editing & resizing(!) until the premiere. Yes, the last one (images) was a killer. If you ever think about writing a book, reserve a lot of time for it unless someone else does it for you. As a result, I am handing you the nearly 400-page book. It is a guide that will help you connect all…
- IBI built a GitHub application that generates documentation automaticallyDec 2025 · codesummary.io · ▲6
Hi HN, A lot of the dev teams I have worked with had a lot of issues with their documentation. In fact, some of my easiest clients to get were from clients that had "black box" solutions that devs no longer at the company had created. Personally, writing documentation is like grinding nails on a chalkboard. I have been having a lot of fun with building solutions that can run in a distributed way, not something a dev needs to run themselves. And after a significant amount of testing and building out several different solutions, I finally have a solution that is easy to set up and runs in the…
- SSSpotlight shows what your Claude Code/Codex are doingJun 2026 · backplanes.com · ▲8
Hola HN! Long time lurker, sometimes commentor, first time poster here. I’ve been working alongside my two co-founders and a few colleagues on a project I’m excited (and a little nervous) to share with you all! Like many of us, I’ve lived a tortured existence with AI coding (is it vibes?) over the past few months - I think November was a big moment with this. But, one thing I’ve noticed after building orchestration layer after orchestration layer is that the thing I always came back to was “what the hell is Claude Code actually doing?” Perhaps it’s because of the time Claude Code got…
- BPBig Picture” project management for software developers2022 · projectburndown.com · ▲8
We got tired of not being able to accurately answer "When will this be done?" and "Will anyone be required to work overtime on the current schedule?", or spending too much time in meetings and standups trying to answer those questions. Just opened up for beta. Would love some opinionated developers to guide future improvements (or feedback on the general idea).
- LILisp in Five Days2022 · github.com · ▲9
Hi HN! I kept hearing about Lisp and why it was special but didn't have a great place to start. I wanted something self-contained that helped me develop intuition rather than fluency. My hope is this is helpful for casual programmers, professionals from other fields who interact with code, or engineers who haven't had much exposure to interpreters or compilers. Hope this helps anyone else who's curious about getting a sense of Lisp and what makes it special with a limited time investment! Feedback or other cool Lisp things welcome :)
- LALucidcode- A Copilot to Understand Codebases2024 · lucidcode.ai · ▲6
Hello HN, I am building a devtool to understand existing codebases. The idea originates from my time at big tech as well as various attempts to get involved in open source projects. When I was in college I wanted to improve my coding skills by contributing to opensource projects. I would pickup a bug or feature request but I always found myself stuck at the very first step. I did not understood where and how to begin contributing. I once submitted a patch in firefox which was labeled "Good first issue" but that was still very handheld. The assigner told me exactly which files I need to…
More dev tools this month
the category →
The first open-source price index for GPU compute
Dev tools · 10d ago · getcomputable.com
OpenTrailPaper is open-source bike computer firmware for the LilyGO T5S3 4.7" E-Paper PRO. It supports offline maps, GPX routes, FIT recording and Bluetooth sensors.
Dev tools · 2d ago · opentrailpaper.com
Open-source GTM skills for technical founders
Dev tools · 29d ago · gtmcofounder.com
Launched alongside, April 2026
the whole month →
- AG
Thought the resources for GPU arch were lacking, so here we are
Life & fun · Apr 2026 · jaso1024.com
- IB
Built a ~9M param LLM from scratch to understand how they actually work. Vanilla transformer, 60K synthetic conversations, ~130 lines of PyTorch. Trains in 5 min on a free Colab T4. The fish thinks the meaning of life is food. Fork it and swap the personality for your own character.
AI · Apr 2026 · github.com
- BC
Life & fun · Apr 2026 · sam-burns.com
- IB
With social media and now AI, its important to keep the indie web alive. There are many people who write frequently. Blogosphere tries to highlight them by fetching the recent posts from personal blogs across many categories. There are two versions: Minimal (HN-inspired, fast, static): https://text.blogosphere.app/ Non-minimal: https://blogosphere.app/ If you don't find your blog (or your favorite ones), please add them. I will review and approve it.
AI · Apr 2026 · text.blogosphere.app