platform-guide — fresh-docs discipline for third-party platforms
Third-party dashboards change constantly (a real example: Forge's Oct-2025 UI rework renamed "aliases" to Custom Domains and made site-type choices one-shot — pre-rework instructions were confidently wrong). Stale memory produces walkthroughs that look right and waste an afternoon.
Rules
- Search before instructing. Before any UI walkthrough, configuration guide, or credential-setup explanation for an external platform: WebSearch for the current official documentation (qualify the query with the current year where UIs churn). WebFetch the top official source. Cross-check a second source when steps are security-sensitive (OAuth scopes, webhooks, payment config).
- Prefer official channels: platform docs > changelogs/release notes > reputable recent tutorials. If a dedicated plugin exists for the platform (e.g. a Shopify plugin), use its skills as the first stop — and never fabricate endpoints, GraphQL fields, or doc URLs.
- Cite freshness: note the source and fetched date
(
platform docs <url> (fetched YYYY-MM-DD)), consistent with the docs convention. If the live UI may differ from the doc, say so and offer to verify against the real dashboard (browser MCP) instead of guessing. - API versions matter: pin/mention the API version rather than "latest", and check deprecation notices for anything the instruction depends on.
- If search is unavailable, say the answer is from memory as of the knowledge cutoff and mark every step that could have changed — don't present stale steps as current.