What is something you learned using Coding agents?
For me it was Claude code who kept talking about footguns (which I legitimately knew nothing about). Humor me with a little context on this one.
I transitioned from BluefinOS to NixOS mid last December. My workflow then was Tailscale Android app on GrapheneOS in Termux ssh'ing into machines at my house using Claude Code. I was delivering Uber Eats and DoorDash running 3 phones into 3 machines- I don't recommend this 😂 btw.
But Coder kept talking about footguns and after about 9 or 10 of them I asked what they were and culture.git was born and here's our standing list. Serious question, do you have a documented footgun list and would you share it with the community? 🤔🧐😂
# Known Footguns
A catalog of recurring traps that have bitten contributors during UCOS work. Each entry names a specific shape, where it surfaces, what it looks like when you've stepped on it, and the discipline that prevents it.
This document complements CULTURE.md. Culture is how the team works
when it is working well; this is the inverse — patterns that produce
failures when discipline lapses. Entries are added as the patterns
surface in real work.
CULTURE.md Rule 10 (new Nix files must be staged before flake builds) was the trigger for creating this doc. It is now Entry 1 below; CULTURE.md retains a stub pointing here.
---
## Footgun 1: New Nix files must be staged before flake builds see them
Where it surfaces: any time you create a new .nix file in a
flake-managed repository and run nix build or nix flake check
before git add-ing the file.
Surfaced during: FU-009 (kubo.nix), 2026-05-01.
The shape: nix build and nix flake check operate on a source
snapshot of the flake. Untracked files are invisible to this
snapshot — they do not exist as far as Nix is concerned. The
dirty-tree warning (warning: Git tree is dirty) only fires for
files, not untracked ones, so its absence is not
a signal that the build will see your new file.
One thoughtful comment unlocks the ability to create threads.
Apparently Chrome saved what boxes you checked in a local db, I accidentally exited out of a Claude artifact where I was marking things as yes / no and thought I lost my work but Claude Code was able to recover it from this cache I had no idea existed!