diff --git a/CLAUDE.md b/CLAUDE.md
index ba83c69..a8e000e 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -5,8 +5,9 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 ## Agent Workflow Rules
 
 - **Commit after every task**: When a task is complete, stage all changed files and create a git commit before marking the task done.
-- **Keep documentation current**: Update `CLAUDE.md` with any new commands, architecture details, or setup steps introduced by your task. Update `PRD.md` only if scope/design decisions changed.
+- **Keep documentation current**: Update `CLAUDE.md` after every task that adds, changes, or removes a feature, API endpoint, or architectural pattern. This is mandatory, not optional. Update `PRD.md` only if scope/design decisions changed.
 - **Mark tasks in td**: `td start <id>` when beginning, `td close <id>` when done.
+- **Run td commands one at a time**: Never chain `td` commands with `&&` or `;`. Each `td` call must be its own separate shell invocation.
 - **Only the orchestrator touches td**: Sub-agents must never call `td` commands directly. Concurrent `td` writes from parallel agents corrupt the SQLite database. The orchestrator handles all `td start`/`td close` calls before and after delegating to sub-agents.
 
 ## Task Management