refactor(ci): split api-reference sync into three focused jobs (#677)

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

.github/templates/docs/reference-copy-issue.md

@@ -0,0 +1,40 @@
+<!-- component:{{COMPONENT_NAME}} -->
+<!-- drift-type:reference-copy -->
+<!-- trigger-prs:{{TRIGGER_PR_NUMBERS}} -->
+<!-- trigger-issues:{{TRIGGER_ISSUE_NUMBERS}} -->
+
+## Summary
+The hand-written MDX reference page for `{{COMPONENT_NAME}}` has drifted from the auto-generated API JSON.
+
+> The API JSON files are rebuilt on every sync run and are always current.
+> Drift listed here is in the **MDX prose**, not the generated data.
+
+## References
+- Triggering PR(s): {{SOURCE_PR_URLS}}
+- Triggering issue(s): {{SOURCE_PR_ISSUE_URLS}}
+
+## API Changes Summary
+| Surface | Change Type | Before | After | Source |
+|---|---|---|---|---|
+{{API_CHANGES_TABLE_ROWS}}
+
+## Out-of-Sync Docs
+| MDX File | Section | Drift Type | Current (MDX) | Expected (from JSON) | Action |
+|---|---|---|---|---|---|
+{{OUT_OF_SYNC_TABLE_ROWS}}
+
+## Sidebar Status
+- `site/src/docs.config.ts` entry: {{SIDEBAR_STATUS}}
+
+## Implementation Notes
+- Target files: {{TARGET_FILES_LIST}}
+- Drift-specific tasks: {{IMPLEMENTATION_TASKS}}
+- Validation commands:
+  - `pnpm -C site api-docs`
+  - `pnpm -C site build`
+
+## Scope Checklist
+- [ ] Update MDX reference page content for `{{COMPONENT_NAME}}`.
+- [ ] Update sidebar entries in `site/src/docs.config.ts` if required.
+- [ ] Regenerate API reference JSON (`pnpm -C site api-docs`).
+- [ ] Verify build (`pnpm -C site build`).