# Bug Report: README and Upgrade Docs

## Bugs Found: 0

No bugs found. Changes are documentation-only and all tests pass.

## Issues Noted (pre-existing, not introduced by this task)
1. `upgrade.sh` uses `|| true` so `status.py --upgrade` failure is silently swallowed
2. `upgrade.sh` doesn't verify python3 is available
3. Pre-commit hook assumes `.git/hooks/` path (doesn't handle bare repos/worktrees)