[Feedback] Docs: add workaround for setup stuck after auth

[chrizbo]

Customer Language

Exact Phrases

• "setup gets stuck after login"
• "rerun project sync"

Terminology

• workaround
• project sync

Error Messages / Commands / Product Names

• None captured

Source Evidence

• Source link: https://github.com/chrizbo/agentics-beyond-code-test/pull/9
• Source context: Docs: add workaround for setup stuck after auth This PR documents a workaround for when setup gets stuck after login. The workaround is to refresh the browser and rerun project sync.

[github-actions]

Feedback Review

Potential duplicates: #311 ("just hangs after auth"), #316 ("gets stuck after login"), #322 ("black box after auth") — all report setup appearing stuck after auth.

Strategy fit: Strong Fit
The presence of multiple reports about setup appearing stuck supports tradeoffs #3 (Transparency by default) and #1 (Ship to learn): improving visibility and adding documented workarounds reduces customer friction while the root cause is investigated.

Suggested priority: P1
A docs workaround is a reasonable near-term mitigation; consider shipping docs + a small UX visibility patch soon.

PM decision needed: Confirm whether to accept the documented workaround as short-term mitigation and prioritize a UI/telemetry fix.