Notes
// things worth writing down once, so nobody has to rediscover them.
Write-ups from the lab: bugs that took a while to corner, tooling decisions and their trade-offs, and the occasional fix that was too annoying to find the first time. Specific rather than general — if a note can be summarised as "it depends", it doesn't get written.
-
Giving Claude Code a map of your projects
An agent rooted at project A knows nothing about project B, so you paste absolute paths forever. Writing them into the project's config instead fails for four reasons, and the fourth — a stale line can't know it's stale — is the one that has to be answered with behaviour, not architecture.
-
Surviving context compaction with a handoff doc
Compaction is lossy in a predictable direction: it keeps what happened and drops what it cost to learn. One filter — could the next session recover this from git log in under a minute? — decides what belongs in the doc, and one rule stops it rotting into a confident lie.
-
WSL 2 loses all networking under Check Point VPN hub mode
Connect the VPN and WSL stops reaching anything while Windows carries on fine. Names still resolve, so it looks like DNS and isn't. The client splits the WSL subnet into two halves pointed at the tunnel, and a
/21beats a/20. -
cdp: jumping to project directories by label, not by guess
Directory jumpers rank by frequency, which is inference, and leaves nowhere to record that arriving somewhere usually means starting three processes. Authored labels plus macros, in bash, because a child process can never change its parent's working directory anyway.
-
Running WSL shell functions from PowerShell
wsl project-jump apireports command not found for a command that works fine inside WSL, because non-interactive Bash never reads~/.bashrc. The obvious fix collides with PowerShell's argument marshalling, so the fragile part gets designed out instead.