docs: require git worktrees and refresh AGENTS.md (#235)

Rewrite agent guidelines against the current tree: always-on worktrees,
real Sources layout (CLI, ObjC, resources), SPM deps, VocaLogger, and Hugo site.

Author: jatinkrmalik