A personal knowledge base following the Zettelkasten methodology, maintained by LLMs using the LLM Wiki pattern.
Interlinked notes organized by topic. Browse in Obsidian for graph view and backlinks, or read the full index.
2026-09-17An upstream identifier can be duplicated - A source's own printed identifier is not a uniqueness guarantee; prefer a key the traversal itself produces2026-09-17An incremental job must record confirmed absent - A fetch that returned nothing is a result; collapsing it into "not yet done" makes a job rescan its finished backlog forever2026-09-17A prompt constraint is a request, not an enforcement - A rule in the prompt sets a probability; only a validator on the output sets a floor2026-09-17Skill selection runs on the description text alone - Only the description text is read when a skill competes with a command; write it as a router entry, not a label2026-09-17wrangler --env deploys a second worker when no env block exists - Wrangler synthesises and deploys a stray<name>-<env>Worker instead of erroring2026-09-17Push plus reconcile beats polling an address pool - Push handles the normal case at cost proportional to real deposits; a slow idempotent reconcile sweep covers what the push drops2026-09-17A scripted click carries no user activation -element.click()over CDP fires the handler but carries no transient user activation; dispatch at the input layer with coordinates instead2026-09-17Optimize Mac Storage turns disk pressure into an iCloud loop - Disk pressure evicts iCloud files to dataless stubs; a periodic job that reads them re-downloads the same bytes forever2026-09-17Cargo and rustup directories are not caches -~/.cargo/binand~/.rustuphold installs, not caches; check for abin/and PATH resolution before deleting2026-09-17An escaped delimiter is still the delimiter byte -\|in a markdown cell is a rendering convention, not a transformation; a byte-level split still splits on it2026-05-25LKY on why Singapore can never build a Google: Vietnam comparison - LKY's five constraints (size, brain drain, Confucian culture, comfort, takeovers); Vietnam inverts market size and risk culture, mirrors brain drain and scholar pull, lacks rule of law and capital
Obsidian Clipper (raw) ──┐
Claude Code (refined) ───┤──► this repo ──► Obsidian reads/lints/links
Claude AI skill (refined)┘
- Ingest: new knowledge arrives from web clips, coding sessions, or research conversations
- Compile: the LLM checks for overlaps, flags contradictions, updates cross-references and synthesis pages
- Query: ask questions against the compiled wiki; good answers get filed back as new notes
- Lint: periodic health checks for orphans, broken links, stale claims
The human thinks and curates. The LLM handles the bookkeeping.
Type these to Claude in this repo (exact wording doesn't matter, intent does):
| Command | What it does |
|---|---|
process inbox |
Refine raw _inbox/ captures into the right folder with links |
capture this as a note: ... |
Save a learning moment from the current chat |
compile recent commits / re-ingest |
Run compilation on notes pushed directly to GitHub (backlinks, index, README, log) |
answer from the wiki: ... |
Synthesize across notes, cite with [[wikilinks]] |
file that answer as a wiki page |
Commit a synthesis from chat as a new note |
reorganize the wiki |
Clean up orphans, folders, backlinks |
lint the wiki |
Health check: orphans, broken links, raw stragglers |
Full reference: commands cheatsheet in the usage guide.
| Folder | Domain |
|---|---|
| engineering/ | Software engineering practices, principles, languages |
| life/ | Life philosophy, habits, mindset, career wisdom |
| leadership/ | Management, negotiation, business leadership |
| cs/ | Computer science fundamentals |
| dwarves-kit/ | Dwarves Kit architecture and design |
| hiring/ | Candidate assessment and hiring |
| ai-tooling/ | AI developer tools and evaluations |
| ai/ | AI concepts, memory systems, agent patterns |
| diaspora/ | Vietnamese and Asian diaspora analysis |
| history/ | History, civilizations, geopolitical patterns |
| claude-code/ | Claude Code hooks, skills, workflows |
| coding-agents/ | Agent-laptop ergonomics: sandboxing, opt-in design, integration tradeoffs |
| agentkernel/ | agentkernel CLI gotchas and operational notes |
| crypto/ | Cryptocurrency, blockchain, DeFi, tokenomics |
| wealth/ | Trust-building, business relationships |
| geopolitics/ | Oil crises, government structures |
| startup/ | Startup strategy, product focus |
| health/ | Wellness, nutrition |
| investing/ | Compound interest, startup investing |
| mcp/ | Model Context Protocol |
| pkm/ | Personal knowledge management |
| devtools/ | Developer tools and config |
| patterns/ | Software patterns and anti-patterns |
| philosophy/ | Taoism, I Ching, timing and preparation |
| finance/ | Bond markets, capital structure, compounding knowledge |
| finance-tooling/ | Financial tool evaluations: terminals, data providers, broker platforms, frameworks |
| comp-fin/ | Computational finance: optimization, stochastic control, learning paths |
| optimization/ | Operations research, MILP, mathematical optimization fundamentals |
| career/ | Career strategy, workplace dynamics, office politics |
| macos/ | macOS frameworks and platform-specific architecture |
| local-llm/ | Local LLM economics, Ollama Cloud, Qwen on Apple Silicon |
| networking/ | Tailscale, WireGuard, portless, mesh VPN ergonomics |
| security/ | Threat modeling for AI agents, sandboxing trade-offs |
| decentralized/ | Decentralized git collaboration, p2p protocols |
| math/ | Math vocabulary and notation, Vietnamese-English mapping for QC and comp-fin |
| quantum/ | Quantum computing fundamentals: complexity classes, algorithms, state preparation, Vietnamese terms |
| jupyter/ | Jupyter architecture, usage patterns, Claude integration paths, post-Jupyter reactive notebooks |
| vietnam/ | LKY framework applied to Vietnamese founders and operators; capital portfolio across seven forms |
| etymology/ | Word origins and prefix decompositions |
| youtube/ | YouTube tooling |
| zed/ | Zed editor agent rules and configuration |
| cloudflare/ | Cloudflare Workers, Durable Objects, wrangler operational gotchas |
| browser-automation/ | CDP and browser-automation debugging |
| ci/ | CI pipeline behavior, GitHub Actions gotchas |
- Full note index - catalog of all notes with one-line summaries
- Usage guide - how to add notes, use Obsidian, work with Claude
- Architecture - system design, folder conventions, operations model
- Requirements - feature tracker, design principles, scaling triggers
- Changelog - project decisions log
- Operations log - chronological record of ingests, queries, lints