Release Preflight Skill
SKILL.md
Release Preflight Skill
Pre-checks, version consistency, and deployment discipline.
The Golden Rule
NEVER publish without running the preflight checklist.
Quick Start
# Full preflight check
scripts/release-preflight.ps1
# With packaging test
scripts/release-preflight.ps1 -Package
# Skip time-consuming tests
scripts/release-preflight.ps1 -SkipTests
Version Locations (Must Stay Synchronized)
| # | Location | Field | Example |
|---|---|---|---|
| 1 | platforms/vscode-extension/package.json |
version |
"5.1.0" |
| 2 | CHANGELOG.md |
Latest heading | ## [5.1.0] - 2026-02-07 |
| 3 | .github/copilot-instructions.md |
**Version**: line |
**Version**: 5.1.0 |
| 4 | platforms/vscode-extension/.github/copilot-instructions.md |
Same as #3 | |
| 5 | docs/index.html |
Footer version | v5.1.0 |
| 6 | ROADMAP-UNIFIED.md |
Quick Status table | Master 5.1.0 row |
| 7 | Git tag | Tag name | v5.1.0 |
Preflight Gates
| Gate | Check | Script Flag |
|---|---|---|
| 0 | PAT configured | Always |
| 1 | Version sync (all 7 locations) | Always |
| 2 | Build passes | Always |
| 3 | Lint passes | Always |
| 4 | Tests pass | -SkipTests to skip |
| 5 | Package creates | -Package to include |
| 6 | Human review | Manual |
Full Release Workflow
# VS Code Extension release
scripts/release-vscode.ps1 -BumpType minor
# M365 Agent release
scripts/release-m365.ps1 -Validate
Version Bump Only
# 1. Bump
npm version patch --no-git-tag-version
# 2. Get version
$v = (Get-Content package.json | ConvertFrom-Json).version
# 3. Update CHANGELOG, commit, tag, push
git add -A; git commit -m "release: v$v"; git tag "v$v"; git push --tags
Common Mistakes
| Mistake | Prevention |
|---|---|
| Published without version bump | Run preflight first |
| CHANGELOG not updated | Script checks this |
| Forgot to push tags | Script does this |
| Version mismatch | Grep entire repo for old version |
| PAT 401 error | Refresh PAT before release |
Related Scripts
| Script | Purpose |
|---|---|
scripts/release-preflight.ps1 |
Pre-release validation |
scripts/release-vscode.ps1 |
Full VS Code release |
scripts/release-m365.ps1 |
M365 agent packaging |
.github/muscles/build-extension-package.ps1 |
Full build (sync + compile + PII scan) |
.github/muscles/sync-architecture.js |
Canonical Master → Heir sync |
Triggers
- "release", "publish", "deploy"
- "preflight", "pre-release check"
- "version bump", "version sync"
Scripts: scripts/release-preflight.ps1, scripts/release-vscode.ps1