rollout-basecoat

name	rollout-basecoat
compatibility	["github-copilot-cli"]
description	Use when refreshing a consumer repository to the latest BaseCoat build or a pinned BaseCoat release tag. USE FOR: refresh basecoat, update basecoat in a consumer repo, run sync.ps1 or sync.sh with .basecoat.yml defaults, verify installed basecoat version after sync, recover when rollout-basecoat skill invocation fails. DO NOT USE FOR: editing BaseCoat framework internals, designing new agents or skills, running unrelated CI/CD deployments.
category	operations
visibility	public
metadata	{"category":"operations","maturity":"stable","audience":["developer"]}
allowed-tools	[]

Rollout BaseCoat Skill

Use this skill to refresh a consumer repository to the latest BaseCoat build or to a pinned BaseCoat release.

Shortcut Phrases

• refresh basecoat
• update basecoat
• sync basecoat to latest
• upgrade basecoat in this repo

Workflow

1. Read .basecoat.yml (if present) for source and ref.
2. Run sync using the platform script:
   • Windows: pwsh sync.ps1
   • Linux or macOS: ./sync.sh
3. Verify .github/base-coat/version.json in the consumer repo.
   • When ref is pinned to a semver tag (for example v3.33.0), sync now enforces provenance and fails if version.json does not match the tag.
   • Known-bad tags with confirmed payload drift are auto-remapped to the first corrected release, with a warning to update the consumer pin.
4. Compare installed version with latest upstream release: gh release list --repo IBuySpy-Shared/basecoat --limit 1.
5. Report exactly what changed and any follow-up steps.

Fallback When Skill Routing Fails

If the environment reports Skill not found: rollout-basecoat, run direct sync commands instead of stopping:

# PowerShell fallback (from consumer repo root)
$env:BASECOAT_REPO = 'https://github.com/ivegamsft/basecoat.git'
$env:BASECOAT_REF  = 'main'  # or vX.Y.Z
pwsh .\sync.ps1

# Bash fallback (from consumer repo root)
BASECOAT_REPO=https://github.com/ivegamsft/basecoat.git \
BASECOAT_REF=main ./sync.sh