From e3287115c59375da5beef8de2fe20a7ead3f6916 Mon Sep 17 00:00:00 2001
From: Aiden McClelland <me@drbonez.dev>
Date: Thu, 5 Feb 2026 13:46:14 -0700
Subject: [PATCH] docs: add USER.md for per-developer TODO filtering

- Add agents/USER.md to .gitignore (contains user identifier)
- Document session startup flow in CLAUDE.md:
  - Create USER.md if missing, prompting for identifier
  - Filter TODOs by @username tags
  - Offer relevant TODOs on session start
---
 .gitignore |  1 +
 CLAUDE.md  | 15 +++++++++++++++
 2 files changed, 16 insertions(+)

diff --git a/.gitignore b/.gitignore
index 51e25ae95..4207eb792 100644
--- a/.gitignore
+++ b/.gitignore
@@ -21,3 +21,4 @@ secrets.db
 /build/lib/firmware
 tmp
 web/.i18n-checked
+agents/USER.md
diff --git a/CLAUDE.md b/CLAUDE.md
index d2bdb8a73..80cd0da76 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -125,6 +125,21 @@ Git submodule providing diff-based state synchronization. Changes to `db/model/p
 The `agents/` directory contains detailed documentation for AI assistants:
 
 - `TODO.md` - Pending tasks for AI agents (check this first, remove items when completed)
+- `USER.md` - Current user identifier (gitignored, see below)
 - `rpc-toolkit.md` - JSON-RPC patterns and handler configuration
 - `core-rust-patterns.md` - Common utilities and patterns for Rust code in `/core` (guard pattern, mount guards, etc.)
 - `s9pk-structure.md` - S9PK package format structure
+
+### Session Startup
+
+On startup:
+
+1. **Check for `agents/USER.md`** - If it doesn't exist, prompt the user for their name/identifier and create it. This file is gitignored since it varies per developer.
+
+2. **Check `agents/TODO.md` for relevant tasks** - Show TODOs that either:
+   - Have no `@username` tag (relevant to everyone)
+   - Are tagged with the current user's identifier
+
+   Skip TODOs tagged with a different user.
+
+3. **Ask "What would you like to do today?"** - Offer options for each relevant TODO item, plus "Something else" for other requests.