{{ message }}
Discover gists
A pattern for building personal knowledge bases using LLMs.
This is an idea file, it is designed to be copy pasted to your own LLM Agent (e.g. OpenAI Codex, Claude Code, OpenCode / Pi, or etc.). Its goal is to communicate the high level idea, but your agent will build out the specifics in collaboration with you.
Most people's experience with LLMs and documents looks like RAG: you upload a collection of files, the LLM retrieves relevant chunks at query time, and generates an answer. This works, but the LLM is rediscovering knowledge from scratch on every question. There's no accumulation. Ask a subtle question that requires synthesizing five documents, and the LLM has to find and piece together the relevant fragments every time. Nothing is built up. NotebookLM, ChatGPT file uploads, and most RAG systems work this way.
13 custom zsh functions that make the macOS terminal dramatically more productive — one-step git, instant JSON formatting, a phone-friendly file server, timers, todo lists, and more. No frameworks, no plugin managers, just plain readable shell functions.
Full write-up: [link to your Medium article]
# 1. Download the functions file
bavanws
/ reducing-comment-verbosity-claude-code.md
Last active
October 27, 2026 09:56
Reducing code-comment verbosity with Claude Code: pre-hoc (CLAUDE.md rules) + post-hoc (comment-cleanup skill)
Claude Code over-comments. It narrates loops, restates signatures, leaves change-log notes addressed to a PR reviewer who'll never see them, and points at spec sections that have already moved. Two layers fix it and compound: a pre-hoc layer in CLAUDE.md that steers the model as it writes, and a post-hoc cleanup skill that reclaims the residue — plus everything verbose you inherited from past work and other contributors. Use both; neither is sufficient alone.
The whole thing is one principle applied twice. Code shows how. A comment earns its place only by carrying why — a non-obvious constraint, a deliberate deviation, a gotcha, a workaround, the reason a tempting simpler version is wrong. Everything else is restatement, and restatement rots: it drifts out of sync, adds diff noise, and trains readers to skim past comments entirely.
The block I use:
This is especially useful if you do not have an SD card reader or if you do not want to open the New 3DS' pesky shell.
There are two options: the official MicroSD management (New 3DS only) (Requires Windows) or FTPD (must have CFW or homebrew installed).
FTPD is quicker and easier to use in the long run and can be used on all systems and computers (and phones!); however, MicroSD management is official and can be done with a stock system.
NewerOlder