AGENTS.md has stale/broken references that break agent workflows

[beastoin]

Broken References in AGENTS.md

Audit of AGENTS.md found references to tools, scripts, and docs that don't exist. Agents following these instructions will fail.

Dead tool references

• Line 194: codriver / mcp__codriver__desktop_screenshot — not installed on VPS or Mac Mini. Added in 0dd94534 (Mar 18), carried to AGENTS.md in 49f9a047 (May 22). Was likely an MCP server local to Nik's session.
• Line 197: claude-in-chrome — referenced without install/setup context; Claude Code-only browser extension.

Dead script references

• Line 163: ./scripts/sentry-logs.sh — does not exist in desktop/scripts/
• Line 163: ./scripts/posthog_query.py — does not exist in desktop/scripts/
• Line 242: desktop/scripts/promote_release.sh — does not exist

Dead doc references

• Line 240: docs/runbooks/deploy.md — file does not exist
• Line 241: docs/runbooks/logging.md — file does not exist

Claude Code-specific instructions without Codex fallback

• Line 220: EnterWorktree — Claude Code deferred tool, Codex agents don't have it
• Lines 91, 111: Skills (add-a-new-localization-key-l10n-arb, omi-add-missing-language-keys-l10n) — Claude Code only, no manual fallback documented
• Line 194: mcp__codriver__desktop_screenshot syntax — Claude Code MCP invocation format

Missing practical info

• No screencapture command for Mac desktop screenshots (confirmed working natively from SSH after TCC fix on May 31)
• ./run.sh commands (lines 119-123) missing cd desktop context
• scan_async_blockers.py (line 36) vs lint_async_blockers.py (worktree CLAUDE.md) — unclear which is canonical

Context

CLAUDE.md was reduced to a thin pointer at AGENTS.md in commit 49f9a047 (May 22, by Nik). Previously the two files had separate content tailored for Claude Code vs Codex. The consolidation moved Claude-specific content into the agent-neutral AGENTS.md without adding Codex fallbacks.