docs: harden destination-generator skill from PR feedback + document /orchestrate

[mdkhan-tw]

Summary

Updates the Claude Code destination-generator skill and its docs. No product/destination code changes — this is tooling + documentation only (.claude/ skills and READMEs).

Two things:

1. Encodes real PR-review feedback into the /generate-destination skill so future generated destinations follow repo conventions by default.
2. Documents the /orchestrate one-command pipeline for end users (root README + skills README/QUICK_START).

All patterns were verified against existing destinations in the repo (klaviyo, reddit-conversions-api, iterable, ms-bing-capi, s3, trackey) before being written into the skill.

Feedback incorporated into generate-destination.md

#	Feedback	Change
1	Enable batching with batch_keys + implement performBatch	New Batching (REQUIRED) section: enable_batching / batch_size / batch_keys field defs + perform/performBatch delegating to a shared utils.ts helper. Added to constraints & checklist.
2	Avoid registering the destination ID in destinations/index.ts	Step 6 rewritten to "Do NOT register a destination ID" — leave the registry untouched and record it as a PR TODO for the production-assigned metadata ID (IDs must match across environments, synced via sprout).
3	Every request/response object should be typed	New Typed Requests and Responses (REQUIRED) section: interfaces in types.ts, annotated request bodies, request<ResponseType>(...).
4	Separate types.ts, constants.ts, utils.ts for send logic	Updated folder structure + file-generation order + a file-organization rule (endpoints/enums → constants.ts, interfaces → types.ts, send logic → utils.ts; actions are thin wrappers).
5	Snapshot tests were missing	New Snapshot Tests (REQUIRED) section with the shared generateTestData boilerplate; snapshot.test.ts added to structure & checklist.

Also fixed the documented test command to use the package-local Jest binary (avoids the root Jest 30 bind crash).

/orchestrate documentation

• Root README.md — new concise, end-user-facing "Generate a Destination with Claude Code" section (+ TOC entry).
• .claude/skills/README.md — "🚀 Start here: /orchestrate" section with the 7-step pipeline and conventions callout.
• .claude/skills/QUICK_START.md — /orchestrate fastest-path at the top + pipeline commands in the file-locations table.

Files changed

• .claude/commands/generate-destination.md
• .claude/skills/README.md
• .claude/skills/QUICK_START.md
• README.md

Testing

Docs/skill-definition changes only — no runtime code affected. All patterns cross-checked against existing destinations for accuracy.

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Note

Copilot couldn't run its full agentic review because no GitHub Actions runner was available. Make sure your repository has a runner available to run Copilot's review, or add a copilot-setup-steps.yml file specifying one with the runs-on attribute. See the docs for more details.

Adds and expands documentation around using Claude Code “skills” to scaffold Segment action-destinations, including a new /orchestrate end-to-end flow and stronger guidance for batching, typing, snapshots, and registration conventions.

Changes:

• Adds a new top-level README section introducing Claude Code scaffolding commands.
• Expands .claude/skills docs with an /orchestrate quick path and updated generated file conventions.
• Updates the /generate-destination command guidance (batching, typed I/O, snapshot tests, and avoiding placeholder destination IDs).

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 5 comments.

File	Description
README.md	Adds a “Generate a Destination with Claude Code” section and command list.
.claude/skills/README.md	Adds /orchestrate documentation and updates generated destination structure/conventions.
.claude/skills/QUICK_START.md	Adds an /orchestrate fast path and updates the file map.
.claude/commands/generate-destination.md	Adds detailed generator rules for file organization, batching, typed requests/responses, and snapshot testing.