docs(setup): document the existing validate+init stale-relay resync path

[gmoncor]

What: Document that bmad-loop validate already flags a stale hook relay copy (via install.hook_script_current and the "hooks.relay-stale" warning) and that bmad-loop init is the existing resync command for it.

Why: A stray docstring implies no detect+resync mechanism exists for the hook relay, but validate and init already provide it together; the real gap is discoverability, not a missing feature, so no new command should be added. Related to #563, which shows the resync is not fully reliable when a stale marker already exists (re-init can print "hooks already registered" without updating a command-shape change) -- this PR documents the happy path and links #563 as its known limitation, rather than overstating the mechanism as unconditionally reliable.

How:

• Add a short note to docs/setup-guide.md and AGENTS.md near the existing hooks/relay documentation, cross-referencing bmad-loop validate's stale-relay warning and bmad-loop init as its fix.

Testing: Read-through diff; doc-only change, no new command implemented.

Changelog: "Docs: documented that bmad-loop validate detects a stale hook relay and bmad-loop init resyncs it."

🤖 Generated with Claude Code

[coderabbitai]

Warning

Review limit reached

Next included review available in 59 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used all 2 included reviews currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: 169f6df1-3315-43a6-8c47-4a8cf4eadd0f

📥 Commits

Reviewing files that changed from the base of the PR and between e10f02f and ec1808f.

📒 Files selected for processing (3)

• AGENTS.md
• CHANGELOG.md
• docs/setup-guide.md

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}