Skip to content

Configuration

Set these in repositories that publish template migrations with .github/workflows/template-publish-migration.yml.

NameRequiredDescription
TEMPLATE_SYNC_PACKAGENoPackage spec installed by the workflow with npm --ignore-scripts. Defaults to template-subscriber-migration-system@latest; change it to pin a version, git URL, or tarball URL.
OPENAI_MODELNoModel used for optional migration summary generation. Defaults to gpt-5.5.
NameRequiredDescription
GITHUB_TOKENBuilt inGitHub Actions token used to read PRs and publish release assets. No manual secret is needed.
OPENAI_API_KEYOnly when generate_summary is trueOpenAI API key for one-time migration summary generation.

The template repository does not need OPENAI_API_KEY unless optional summary generation is enabled.

Set these in repositories that receive template migrations with .github/workflows/template-sync.yml and .github/workflows/template-migration-command.yml.

NameRequiredDescription
TEMPLATE_SYNC_PACKAGENoPackage spec installed by the workflow with npm --ignore-scripts. Defaults to template-subscriber-migration-system@latest; change it to pin a version, git URL, or tarball URL.
TEMPLATE_SYNC_DEFAULT_UPSTREAM_REPOYesDefault upstream template repository in OWNER/REPO form.
OPENAI_MODELNoModel used for generation. Defaults to gpt-5.5 in the workflow example.
NameRequiredDescription
TEMPLATE_SYNC_BOT_TOKENYesToken for opening PRs, pushing commits, writing comments, labels, and variables.
OPENAI_API_KEYYesOpenAI API key for approve and revise generation.
TEMPLATE_SYNC_UPSTREAM_READ_TOKENNoToken for reading private template releases.

Subscriber workflows create and update these automatically:

NameDescription
TEMPLATE_SYNC_LAST_HANDLED_MIGRATION_IDNewest migration opened, applied, or declined.
TEMPLATE_SYNC_LAST_APPLIED_MIGRATION_IDNewest migration applied.
TEMPLATE_SYNC_LAST_DECLINED_MIGRATION_IDNewest migration declined.
TEMPLATE_SYNC_UPSTREAM_REPOOptional upstream override for one subscriber.