Separate audiences: README as navigation entry, getting-started as canonical tutorial,
troubleshooting as failure recovery, AGENTS as agent-only operating contract,
COMMANDS as pure reference, maintainer-guide for release/versioning/architecture.
- Update test_command_docs.py to reference new pf-* command docs
- Add TestUnifiedCommandsInUserDocs to verify no old commands in primary docs
- Update test_smoke.py docstring for sync command